problems in one or more man pages you maintain

esr at thyrsus.com esr at thyrsus.com
Mon Jul 12 15:14:43 UTC 2004


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 dbz.3:

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.

--- dbz.3-orig	2003-11-24 11:06:43.000000000 -0500
+++ dbz.3	2003-11-24 11:07:11.000000000 -0500
@@ -1,11 +1,7 @@
 .TH DBZ 3 "6 Sep 1997"
 .BY "INN"
 .SH NAME
-dbzinit, dbzfresh, dbzagain, dbzclose \- database routines
-.br
-dbzexists, dbzfetch, dbzstore \- database routines
-.br
-dbzsync, dbzsize, dbzgetoptions, dbzsetoptions, dbzdebug \- database routines
+dbzinit, dbzfresh, dbzagain, dbzclose, dbzexists, dbzfetch, dbzstore, dbzsync, dbzsize, dbzgetoptions, dbzsetoptions, dbzdebug \- database routines
 .SH SYNOPSIS
 .nf
 .B #include <dbz.h>
Problems with motd.news.5:

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.

--- motd.news.5-orig	2003-12-02 03:00:38.000000000 -0500
+++ motd.news.5	2003-12-02 03:01:13.000000000 -0500
@@ -2,7 +2,7 @@
 .\" $Revision: 1.3 $
 .TH MOTD.NEWS 5
 .SH NAME
-motd.news
+motd.news \- internet news message-of-the-day file
 .SH DESCRIPTION
 The
 .I <pathetc in inn.conf>/motd.news
Problems with nnrp.access.5:

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 send-uucp.8:

1. Broken command synopsis syntax.  This may mean you're using a
construction in the command synopsis other than the standard
[ ] | { }, or it may mean you have running text in the command synopsis
section (the latter is not technically an error, but it's impossible
to translate into DocBook markup).

--- send-uucp.8-orig	2003-11-26 17:37:14.000000000 -0500
+++ send-uucp.8	2003-11-26 17:37:30.000000000 -0500
@@ -2,13 +2,25 @@
 .SH NAME
 send-uucp, send-nntp, send-ihave \- send Usenet articles to remote site
 .SH SYNOPSIS
-{
 .B send-nntp
-|
+[
+.B \-d
+]
+.B sitename:hostname | sitename
+[
+.B sitename:hostname | sitename ..
+]
+.br
 .B send-uucp
-|
+[
+.B \-d
+]
+.B sitename:hostname | sitename
+[
+.B sitename:hostname | sitename ..
+]
+.br
 .B send-ihave
-}
 [
 .B \-d
 ]
@@ -16,6 +28,7 @@
 [
 .B sitename:hostname | sitename ..
 ]
+.br
 .SH DESCRIPTION
 The send-* utilities are scripts that process the batch files written
 by

--
                             Eric S. Raymond


More information about the inn-bugs mailing list