problems in one or more man pages you maintain

[esr]

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 afmtodit.1:

1. Macro definition is in a location (such as the Synopsis section)
that confuses translation tools.

--- afmtodit.1-orig     2003-02-21 02:36:03.000000000 -0500
+++ afmtodit.1  2003-02-21 02:37:01.000000000 -0500
@@ -25,6 +25,11 @@
 .el .TP "\\$1"
 ..
 .
+.de OP
+.ie \\n(.$-1 .RI "[\ \fB\\$1\fP" "\\$2" "\ ]"
+.el .RB "[\ " "\\$1" "\ ]"
+..
+.
 .
 .TH AFMTODIT 1 "01 March 2002" "Groff Version 1.18"
 .
@@ -40,11 +45,6 @@
 .in +\w'\fBafmtodit 'u
 .ti \niu
 .B afmtodit
-.de OP
-.ie \\n(.$-1 .RI "[\ \fB\\$1\fP" "\\$2" "\ ]"
-.el .RB "[\ " "\\$1" "\ ]"
-..
-.
 .OP \-nsv
 .OP \-d desc_file
 .OP \-e enc_file
Problems with eqn.1:

1. Unbalanced .RS or .RE macro

--- eqn.1-orig  2003-12-19 21:22:48.000000000 -0500
+++ eqn.1       2003-12-19 21:26:15.000000000 -0500
@@ -459,13 +459,12 @@
 of the object.
 The number registers must also be modified so that they correspond to the
 result.
-.RS
 .LP
 For example, suppose you wanted a construct that `cancels' an expression
 by drawing a diagonal line through it.
-.IP
+.RS
 .nf
-.ft B
+.ft CW
 .if t .ne 6+\n(.Vu
 \&.EQ
 define cancel 'special Ca'
@@ -475,16 +474,18 @@
 \&..
 .ft
 .fi
+.RE
 .LP
 Then you could cancel an expression
 .I e
 with
 .BI cancel\ {\  e\  }
 .LP
-Here's a more complicated construct that draws a box round an expression:
-.IP
+Here's a more complicated construct that draws a box round an
+expression:
+.RS
 .nf
-.ft B
+.ft CW
 .if t .ne 11+\n(.Vu
 \&.EQ
 define box 'special Bx'
Problems with geqn.1:

1. Unbalanced .RS or .RE macro

--- geqn.1-orig 2003-12-19 21:22:48.000000000 -0500
+++ geqn.1      2003-12-19 21:26:15.000000000 -0500
@@ -459,13 +459,12 @@
 of the object.
 The number registers must also be modified so that they correspond to the
 result.
-.RS
 .LP
 For example, suppose you wanted a construct that `cancels' an expression
 by drawing a diagonal line through it.
-.IP
+.RS
 .nf
-.ft B
+.ft CW
 .if t .ne 6+\n(.Vu
 \&.EQ
 define cancel 'special Ca'
@@ -475,16 +474,18 @@
 \&..
 .ft
 .fi
+.RE
 .LP
 Then you could cancel an expression
 .I e
 with
 .BI cancel\ {\  e\  }
 .LP
-Here's a more complicated construct that draws a box round an expression:
-.IP
+Here's a more complicated construct that draws a box round an
+expression:
+.RS
 .nf
-.ft B
+.ft CW
 .if t .ne 11+\n(.Vu
 \&.EQ
 define box 'special Bx'
Problems with gpic.1:

1. List syntax error. This means .IP, .TP or .RS/.RE markup is garbled.
This confuses doclifter, and may also mess up stricter troff
interpreters like groffer and TkMan.

--- gpic.1-orig 2003-12-19 21:41:13.000000000 -0500
+++ gpic.1      2003-12-19 21:42:09.000000000 -0500
@@ -480,7 +480,6 @@
 and then changes the value in the current block only.)
 For example, the following:
 .RS
-.IP
 .ft B
 .nf
 \&.PS
Problems with pic.1:

1. List syntax error. This means .IP, .TP or .RS/.RE markup is garbled.
This confuses doclifter, and may also mess up stricter troff
interpreters like groffer and TkMan.

--- pic.1-orig  2003-12-19 21:41:13.000000000 -0500
+++ pic.1       2003-12-19 21:42:09.000000000 -0500
@@ -480,7 +480,6 @@
 and then changes the value in the current block only.)
 For example, the following:
 .RS
-.IP
 .ft B
 .nf
 \&.PS
Problems with groff_mom.7:

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.

--- groff_mom.7-orig    2003-12-01 17:37:40.000000000 -0500
+++ groff_mom.7 2003-12-01 17:38:38.000000000 -0500
@@ -68,10 +68,9 @@
 .TP
 .B om.tmac
 \[en] the main macro file
-.TQ
+.TP
 .B mom.tmac
 \[en] a wrapper file that calls om.tmac directly.
-.
 .TP
 .URL /usr/share/doc/groff/1.18.1/html/momdoc/toc.html 
/usr/share/doc/groff/1.18.1/html/momdoc/toc.html
 \[en] entry point to the HTML documentation

--
                             Eric S. Raymond