From 54a0b4928967a350be687e17ff3576f2af6e21fb Mon Sep 17 00:00:00 2001 From: Max Bolingbroke Date: Mon, 4 Apr 2011 14:45:13 +0100 Subject: [PATCH] Document invariants on mkText{Decoder,Encoder} --- GHC/IO/Encoding/Types.hs | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/GHC/IO/Encoding/Types.hs b/GHC/IO/Encoding/Types.hs index caffa24..ac9147a 100644 --- a/GHC/IO/Encoding/Types.hs +++ b/GHC/IO/Encoding/Types.hs @@ -90,8 +90,12 @@ data TextEncoding textEncodingName :: String, -- ^ a string that can be passed to 'mkTextEncoding' to -- create an equivalent 'TextEncoding'. - mkTextDecoder :: IO (TextDecoder dstate), - mkTextEncoder :: IO (TextEncoder estate) + mkTextDecoder :: IO (TextDecoder dstate), + -- ^ Creates a means of decoding bytes into characters: the result must not + -- be shared between several byte sequences or simultaneously across threads + mkTextEncoder :: IO (TextEncoder estate) + -- ^ Creates a means of encode characters into bytes: the result must not + -- be shared between several character sequences or simultaneously across threads } instance Show TextEncoding where -- 1.7.10.4