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: These patches do not change the mod date of any manual page.  You
may wish to do that by hand.

Problems with DBM_Filter::compress.3pm:
(May reflect bugs in POD).

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.  Or your page
may add running text duch as a version or authorship banner.  These
problems make it impossible to lift the page to DocBook.  They
can also confuse third-party manpage browsers and some implementations
of man -k.

--- DBM_Filter::compress.3pm-orig       2007-01-03 19:27:12.000000000 -0500
+++ DBM_Filter::compress.3pm    2007-01-03 19:28:06.000000000 -0500
@@ -130,8 +130,9 @@
 .\"
 .IX Title "DBM_Filter::compress 3pm"
 .TH DBM_Filter::compress 3pm "2001-09-21" "perl v5.8.8" "Perl Programmers 
Reference Guide"
-.SH "DBM_Filter::compress"
+.SH NAME
 .IX Header "DBM_Filter::compress"
+DBM_Filter::compress \- set compression on a DBM database
 .SH "SYNOPSIS"
 .IX Header "SYNOPSIS"
 .Vb 2
-----------------------------
Problems with DBM_Filter::encode.3pm:
(May reflect bugs in POD).

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.  Or your page
may add running text duch as a version or authorship banner.  These
problems make it impossible to lift the page to DocBook.  They
can also confuse third-party manpage browsers and some implementations
of man -k.

--- DBM_Filter::encode.3pm-orig 2007-01-03 19:29:38.000000000 -0500
+++ DBM_Filter::encode.3pm      2007-01-03 19:30:21.000000000 -0500
@@ -130,7 +130,8 @@
 .\"
 .IX Title "DBM_Filter::encode 3pm"
 .TH DBM_Filter::encode 3pm "2001-09-21" "perl v5.8.8" "Perl Programmers 
Reference Guide"
-.SH "DBM_Filter::encode"
+.SH NAME
+DBM_Filter::encode \- choose character incoding for a DBM file
 .IX Header "DBM_Filter::encode"
 .SH "SYNOPSIS"
 .IX Header "SYNOPSIS"
-----------------------------
Problems with DBM_Filter::int32.3pm:
(May reflect bugs in POD).

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.  Or your page
may add running text duch as a version or authorship banner.  These
problems make it impossible to lift the page to DocBook.  They
can also confuse third-party manpage browsers and some implementations
of man -k.

--- DBM_Filter::int32.3pm-orig  2007-01-03 19:32:52.000000000 -0500
+++ DBM_Filter::int32.3pm       2007-01-03 19:33:49.000000000 -0500
@@ -130,7 +130,8 @@
 .\"
 .IX Title "DBM_Filter::int32 3pm"
 .TH DBM_Filter::int32 3pm "2001-09-21" "perl v5.8.8" "Perl Programmers 
Reference Guide"
-.SH "DBM_Filter::int32"
+.SH NAME
+DBM_Filter::int32 \- support C integer keys or values in DBM files
 .IX Header "DBM_Filter::int32"
 .SH "SYNOPSIS"
 .IX Header "SYNOPSIS"
-----------------------------
Problems with DBM_Filter::null.3pm:
(May reflect bugs in POD).

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.  Or your page
may add running text duch as a version or authorship banner.  These
problems make it impossible to lift the page to DocBook.  They
can also confuse third-party manpage browsers and some implementations
of man -k.

--- DBM_Filter::null.3pm-orig   2007-01-03 16:37:17.000000000 -0500
+++ DBM_Filter::null.3pm        2007-01-03 16:37:56.000000000 -0500
@@ -130,7 +130,8 @@
 .\"
 .IX Title "DBM_Filter::null 3pm"
 .TH DBM_Filter::null 3pm "2001-09-21" "perl v5.8.8" "Perl Programmers 
Reference Guide"
-.SH "DBM_Filter::null"
+.SH NAME
+DBM_Filter::null \- null-termination filter for DBM writes
 .IX Header "DBM_Filter::null"
 .SH "SYNOPSIS"
 .IX Header "SYNOPSIS"
-----------------------------
Problems with DBM_Filter::utf8.3pm:
(May reflect bugs in POD).

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.  Or your page
may add running text duch as a version or authorship banner.  These
problems make it impossible to lift the page to DocBook.  They
can also confuse third-party manpage browsers and some implementations
of man -k.

--- DBM_Filter::utf8.3pm-orig   2007-01-03 16:39:45.000000000 -0500
+++ DBM_Filter::utf8.3pm        2007-01-03 16:40:18.000000000 -0500
@@ -130,7 +130,8 @@
 .\"
 .IX Title "DBM_Filter::utf8 3pm"
 .TH DBM_Filter::utf8 3pm "2001-09-21" "perl v5.8.8" "Perl Programmers 
Reference Guide"
-.SH "DBM_Filter::utf8"
+.SH NAME
+DBM_Filter::utf8 \- UTF-8 encoding filter for DBM
 .IX Header "DBM_Filter::utf8"
 .SH "SYNOPSIS"
 .IX Header "SYNOPSIS"
-----------------------------
Problems with Mail::SpamAssassin::Client.3pm:
(May reflect bugs in POD).

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.  Or your page
may add running text duch as a version or authorship banner.  These
problems make it impossible to lift the page to DocBook.  They
can also confuse third-party manpage browsers and some implementations
of man -k.

--- Mail::SpamAssassin::Client.3pm-orig 2007-01-03 21:32:50.000000000 -0500
+++ Mail::SpamAssassin::Client.3pm      2007-01-03 21:33:26.000000000 -0500
@@ -132,8 +132,6 @@
 .TH Mail::SpamAssassin::Client 3 "2006-03-10" "perl v5.8.8" "User Contributed 
Perl Documentation"
 .SH "NAME"
 Mail::SpamAssassin::Client \- Client for spamd Protocol
-.PP
-NOTE: This interface is alpha at best, and almost guaranteed to change
 .SH "SYNOPSIS"
 .IX Header "SYNOPSIS"
 .Vb 3
@@ -159,6 +157,8 @@
 .Ve
 .SH "DESCRIPTION"
 .IX Header "DESCRIPTION"
+NOTE: This interface is alpha at best, and almost guaranteed to change
+.PP
 Mail::SpamAssassin::Client is a module that provides a perl implementation for
 the spamd protocol.
 .SH "PUBLIC METHODS"
-----------------------------
Problems with Mail::SpamAssassin::Plugin::ReplaceTags.3pm:
(May reflect bugs in POD).

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.  Or your page
may add running text duch as a version or authorship banner.  These
problems make it impossible to lift the page to DocBook.  They
can also confuse third-party manpage browsers and some implementations
of man -k.

--- Mail::SpamAssassin::Plugin::ReplaceTags.3pm-orig    2007-01-03 
21:35:50.000000000 -0500
+++ Mail::SpamAssassin::Plugin::ReplaceTags.3pm 2007-01-03 21:36:29.000000000 
-0500
@@ -132,13 +132,6 @@
 .TH Mail::SpamAssassin::Plugin::ReplaceTags 3 "2006-03-10" "perl v5.8.8" "User 
Contributed Perl Documentation"
 .SH "NAME"
 Mail::SpamAssassin::Plugin::ReplaceTags \- tags for SpamAssassin rules
-.PP
-The plugin allows rules to contain regular expression tags to be used in
-regular expression rules.  The tags make it much easier to maintain
-complicated rules.
-.PP
-Warning: This plugin replies on data structures specific to this version of
-SpamAssasin; it is not guaranteed to work with other versions of SpamAssassin.
 .SH "SYNOPSIS"
 .IX Header "SYNOPSIS"
 .Vb 1
@@ -167,6 +160,14 @@
 .Vb 1
 \&  replace_rules VIAGRA_OBFU
 .Ve
+.SH SUMMARY
+.PP
+This plugin allows rules to contain regular expression tags to be used in
+regular expression rules.  The tags make it much easier to maintain
+complicated rules.
+.PP
+Warning: This plugin replies on data structures specific to this version of
+SpamAssasin; it is not guaranteed to work with other versions of SpamAssassin.
 .SH "CONFIGURATION"
 .IX Header "CONFIGURATION"
 .IP "replace_tag tagname expression" 4
-----------------------------
Problems with XML::LibXML::DocumentFragment.3pm:
(May reflect bugs in POD).

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.  Or your page
may add running text duch as a version or authorship banner.  These
problems make it impossible to lift the page to DocBook.  They
can also confuse third-party manpage browsers and some implementations
of man -k.

--- XML::LibXML::DocumentFragment.3pm-orig      2007-01-03 21:38:12.000000000 
-0500
+++ XML::LibXML::DocumentFragment.3pm   2007-01-03 21:38:31.000000000 -0500
@@ -132,6 +132,7 @@
 .TH XML::LibXML::DocumentFragment 3 "2003-11-07" "perl v5.8.8" "User 
Contributed Perl Documentation"
 .SH "NAME"
 XML::LibXML::DocumentFragment \- XML::LibXML's DOM L2 Document Fragment 
Implementation
+.SH DESCRIPTION
 .PP
 This class is a helper class as described in the DOM Level 2 Specification. It
 is implemented as a node without name. All adding, inserting or replacing
-----------------------------
Problems with XML::DOM-ecmascript.3pm:
(May reflect bugs in POD).

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.  Or your page
may add running text duch as a version or authorship banner.  These
problems make it impossible to lift the page to DocBook.  They
can also confuse third-party manpage browsers and some implementations
of man -k.

--- XML::DOM-ecmascript.3pm-orig        2007-01-03 16:31:31.000000000 -0500
+++ XML::DOM-ecmascript.3pm     2007-01-03 16:32:34.000000000 -0500
@@ -129,6 +129,8 @@
 .\" ========================================================================
 .\"
 .IX Title "DOM-ecmascript 3"
+.SH NAME
+DOM-ecmascript \- Document Object Model for ECMAscript.
 .TH DOM-ecmascript 3 "1999-08-25" "perl v5.8.8" "User Contributed Perl 
Documentation"
 .SH "XML::Grove and DOM Level One"
 .IX Header "XML::Grove and DOM Level One"
-----------------------------

--
                             Eric S. Raymond

Reply via email to