problems in one or more man pages you maintain

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 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 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

--
                             Eric S. Raymond