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
lmpx.com only provides a reader for public news (NNTP) servers. It is not
affiliated with the servers or forums shown here and is not responsible for
the content of articles, which is written by their respective authors.