@@ -196,6 +196,12 @@ newBytesAs Pinned = pinnedNew
196196-- Copying
197197-------------------------------------------------------------------------------
198198
199+-- Note: Array copy is more efficient than streaming copy.
200+-- CopyMutableByteArray# translates to genMemcpy in GHC/CmmToAsm/X86/CodeGen.hs
201+-- glibc memcpy copies bytes/words/pages - unrolls the loops:
202+-- https://github.com/bminor/glibc/blob/4290aed05135ae4c0272006442d147f2155e70d7/string/memcpy.c
203+-- https://github.com/bminor/glibc/blob/4290aed05135ae4c0272006442d147f2155e70d7/string/wordcopy.c
204+
199205-- | Put a sub range of a source array into a subrange of a destination array.
200206-- This is not safe as it does not check the bounds of neither the src array
201207-- nor the destination array.