aboutsummaryrefslogtreecommitdiff
path: root/perl/perl-encode-locale
diff options
context:
space:
mode:
authorB. Watson <yalhcru@gmail.com>2022-03-14 04:05:07 -0400
committerB. Watson <yalhcru@gmail.com>2022-03-14 04:05:07 -0400
commit293c741d5a883d1fb6725402dc28de9ab51b2393 (patch)
tree772c32a8a7a901a81e9c8b3c3b1849b8b9e854d7 /perl/perl-encode-locale
parenta84dc3aa6c2ca6003eea5724f4a5c473516f8fa0 (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/README33
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".