[groff] 09/15: man pages: Fix style nits.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 048f3d7d608d7363a1e1df35384b5910d50da9cc
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Mon Oct 19 03:00:17 2020 +1100

    man pages: Fix style nits.
    
    * contrib/hdtbl/groff_hdtbl.7.man:
      + Set macro package and program names in italics.
      + Set "HTML" in roman, not bold.
      + Break input lines after commas and semicolons.
      + Add configurable command prefix to tbl(1) cross-reference.
      + Set roff request in bold, not Courier roman.  (This page abuses
        Courier aggressively and needs a lot more work.)
    * man/groff_diff.7.man:
      + Set request names with leading dots.
      + Fix spacing goof in .IR call.
      + Break input lines after commas.  Reflow where necessary.
      + Fix example to .ne the number of vees it actually uses.
      + Set program and file names in italics.
      + Fix example to .ne the number of vees it actually uses.
      + Suppress hyphenation of configurably-prefixed man page
        cross-references.
      + Stop referring to strings as a type of register.
      + Break input lines at commas.
      + Use more contemporary examples of output devices.
      + Use configurable command-prefix when referring to groff programs
        using them.
      + Stop using a non-breaking space after "AT&T".
      + Set request names with a leading dot.
      + Recast some wording for clarify.
      + Use two empty requests where inter-paragraph space is expected.
      + Use two-font macros in preference to the \~\c antipattern.
      + Recast some language to stop talking about what can be done "now"
        when discussing groff features that have been around for 30 years.
      + Use special character escape \[ha] to represent circumflex accent.
    * man/groff_font.5.man:
      + Set program names in italics.
      + Add configurable command prefix to troff(1) cross-reference.
      + Use two empty requests where inter-paragraph space is expected.
      + Say "PostScript", not "PS".
    * src/preproc/eqn/neqn.1.man:
      + Tighten wording.  (Dave Kemper strikes through again! :D )
      + Break input lines at commas.
    * src/preproc/grn/grn.1.man (Description):
      + Break input lines after commas.
      + Set multi-word parentheticals on their own input lines.
    * src/preproc/refer/refer.1.man:
      + Break input lines after commas.
      + Quote alphabetic literal for clarity.
      + Fix grammar nits.
    * src/utils/afmtodit/afmtodit.1.man:
      + Set multi-word parentheticals on their own input lines.
      + Set man page topics and program names in italics.
      + Use groff-style special character escapes.
      + Suppress hyphenation in file names and info command example.
---
 contrib/hdtbl/groff_hdtbl.7.man   |  39 ++---
 man/groff_diff.7.man              | 299 +++++++++++++++++++++++---------------
 man/groff_font.5.man              |  28 ++--
 src/preproc/eqn/neqn.1.man        |   6 +-
 src/preproc/grn/grn.1.man         |  48 ++++--
 src/preproc/refer/refer.1.man     |  10 +-
 src/utils/afmtodit/afmtodit.1.man |  89 +++++++-----
 7 files changed, 315 insertions(+), 204 deletions(-)

diff --git a/contrib/hdtbl/groff_hdtbl.7.man b/contrib/hdtbl/groff_hdtbl.7.man
index 9cfc161..e3de2e4 100644
--- a/contrib/hdtbl/groff_hdtbl.7.man
+++ b/contrib/hdtbl/groff_hdtbl.7.man
@@ -166,34 +166,35 @@ groff_hdtbl \- Heidelberger table macros for GNU roff
 .\" ====================================================================
 .
 The
-.B hdtbl
+.I hdtbl
 macros consist of four base and three optional macros,
 controlled by about twenty arguments.
 .
-The syntax is simple and similar to the
-.B HTML
-table model and nearly as flexible:
+The syntax is simple and similar to the HTML table model and nearly as
+flexible:
 you can write sequences of tokens
 (macro calls with their arguments and content data),
 separated by blanks and beginning with a macro call,
 into the same line to get compact and cleanly arrranged input.
 .
 An advantage of
-.B hdtbl
-is that the tables are constructed without calling a preprocessor; this
-means that
-.BR groff 's
+.I hdtbl
+is that the tables are constructed without calling a preprocessor;
+this means that
+.IR groff 's
 full macro capabilities are available.
 .
-On the other hand, table processing with
-.B hdtbl
+On the other hand,
+table processing with
+.I hdtbl
 is much slower than using the
-.BR tbl (@MAN1EXT@)
+.IR \%@g@tbl (@MAN1EXT@)
 preprocessor.
 .
 A further advantage is that the HTML-like syntax of
-.B hdtbl
-will be easily converted to HTML; this is not implemented yet.
+.I hdtbl
+will be easily converted to HTML;
+this is not implemented yet.
 .
 .
 .\" ====================================================================
@@ -1040,12 +1041,14 @@ One of
 for roman,
 .BR bold ,
 .IR italic ,
-or \f[BI]bold italic\f[], respectively.
+or \f[BI]bold italic\f[], \" \f[BI] is not portable man(7)
+respectively.
 .
 As with
-.BR roff 's
-.CR .ft
-request the
+.IR roff 's
+.B .ft
+request,
+the
 .CR \[oq]fst\[cq]
 argument can be used to specify the font family and font style together,
 for example
@@ -1298,7 +1301,7 @@ language and GNU extensions to it.
 .
 .
 .TP
-.IR @g@tbl (@MAN1EXT@)
+.IR \%@g@tbl (@MAN1EXT@)
 describes the traditional
 .I roff
 preprocessor for tables.
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 2586586..4f07514 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -492,7 +492,7 @@ i.e., to return to the previous font.
 Change font family.
 .
 This is the same as the
-.B fam
+.B .fam
 request.
 .
 .B \[rs]F[]
@@ -1084,7 +1084,7 @@ It can be also used for gross hacks; for example, this
 .RS
 .IP
 .EX
-.ne 7v+\n(.Vu
+.ne 8v+\n(.Vu
 \&.tr @.
 \&.di x
 \&@nr n 1
@@ -1363,66 +1363,93 @@ If we use value\~6 instead for the left character,
 a break after the character can't be suppressed since the neighboring
 character on the right doesn't get examined.
 .
-.TP
-.BI .char\~ c\~string
-[This request can both define characters and glyphs.]
 .
-.IP
-Define entity\~\c
-.I c
+.TP
+.BI .char\~ "g string"
+Define a new character or
+.RI glyph\~ g
 to be
-.IR string .
+.IR string ,
+which can be empty.
 .
-To be more precise, define (or even override) a groff entity which
-can be accessed with name\~\c
-.I c
-on the input side, and which uses
+More precisely,
+.B .char
+defines
+(or redefines an existing)
+.I groff
+object that is accessed with the
+.RI name\~ g
+on input,
+and produces
 .I string
-on the output side.
+on output.
 .
-Every time glyph\~\c
-.I c
+Every time
+.RI glyph\~ g
 needs to be printed,
 .I string
-is processed in a temporary environment and the result is
-wrapped up into a single object.
+is processed in a temporary environment and the result is wrapped up
+into a single object.
 .
 Compatibility mode is turned off and the escape character is
-set to\~\c
-.B \[rs]
+set
+.RB to\~ \[rs]
 while
 .I string
-is being processed.
+is processed.
 .
-Any emboldening, constant spacing or track kerning is applied to
-this object rather than to individual glyphs in
+Any emboldening,
+constant spacing,
+or track kerning is applied to this object rather than to individual
+glyphs in
 .IR string .
 .
+.
 .IP
-A groff object defined by this request can be used just like a
-normal glyph provided by the output device.
+An object defined by this request can be used just like a normal glyph
+provided by the output device.
 .
-In particular other characters can be translated to it with the
-.B tr
-request; it can be made the leader glyph by the
-.B lc
-request; repeated patterns can be drawn with the glyph using the
+In particular,
+other characters can be translated to it with the
+.B .tr
+request;
+it can be made the leader glyph with the
+.B .lc
+request;
+repeated patterns can be drawn with it using the
 .B \[rs]l
 and
 .B \[rs]L
-escape sequences; words containing\~\c
-.I c
-can be hyphenated correctly, if the
-.B hcode
+escape sequences;
+and words
+.RI containing\~ g
+can be hyphenated correctly,
+if the
+.B .hcode
 request is used to give the object a hyphenation code.
 .
+.
 .IP
-There is a special anti-recursion feature: Use of glyph within the
-glyph's definition is handled like normal glyphs not defined with
-.BR char .
+There is a special anti-recursion feature:
+use of the object within its own definition is handled like a normal
+character
+(one not defined with
+.BR .char ).
+.
+.
+.IP
+The
+.B .tr
+and
+.B .trin
+requests take precedence if
+.B .char
+accesses the same symbol.
+.
+.
 .IP
 A glyph definition can be removed with the
-.B rchar
+.B .rchar
 request.
 .
 .
@@ -1886,7 +1913,7 @@ request; the only difference is that a glyph defined with
 .B char
 hides the glyph with the same name in the current font, whereas a
 glyph defined with
-.B fchar
+.B .fchar
 is checked only if the particular glyph isn't found in the current
 font.
 .
@@ -2407,7 +2434,7 @@ is non-zero or missing, enable pairwise kerning, 
otherwise disable it.
 Compute the number of characters in
 .I anything
 and return the count in the number register
-.IR reg.
+.IR reg .
 .
 If
 .I reg
@@ -2508,7 +2535,7 @@ command-line option.
 If the file name to be included has the form
 .IB name .tmac
 and it isn't found,
-.B mso
+.B .mso
 tries to include
 .BI tmac. name
 instead and vice versa.
@@ -2851,7 +2878,7 @@ warnings are not suppressed and
 must add 0.2\~m or more for each interword space in a line.
 .
 See
-.IR @g@troff (@MAN1EXT@)
+.IR \%@g@troff (@MAN1EXT@)
 for warning types and control.
 .
 .TP
@@ -3178,7 +3205,7 @@ is the sum of the numbers associated with each warning 
that is to be
 enabled; all other warnings are disabled.
 .
 The number associated with each warning is listed in
-.BR @g@troff (@MAN1EXT@).
+.IR \%@g@troff (@MAN1EXT@).
 .
 For example,
 .B .warn 0
@@ -3776,7 +3803,7 @@ The sum of the numbers associated with each of the 
currently enabled
 warnings.
 .
 The number associated with each warning is listed in
-.BR @g@troff (@MAN1EXT@).
+.IR \%@g@troff (@MAN1EXT@).
 .
 .TP
 .B \[rs]n[.x]
@@ -3867,8 +3894,9 @@ The current horizontal position at input line.
 .TQ
 .B \[rs]n[lss]
 If there are leading spaces in an input line, these registers
-hold the number of leading spaces and the corresponding
-horizontal space, respectively.
+hold the number of leading spaces and the corresponding horizontal
+space,
+respectively.
 .
 .TP
 .B \[rs]n[minutes]
@@ -3903,7 +3931,7 @@ exhausted.
 The current year.
 .
 Note that the traditional
-.B troff
+.I troff \" AT&T
 number register
 .B \[rs]n[yr]
 is the current year minus 1900.
@@ -3913,78 +3941,97 @@ is the current year minus 1900.
 .SS Miscellaneous
 .\" ====================================================================
 .
-.B @g@troff
-predefines a single (read/write) string-based register,
-.BR \[rs]*[.T] ,
-which contains the argument given to the
+.I @g@troff
+predefines a string,
+.BR \[rs]*[.T] ;
+it contains the argument given to the
 .B \-T
-command-line option, namely the current output device (for example,
-.I latin1
+command-line option,
+namely the current output device
+(for example,
+.B pdf
 or
-.IR ascii ).
-Note that this is not the same as the (read-only) number register
-.B \[rs]n[.T]
+.BR utf8 ).
+.
+This is not the same as the (read-only) register
+.BR \[rs]n[.T] ,
 which is defined to be\~1 if
-.B troff
+.I @g@troff
 is called with the
 .B \-T
-command-line option, and zero otherwise.
+command-line option,
+and zero otherwise.
+.
+This behavior differs from AT&T
+.IR troff . \" AT&T
 .
-This behavior is different from
-.RI AT&T\~ troff .
 .
 .P
 Fonts not listed in the
-DESC
+.I DESC
 file are automatically mounted on the next available font position
 when they are referenced.
 .
 If a font is to be mounted explicitly with the
-.B fp
-request on an unused font position, it should be mounted on the first
-unused font position, which can be found in the
+.B .fp
+request on an unused font position,
+it should be mounted on the first unused font position,
+which can be found in the
 .B \[rs]n[.fp]
-register; although
-.B troff
-does not enforce this strictly, it does not allow a font to be mounted
-at a position whose number is much greater than that of any currently
-used position.
+register;
+although
+.I @g@troff
+does not enforce that strictly.
+.
+Rather,
+it does not allow a font to be mounted at a position whose number is
+much greater than that of any currently used position.
+.
 .
 .P
 Interpolating a string does not hide existing macro arguments.
 .
-Thus in a macro, a more efficient way of doing
+Thus,
+in a macro,
+a more efficient way of doing
 .
 .IP
 .BI . xx\~ \[rs]\[rs]$@
+.
+.
 .P
 is
 .
 .IP
 .BI \[rs]\[rs]*[ xx ]\[rs]\[rs]
 .
+.
 .P
 If the font description file contains pairwise kerning information,
 glyphs from that font are kerned.
 .
-Kerning between two glyphs can be inhibited by placing a
+Kerning between two glyphs can be inhibited by placing a non-printing
+input break
 .B \[rs]&
 between them.
 .
+.
 .P
-In a string comparison in a condition, characters that appear at
-different input levels to the first delimiter character are not
-recognized as the second or third delimiters.
+In a string comparison in a condition,
+characters that appear at different input levels from the first
+delimiter character are not recognized as the second or third
+delimiters.
 .
-This applies also to the
-.B tl
+This also applies to the
+.B .tl
 request.
 .
 In a
 .B \[rs]w
-escape sequence, a character that appears at a different input level
-to the starting delimiter character is not recognized as the
-closing delimiter character.
+escape sequence,
+a character that appears at a different input level from the starting
+delimiter character is not recognized as the closing delimiter
+character.
 .
 The same is true for
 .BR \[rs]A ,
@@ -3999,52 +4046,64 @@ and
 .BR \[rs]Z .
 .
 When decoding a macro or string argument that is delimited by double
-quotes, a character that appears at a different input level to the
-starting delimiter character is not recognized as the closing delimiter
+quotes,
+a character that appears at a different input level from the starting
+delimiter character is not recognized as the closing delimiter
 character.
 .
 The implementation of
 .B \[rs]$@
 ensures that the double quotes surrounding an argument appear at the
-same input level, which is different to the input level of the
-argument itself.
+same input level,
+which is differs from the input level of the argument itself.
 .
 In a long escape name
 .B ]
 is not recognized as a closing delimiter except when it occurs at
-the same input level as the opening\~\c
-.BR [ .
+the same input level as the
+.RB opening\~ [ .
 .
-In compatibility mode, no attention is paid to the input-level.
+In compatibility mode,
+no attention is paid to the input level.
 .
 .
 .P
-The
-.B tr
-request can now map characters onto
+In
+.IR groff ,
+the
+.B .tr
+request can map characters onto
 .BR \[rs]\[ti] .
 .
+.
 .P
 The space width emitted by the
 .B \[rs]|
 and
 .B \[rs]^
 escape sequences can be controlled on a per-font basis.
+.
 If there is a glyph named
 .B \[rs]|
 or
-.BR \[rs]^ ,
-respectively (note the leading backslash), defined in the current font
-file, use this glyph's width instead of the default value.
+.BR \[rs]\[ha] ,
+respectively
+(note the leading backslash),
+defined in the current font file,
+use this glyph's width instead of the default value.
+.
 .
 .P
-It is now possible to have whitespace between the first and second dot
-(or the name of the ending macro) to end a macro definition.
+In
+.IR groff ,
+tabs and spaces are allowed between the first and second dots
+(or between the dot and the name of the ending macro)
+that end a macro definition.
 .
 Example:
 .
 .IP
-.ne 6v+\n(.Vu
+.ne 5v+\n(.Vu
 .EX
 \&.if t \[rs]{\[rs]
 \&.  de bar
@@ -4060,8 +4119,8 @@ Example:
 .
 The output format of
 .I groff
-is modeled after that used
-.RI AT&T\~ troff
+is modeled after that used by AT&T
+.I troff \" AT&T
 once it adopted a device-independent approach in the early 1980s.
 .
 Only the differences are documented here.
@@ -4072,14 +4131,17 @@ Only the differences are documented here.
 .\" ====================================================================
 .
 The argument to the
-.BR s \~\c
-command is in scaled points (units of
+.BR s \~command
+is in scaled points
+(in units of
 .RI points/ n ,
 where
 .I n
 is the argument to the
 .B sizescale
-command  in the DESC file).
+command in the
+.I DESC
+file).
 .
 The argument to the
 .B x Height
@@ -4094,38 +4156,45 @@ command is also in scaled points.
 .BI N n
 Print glyph with index\~\c
 .I n
-(a non-negative integer) of the current font.
+(a non-negative integer)
+of the current font.
 .
 .P
 If the
 .B tcommand
-line is present in the DESC file, troff uses the following two
-commands.
+line is present in the
+.I DESC
+file,
+GNU
+.I troff \" GNU
+uses the following two commands.
 .
 .TP
 .BI t xxx
 .I xxx
-is any sequence of characters terminated by a space or a newline (to
-be more precise, it is a sequence of glyphs which are accessed with
-the corresponding characters); the first character should be printed at
-the current position, the current horizontal position should be
-increased by the width of the first character, and so on for each
-character.
+is any sequence of characters terminated by a space or a newline
+(to be more precise,
+it is a sequence of glyphs which are accessed with the corresponding
+characters);
+the first character should be printed at the current position,
+the current horizontal position should be increased by the width of the
+first character,
+and so on for each character.
 .
 The width of the glyph is that given in the font file,
-appropriately scaled for the current point size, and rounded so that
-it is a multiple of the horizontal resolution.
+appropriately scaled for the current point size,
+and rounded so that it is a multiple of the horizontal resolution.
 .
 Special characters cannot be printed using this command.
 .
 .TP
 .BI u n\~xxx
 This is same as the
-.BR t \~\c
-command except that after printing each character, the current
+.BR t \~command
+except that after printing each character, the current
 horizontal position is increased by the sum of the width of that
-character and\~\c
-.IR n .
+character
+.RI and\~ n .
 .
 .P
 Note that single characters can have the eighth bit set, as can the
diff --git a/man/groff_font.5.man b/man/groff_font.5.man
index c0ebcb5..a860bfc 100644
--- a/man/groff_font.5.man
+++ b/man/groff_font.5.man
@@ -129,7 +129,7 @@ name.
 The physical vertical dimension of the output medium in machine units.
 .
 This isn't used by
-.B troff
+.I @g@troff
 itself but by output devices.
 .
 Deprecated.
@@ -557,22 +557,24 @@ Note, however, that the
 .B \[rs]N
 escape sequence only accepts a decimal integer.
 .
+.
 .LP
 The
 .I entity_name
-field gives an ASCII string identifying the glyph which the
-postprocessor uses to print that glyph.
+field defines a string identifying the glyph which the postprocessor
+uses to print that glyph.
+.
+This field is optional and is used by
+.I grops
+to build sub-encoding arrays for PostScript fonts containing more than
+256 glyphs.
 .
-This field is optional and is currently used by
-.B grops
-to build sub-encoding arrays for PS fonts containing more than 256
-glyphs.
+(It was formerly used for
+.IR \%grohtml 's
+entity names,
+but for efficiency reasons these data are now compiled directly into
+.IR \%grohtml .)
 .
-(It has also been used for
-.BR \%grohtml 's
-entity names but for efficiency reasons this data is now compiled
-directly into
-.BR \%grohtml .)
 .
 .LP
 Anything on the line after the encoding field or \[oq]\-\-\[cq] are
@@ -698,7 +700,7 @@ of device
 .\" ====================================================================
 .
 .BR groff_out (@MAN5EXT@),
-.BR @g@troff (@MAN1EXT@),
+.BR \%@g@troff (@MAN1EXT@),
 .BR addftinfo (@MAN1EXT@),
 .BR afmtodit (@MAN1EXT@)
 .
diff --git a/src/preproc/eqn/neqn.1.man b/src/preproc/eqn/neqn.1.man
index 52705d9..6dfd820 100644
--- a/src/preproc/eqn/neqn.1.man
+++ b/src/preproc/eqn/neqn.1.man
@@ -47,10 +47,10 @@ output device.
 .
 .
 .LP
-Note that
 .I @g@eqn
-does not support low-resolution, typewriter-like devices (although it
-may work adequately for very simple input).
+does not support low-resolution,
+typewriter-like devices,
+although it may work adequately for very simple input.
 .
 .
 .\" ====================================================================
diff --git a/src/preproc/grn/grn.1.man b/src/preproc/grn/grn.1.man
index 8d091fd..af6d3a3 100644
--- a/src/preproc/grn/grn.1.man
+++ b/src/preproc/grn/grn.1.man
@@ -73,34 +73,42 @@ pictures in
 input.
 .
 .I @g@grn
-writes to standard output, processing only input lines between two
-that start with
+writes to standard output,
+processing only input lines between two that start with
 .B .GS
 and
 .BR .GE .
 .
 Those lines must contain
 .I @g@grn
-commands (see below).
+commands
+(see below).
 .
-These commands request a
+These macros request a
 .I gremlin
-file, and the picture in that file is converted and placed in the
+file;
+the picture in that file is converted and placed in the
 .I @g@troff
 input stream.
 .
 The
 .B .GS
-request may be followed by a C, L, or R to center, left, or right
-justify the whole
+macro may be followed by a C,
+L,
+or R to center,
+left-,
+or right-justify the whole
 .I gremlin
-picture (default justification is center).
+picture
+(the default is to center).
 .
 If no
 .I file
-is mentioned, the standard input is read.
+is mentioned,
+the standard input is read.
 .
-At the end of the picture, the position on the page is the bottom of the
+At the end of the picture,
+the position on the page is the bottom of the
 .I gremlin
 picture.
 .
@@ -409,14 +417,21 @@ line.
 .
 Since
 .I @g@grn
-is a preprocessor, it doesn't know about current indents, point
-sizes, margins, number registers, etc.  Consequently, no
+is a preprocessor,
+it doesn't know about current indentation,
+point sizes,
+margins,
+registers,
+and so on.
+.
+Consequently,
+no
 .I @g@troff
 input can be placed between the
 .B .GS
 and
 .B .GE
-requests.
+macros.
 .
 However,
 .I gremlin
@@ -478,9 +493,12 @@ and
 .B g2
 to the width and height of the
 .I gremlin
-figure (in device units) before entering the
+figure
+(in device units)
+before entering the
 .B .GS
-request (this is for those who want to rewrite these macros).
+macro
+(this is for those who want to rewrite these macros).
 .
 .
 .\" ====================================================================
diff --git a/src/preproc/refer/refer.1.man b/src/preproc/refer/refer.1.man
index 9c442ff..12df01a 100644
--- a/src/preproc/refer/refer.1.man
+++ b/src/preproc/refer/refer.1.man
@@ -1394,10 +1394,12 @@ command.
 .
 The whole of each author's name will be used.
 .
-However, if the references are sorted by author (that is the sort
-specification starts with
-.BR A+ ),
-then authors last names will be used instead,
+However,
+if the references are sorted by author
+(that is,
+the sort specification starts with
+.RB \[lq] A+ \[rq]),
+then authors' last names will be used instead,
 provided that this does not introduce ambiguity,
 and also an initial subsequence of the authors may be used instead of
 all the authors,
diff --git a/src/utils/afmtodit/afmtodit.1.man 
b/src/utils/afmtodit/afmtodit.1.man
index 2dee4d0..9a1adb5 100644
--- a/src/utils/afmtodit/afmtodit.1.man
+++ b/src/utils/afmtodit/afmtodit.1.man
@@ -72,7 +72,9 @@ you must have Perl version 5.004 or newer installed in order 
to run
 .
 .LP
 .I afm-file
-is the AFM (Adobe Font Metric) file for the font.
+is the AFM
+(Adobe Font Metric)
+file for the font.
 .
 .
 .LP
@@ -83,15 +85,17 @@ character names map onto each PostScript character name;
 this file should contain a sequence of lines of the form
 .
 .RS
-.I
-ps-char groff-char
+.I ps-char groff-char
 .RE
 .
 where
 .I ps-char
 is the PostScript name of the character and
 .I groff-char
-is the groff name of the character (as used in the
+is the
+.I groff
+name of the character
+(as used in the
 .I groff
 font file).
 .
@@ -102,7 +106,7 @@ each
 .I groff-char
 must occur at most once.
 .
-Lines starting with \(oq#\(cq and blank lines are ignored.
+Lines starting with \[lq]#\[rq] and blank lines are ignored.
 .
 If the file isn't found in the current directory,
 it is searched for in the
@@ -116,28 +120,33 @@ If a PostScript character is not mentioned in
 and a generic
 .I groff
 glyph name can't be deduced using the Adobe Glyph List
-(AGL, built into
+(AGL,
+built into
 .IR afmtodit ),
 then
 .I afmtodit
 puts the PostScript character into the
 .I groff
 font file as an unnamed character which can only be accessed by the
-\(oq\eN\(cq escape sequence in a
+\[lq]\eN\[rq] escape sequence in a
 .I roff
 document.
 .
 In particular,
-this is true for glyph variants named in the form \(lqfoo.bar\(rq;
+this is true for glyph variants named in the form \[lq]foo.bar\[rq];
 all glyph names containing one or more periods are mapped to unnamed
 entities.
 .
 If option
 .B \-e
-is not specified, the encoding defined in the AFM file (i.e., entries
-with non-negative character codes) is used.
-.
-Refer to section \(lqUsing Symbols\(rq in
+is not specified,
+the encoding defined in the AFM file
+(i.e.,
+entries
+with non-negative character codes)
+is used.
+.
+Refer to section \[lq]Using Symbols\[rq] in
 .IR "Groff: The GNU Implementation of troff" ,
 the
 .I groff
@@ -148,12 +157,15 @@ glyph names are constructed.
 .
 .
 .LP
-Characters not encoded in the AFM file (i.e., entries which have
-\(oq\-1\(cq as the character code) are still available in
+Characters not encoded in the AFM file
+(i.e.,
+entries which have \[lq]\-1\[rq] as the character code)
+are still available in
 .IR groff ;
-they get glyph index values greater than 255 (or greater than the
-biggest character code used in the AFM file in the unlikely case that it
-is greater than 255) in the
+they get glyph index values greater than 255
+(or greater than the biggest character code used in the AFM file in the
+unlikely case that it is greater than 255)
+in the
 .I groff
 font file.
 .
@@ -172,9 +184,9 @@ option is used.
 .
 .
 .LP
-If there is a downloadable font file for the font, it may be listed in
-the file
-.IR \%@FONTDIR@/\:devps/\:download ;
+If there is a downloadable font file for the font,
+it may be listed in the file
+.IR \%@FONTDIR@/\:\%devps/\:\%download ;
 see
 .IR grops (@MAN1EXT@).
 .
@@ -210,7 +222,9 @@ and
 is the desired value of the corresponding parameter in thousandths of an
 em.
 .
-These parameters are normally needed only for italic (or oblique) fonts.
+These parameters are normally needed only for italic
+(or oblique)
+fonts.
 .
 .
 .\" ====================================================================
@@ -257,8 +271,9 @@ rather than the default
 If not found in the current directory,
 the
 .I devps
-subdirectory of the default font directory is searched (this is true for
-both the default device description file and a file given with option
+subdirectory of the default font directory is searched
+(this is true for both the default device description file and a file
+given with option
 .BR \-d ).
 .
 .
@@ -296,8 +311,8 @@ thousandths of an em
 plus the amount by which the right edge of the character's bounding box
 is to the right of the character's origin.
 .
-If this would result in a negative italic correction, use a zero
-italic correction instead.
+If this would result in a negative italic correction,
+use a zero italic correction instead.
 .
 .
 .IP
@@ -306,8 +321,8 @@ product of the tangent of the slant of the font and
 four fifths of the x-height of the font.
 .
 If this would result in a subscript correction greater than the italic
-correction, use a subscript correction equal to the italic correction
-instead.
+correction,
+use a subscript correction equal to the italic correction instead.
 .
 .
 .IP
@@ -324,7 +339,9 @@ is given.
 .
 .
 .IP
-This option is normally needed only with italic (or oblique) fonts.
+This option is normally needed only with italic
+(or oblique)
+fonts.
 .
 The font files distributed with
 .I groff
@@ -393,28 +410,28 @@ Don't use the built-in Adobe Glyph List.
 .\" ====================================================================
 .
 .TP
-.I \%@FONTDIR@/\:devps/\:DESC
+.I \%@FONTDIR@/\:\%devps/\:DESC
 Device description file.
 .
 .
 .TP
-.IR \%@FONTDIR@/\:devps/\: F
+.IR \%@FONTDIR@/\:\%devps/\: F
 Font description file for font
 .IR F .
 .
 .
 .TP
-.I \%@FONTDIR@/\:devps/\:download
+.I \%@FONTDIR@/\:\%devps/\:\%download
 List of downloadable fonts.
 .
 .
 .TP
-.I \%@FONTDIR@/\:devps/\:text.enc
+.I \%@FONTDIR@/\:\%devps/\:text.enc
 Encoding used for text fonts.
 .
 .
 .TP
-.I \%@FONTDIR@/\:devps/\:generate/\:textmap
+.I \%@FONTDIR@/\:\%devps/\:\%generate/\:textmap
 Standard mapping.
 .
 .
@@ -428,10 +445,10 @@ is the primary
 .I groff
 manual.
 .
-Section \(lqUsing Symbols\(rq may be of particular note.
+Section \[lq]Using Symbols\[rq] may be of particular note.
 .
-You can browse it interactively with \(lqinfo \(aq(groff)Using
-Symbols\(aq\(rq.
+You can browse it interactively with \[lq]info \[aq](groff)Using
+\%Symbols\[aq]\[rq].
 .
 .
 .LP