Trim multiple blank lines above =item in pod files.
authorNicholas Clark <nick@ccl4.org>
Wed, 22 Jun 2011 10:44:05 +0000 (12:44 +0200)
committerNicholas Clark <nick@ccl4.org>
Wed, 22 Jun 2011 10:44:05 +0000 (12:44 +0200)
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.

16 files changed:
pod/perl5110delta.pod
pod/perl5111delta.pod
pod/perl5120delta.pod
pod/perl5121delta.pod
pod/perl5139delta.pod
pod/perl561delta.pod
pod/perl56delta.pod
pod/perlapio.pod
pod/perlbook.pod
pod/perlcall.pod
pod/perldbmfilter.pod
pod/perldebug.pod
pod/perldiag.pod
pod/perlport.pod
pod/perlre.pod
pod/perlvms.pod

index b2cb59c..9c815f9 100644 (file)
@@ -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:
index e84ab85..e3e70dc 100644 (file)
@@ -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'.
index d36f3de..f8a1810 100644 (file)
@@ -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
index 6b88033..a999f14 100644 (file)
@@ -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
index a932080..f09e976 100644 (file)
@@ -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
index 72c38f1..664cc0e 100644 (file)
@@ -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.
index 91b4aed..4ae5c96 100644 (file)
@@ -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.
index 1c57f9a..f3023d9 100644 (file)
@@ -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"
index 8a90e4f..5ed6b32 100644 (file)
@@ -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
index 61649e8..dd01bbb 100644 (file)
@@ -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
index 2a4c239..0413bf9 100644 (file)
@@ -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
index d44ca14..73e4f80 100644 (file)
@@ -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>
 
index 80af627..7954739 100644 (file)
@@ -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()>
index 7dbcd8c..45b84c1 100644 (file)
@@ -2141,7 +2141,6 @@ Caveats:
 
 =back
 
-
 =item Symbian (Series 60 v3, 3.2 and 5 - what else?)
 
 =item Stratus VOS / OpenVOS
index c2a8bfb..c15791c 100644 (file)
@@ -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)>
 
index 7e96c06..241a66c 100644 (file)
@@ -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>