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
-
[PATCH pod/perlrun.pod] Layout & POD nit.
by Abigail