diff options
author | B. Watson <yalhcru@gmail.com> | 2022-03-14 04:05:07 -0400 |
---|---|---|
committer | B. Watson <yalhcru@gmail.com> | 2022-03-14 04:05:07 -0400 |
commit | 293c741d5a883d1fb6725402dc28de9ab51b2393 (patch) | |
tree | 772c32a8a7a901a81e9c8b3c3b1849b8b9e854d7 /perl/perl-encode-locale | |
parent | a84dc3aa6c2ca6003eea5724f4a5c473516f8fa0 (diff) |
perl/perl-encode-locale: Wrap README at 72 columns.
Signed-off-by: B. Watson <yalhcru@gmail.com>
Diffstat (limited to 'perl/perl-encode-locale')
-rw-r--r-- | perl/perl-encode-locale/README | 33 |
1 files changed, 18 insertions, 15 deletions
diff --git a/perl/perl-encode-locale/README b/perl/perl-encode-locale/README index 586df94791bd1..f0eb8ec66060c 100644 --- a/perl/perl-encode-locale/README +++ b/perl/perl-encode-locale/README @@ -1,21 +1,24 @@ Perl module to determine the locale encoding. In many applications it's wise to let Perl use Unicode for the strings -it processes. Most of the interfaces Perl has to the outside world is -still byte based. Programs therefore needs to decode byte strings that -enter the program from the outside and encode them again on the way out. -The POSIX locale system is used to specify both the language conventions -requested by the user and the preferred character set to consume and -output. The Encode::Locale module looks up the charset and encoding -(called a CODESET in the locale jargon) and arrange for the Encode module -to know this encoding under the name "locale". It means bytes obtained +it processes. Most of the interfaces Perl has to the outside world +is still byte based. Programs therefore needs to decode byte strings +that enter the program from the outside and encode them again on the +way out. The POSIX locale system is used to specify both the language +conventions requested by the user and the preferred character set to +consume and output. + +The Encode::Locale module looks up the charset and encoding (called +a CODESET in the locale jargon) and arrange for the Encode module to +know this encoding under the name "locale". It means bytes obtained from the environment can be converted to Unicode strings by calling Encode::encode(locale => $bytes) and converted back again with Encode::decode(locale => $string). -Where file systems interfaces pass file names in and out of the program -we also need care. The trend is for operating systems to use a fixed file -encoding that don't actually depend on the locale; and this module -determines the most appropriate encoding for file names. The Encode -module will know this encoding under the name "locale_fs". For -traditional Unix systems this will be an alias to the same encoding -as "locale". + +Where file systems interfaces pass file names in and out of the +program we also need care. The trend is for operating systems to use a +fixed file encoding that don't actually depend on the locale; and this +module determines the most appropriate encoding for file names. The +Encode module will know this encoding under the name "locale_fs". For +traditional Unix systems this will be an alias to the same encoding as +"locale". |