Documenting primtypes, round 1: ByteArray# and Array#

Hécate hecate at
Sat Apr 30 10:39:34 UTC 2022

Hi everyone,

With the sunny days back in this hemisphere, so do the documentation MRs.

I have two primtypes for which I'd like some help / review / interesting 

* ByteArray#: This is mostly done, you can observe the current rendered 
draft documentation here:
    Please note that the free-floating "Byte Arrays" section of 
documentation cannot be exported or re-exported by GHC.Exts, so we're 
pretty much left with what's in the types' documentation;

* Array#:  The ticket is here:
    State of things: In terms of documentation, we have no 
documentation. Some stuff can be inferred from the SmallArray# haddocks 
but I doubt that every property / interesting usage / pitfall can be 
reasonable derived from putting ¬ at the beginning of the SmallArray# 

Now, on an unrelated note, I'm also wondering about the fate of 
GHC.Pack, for a number of reasons. You will find the ticket here:

My thanks to everyone who's helped me so far, with a special mention to 
bodigrim and koz ross.


Hécate ✨
🐦: @TechnoEmpress
IRC: Hecate

More information about the ghc-devs mailing list