Problems in ode.1, plot.1, plotfont.1, tek2plot.1

[esr]

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 tek2plot.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.  Or your page
may add running text such as a version or authorship banner.  These
problems make it impossible to lift the page to DocBook.  They
can also confuse third-party manpage browsers and some implementations
of man -k.

--- tek2plot.1-unpatched        2012-07-18 22:48:17.175686575 -0400
+++ tek2plot.1  2012-07-18 22:49:06.371687430 -0400
@@ -1,12 +1,9 @@
 .TH TEK2PLOT 1 "Jun 2000" "FSF" "GNU Plotting Utilities"
-.SH NAME
-tek2plot \- translate Tektronix files to other graphics formats
-.ig
-Not all man macros define SB (and not all whatis parsers stop on .\")
-..
 .de SB
 \&\fB\s-1\&\\$1 \\$2\s0\fR
 ..
+.SH NAME
+tek2plot \- translate Tektronix files to other graphics formats
 .SH SYNOPSIS
 .B tek2plot 
 [ 

Problems with ode.1:

Macro definitions in the NAME section confuse doclifter and are
likely to screw up third-party man viewers with their own parsers.

--- ode.1-unpatched     2012-07-02 12:38:51.157056771 -0400
+++ ode.1       2012-07-02 12:41:46.497053492 -0400
@@ -1,12 +1,10 @@
 .TH ODE 1 "Dec 1998" "FSF" "GNU Plotting Utilities"
-.SH NAME
-ode \- numerical solution of ordinary differential equations
-.ig
-Not all man macros define SB (and not all whatis parsers stop on .\")
-..
 .de SB
 \&\fB\s-1\&\\$1 \\$2\s0\fR
 ..
+
+.SH NAME
+ode \- numerical solution of ordinary differential equations
 .SH SYNOPSIS
 .B ode
 [

Problems with plot.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.  Or your page
may add running text such as a version or authorship banner.  These
problems make it impossible to lift the page to DocBook.  They
can also confuse third-party manpage browsers and some implementations
of man -k.

--- plot.1-unpatched    2012-07-06 13:21:02.614546256 -0400
+++ plot.1      2012-07-06 13:21:51.350545344 -0400
@@ -1,12 +1,6 @@
 .TH PLOT 1 "Jun 2000" "FSF" "GNU Plotting Utilities"
 .SH NAME
 plot \- translate GNU metafiles to other graphics formats
-.ig
-Not all man macros define SB (and not all whatis parsers stop on .\")
-..
-.de SB
-\&\fB\s-1\&\\$1 \\$2\s0\fR
-..
 .SH SYNOPSIS
 .B plot 
 [ 
@@ -15,6 +9,9 @@
 .I files 
 ]
 .SH DESCRIPTION
+.de SB
+\&\fB\s-1\&\\$1 \\$2\s0\fR
+..
 .LP
 .B plot
 translates files in GNU metafile format to other graphics formats, or

Problems with plotfont.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.  Or your page
may add running text such as a version or authorship banner.  These
problems make it impossible to lift the page to DocBook.  They
can also confuse third-party manpage browsers and some implementations
of man -k.

--- plotfont.1-unpatched        2012-07-05 17:31:24.527881120 -0400
+++ plotfont.1  2012-07-05 17:31:41.015880808 -0400
@@ -1,12 +1,9 @@
 .TH PLOTFONT 1 "Jun 2000" "FSF" "GNU Plotting Utilities"
-.SH NAME
-plotfont \- produce character maps of fonts supported by the plotting utilities
-.ig
-Not all man macros define SB (and not all whatis parsers stop on .\")
-..
 .de SB
 \&\fB\s-1\&\\$1 \\$2\s0\fR
 ..
+.SH NAME
+plotfont \- produce character maps of fonts supported by the plotting utilities
 .SH SYNOPSIS
 .B plotfont
 [