X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pod%2Fperlpod.pod;h=6a578caec355647754ced1d061ee961e98cdf21e;hb=ae77835f9b08444f73b593d4cdc0758132dbbf00;hp=ce092214b86109275b67b4404336d18a350c35b7;hpb=116160e32f4979492c7c0fe9a443602fcbf9b470;p=p5sagit%2Fp5-mst-13.2.git
diff --git a/pod/perlpod.pod b/pod/perlpod.pod
index ce09221..6a578ca 100644
--- a/pod/perlpod.pod
+++ b/pod/perlpod.pod
@@ -54,7 +54,7 @@ items consistent: either use "=item *" for all of them, to produce bullets,
or use "=item 1.", "=item 2.", etc., to produce numbered lists, or use
"=item foo", "=item bar", etc., i.e., things that looks nothing like bullets
or numbers. If you start with bullets or numbers, stick with them, as many
-formatters use the first "=item" type to decide how to format the list.
+formatters use the first "=item" type to decide how to format the list.
For, begin, and end let you include sections that are not interpreted
as pod text, but passed directly to particular formatters. A formatter
@@ -63,12 +63,12 @@ completely ignored. The directive "=for" specifies that the entire next
paragraph is in the format indicated by the first word after
"=for", like this:
- =for html
+ =for html
This is a raw HTML paragraph
The paired commands "=begin" and "=end" work very similarly to "=for", but instead of only accepting a single paragraph, all text from "=begin" to a -paragraph with a matching "=end" are treated as a particular format. +paragraph with a matching "=end" are treated as a particular format. Here are some examples of how to use these: @@ -95,7 +95,7 @@ treat some of these as synonyms.) And don't forget, when using any command, that the command lasts up until the end of the B literal code
+ C literal code
L A link (cross reference) to name
L manual page
L item in manual page
@@ -142,7 +142,7 @@ here and in commands:
L"sec"> ditto
F Used for filenames
X An index entry
- ZEE A zero-width character
+ Z<> A zero-width character
E A named character (very similar to HTML escapes)
E A literal <
E A literal >
@@ -188,7 +188,7 @@ documentation with a "=head1" command at the beginning, and end it
with a "=cut" command. Perl will ignore the pod text. See any of the
supplied library modules for examples. If you're going to put your
pods at the end of the file, and you're using an __END__ or __DATA__
-cut mark, make sure to put a blank line there before the first pod
+cut mark, make sure to put an empty line there before the first pod
directive.
__END__
@@ -198,7 +198,7 @@ directive.
modern - I am a modern module
-If you had not had that blank line there, then the translators wouldn't
+If you had not had that empty line there, then the translators wouldn't
have seen it.
=head1 Common Pod Pitfalls
@@ -208,7 +208,7 @@ have seen it.
=item *
Pod translators usually will require paragraphs to be separated by
-completely empty lines. If you have an apparently blank line with
+completely empty lines. If you have an apparently empty line with
some spaces on it, this can cause odd formatting.
=item *
@@ -222,7 +222,7 @@ sensibly.
=item *
The script F in the Perl source distribution
-provides skeletal checking for lines that look blank but aren't
+provides skeletal checking for lines that look empty but aren't
B, but is there as a placeholder until someone writes
Pod::Checker. The best way to check your pod is to pass it through
one or more translators and proofread the result, or print out the