X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pod%2Fperlpod.pod;h=955d706ef8357bd22d35891d6ac9e58bf8d7aa9c;hb=363c40c40eaf5d0cfd92f460a3f838c41f9756ad;hp=80c9ba134aa81205466973d35b57bc9cf55f526d;hpb=210b36aa2e9e009554be8970c3315c2658c0384f;p=p5sagit%2Fp5-mst-13.2.git diff --git a/pod/perlpod.pod b/pod/perlpod.pod index 80c9ba1..955d706 100644 --- a/pod/perlpod.pod +++ b/pod/perlpod.pod @@ -269,6 +269,23 @@ to signal that the text is not raw data, but instead I Pod text normal formatting (e.g., may not be a normal-use paragraph, but might be for formatting as a footnote). +=item C<=encoding I> + +This command is used for declaring the encoding of a document. Most +users won't need this; but if your encoding isn't US-ASCII or Latin-1, +then put a C<=encoding I> command early in the document so +that pod formatters will know how to decode the document. For +I, use a name recognized by the L +module. Examples: + + =encoding utf8 + + =encoding koi8-r + + =encoding ShiftJIS + + =encoding big5 + =back And don't forget, when using any command, that the command lasts up @@ -552,7 +569,7 @@ you could do it like so: which is presumably easier to read than the old way: CEthing.dat") || die $!> - C<$foo-Ebar(); >> + C<$foo-Ebar();> This is currently supported by pod2text (Pod::Text), pod2man (Pod::Man), and any other pod2xxx or Pod::Xxxx translators that use