This is automatically generated email about problems in a man page for which you appear to be responsible. If you are not the right person or list, tell me and I will attempt to correct my database.
See http://catb.org/~esr/doclifter/problems.html for details on how and why these patches were generated. Feel free to email me with any questions. Note: This patch does not change the mod date of the manual page. You may wish to do that by hand. Problems with Carp.3pm: (May reflect bugs in POD). 1. There are multiple name lines. This makes it impossible to translate the page to DocBook. It may also confuse some implementations of man -k. --- Carp.3pm-orig 2003-12-15 09:23:36.000000000 -0500 +++ Carp.3pm 2003-12-15 09:25:06.000000000 -0500 @@ -131,18 +131,7 @@ .IX Title "Carp 3pm" .TH Carp 3pm "2002-06-01" "perl v5.8.0" "Perl Programmers Reference Guide" .SH "NAME" -carp \- warn of errors (from perspective of caller) -.PP -cluck \- warn of errors with stack backtrace - (not exported by default) -.PP -croak \- die of errors (from perspective of caller) -.PP -confess \- die of errors with stack backtrace -.PP -shortmess \- return the message that carp and croak produce -.PP -longmess \- return the message that cluck and confess produce +carp, cluck, croak, shortmess, longmess \- error-warning and exit facilities .SH "SYNOPSIS" .IX Header "SYNOPSIS" .Vb 2 Problems with diagnostics.3pm: (May reflect bugs in POD). 1. There are multiple name lines. This makes it impossible to translate the page to DocBook. It may also confuse some implementations of man -k. --- diagnostics.3pm-orig 2004-02-15 17:06:52.000000000 -0500 +++ diagnostics.3pm 2004-02-15 17:07:10.000000000 -0500 @@ -132,8 +132,6 @@ .TH diagnostics 3pm "2003-09-02" "perl v5.8.1" "Perl Programmers Reference Guide" .SH "NAME" diagnostics \- Perl compiler pragma to force verbose warning diagnostics -.PP -splain \- filter to produce verbose descriptions of perl warning diagnostics .SH "SYNOPSIS" .IX Header "SYNOPSIS" As a pragma: Problems with DynaLoader.3pm: (May reflect bugs in POD). 1. There are multiple name lines. This makes it impossible to translate the page to DocBook. It may also confuse some implementations of man -k. --- DynaLoader.3pm-orig 2003-12-04 04:42:22.000000000 -0500 +++ DynaLoader.3pm 2003-12-04 04:43:13.000000000 -0500 @@ -131,9 +131,7 @@ .IX Title "DynaLoader 3pm" .TH DynaLoader 3pm "2002-06-01" "perl v5.8.0" "Perl Programmers Reference Guide" .SH "NAME" -DynaLoader \- Dynamically load C libraries into Perl code -.PP -dl_error(), dl_findfile(), dl_expandspec(), dl_load_file(), dl_unload_file(), dl_find_symbol(), dl_find_symbol_anywhere(), dl_undef_symbols(), dl_install_xsub(), dl_load_flags(), bootstrap() \- routines used by DynaLoader modules +dl_error(), dl_findfile(), dl_expandspec(), dl_load_file(), dl_unload_file(), dl_find_symbol(), dl_find_symbol_anywhere(), dl_undef_symbols(), dl_install_xsub(), dl_load_flags(), bootstrap() \- dynamically load C libraries into Perl code .SH "SYNOPSIS" .IX Header "SYNOPSIS" .Vb 4 Problems with File::Basename.3pm: (May reflect bugs in POD). 1. There are multiple name lines. This makes it impossible to translate the page to DocBook. It may also confuse some implementations of man -k. --- File::Basename.3pm-orig 2003-12-15 09:45:12.000000000 -0500 +++ File::Basename.3pm 2003-12-15 09:46:35.000000000 -0500 @@ -131,11 +131,7 @@ .IX Title "File::Basename 3pm" .TH File::Basename 3pm "2002-06-01" "perl v5.8.0" "Perl Programmers Reference Guide" .SH "NAME" -fileparse \- split a pathname into pieces -.PP -basename \- extract just the filename from a path -.PP -dirname \- extract just the directory from a path +fileparse, basename, dirname \- extract segments, basename, or directory name from a filename .SH "SYNOPSIS" .IX Header "SYNOPSIS" .Vb 1 Problems with Getopt::Std.3pm: (May reflect bugs in POD). 1. There are multiple name lines. This makes it impossible to translate the page to DocBook. It may also confuse some implementations of man -k. --- Getopt::Std.3pm-orig 2003-12-02 02:42:17.000000000 -0500 +++ Getopt::Std.3pm 2003-12-02 02:42:40.000000000 -0500 @@ -131,9 +131,7 @@ .IX Title "Getopt::Std 3pm" .TH Getopt::Std 3pm "2002-06-01" "perl v5.8.0" "Perl Programmers Reference Guide" .SH "NAME" -getopt \- Process single\-character switches with switch clustering -.PP -getopts \- Process single\-character switches with switch clustering +getopt, getopts \- Process single\-character switches with switch clustering .SH "SYNOPSIS" .IX Header "SYNOPSIS" .Vb 1 Problems with pcrepattern.3: 1. Ambiguous or invalid backslash. This doesn't cause groff a problem. but it confuses doclifter and may confuse older troff implementations. --- pcrepattern.3-orig 2004-02-16 02:34:32.000000000 -0500 +++ pcrepattern.3 2004-02-16 02:36:14.000000000 -0500 @@ -1212,7 +1212,7 @@ can put a number less than 256 after the letter C. The default value is zero. For example, this pattern has two callout points: - (?C1)\dabc(?C2)def + (?C1)abc(?C2)def During matching, when PCRE reaches a callout point (and \fIpcre_callout\fR is set), the external function is called. It is provided with the number of the Problems with pcrecallout.3: 1. Ambiguous or invalid backslash. This doesn't cause groff a problem. but it confuses doclifter and may confuse older troff implementations. --- pcrecallout.3-orig 2004-02-16 02:41:26.000000000 -0500 +++ pcrecallout.3 2004-02-16 02:41:33.000000000 -0500 @@ -17,7 +17,7 @@ a number less than 256 after the letter C. The default value is zero. For example, this pattern has two callout points: - (?C1)\dabc(?C2)def + (?C1)abc(?C2)def During matching, when PCRE reaches a callout point (and \fIpcre_callout\fR is set), the external function is called. Its only argument is a pointer to a Problems with perlce.1: 1. Missing or garbled name section. The most common form of garbling is a missing - or extra -. Or your manual page may have been generated by a tool that doesn't emit a NAME section as it should. These problems make it impossible to lift the page to DocBook. They can also confuse some implementations of man -k. --- perlce.1 2003-02-16 19:38:54.000000000 -0500 +++ perlce.1 2003-02-16 19:39:19.000000000 -0500 @@ -132,7 +132,7 @@ .TH PERLCE 1 "2002-06-08" "perl v5.8.0" "Perl Programmers Reference Guide" .SH "Name" .IX Header "Name" -Perl for WinCE +perlce \- Perl for WinCE .SH "Description" .IX Header "Description" This file gives the instructions for building Perl5.6 and above for Problems with perlnetware.1: 1. Missing or garbled name section. The most common form of garbling is a missing - or extra -. Or your manual page may have been generated by a tool that doesn't emit a NAME section as it should. These problems make it impossible to lift the page to DocBook. They can also confuse some implementations of man -k. --- perlnetware.1-orig 2003-12-10 03:53:18.000000000 -0500 +++ perlnetware.1 2003-12-10 03:53:40.000000000 -0500 @@ -132,7 +132,7 @@ .TH PERLNETWARE 1 "2003-08-13" "perl v5.8.0" "Perl Programmers Reference Guide" .SH "Name" .IX Header "Name" -Perl for NetWare +perlnetware \- Perl for NetWare .SH "Description" .IX Header "Description" This file gives instructions for building Perl 5.7 and above, and also -- Eric S. Raymond
