@@ -6,6 +6,16 @@
6-- Portability : GHC
6-- Portability : GHC
8-- Encode Haskell data types to byte streams.
8-- Encode Haskell data types to byte streams.
10+-- The primary purpose of this module is to serialize primitive Haskell types
11+-- to streams for convenient byte by byte processing when such a need arises.
13+-- It would be inefficient to use this to build byte streams from algebraic
14+-- data types. For general serialization of ADTs please use the Serialize type
15+-- class instances. The fastest way to convert general Haskell types to byte
16+-- streams is to serialize them to an array and then stream the array.
18+-- XXX remove unit, bool, ordering, and the type class as well
10module Streamly.Internal.Serialize.ToBytes
20module Streamly.Internal.Serialize.ToBytes