bug-groff
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Problems in groff_mom.7, grodvi.1, lkbib.1


From: esr
Subject: Problems in groff_mom.7, grodvi.1, lkbib.1
Date: Tue, 18 Jun 2013 01:13:54 -0400 (EDT)

This is automatically generated email about markup problems in a man
page for which you appear to be responsible.  If you are not the right
person or list, please tell me so I can correct my database.

See http://catb.org/~esr/doclifter/bugs.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 modification date of
any manual page.  You may wish to do that by hand.

I apologize if this message seems spammy or impersonal. The volume of
markup bugs I am tracking is over five hundred - there is no real
alternative to generating bugmail from a database and template.

--
                             Eric S. Raymond
Problems with groff_mom.7:

My records indicate that you have accepted this patch, so this is just
a reminder.

Changed page to use the .URL macro now preferred on man(7).

--- groff_mom.7-unpatched       2013-05-24 04:42:39.170660253 -0400
+++ groff_mom.7 2013-05-24 04:43:40.770659101 -0400
@@ -121,8 +121,7 @@
 \[en] a wrapper file that calls om.tmac directly.
 .
 .TP
-.UR \%/usr/share/doc/groff-base/html/\:mom/\:toc.html
-.UE
+.URL \%/usr/share/doc/groff-base/html/\:mom/\:toc.html
 \[en] entry point to the HTML documentation
 .
 .TP
@@ -131,7 +130,7 @@
 .I Producing PDFs with groff and mom
 .
 .TP
-.B /usr/share/doc/groff-base/examples/mom/*.mom
+.R /usr/share/doc/groff-base/examples/mom/*.mom
 \[en] example files using mom
 .
 .
Problems with grodvi.1:

My records indicate that you have accepted this patch, so this is just
a reminder.

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 most cases of it
are impossible to translate into DocBook markup), or it may mean the
command syntax fails to match the description.

This page wins an award for exceptionally creative and perverse
abuse of list syntax.

--- grodvi.1-unpatched  2012-07-06 12:22:32.582611895 -0400
+++ grodvi.1    2012-07-06 12:23:09.078611215 -0400
@@ -60,11 +60,6 @@
 ] [
 .IR files \|.\|.\|.\&
 ]
-.PP
-It is possible to have whitespace between a command line option and its
-parameter.
-.
-.
 .SH DESCRIPTION
 .B grodvi
 is a driver for
@@ -198,6 +193,11 @@
 .
 .
 .SH OPTIONS
+.PP
+It is possible to have whitespace between a command line option and its
+parameter.
+.
+.
 .TP
 .B \-d
 Do not use tpic specials to implement drawing commands.
Problems with lkbib.1:

My records indicate that you have accepted this patch, so this is just
a reminder.

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 most cases of it
are impossible to translate into DocBook markup), or it may mean the
command syntax fails to match the description.

--- lkbib.1-unpatched   2012-07-05 16:07:06.175975715 -0400
+++ lkbib.1     2012-07-05 16:07:29.663975277 -0400
@@ -50,11 +50,6 @@
 ]
 .IR key \|.\|.\|.
 .
-.PP
-It is possible to have whitespace between a command line option and its
-parameter.
-.
-.
 .SH DESCRIPTION
 .B lkbib
 searches bibliographic databases for references that contain the keys
@@ -81,6 +76,11 @@
 .
 .
 .SH OPTIONS
+.PP
+It is possible to have whitespace between a command line option and its
+parameter.
+.
+.
 .TP
 .B \-v
 Print the version number.

reply via email to

[Prev in Thread] Current Thread [Next in Thread]