develooper Front page | perl.perl5.porters | Postings from October 2003

[PATCH pod/perlrun.pod] Layout & POD nit.

Thread Next
From:
Abigail
Date:
October 8, 2003 03:51
Subject:
[PATCH pod/perlrun.pod] Layout & POD nit.
Message ID:
20031008105049.GA15770@ucan.foad.org

Two fixes regarding the documentation of the -C switch.
First a layout issue; I've reformatted the table such that
pod2man perlrun.pod | nroff -man won't generate lines over 80
chars. Second is a podnit, adding the C of a C<..> construct.


Abigail

--- pod/perlrun.pod.orig        Wed Oct  8 12:07:35 2003
+++ pod/perlrun.pod     Wed Oct  8 12:09:54 2003
@@ -285,19 +285,20 @@
 of option letters.  The letters, their numeric values, and effects
 are as follows; listing the letters is equal to summing the numbers.
 
-    I     1    STDIN is assumed to be in UTF-8
-    O     2    STDOUT will be in UTF-8
-    E     4    STDERR will be in UTF-8
-    S     7    I + O + E
-    i     8    UTF-8 is the default PerlIO layer for input streams
-    o    16    UTF-8 is the default PerlIO layer for output streams
-    D    24    i + o
-    A    32    the @ARGV elements are expected to be strings encoded in UTF-8
-    L    64    normally the "IOEioA" are unconditional,
-               the L makes them conditional on the locale environment
-               variables (the LC_ALL, LC_TYPE, and LANG, in the order
-               of decreasing precedence) -- if the variables indicate
-               UTF-8, then the selected "IOEioA" are in effect
+    I     1   STDIN is assumed to be in UTF-8
+    O     2   STDOUT will be in UTF-8
+    E     4   STDERR will be in UTF-8
+    S     7   I + O + E
+    i     8   UTF-8 is the default PerlIO layer for input streams
+    o    16   UTF-8 is the default PerlIO layer for output streams
+    D    24   i + o
+    A    32   the @ARGV elements are expected to be strings encoded
+              in UTF-8
+    L    64   normally the "IOEioA" are unconditional,
+              the L makes them conditional on the locale environment
+              variables (the LC_ALL, LC_TYPE, and LANG, in the order
+              of decreasing precedence) -- if the variables indicate
+              UTF-8, then the selected "IOEioA" are in effect
 
 For example, C<-COE> and C<-C6> will both turn on UTF-8-ness on both
 STDOUT and STDERR.  Repeating letters is just redundant, not cumulative
@@ -312,7 +313,7 @@
 
 C<-C> on its own (not followed by any number or option list), or the
 empty string C<""> for the C<$ENV{PERL_UNICODE}, has the same effect
-as <-CSDL>.  In other words, the standard I/O handles and the default
+as C<-CSDL>.  In other words, the standard I/O handles and the default
 C<open()> layer are UTF-8-fied B<but> only if the locale environment
 variables indicate a UTF-8 locale.  This behaviour follows the
 I<implicit> (and problematic) UTF-8 behaviour of Perl 5.8.0.


Thread Next


nntp.perl.org: Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at ask@perl.org | Group listing | About