From d220eb00ef3acc7b8eb92c164c58ff946a556955 Mon Sep 17 00:00:00 2001 From: Nicholas Clark Date: Wed, 22 Jun 2011 12:44:05 +0200 Subject: 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. --- pod/perl5110delta.pod | 2 -- pod/perl5111delta.pod | 1 - pod/perl5120delta.pod | 7 ------- pod/perl5121delta.pod | 2 -- pod/perl5139delta.pod | 3 --- pod/perl561delta.pod | 1 - pod/perl56delta.pod | 1 - pod/perlapio.pod | 1 - pod/perlbook.pod | 1 - pod/perlcall.pod | 1 - pod/perldbmfilter.pod | 1 - pod/perldebug.pod | 2 -- pod/perldiag.pod | 3 --- pod/perlport.pod | 1 - pod/perlre.pod | 1 - pod/perlvms.pod | 1 - 16 files changed, 29 deletions(-) (limited to 'pod') 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 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 Cs 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 no longer contains the C<%:patchlevel> hash. - =item * C now returns undef. @@ -529,7 +528,6 @@ The following items are now deprecated: C 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 statement will result in a deprecation warning. - =item Use of "goto" to jump into a construct Using C 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 files (which listed every change made @@ -1447,7 +1443,6 @@ F 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. - =item * The syntax C is now documented as valid, @@ -1455,7 +1450,6 @@ as is the syntax C, 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 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 - =item * utf8::is_utf8 now respects GMAGIC (e.g. $1) - =item * XS code using C or C: 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 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 pragma is now obsolete, and is only provided for backward-compatibility. See L. - =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 pragma is now obsolete, and is only provided for backward-compatibility. See L. - =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 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 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 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 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 command. - =item p expr X @@ -603,7 +602,6 @@ X Display all loaded modules and their versions. - =item man [manpage] X 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 pragma? See L. - =item Constant is not %s reference (F) A constant value (perhaps declared using the C 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 and L. - =item Integer overflow in format string for %s (F) The indexes and widths specified in the format string of C 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 -- cgit v1.2.1