summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorZubin Duggal <zubin.duggal@gmail.com>2021-10-04 16:19:37 +0530
committerZubin Duggal <zubin.duggal@gmail.com>2021-10-05 12:34:47 +0530
commitc92491d5621ae6f3639307247ae2485e3406fcca (patch)
tree87418fc5a3853faa03330822138ebdf2e6d11d6d
parente8693713a40072a0dec5e83b1a31ffb0ee881633 (diff)
downloadhaskell-wip/docs-fixes-20344.tar.gz
docs: Clarify documentation of `getFileSystemEncoding` (#20344)wip/docs-fixes-20344
It may not always be a Unicode encoding
-rw-r--r--libraries/base/GHC/IO/Encoding.hs4
1 files changed, 3 insertions, 1 deletions
diff --git a/libraries/base/GHC/IO/Encoding.hs b/libraries/base/GHC/IO/Encoding.hs
index 9bad2c6b58..0238f1b348 100644
--- a/libraries/base/GHC/IO/Encoding.hs
+++ b/libraries/base/GHC/IO/Encoding.hs
@@ -109,9 +109,11 @@ utf32be = UTF32.utf32be
getLocaleEncoding :: IO TextEncoding
{-# NOINLINE getLocaleEncoding #-}
--- | The Unicode encoding of the current locale, but allowing arbitrary
+-- | The encoding of the current locale, but allowing arbitrary
-- undecodable bytes to be round-tripped through it.
--
+-- Do not expect the encoding to be Unicode-compatible: it could appear to be ASCII or anything else.
+--
-- This 'TextEncoding' is used to decode and encode command line arguments
-- and environment variables on non-Windows platforms.
--