problems in inews.1, nnrp.access.5, perl-nocem.8

esr at thyrsus.com esr at thyrsus.com
Fri Jan 14 08:27:12 UTC 2005


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

--- inews.1-orig	2005-01-13 12:46:52.000000000 -0500
+++ inews.1	2005-01-13 12:47:06.000000000 -0500
@@ -130,7 +130,7 @@
 .\"
 .IX Title "INEWS 1"
 .TH INEWS 1 "2004-12-19" "INN 2.4.2" "InterNetNews Documentation"
-.SH "NEWS"
+.SH "NAME"
 .IX Header "NEWS"
 inews \- Post a Usenet article to the local news server
 .SH "SYNOPSIS"
-----------------------------
Problems with nnrp.access.5:

My records indicate that you have accepted this patch, so this is just
a reminder.  Please try to get a release with the patch incorporated
to the Fedora folks in time for Fedora Core 4.

1. Unknown or invalid macro.  That is, one that does not fit in the
macro set that the man page seems to be using.  This is a serious
error; it often means part of your text is being lost or rendered
incorrectly.

--- nnrp.access.5-orig	2003-11-30 14:04:14.000000000 -0500
+++ nnrp.access.5	2003-11-30 14:04:26.000000000 -0500
@@ -5,6 +5,6 @@
 .SH DESCRIPTION
 This file is obsolete.  Please see the man page for
 .IR readers.conf (5).
-.R$ $Id: nnrp.access.5,v 1.15 1998/10/30 14:09:50 kondou Exp $
+.\" $Id: nnrp.access.5,v 1.15 1998/10/30 14:09:50 kondou Exp $
 .SH "SEE ALSO"
 readers.conf(5).
-----------------------------
Problems with perl-nocem.8:

1. Contents of SYNOPSIS is not a synopsis, and can't be parsed.

--- perl-nocem.8-orig	2005-01-13 12:53:04.000000000 -0500
+++ perl-nocem.8	2005-01-13 12:54:18.000000000 -0500
@@ -135,8 +135,8 @@
 .UC
 .SH "NAME"
 perl-nocem \- a NoCeM-on-spool implementation for \s-1INN\s0 2.x
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
+.SH "DESCRIPTION"
+.IX Header "DESCRIPTION"
 Add to the newsfeeds file an entry like this one:
 .PP
 .Vb 2
-----------------------------

--
                             Eric S. Raymond



More information about the inn-bugs mailing list