Path: csiph.com!goblin3!goblin1!goblin.stu.neva.ru!usenet.stanford.edu!not-for-mail From: esr@thyrsus.com Newsgroups: gnu.utils.bug Subject: Problems in ode.1, plot.1, plotfont.1, tek2plot.1 Date: Tue, 12 Jun 2018 15:16:14 -0400 (EDT) Lines: 160 Approved: bug-gnu-utils@gnu.org Message-ID: NNTP-Posting-Host: lists.gnu.org Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="===============4989010334671299358==" X-Trace: usenet.stanford.edu 1528830982 19558 208.118.235.17 (12 Jun 2018 19:16:22 GMT) X-Complaints-To: action@cs.stanford.edu To: bug-gnu-utils@gnu.org Envelope-to: bug-gnu-utils@gnu.org X-Mailbox-Line: From nobody Tue Jun 12 15:16:14 2018 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] [fuzzy] X-Received-From: 71.162.243.5 X-BeenThere: bug-gnu-utils@gnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: Bug reports for the GNU utilities List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Xref: csiph.com gnu.utils.bug:2244 --===============4989010334671299358== Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit 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 --===============4989010334671299358== Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit 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 [ --===============4989010334671299358== Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit 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 [ --===============4989010334671299358== Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit 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 --===============4989010334671299358== Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit 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 [ --===============4989010334671299358==--