summaryrefslogtreecommitdiff
path: root/pod
diff options
context:
space:
mode:
authorNicholas Clark <nick@ccl4.org>2011-06-22 12:44:05 +0200
committerNicholas Clark <nick@ccl4.org>2011-06-22 12:44:05 +0200
commitd220eb00ef3acc7b8eb92c164c58ff946a556955 (patch)
tree2068daefd8e1f731ed4eb3fc87ae603081118d6a /pod
parent56466d0ead41a249b0feba363954f09c4f090035 (diff)
downloadperl-d220eb00ef3acc7b8eb92c164c58ff946a556955.tar.gz
Trim multiple blank lines above =item in pod files.
This makes many documents more consistent in their pod formatting. Don't trim blank lines between verbatim blocks and =item, as removing them makes the (raw) pod harder to read.
Diffstat (limited to 'pod')
-rw-r--r--pod/perl5110delta.pod2
-rw-r--r--pod/perl5111delta.pod1
-rw-r--r--pod/perl5120delta.pod7
-rw-r--r--pod/perl5121delta.pod2
-rw-r--r--pod/perl5139delta.pod3
-rw-r--r--pod/perl561delta.pod1
-rw-r--r--pod/perl56delta.pod1
-rw-r--r--pod/perlapio.pod1
-rw-r--r--pod/perlbook.pod1
-rw-r--r--pod/perlcall.pod1
-rw-r--r--pod/perldbmfilter.pod1
-rw-r--r--pod/perldebug.pod2
-rw-r--r--pod/perldiag.pod3
-rw-r--r--pod/perlport.pod1
-rw-r--r--pod/perlre.pod1
-rw-r--r--pod/perlvms.pod1
16 files changed, 0 insertions, 29 deletions
diff --git a/pod/perl5110delta.pod b/pod/perl5110delta.pod
index b2cb59c783..9c815f92ea 100644
--- a/pod/perl5110delta.pod
+++ b/pod/perl5110delta.pod
@@ -1240,7 +1240,6 @@ that was enabled when the F<perl> binary was compiled.
Smartmatch resolution tracing has been added as a new diagnostic. Use C<-DM> to
enable it.
-
=item *
A new debugging flag C<-DB> now dumps subroutine definitions, leaving
@@ -1546,7 +1545,6 @@ simpler to spot and correct the suspicious character.
Explicitly point to $. when it causes an uninitialized warning for ranges in scalar context
-
=item *
Deprecated numerous Perl 4-era libraries:
diff --git a/pod/perl5111delta.pod b/pod/perl5111delta.pod
index e84ab85928..e3e70dce61 100644
--- a/pod/perl5111delta.pod
+++ b/pod/perl5111delta.pod
@@ -237,7 +237,6 @@ The Windows select() implementation now supports all empty C<fd_set>s more corre
=over 4
-
=item *
The 'syntax' category was removed from 5 warnings that should only be in 'deprecated'.
diff --git a/pod/perl5120delta.pod b/pod/perl5120delta.pod
index d36f3de48c..f8a1810c86 100644
--- a/pod/perl5120delta.pod
+++ b/pod/perl5120delta.pod
@@ -456,7 +456,6 @@ have been removed from this distribution.
C<Module::CoreList> no longer contains the C<%:patchlevel> hash.
-
=item *
C<length undef> now returns undef.
@@ -529,7 +528,6 @@ The following items are now deprecated:
C<suidperl> is no longer part of Perl. It used to provide a mechanism to
emulate setuid permission bits on systems that don't support it properly.
-
=item Use of C<:=> to mean an empty attribute list
An accident of Perl's parser meant that these constructions were all
@@ -561,7 +559,6 @@ The method C<< UNIVERSAL->import() >> is now deprecated. Attempting to
pass import arguments to a C<use UNIVERSAL> statement will result in a
deprecation warning.
-
=item Use of "goto" to jump into a construct
Using C<goto> to jump from an outer scope into an inner scope is now
@@ -1433,7 +1430,6 @@ the beginnings of a document on Perl porting policies.
=over
-
=item *
The various large F<Changes*> files (which listed every change made
@@ -1447,7 +1443,6 @@ F<Porting/patching.pod> has been deleted, as it mainly described
interacting with the old Perforce-based repository, which is now obsolete.
Information still relevant has been moved to L<perlrepository>.
-
=item *
The syntax C<unless (EXPR) BLOCK else BLOCK> is now documented as valid,
@@ -1455,7 +1450,6 @@ as is the syntax C<unless (EXPR) BLOCK elsif (EXPR) BLOCK ... else
BLOCK>, although actually using the latter may not be the best idea for
the readability of your source code.
-
=item *
Documented -X overloading.
@@ -2106,7 +2100,6 @@ passed a position that is not within the scalar's string buffer. This
could be caused by buggy XS code, and at this point recovery is not
possible.
-
=item *
The fatal error C<Malformed UTF-8 returned by \N> is now produced if the
diff --git a/pod/perl5121delta.pod b/pod/perl5121delta.pod
index 6b88033017..a999f14484 100644
--- a/pod/perl5121delta.pod
+++ b/pod/perl5121delta.pod
@@ -210,12 +210,10 @@ XSUB.h now correctly redefines fgets under PERL_IMPLICIT_SYS
See also: L<http://rt.cpan.org/Public/Bug/Display.html?id=55049>
-
=item *
utf8::is_utf8 now respects GMAGIC (e.g. $1)
-
=item *
XS code using C<fputc()> or C<fputs()>: on Windows could cause an error
diff --git a/pod/perl5139delta.pod b/pod/perl5139delta.pod
index a932080c44..f09e97694e 100644
--- a/pod/perl5139delta.pod
+++ b/pod/perl5139delta.pod
@@ -413,7 +413,6 @@ Perl distribution. It was officially discontinued in an earlier version.
=over 4
-
=item Cygwin
=over
@@ -440,7 +439,6 @@ Updated build hints file
=back
-
=item Solaris
DTrace is now supported on Solaris. There used to be build failures, but
@@ -494,7 +492,6 @@ A new option has been added to C<pv_escape> to dump all characters above
ASCII in hexadecimal. Before, one could get all characters as hexadecimal
or the Latin1 non-ASCII as octal
-
=item *
Generate pp_* prototypes in pp_proto.h, and remove pp.sym
diff --git a/pod/perl561delta.pod b/pod/perl561delta.pod
index 72c38f15a9..664cc0e183 100644
--- a/pod/perl561delta.pod
+++ b/pod/perl561delta.pod
@@ -2977,7 +2977,6 @@ You should use the new declaration syntax instead.
The C<use attrs> pragma is now obsolete, and is only provided for
backward-compatibility. See L<perlsub/"Subroutine Attributes">.
-
=item Premature end of script headers
See Server error.
diff --git a/pod/perl56delta.pod b/pod/perl56delta.pod
index 91b4aede49..4ae5c968b6 100644
--- a/pod/perl56delta.pod
+++ b/pod/perl56delta.pod
@@ -2372,7 +2372,6 @@ You should use the new declaration syntax instead.
The C<use attrs> pragma is now obsolete, and is only provided for
backward-compatibility. See L<perlsub/"Subroutine Attributes">.
-
=item Premature end of script headers
See Server error.
diff --git a/pod/perlapio.pod b/pod/perlapio.pod
index 1c57f9a9a8..f3023d983f 100644
--- a/pod/perlapio.pod
+++ b/pod/perlapio.pod
@@ -392,7 +392,6 @@ vary from handle to handle.
PerlIO_canset_cnt(f) && \
`Can set pointer into buffer'
-
=item B<PerlIO_has_cntptr(f)>
Implementation can return pointer to current position in the "buffer"
diff --git a/pod/perlbook.pod b/pod/perlbook.pod
index 8a90e4fbf2..5ed6b32874 100644
--- a/pod/perlbook.pod
+++ b/pod/perlbook.pod
@@ -151,7 +151,6 @@ You might want to keep these desktop references close by your keyboard:
ISBN 1-56592-243-3 [2nd edition August 2003]
http://oreilly.com/catalog/9780596003135
-
=item I<Automating System Administration with Perl>
by David N. Blank-Edelman
diff --git a/pod/perlcall.pod b/pod/perlcall.pod
index 61649e870f..dd01bbbf71 100644
--- a/pod/perlcall.pod
+++ b/pod/perlcall.pod
@@ -203,7 +203,6 @@ As with G_SCALAR, this flag has 2 effects:
It indicates to the subroutine being called that it is executing in a
list context (if it executes I<wantarray> the result will be true).
-
=item 2.
It ensures that all items returned from the subroutine will be
diff --git a/pod/perldbmfilter.pod b/pod/perldbmfilter.pod
index 2a4c239955..0413bf95f8 100644
--- a/pod/perldbmfilter.pod
+++ b/pod/perldbmfilter.pod
@@ -35,7 +35,6 @@ every time you write a key to a DBM database.
If a filter has been installed with this method, it will be invoked
every time you write a value to a DBM database.
-
=item B<filter_fetch_key>
If a filter has been installed with this method, it will be invoked
diff --git a/pod/perldebug.pod b/pod/perldebug.pod
index d44ca149d6..73e4f80bd9 100644
--- a/pod/perldebug.pod
+++ b/pod/perldebug.pod
@@ -105,7 +105,6 @@ that it's run through your pager, as in
You may change the pager which is used via C<o pager=...> command.
-
=item p expr
X<debugger command, p>
@@ -603,7 +602,6 @@ X<debugger command, M>
Display all loaded modules and their versions.
-
=item man [manpage]
X<debugger command, man>
diff --git a/pod/perldiag.pod b/pod/perldiag.pod
index 80af627a37..7954739f77 100644
--- a/pod/perldiag.pod
+++ b/pod/perldiag.pod
@@ -445,7 +445,6 @@ wasn't a symbol table entry.
(P) An internal request asked to add a dirhandle entry to something
that wasn't a symbol table entry.
-
=item Bad symbol for filehandle
(P) An internal request asked to add a filehandle entry to something
@@ -1451,7 +1450,6 @@ the character name specified in the C<\N{...}> escape. Perhaps you
forgot to load the corresponding C<charnames> pragma?
See L<charnames>.
-
=item Constant is not %s reference
(F) A constant value (perhaps declared using the C<use constant> pragma)
@@ -2186,7 +2184,6 @@ expression that contains a call to a user-defined character property
function, i.e. C<\p{IsFoo}> or C<\p{InFoo}>.
See L<perlunicode/User-Defined Character Properties> and L<perlsec>.
-
=item Integer overflow in format string for %s
(F) The indexes and widths specified in the format string of C<printf()>
diff --git a/pod/perlport.pod b/pod/perlport.pod
index 7dbcd8c07d..45b84c14d2 100644
--- a/pod/perlport.pod
+++ b/pod/perlport.pod
@@ -2141,7 +2141,6 @@ Caveats:
=back
-
=item Symbian (Series 60 v3, 3.2 and 5 - what else?)
=item Stratus VOS / OpenVOS
diff --git a/pod/perlre.pod b/pod/perlre.pod
index c2a8bfb03b..c15791cd9d 100644
--- a/pod/perlre.pod
+++ b/pod/perlre.pod
@@ -1676,7 +1676,6 @@ replaced with a C<< (?>pattern) >> with no functional difference; however,
C<(*PRUNE)> can be used to handle cases that cannot be expressed using a
C<< (?>pattern) >> alone.
-
=item C<(*SKIP)> C<(*SKIP:NAME)>
X<(*SKIP)>
diff --git a/pod/perlvms.pod b/pod/perlvms.pod
index 7e96c06b05..241a66c39a 100644
--- a/pod/perlvms.pod
+++ b/pod/perlvms.pod
@@ -704,7 +704,6 @@ results of testing and further review.
See L</"$?"> for a description of the encoding of the Unix value to
produce a native VMS status containing it.
-
=item dump
Rather than causing Perl to abort and dump core, the C<dump>