man pages: Make style fixes.

	* src/preproc/eqn/neqn.1.man:
	* src/utils/lkbib/lkbib.1.man:
	* src/utils/lookbib/lookbib.1.man:
	* src/utils/pfbtops/pfbtops.1.man:
	* src/utils/xtotroff/xtotroff.1.man:
	  + Set command names in italics (as works of software), not
	    bold.

	* src/preproc/eqn/neqn.1.man:
	  + Convert Synopsis section to use .SY/.YS synopsis macros.

	* src/utils/lkbib/lkbib.1.man:
	* src/utils/lookbib/lookbib.1.man:
	* src/utils/pfbtops/pfbtops.1.man:
	* src/utils/xtotroff/xtotroff.1.man:
	  + Set (fixed portions of) filenames in italics, not bold.
	  + Tweak description of (help and) version flags' behavior;
	    "print" can be ambiguous in typesetting contexts.

	* src/utils/pfbtops/pfbtops.1.man:
	* src/utils/xtotroff/xtotroff.1.man:
	  + Document --help option.

	* src/utils/lkbib/lkbib.1.man:
	* src/utils/lookbib/lookbib.1.man:
	  + Use the "standard ellipsis" documented in groff_man(7).
	  + Set variable portions of filenames in roman when not used in
	    isolation.
	  + Sort option descriptions in Options section in alphabetical
	    order.

	* src/utils/lkbib/lkbib.1.man:
	  + Set environment variable names in italics, not small bold.

	* src/utils/pfbtops/pfbtops.1.man:
	  + Expand PFB initialism (Printer Font Binary), to aid
	    comprehension and man -k indexing.
	  + Use hyphens instead of underscores in option argument names;
            they are prose, not C identifiers.

	* src/utils/xtotroff/xtotroff.1.man:
	  + Use hyphens instead of StudlyCaps in option argument names;
	    they are prose, not C identifiers.
	  + Add man page cross references to first mentions of groff and
	    troff; also add them to the See Also section.
	  + Expand XLFD initialism to aid comprehension.
	  + Set off XLFD example inside relative indent and example
	    macros.
	  + Escape hyphens in XLFD example.
	  + Double-quote (instead of single-quoting) the names of the
	    supported encodings, since they are used as strings; also
	    escape the hyphens therein, as they are subsets of an XLFD,
	    not ordinary prose (cf. "ISO 8859-1" and "iso8859\-1").

	* src/utils/lkbib/lkbib.1.man:
	* src/utils/lookbib/lookbib.1.man:
	* src/utils/tfmtodit/tfmtodit.1.man:
	* src/utils/xtotroff/xtotroff.1.man:
	  + Consistently put two empty requests between paragraph
	    macros.

Signed-off-by: G. Branden Robinson <g.branden.robinson@gmail.com>

1 files changed, 24 insertions, 20 deletions

diff --git a/src/utils/pfbtops/pfbtops.1.man b/src/utils/pfbtops/pfbtops.1.man
index e6512b189..8f90ff60d 100644
--- a/src/utils/pfbtops/pfbtops.1.man
+++ b/src/utils/pfbtops/pfbtops.1.man
@@ -1,6 +1,6 @@
 .TH PFBTOPS @MAN1EXT@ "@MDATE@" "groff @VERSION@"
 .SH NAME
-pfbtops \- translate a PostScript font in .pfb format to ASCII
+pfbtops \- translate Printer Font Binary files to PostScript ASCII
 .
 .
 .\" ====================================================================
@@ -30,7 +30,7 @@ pfbtops \- translate a PostScript font in .pfb format to ASCII
 .\" ====================================================================
 .
 .SY pfbtops
-.RI [ pfb_file ]
+.RI [ pfb-file ]
 .YS
 .
 .SY pfbtops
@@ -47,45 +47,49 @@ pfbtops \- translate a PostScript font in .pfb format to ASCII
 .SH DESCRIPTION
 .\" ====================================================================
 .
-.B pfbtops
-translates a PostScript font in
-.B .pfb
-format to ASCII, splitting overlong lines in text packets into smaller
-chunks.
+.I pfbtops
+translates a PostScript font in Printer Font Binary (PFB) format to
+ASCII, splitting overlong lines in text packets into smaller chunks.
 .
 If
-.I pfb_file
-is omitted the pfb file will be read from the standard input.
+.I pfb-file
+is omitted, the PFB file will be read from the standard input.
 .
 The ASCII format PostScript font will be written on the standard output.
 .
-PostScript fonts for MS-DOS are normally supplied in
-.B .pfb
-format.
+PostScript fonts for MS-DOS are normally supplied in PFB format.
 .
 .
 .LP
-The resulting ASCII format PostScript font can be used with groff.
-.
-It must first be listed in
-.B @FONTDIR@/devps/download
+The resulting ASCII format PostScript font can be used with groff,
+if it is first listed in
+.I @FONTDIR@/\:devps/\:download
 and
-.BR @FONTDIR@/devpdf/download .
+.IR @FONTDIR@/\:devpdf/\:download .
 .
 .
 .\" ====================================================================
 .SH OPTIONS
 .\" ====================================================================
+.
+.TP
+.B \-\-help
+Display a usage message and exit.
+.
+.
 .TP
 .B \-v
-Print the version number.
+.TQ
+.B \-\-version
+Display version information and exit.
 .
 .
 .\" ====================================================================
 .SH "SEE ALSO"
 .\" ====================================================================
-.BR grops (@MAN1EXT@),
-.BR gropdf (@MAN1EXT@)
+.
+.IR grops (@MAN1EXT@),
+.IR gropdf (@MAN1EXT@)
 .
 .
 .\" Local Variables: