summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKarl Williamson <khw@cpan.org>2014-04-28 14:10:37 -0600
committerKarl Williamson <khw@cpan.org>2014-05-17 12:33:30 -0600
commite023b52d29900981e0c68349b3ec306d85c0716d (patch)
tree68c86911e60a05cca1942760c766cf78428e6e1d
parent54ff0eaa0a8068c19c4e207390dfd6f0a6249cdd (diff)
downloadperl-e023b52d29900981e0c68349b3ec306d85c0716d.tar.gz
PATCH: [perl #121630]: perlpod clarification
-rw-r--r--pod/perlpod.pod10
1 files changed, 6 insertions, 4 deletions
diff --git a/pod/perlpod.pod b/pod/perlpod.pod
index 7333fcc013..0a55ffd4f3 100644
--- a/pod/perlpod.pod
+++ b/pod/perlpod.pod
@@ -296,14 +296,16 @@ module. Examples:
=encoding big5
-=back
-
C<=encoding> affects the whole document, and must occur only once.
-And don't forget, when using any other command, that the command lasts up
+=back
+
+And don't forget, all commands but C<=encoding> last up
until the end of its I<paragraph>, not its line. So in the
examples below, you can see that every command needs the blank
-line after it, to end its paragraph.
+line after it, to end its paragraph. (And some older
+Pod translators may require the C<=encoding> line to be similarly
+separated.)
Some examples of lists include: