fix various Pod line length warnings
authorDavid Golden <dagolden@cpan.org>
Thu, 23 May 2013 20:58:20 +0000 (16:58 -0400)
committerDavid Golden <dagolden@cpan.org>
Fri, 24 May 2013 00:11:25 +0000 (20:11 -0400)
12 files changed:
Porting/todo.pod
README.ce
README.cygwin
README.netware
README.os2
README.tru64
dist/ExtUtils-ParseXS/lib/perlxstut.pod
ext/POSIX/lib/POSIX.pod
pod/perldiag.pod
pod/perlgit.pod
pod/perlrun.pod
t/porting/known_pod_issues.dat

index 0aba9f2..ffd0035 100644 (file)
@@ -548,7 +548,8 @@ Maybe create a utility that checks after each libperl.a creation that
 none of the above (nor sprintf(), vsprintf(), or *SHUDDER* gets())
 ever creep back to libperl.a.
 
-  nm libperl.a | ./miniperl -alne '$o = $F[0] if /:$/; print "$o $F[1]" if $F[0] eq "U" && $F[1] =~ /^(?:strn?c(?:at|py)|v?sprintf|gets)$/'
+  nm libperl.a | ./miniperl -alne '$o = $F[0] if /:$/;
+    print "$o $F[1]" if $F[0] eq "U" && $F[1] =~ /^(?:strn?c(?:at|py)|v?sprintf|gets)$/'
 
 Note, of course, that this will only tell whether B<your> platform
 is using those naughty interfaces.
index 7481bad..6b44731 100644 (file)
--- a/README.ce
+++ b/README.ce
@@ -120,8 +120,10 @@ has proper "MACHINE" parameter set, to, say, C<wince-mips-pocket-wce300>.
 
   compile.bat
   compile.bat dist
-  compile.bat CROSS_NAME=mips-wce300-thr "USE_ITHREADS=define" "USE_IMP_SYS=define" "USE_MULTI=define"
-  compile.bat CROSS_NAME=mips-wce300-thr "USE_ITHREADS=define" "USE_IMP_SYS=define" "USE_MULTI=define" dist
+  compile.bat CROSS_NAME=mips-wce300-thr "USE_ITHREADS=define" ^
+    "USE_IMP_SYS=define" "USE_MULTI=define"
+  compile.bat CROSS_NAME=mips-wce300-thr "USE_ITHREADS=define" ^
+    "USE_IMP_SYS=define" "USE_MULTI=define" dist
 
 If all goes okay and no errors during a build, you'll get two independent
 distributions: C<wince-mips-pocket-wce300> and C<mips-wce300-thr>.
index 0ad627f..8414a97 100644 (file)
@@ -409,7 +409,8 @@ looks like like the following:
 
 or:
 
-  183 [main] perl 3588 C:\cygwin\bin\perl.exe: *** fatal error - unable to remap C:\cygwin\bin\cygsvn_subr-1-0.dll to same address as parent(0x6FB30000) != 0x6FE60000
+  183 [main] perl 3588 C:\cygwin\bin\perl.exe: *** fatal error - unable to remap
+  C:\cygwin\bin\cygsvn_subr-1-0.dll to same address as parent(0x6FB30000) != 0x6FE60000
   46 [main] perl 3488 fork: child 3588 - died waiting for dll loading, errno11
 
 See L<http://cygwin.com/faq/faq-nochunks.html#faq.using.fixing-fork-failures>
index 6720a58..d8c0416 100644 (file)
@@ -174,13 +174,13 @@ typing I<nmake install>, will copy the files onto the NetWare server.
 
 Example: You can execute the following on the command prompt.
 
-          perl -Ic:/perl/5.6.1/lib/NetWare-x86-multi-thread -Ic:\perl\5.6.1\lib MakeFile.pl
-          INSTALLSITELIB=i:\perl\lib
+  perl -Ic:/perl/5.6.1/lib/NetWare-x86-multi-thread -Ic:\perl\5.6.1\lib MakeFile.pl
+  INSTALLSITELIB=i:\perl\lib
 
 or
 
-          perl -Ic:/perl/5.8.0/lib/NetWare-x86-multi-thread -Ic:\perl\5.8.0\lib MakeFile.pl
-          INSTALLSITELIB=i:\perl\lib
+  perl -Ic:/perl/5.8.0/lib/NetWare-x86-multi-thread -Ic:\perl\5.8.0\lib MakeFile.pl
+  INSTALLSITELIB=i:\perl\lib
 
 =item * 
 
index d5a86df..90938eb 100644 (file)
@@ -404,11 +404,12 @@ there is an executable file F<blah.exe> I<anywhere> on C<PATH>.  In
 other words, C<PATH> is essentially searched twice: once by the OS for
 an executable, then by Perl for scripts.
 
-Note also that executable files on OS/2 can have an arbitrary extension, 
-but F<.exe> will be automatically appended if no dot is present in the name.  
-The workaround is as simple as that:  since F<blah.> and F<blah> denote the 
-same file (at list on FAT and HPFS file systems), to start an executable residing in file F<n:/bin/blah> (no 
-extension) give an argument C<n:/bin/blah.> (dot appended) to system().
+Note also that executable files on OS/2 can have an arbitrary extension, but
+F<.exe> will be automatically appended if no dot is present in the name.  The
+workaround is as simple as that:  since F<blah.> and F<blah> denote the same
+file (at list on FAT and HPFS file systems), to start an executable residing in
+file F<n:/bin/blah> (no extension) give an argument C<n:/bin/blah.> (dot
+appended) to system().
 
 Perl will start PM programs from VIO (=text-mode) Perl process in a
 separate PM session;
@@ -1409,7 +1410,8 @@ For best results compile the C file below with the same options as the Perl
 DLL.  However, a lot of functionality will work even if the executable is not
 an EMX applications, e.g., if compiled with
 
-  gcc -Wall -DDOSISH -DOS2=1 -O2 -s -Zomf -Zsys perl-starter.c -DPERL_DLL_BASENAME=\"perl312F\" -Zstack 8192 -Zlinker /PM:VIO
+  gcc -Wall -DDOSISH -DOS2=1 -O2 -s -Zomf -Zsys perl-starter.c \
+    -DPERL_DLL_BASENAME=\"perl312F\" -Zstack 8192 -Zlinker /PM:VIO
 
 Here is the sample C file:
 
index 81ef9fe..8f7e9b9 100644 (file)
@@ -120,13 +120,15 @@ since pointers are automatically 64-bit wide.
 When compiling Perl in Tru64 you may (depending on the compiler
 release) see two warnings like this
 
-    cc: Warning: numeric.c, line 104: In this statement, floating-point overflow occurs in evaluating the expression "1.8e308". (floatoverfl)
+    cc: Warning: numeric.c, line 104: In this statement, floating-point
+    overflow occurs in evaluating the expression "1.8e308". (floatoverfl)
         return HUGE_VAL;
     -----------^
 
 and when compiling the POSIX extension
 
-    cc: Warning: const-c.inc, line 2007: In this statement, floating-point overflow occurs in evaluating the expression "1.8e308". (floatoverfl)
+    cc: Warning: const-c.inc, line 2007: In this statement, floating-point
+    overflow occurs in evaluating the expression "1.8e308". (floatoverfl)
                 return HUGE_VAL;
     -------------------^
 
index d36f425..189b6e9 100644 (file)
@@ -265,7 +265,8 @@ We will be calling the test script through the command "C<make test>".  You
 should see output that looks something like this:
 
     %make test
-    PERL_DL_NONLAZY=1 /usr/bin/perl "-MExtUtils::Command::MM" "-e" "test_harness(0, 'blib/lib', 'blib/arch')" t/*.t
+    PERL_DL_NONLAZY=1 /usr/bin/perl "-MExtUtils::Command::MM" "-e"
+    "test_harness(0, 'blib/lib', 'blib/arch')" t/*.t
     t/Mytest....ok
     All tests successful.
     Files=1, Tests=4,  0 wallclock secs ( 0.03 cusr +  0.00 csys =  0.03 CPU)
index 7141b87..51862ca 100644 (file)
@@ -1998,7 +1998,8 @@ OPOST
 
 =item Constants
 
-_PC_CHOWN_RESTRICTED _PC_LINK_MAX _PC_MAX_CANON _PC_MAX_INPUT _PC_NAME_MAX _PC_NO_TRUNC _PC_PATH_MAX _PC_PIPE_BUF _PC_VDISABLE
+_PC_CHOWN_RESTRICTED _PC_LINK_MAX _PC_MAX_CANON _PC_MAX_INPUT _PC_NAME_MAX
+_PC_NO_TRUNC _PC_PATH_MAX _PC_PIPE_BUF _PC_VDISABLE
 
 =back
 
@@ -2008,7 +2009,11 @@ _PC_CHOWN_RESTRICTED _PC_LINK_MAX _PC_MAX_CANON _PC_MAX_INPUT _PC_NAME_MAX _PC_N
 
 =item Constants
 
-_POSIX_ARG_MAX _POSIX_CHILD_MAX _POSIX_CHOWN_RESTRICTED _POSIX_JOB_CONTROL _POSIX_LINK_MAX _POSIX_MAX_CANON _POSIX_MAX_INPUT _POSIX_NAME_MAX _POSIX_NGROUPS_MAX _POSIX_NO_TRUNC _POSIX_OPEN_MAX _POSIX_PATH_MAX _POSIX_PIPE_BUF _POSIX_SAVED_IDS _POSIX_SSIZE_MAX _POSIX_STREAM_MAX _POSIX_TZNAME_MAX _POSIX_VDISABLE _POSIX_VERSION
+_POSIX_ARG_MAX _POSIX_CHILD_MAX _POSIX_CHOWN_RESTRICTED _POSIX_JOB_CONTROL
+_POSIX_LINK_MAX _POSIX_MAX_CANON _POSIX_MAX_INPUT _POSIX_NAME_MAX
+_POSIX_NGROUPS_MAX _POSIX_NO_TRUNC _POSIX_OPEN_MAX _POSIX_PATH_MAX
+_POSIX_PIPE_BUF _POSIX_SAVED_IDS _POSIX_SSIZE_MAX _POSIX_STREAM_MAX
+_POSIX_TZNAME_MAX _POSIX_VDISABLE _POSIX_VERSION
 
 =back
 
@@ -2018,7 +2023,9 @@ _POSIX_ARG_MAX _POSIX_CHILD_MAX _POSIX_CHOWN_RESTRICTED _POSIX_JOB_CONTROL _POSI
 
 =item Constants
 
-_SC_ARG_MAX _SC_CHILD_MAX _SC_CLK_TCK _SC_JOB_CONTROL _SC_NGROUPS_MAX _SC_OPEN_MAX _SC_PAGESIZE _SC_SAVED_IDS _SC_STREAM_MAX _SC_TZNAME_MAX _SC_VERSION
+_SC_ARG_MAX _SC_CHILD_MAX _SC_CLK_TCK _SC_JOB_CONTROL _SC_NGROUPS_MAX
+_SC_OPEN_MAX _SC_PAGESIZE _SC_SAVED_IDS _SC_STREAM_MAX _SC_TZNAME_MAX
+_SC_VERSION
 
 =back
 
@@ -2047,7 +2054,9 @@ ETXTBSY EUSERS EWOULDBLOCK EXDEV
 
 =item Constants
 
-FD_CLOEXEC F_DUPFD F_GETFD F_GETFL F_GETLK F_OK F_RDLCK F_SETFD F_SETFL F_SETLK F_SETLKW F_UNLCK F_WRLCK O_ACCMODE O_APPEND O_CREAT O_EXCL O_NOCTTY O_NONBLOCK O_RDONLY O_RDWR O_TRUNC O_WRONLY
+FD_CLOEXEC F_DUPFD F_GETFD F_GETFL F_GETLK F_OK F_RDLCK F_SETFD F_SETFL F_SETLK
+F_SETLKW F_UNLCK F_WRLCK O_ACCMODE O_APPEND O_CREAT O_EXCL O_NOCTTY O_NONBLOCK
+O_RDONLY O_RDWR O_TRUNC O_WRONLY
 
 =back
 
@@ -2057,7 +2066,11 @@ FD_CLOEXEC F_DUPFD F_GETFD F_GETFL F_GETLK F_OK F_RDLCK F_SETFD F_SETFL F_SETLK
 
 =item Constants
 
-DBL_DIG DBL_EPSILON DBL_MANT_DIG DBL_MAX DBL_MAX_10_EXP DBL_MAX_EXP DBL_MIN DBL_MIN_10_EXP DBL_MIN_EXP FLT_DIG FLT_EPSILON FLT_MANT_DIG FLT_MAX FLT_MAX_10_EXP FLT_MAX_EXP FLT_MIN FLT_MIN_10_EXP FLT_MIN_EXP FLT_RADIX FLT_ROUNDS LDBL_DIG LDBL_EPSILON LDBL_MANT_DIG LDBL_MAX LDBL_MAX_10_EXP LDBL_MAX_EXP LDBL_MIN LDBL_MIN_10_EXP LDBL_MIN_EXP
+DBL_DIG DBL_EPSILON DBL_MANT_DIG DBL_MAX DBL_MAX_10_EXP DBL_MAX_EXP DBL_MIN
+DBL_MIN_10_EXP DBL_MIN_EXP FLT_DIG FLT_EPSILON FLT_MANT_DIG FLT_MAX
+FLT_MAX_10_EXP FLT_MAX_EXP FLT_MIN FLT_MIN_10_EXP FLT_MIN_EXP FLT_RADIX
+FLT_ROUNDS LDBL_DIG LDBL_EPSILON LDBL_MANT_DIG LDBL_MAX LDBL_MAX_10_EXP
+LDBL_MAX_EXP LDBL_MIN LDBL_MIN_10_EXP LDBL_MIN_EXP
 
 =back
 
@@ -2067,7 +2080,10 @@ DBL_DIG DBL_EPSILON DBL_MANT_DIG DBL_MAX DBL_MAX_10_EXP DBL_MAX_EXP DBL_MIN DBL_
 
 =item Constants
 
-ARG_MAX CHAR_BIT CHAR_MAX CHAR_MIN CHILD_MAX INT_MAX INT_MIN LINK_MAX LONG_MAX LONG_MIN MAX_CANON MAX_INPUT MB_LEN_MAX NAME_MAX NGROUPS_MAX OPEN_MAX PATH_MAX PIPE_BUF SCHAR_MAX SCHAR_MIN SHRT_MAX SHRT_MIN SSIZE_MAX STREAM_MAX TZNAME_MAX UCHAR_MAX UINT_MAX ULONG_MAX USHRT_MAX
+ARG_MAX CHAR_BIT CHAR_MAX CHAR_MIN CHILD_MAX INT_MAX INT_MIN LINK_MAX LONG_MAX
+LONG_MIN MAX_CANON MAX_INPUT MB_LEN_MAX NAME_MAX NGROUPS_MAX OPEN_MAX PATH_MAX
+PIPE_BUF SCHAR_MAX SCHAR_MIN SHRT_MAX SHRT_MIN SSIZE_MAX STREAM_MAX TZNAME_MAX
+UCHAR_MAX UINT_MAX ULONG_MAX USHRT_MAX
 
 =back
 
@@ -2111,7 +2127,8 @@ SIG_UNBLOCK
 
 =item Constants
 
-S_IRGRP S_IROTH S_IRUSR S_IRWXG S_IRWXO S_IRWXU S_ISGID S_ISUID S_IWGRP S_IWOTH S_IWUSR S_IXGRP S_IXOTH S_IXUSR
+S_IRGRP S_IROTH S_IRUSR S_IRWXG S_IRWXO S_IRWXU S_ISGID S_ISUID S_IWGRP S_IWOTH
+S_IWUSR S_IXGRP S_IXOTH S_IXUSR
 
 =item Macros
 
index 13ffbee..3d58c7b 100644 (file)
@@ -2707,10 +2707,10 @@ The number of items in a hash can be obtained by doing:
 
 =item Lexing code attempted to stuff non-Latin-1 character into Latin-1 input
 
-(F) An extension is attempting to insert text into the current parse
-(using L<lex_stuff_pvn|perlapi/lex_stuff_pvn> or similar), but tried to insert a character that
-couldn't be part of the current input.  This is an inherent pitfall
-of the stuffing mechanism, and one of the reasons to avoid it.  Where
+(F) An extension is attempting to insert text into the current parse (using
+L<lex_stuff_pvn|perlapi/lex_stuff_pvn> or similar), but tried to insert a
+character that couldn't be part of the current input.  This is an inherent
+pitfall of the stuffing mechanism, and one of the reasons to avoid it.  Where
 it is necessary to stuff, stuffing only plain ASCII is recommended.
 
 =item Lexing code internal error (%s)
index 65dde7c..100a547 100644 (file)
@@ -889,7 +889,8 @@ Finally, you should then delete the remote smoke-me branch:
 
 (which is likely to produce a warning like this, which can be ignored:
 
-  remote: fatal: ambiguous argument 'refs/heads/smoke-me/tonyc/win32stat': unknown revision or path not in the working tree.
+  remote: fatal: ambiguous argument 'refs/heads/smoke-me/tonyc/win32stat':
+  unknown revision or path not in the working tree.
   remote: Use '--' to separate paths from revisions
 
 ) and then delete your local branch:
index ae2efe1..05dea4e 100644 (file)
@@ -592,8 +592,9 @@ If, for a given file, Perl is unable to create the backup file as
 specified in the extension then it will skip that file and continue on
 with the next one (if it exists).
 
-For a discussion of issues surrounding file permissions and B<-i>,
-see L<perlfaq5/Why does Perl let me delete read-only files?  Why does -i clobber protected files?  Isn't this a bug in Perl?>.
+For a discussion of issues surrounding file permissions and B<-i>, see
+L<perlfaq5/Why does Perl let me delete read-only files?  Why does -i clobber
+protected files?  Isn't this a bug in Perl?>.
 
 You cannot use B<-i> to create directories or to strip extensions from
 files.
@@ -738,9 +739,10 @@ if it is invoked with B<-xyz=abc>.
     #!/usr/bin/perl -s
     if ($xyz) { print "$xyz\n" }
 
-Do note that a switch like B<--help> creates the variable C<${-help}>, which is not compliant
-with C<use strict "refs">.  Also, when using this option on a script with
-warnings enabled you may get a lot of spurious "used only once" warnings.
+Do note that a switch like B<--help> creates the variable C<${-help}>, which is
+not compliant with C<use strict "refs">.  Also, when using this option on a
+script with warnings enabled you may get a lot of spurious "used only once"
+warnings.
 
 =item B<-S>
 X<-S>
index ffdb477..233fda1 100644 (file)
@@ -121,8 +121,6 @@ PerlIO::via::Base64
 PerlIO::via::StripHTML
 perllexwarn(1)
 perlthanks
-pod/perldiag.pod        Verbatim line length including indents exceeds 79 by        1
-pod/perlrun.pod        Verbatim line length including indents exceeds 79 by        3
 POD2::FR
 POD2::IT
 pod2ipf(1)
@@ -186,7 +184,6 @@ Win32::Locale
 YAML
 YAML::Syck
 YAML::Tiny
-dist/extutils-parsexs/lib/perlxstut.pod        Verbatim line length including indents exceeds 100 by   1
 dist/filter-simple/lib/filter/simple.pm        Verbatim paragraph in NAME section      1
 dist/locale-maketext/lib/locale/maketext/tpj13.pod     No items in =over / =back list  3
 dist/math-bigint/lib/math/bigint/calcemu.pm    empty section in previous paragraph     3
@@ -197,28 +194,23 @@ ext/pod-html/bin/pod2html Pod NAME already used   1
 ext/posix/lib/posix.pod        Verbatim line length including indents exceeds 100 by   2
 pod/perlapi.pod        unresolved internal link        3
 pod/perlbook.pod       Verbatim line length including indents exceeds 100 by   1
-pod/perlce.pod Verbatim line length including indents exceeds 100 by   2
-pod/perlcygwin.pod     Verbatim line length including indents exceeds 100 by   1
 pod/perldebguts.pod    Verbatim line length including indents exceeds 100 by   2
 pod/perldiag.pod       =item type mismatch     1
 pod/perldtrace.pod     Verbatim line length including indents exceeds 100 by   4
 pod/perlebcdic.pod     Verbatim line length including indents exceeds 100 by   10
 pod/perlfunc.pod       There is more than one target   1
-pod/perlgit.pod        Verbatim line length including indents exceeds 100 by   1
 pod/perlmacosx.pod     Verbatim line length including indents exceeds 100 by   3
-pod/perlnetware.pod    Verbatim line length including indents exceeds 100 by   2
-pod/perlos2.pod        Verbatim line length including indents exceeds 100 by   5
+pod/perlos2.pod        Verbatim line length including indents exceeds 100 by   4
 pod/perlperf.pod       Verbatim line length including indents exceeds 100 by   32
 pod/perlrun.pod        Verbatim line length including indents exceeds 100 by   1
 pod/perlthrtut.pod     Verbatim line length including indents exceeds 100 by   1
-pod/perltru64.pod      Verbatim line length including indents exceeds 100 by   3
+pod/perltru64.pod      Verbatim line length including indents exceeds 100 by   1
 pod/perlunifaq.pod     empty section in previous paragraph     1
 pod/perluniprops.pod   =item type mismatch     6
 pod/perlwin32.pod      Verbatim line length including indents exceeds 100 by   6
 porting/how_to_write_a_perldelta.pod   There is no NAME        1
 porting/release_managers_guide.pod     Verbatim line length including indents exceeds 100 by   1
 porting/release_schedule.pod   There is no NAME        1
-porting/todo.pod       Verbatim line length including indents exceeds 100 by   1
 utils/pod2html Pod NAME already used   1
 x2p/a2p.pod    empty section in previous paragraph     2
 lib/benchmark.pm       Verbatim line length including indents exceeds 100 by   2