[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
problems in one or more man pages you maintain
From: |
esr |
Subject: |
problems in one or more man pages you maintain |
Date: |
Tue, 17 Feb 2004 00:56:23 -0500 |
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
- problems in one or more man pages you maintain,
esr <=