groff-commit
[Top][All Lists]
Advanced

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

[groff] 02/23: [man pages]: Fix content, style, and markup nits.


From: G. Branden Robinson
Subject: [groff] 02/23: [man pages]: Fix content, style, and markup nits.
Date: Sun, 13 Aug 2023 18:35:07 -0400 (EDT)

gbranden pushed a commit to branch master
in repository groff.

commit 25db73cc35346cabd4184ad69800edcf911c3ee1
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Thu Aug 10 16:04:29 2023 -0500

    [man pages]: Fix content, style, and markup nits.
    
    Prepare for required 2n gap after paragraph tags (see Savannah #64539).
    
    * Add or update indentation arguments to `IP` and `TP` calls to
      allow for the width of the widest tags currently accommodated (under
      the "1n gap regime").  Annotate these.
    * Drop some redundant specifications of the indentation amount (when not
      reset by an intervening sectioning or paragraphing macro).
    
    Perform some other spot fixes.
    
    chem(1): Use `EX` and `EE` for an example.  End sentence with a period.
    
    groff(7): Introduce distinction between "control lines" and "text
    lines".  Clarify syntactical meaning of space characters.  Refer to
    "text lines" when presenting syntax, not merely "text".  Refer to
    "inter-word space" as such, instead of the more vague, unelaborated
    "space".
    
    grn(1): Protect some literals from hyphenation.  Tighten wording.
    
    pic(1): Use two empty requests where vertical space is expected.
    
    refer(1): Drop spurious word.  Tighten wording.
    
    groff(1): Tighten wording.
    
    groff_www(7): Set metasyntactic variable in italics, not bold.
    
    Not updated: contrib/pdfmark
---
 contrib/chem/chem.1.man         | 14 +++++++-------
 contrib/mm/groff_mm.7.man       |  8 ++++----
 man/groff.7.man                 | 37 +++++++++++++++++++++----------------
 man/groff_char.7.man            |  2 +-
 man/groff_diff.7.man            | 16 ++++++++--------
 man/groff_font.5.man            |  4 ++--
 man/groff_out.5.man             | 18 +++++++++---------
 man/groff_tmac.5.man            |  6 +++---
 man/roff.7.man                  |  4 ++--
 src/devices/grodvi/grodvi.1.man |  2 +-
 src/devices/grolj4/grolj4.1.man |  2 +-
 src/devices/gropdf/gropdf.1.man |  4 ++--
 src/devices/grops/grops.1.man   |  4 ++--
 src/devices/grotty/grotty.1.man |  4 ++--
 src/preproc/eqn/eqn.1.man       |  6 +++---
 src/preproc/grn/grn.1.man       | 18 ++++++++----------
 src/preproc/pic/pic.1.man       |  3 ++-
 src/preproc/refer/refer.1.man   |  2 +-
 src/preproc/soelim/soelim.1.man |  7 +++----
 src/preproc/tbl/tbl.1.man       | 10 +++++-----
 src/roff/groff/groff.1.man      | 13 +++++++------
 src/roff/troff/troff.1.man      |  4 ++--
 src/utils/indxbib/indxbib.1.man |  2 +-
 tmac/groff_man.7.man.in         |  6 +++---
 tmac/groff_www.7.man            |  2 +-
 25 files changed, 101 insertions(+), 97 deletions(-)

diff --git a/contrib/chem/chem.1.man b/contrib/chem/chem.1.man
index a02242f3f..b84761571 100644
--- a/contrib/chem/chem.1.man
+++ b/contrib/chem/chem.1.man
@@ -638,15 +638,15 @@ is often the name of a moiety like
 but it need not to be.
 .
 Any name that begins with a capital letter and which contains
-only letters and numbers is valid:
+only letters and numbers is valid.
 .
+.
+.P
 .RS
-.TP
-.B First:
-.B bond
-.TQ
-\&
-.B "bond 30 from First"
+.EX
+First: bond
+       "bond 30 from First"
+.EE
 .RE
 .
 .
diff --git a/contrib/mm/groff_mm.7.man b/contrib/mm/groff_mm.7.man
index 3e48cae5f..5f576f94d 100644
--- a/contrib/mm/groff_mm.7.man
+++ b/contrib/mm/groff_mm.7.man
@@ -147,7 +147,7 @@ implementation found in the AT&T Documenter's Workbench 
(DWB),
 with the following limitations.
 .
 .
-.IP \[bu] 2n
+.IP \[bu] 3n
 Omitted features include
 the logo and company name strings,
 .B }Z
@@ -171,7 +171,7 @@ and
 macros.
 .
 .
-.IP \[bu] 2n
+.IP \[bu]
 The
 .B CS
 (output cover sheet)
@@ -588,7 +588,7 @@ published interface but are documented aspects of
 .I groff mm.
 .
 .
-.TP
+.TP 8n \" "COVEND" + 2n
 .BI )E\  "level text"
 Add heading text
 .I text
@@ -3933,7 +3933,7 @@ localizable text.
 These are presented in quotation marks.
 .
 .
-.TP
+.TP 8n \" "Apptxt" + 2n
 .B App
 \[lq]APPENDIX\[rq]
 .
diff --git a/man/groff.7.man b/man/groff.7.man
index e239d8f4b..9d1887b43 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -55,7 +55,7 @@ language reference
 .\" start a macro, escape sequence, or register definition
 .
 .de TPx
-.  TP 10n
+.  TP 11n \" ".linetabs" + 2n
 ..
 .\" ====================================================================
 .\" .Text anything ...
@@ -362,10 +362,16 @@ requirements.
 Several input characters are syntactically significant to
 .IR groff .
 .
+The most important of these distinguish
+.I "control lines,"
+which instruct the formatter,
+from
+.I "text lines"
+that are formatted as output.
+.
 .
 .IP . 4n
-A dot at the beginning of an input line marks it as a
-.I control line.
+A dot at the beginning of an input line marks it as a control line.
 .
 It can also follow the
 .request .el
@@ -500,13 +506,12 @@ but trailing spaces on text lines are ignored.
 .\" slack text for widow/orphan control: trailing tabs are not
 .
 .
-.TP 8n
+.TP 9n \" "newline" + 2n
 .I space
-Space characters separate arguments in request invocations,
-macro calls,
-and string interpolations.
+On control lines and within bracketed escape sequences,
+spaces separate arguments.
 .
-In text,
+On text lines,
 they separate words.
 .
 Multiple adjacent space characters in text cause
@@ -544,8 +549,8 @@ see section \[lq]Escape sequences\[rq] below.
 .
 .TP
 .I newline
-In text,
-a newline puts an inter-word space onto the output and,
+On text lines,
+a newline formats an inter-word space and,
 if filling is enabled,
 triggers end-of-sentence recognition on the preceding text.
 .
@@ -554,8 +559,8 @@ See section \[lq]Line continuation\[rq] below.
 .
 .TP
 .I tab
-A tab character in text causes the drawing position to advance to the
-next defined tab stop.
+A tab character on a text line causes the drawing position to advance to
+the next defined tab stop.
 .
 .
 .\" ====================================================================
@@ -1817,7 +1822,7 @@ prohibit many delimiters.
 .
 .
 .RS
-.IP \[bu] 2n
+.IP \[bu] 3n
 the numerals 0\[en]9 and the decimal point
 .RB \[lq] . \[rq]
 .
@@ -4686,9 +4691,9 @@ or unformatted as an output comparand in a conditional 
expression.
 .
 .\" ========= spaces and fixed-width horizontal motions =========
 .
-.TP
+.TP 8n \" "\space" + 2n
 .ESC \f[I]space
-Move right one word space.
+Move right one inter-word space.
 .
 .
 .TP
@@ -7596,7 +7601,7 @@ see section \[lq]Debugging\[rq] below.
 Environments store the following information.
 .
 .
-.IP \[bu] 2n
+.IP \[bu] 3n
 a partially collected line, if any
 .
 .
diff --git a/man/groff_char.7.man b/man/groff_char.7.man
index b3ddb49e5..c928fb027 100644
--- a/man/groff_char.7.man
+++ b/man/groff_char.7.man
@@ -870,7 +870,7 @@ glyph name repertoire is presented in tabular form.
 The meanings of the columns are as follows.
 .
 .
-.TP 8n
+.TP 9n \" "Unicode" + 2n
 .B Output
 shows the glyph as it appears on the device used to render this
 document;
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 64a4471cf..33305315a 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -437,7 +437,7 @@ permits spaces in a numeric expression within parentheses,
 and offers three new operators.
 .
 .
-.TP
+.TP 8n \" "e1>?e2" +2n
 .IB e1 >? e2
 Interpolate the greater of
 .I e1
@@ -633,7 +633,7 @@ and then by symbol roughly in Unicode code point order.
 .\" order more agreeable to the development of a topic.
 .
 .
-.TP 7.5 \" sinfully obtain better pagination on typesetters
+.TP 8n \" "\s+'n'" + 2n
 .BI \[rs]A\[aq] anything \[aq]
 Interpolate 1 if
 .I anything
@@ -1342,7 +1342,7 @@ and
 .SS "New requests"
 .\" ====================================================================
 .
-.TP
+.TP 8n \" ".break" + 2n
 .BI .aln\~ "new old"
 Create alias
 .I new
@@ -2252,7 +2252,7 @@ except for the following data.
 .
 .
 .RS
-.IP \[bu] 2n
+.IP \[bu] 3n
 a partially collected line,
 if present;
 .
@@ -2586,7 +2586,7 @@ The following scanning rules are implemented.
 .
 .
 .RS
-.IP \[bu] 2n
+.IP \[bu] 3n
 A percent sign starts a comment
 (up to the end of the line)
 even if preceded by a backslash.
@@ -3827,7 +3827,7 @@ exposes more formatter state via many new read-only 
registers.
 Their names often correspond to the requests that affect them.
 .
 .
-.TP 12n
+.TP 13n \" "\n[.height]" + 2n
 .B \[rs]n[.br]
 Within a macro call,
 interpolate\~1
@@ -4776,7 +4776,7 @@ escape sequences employing these extensions if its
 option is given.
 .
 .
-.TP
+.TP 8n \" "DE h v" + 2n
 .BI Df\~ n
 Set the shade of gray used to fill geometric objects to
 .IR n ,
@@ -5692,7 +5692,7 @@ problem reports and patches are welcome.
 The following incompatibilities are known.
 .
 .
-.IP \[bu] 2n
+.IP \[bu] 3n
 The drawing position after rendering polygons is inconsistent with AT&T
 .I troff \" AT&T
 practice.
diff --git a/man/groff_font.5.man b/man/groff_font.5.man
index 4bcf6403a..bb8aebd4c 100644
--- a/man/groff_font.5.man
+++ b/man/groff_font.5.man
@@ -158,7 +158,7 @@ character and extend to the end of a line.
 Empty lines are ignored.
 .
 .
-.TP
+.TP 8n \" "vert n" + 2n
 .BI family\~ fam
 The default font family is
 .IR fam .
@@ -598,7 +598,7 @@ and the same comment syntax is supported.
 Empty lines are ignored throughout.
 .
 .
-.TP
+.TP 8n \" "name F" + 2n
 .BI name\~ F
 The name of the font
 .RI is\~ F .
diff --git a/man/groff_out.5.man b/man/groff_out.5.man
index a6b7b1e0f..8ffd6b7b6 100644
--- a/man/groff_out.5.man
+++ b/man/groff_out.5.man
@@ -1527,7 +1527,7 @@ fed into
 on the command line.
 .
 .
-.IP \[bu] 2m
+.IP \[bu] 3n
 High-resolution device
 .I ps
 .
@@ -1571,7 +1571,7 @@ to get its representation as a PostScript file, or
 to output directly to PDF.
 .
 .
-.IP \[bu] 2m
+.IP \[bu] 3n
 Low-resolution device
 .I latin1
 .
@@ -1630,7 +1630,7 @@ This output can be fed into the postprocessor
 to get a formatted text document.
 .
 .
-.IP \[bu] 2m
+.IP \[bu] 3n
 Classical style output
 .
 .
@@ -1700,11 +1700,11 @@ format is compatible with this specification except for 
the following
 features.
 .
 .
-.IP \[bu] 2m
+.IP \[bu] 3n
 The classical quasi device independence is not yet implemented.
 .
 .
-.IP \[bu] 2m
+.IP \[bu]
 The old hardware was very different from what we use today.
 .
 So the
@@ -1727,7 +1727,7 @@ modern
 .IR groff .
 .
 .
-.IP \[bu] 2m
+.IP \[bu]
 The B-spline command
 .B D\[ti]
 is correctly handled by the
@@ -1736,7 +1736,7 @@ parser, but the drawing routines aren't implemented in 
some of the
 postprocessor programs.
 .
 .
-.IP \[bu] 2m
+.IP \[bu]
 The argument of the commands
 .B s
 and
@@ -1766,7 +1766,7 @@ So conflicts with classical devices are very unlikely.
 .
 .
 .ie \n[@STUPID_DRAWING_POSITIONING]=1 \{\
-.IP \[bu] 2m
+.IP \[bu]
 The position changing after the commands
 .BR Dp ,
 .BR DP ,
@@ -1776,7 +1776,7 @@ is illogical, but as old versions of groff used this 
feature it is
 kept for compatibility reasons.
 .\}             \" @STUPID_DRAWING_POSITIONING
 .el \{\
-.IP \[bu] 2m
+.IP \[bu]
 Temporarily, there existed some confusion on the positioning after the
 .B D
 commands that are
diff --git a/man/groff_tmac.5.man b/man/groff_tmac.5.man
index 222faae5d..eba3adfc5 100644
--- a/man/groff_tmac.5.man
+++ b/man/groff_tmac.5.man
@@ -216,7 +216,7 @@ are used to format a given document,
 a wrapper is available.
 .
 .
-.TP
+.TP 8n \" "mandoc" + 2n
 .I \%andoc
 .TQ
 .I mandoc
@@ -455,7 +455,7 @@ Chinese.
 .SS "Input encodings"
 .\" ====================================================================
 .
-.TP
+.TP 8n \" "latin1" + 2n
 .I latin1
 .TQ
 .I latin2
@@ -537,7 +537,7 @@ documents.
 .\"   europs
 .\"   psatk
 .\"   psfig
-.TP
+.TP 8n \" "pdfpic" + 2n
 .I 62bit
 provides macros for addition,
 multiplication,
diff --git a/man/roff.7.man b/man/roff.7.man
index 85203a42c..7f68bb143 100644
--- a/man/roff.7.man
+++ b/man/roff.7.man
@@ -2075,7 +2075,7 @@ formatter.
 Several traditions have accrued in service of these goals.
 .
 .
-.IP \[bu] 2n
+.IP \[bu] 3n
 Follow sentence endings in the input with newlines to ease their
 recognition.
 .\" Texinfo: (@pxref{Sentences}).
@@ -2278,7 +2278,7 @@ It is also possible to have the mode automatically 
selected when a
 file is loaded into the editor.
 .
 .
-.IP \(bu 2n
+.IP \(bu 3n
 The most general method is to include file-local variables at the end of
 the file;
 we can also configure the fill column this way.
diff --git a/src/devices/grodvi/grodvi.1.man b/src/devices/grodvi/grodvi.1.man
index 1aa31bb48..3543202a7 100644
--- a/src/devices/grodvi/grodvi.1.man
+++ b/src/devices/grodvi/grodvi.1.man
@@ -500,7 +500,7 @@ show version information;
 all exit afterward.
 .
 .
-.TP
+.TP 8n
 .B \-d
 Do not use
 .I tpic
diff --git a/src/devices/grolj4/grolj4.1.man b/src/devices/grolj4/grolj4.1.man
index 622777985..4c1b6d3dd 100644
--- a/src/devices/grolj4/grolj4.1.man
+++ b/src/devices/grolj4/grolj4.1.man
@@ -755,7 +755,7 @@ show version information;
 all exit afterward.
 .
 .
-.TP
+.TP 8n \" "-d [n]" + 2n
 .BI \-c\~ num-copies
 Format
 .I num-copies
diff --git a/src/devices/gropdf/gropdf.1.man b/src/devices/gropdf/gropdf.1.man
index 6b1c3a030..ae78c74f1 100644
--- a/src/devices/gropdf/gropdf.1.man
+++ b/src/devices/gropdf/gropdf.1.man
@@ -151,7 +151,7 @@ show version information;
 all exit afterward.
 .
 .
-.TP
+.TP 8n \" "-F dir" + 2n
 .B \-d
 Include debug information as comments within the PDF.
 .
@@ -1469,7 +1469,7 @@ The following is a step-by-step font installation guide 
for
 .I gropdf.
 .
 .
-.IP \[bu] 2n
+.IP \[bu] 3n
 Convert your font to something
 .I groff
 understands.
diff --git a/src/devices/grops/grops.1.man b/src/devices/grops/grops.1.man
index 584e0b7ab..4ed8c97ea 100644
--- a/src/devices/grops/grops.1.man
+++ b/src/devices/grops/grops.1.man
@@ -166,7 +166,7 @@ show version information;
 all exit afterward.
 .
 .
-.TP
+.TP 8n \" "-F dir" + 2n
 .BI \-b\~ n
 Work around problems with spoolers,
 previewers,
@@ -1402,7 +1402,7 @@ The following is a step-by-step font installation guide 
for
 .I grops.
 .
 .
-.IP \[bu] 2n
+.IP \[bu] 3n
 Convert your font to something
 .I groff
 understands.
diff --git a/src/devices/grotty/grotty.1.man b/src/devices/grotty/grotty.1.man
index 7e47fc250..0e6d7be86 100644
--- a/src/devices/grotty/grotty.1.man
+++ b/src/devices/grotty/grotty.1.man
@@ -414,7 +414,7 @@ show version information;
 all exit afterward.
 .
 .
-.TP
+.TP 8n \" "-F dir" + 2n
 .B \-b
 Suppress the use of overstriking for bold characters in legacy output
 format.
@@ -681,7 +681,7 @@ See
 is intended only for simple documents.
 .
 .
-.IP \[bu] 2n
+.IP \[bu] 3n
 There is no support for fractional horizontal or vertical motions.
 .
 .
diff --git a/src/preproc/eqn/eqn.1.man b/src/preproc/eqn/eqn.1.man
index ca833779a..1eb3fc4a9 100644
--- a/src/preproc/eqn/eqn.1.man
+++ b/src/preproc/eqn/eqn.1.man
@@ -197,7 +197,7 @@ these may safely be ignored if you do not know \*[tx].
 Three points are worth special note. \" good, bad, and different
 .
 .
-.IP \[bu] 2n
+.IP \[bu] 3n
 GNU
 .I eqn \" GNU
 emits Presentation MathML output when invoked with the
@@ -1763,7 +1763,7 @@ show version information;
 all exit afterward.
 .
 .
-.TP
+.TP 8n \" "-M dir" + 2n
 .B \-C
 Recognize
 .B .EQ
@@ -1908,7 +1908,7 @@ degree
 does.
 .
 .
-.IP \[bu] 2n
+.IP \[bu] 3n
 .I @g@eqn
 customization parameters have no effect on generated MathML.
 .
diff --git a/src/preproc/grn/grn.1.man b/src/preproc/grn/grn.1.man
index df979c2be..cd969e89a 100644
--- a/src/preproc/grn/grn.1.man
+++ b/src/preproc/grn/grn.1.man
@@ -580,14 +580,14 @@ POLYGON@@6
 .TE
 .
 .
-.IP \[bu] 2n
+.IP \[bu] 3n
 The first line of each
 .I gremlin
 file contains either the string
-.RB \[lq] gremlinfile \[rq]
+.RB \%\[lq] gremlinfile \[rq]
 (AED)
 or
-.RB \[lq] sungremlinfile \[rq]
+.RB \%\[lq] sungremlinfile \[rq]
 (Sun/X11).
 .
 .
@@ -647,7 +647,7 @@ Lines longer than 127 characters are truncated to that 
length.
 .SS "Element specifications"
 .\" ====================================================================
 .
-.IP \[bu] 2n
+.IP \[bu] 3n
 The first line of each element contains a single decimal number giving
 the type of the element (AED) or its name (Sun/X11).
 .
@@ -722,11 +722,9 @@ nB l.
 .
 .IP
 For polygons,
-one more value,
-0,
-is valid.
-.
-It specifies a polygon with an invisible border.
+0
+is also valid:
+it specifies an invisible border.
 .
 For text,
 the brush selects a font as follows.
@@ -860,7 +858,7 @@ show version information;
 all exit afterward.
 .
 .
-.TP
+.TP 8n \" "-F dir" + 2n
 .B \-C
 Recognize
 .B .GS
diff --git a/src/preproc/pic/pic.1.man b/src/preproc/pic/pic.1.man
index 727cbc347..ce0d2b599 100644
--- a/src/preproc/pic/pic.1.man
+++ b/src/preproc/pic/pic.1.man
@@ -208,7 +208,7 @@ show version information;
 all exit afterward.
 .
 .
-.TP
+.TP 8n \" "-T dev" + 2n
 .B \-c
 Be more compatible with
 .IR tpic ;
@@ -318,6 +318,7 @@ GNU
 .I pic \" GNU
 always does this.
 .
+.
 .TP
 .BI \-T\~ dev
 Generate output for the
diff --git a/src/preproc/refer/refer.1.man b/src/preproc/refer/refer.1.man
index 210afe7c8..83e69dec5 100644
--- a/src/preproc/refer/refer.1.man
+++ b/src/preproc/refer/refer.1.man
@@ -1298,7 +1298,7 @@ The description below applies to normal evaluation,
 except where otherwise specified.
 .
 .
-.TP
+.TP 8n \" "expr-n" + 2n
 .I field
 .TQ
 .I field\~n
diff --git a/src/preproc/soelim/soelim.1.man b/src/preproc/soelim/soelim.1.man
index 4a1c04296..ea13da6ad 100644
--- a/src/preproc/soelim/soelim.1.man
+++ b/src/preproc/soelim/soelim.1.man
@@ -379,7 +379,7 @@ show version information;
 all exit afterward.
 .
 .
-.TP
+.TP 8n \" "-I dir" + 2n
 .B \-C
 Recognize an input line starting with
 .B .so
@@ -389,13 +389,12 @@ even if a character other than a space or newline follows.
 .BI \-I\~ dir
 Search the directory
 .I dir
-path for
+for
 .I input-
 and
 .I included-files.
 .
-.B \-I
-may be specified more than once;
+If specified more than once,
 each
 .I dir
 is searched in the given order.
diff --git a/src/preproc/tbl/tbl.1.man b/src/preproc/tbl/tbl.1.man
index 40e7fa94b..850b55b92 100644
--- a/src/preproc/tbl/tbl.1.man
+++ b/src/preproc/tbl/tbl.1.man
@@ -246,7 +246,7 @@ region options makes a table \[lq]boxed\[rq] for the 
purpose of later
 discussion.
 .
 .
-.TP
+.TP 8n \" "allbox" + 2n
 .B allbox
 Enclose each table entry in a box;
 implies
@@ -1066,7 +1066,7 @@ do not persist between entries.
 Several forms of table entry are interpreted specially.
 .
 .
-.IP \[bu] 2n
+.IP \[bu] 3n
 If a table row contains only an underscore or equals sign
 .RB ( _
 or
@@ -1076,7 +1076,7 @@ respectively,
 is drawn across the table at that point.
 .
 .
-.IP \[bu] 2n
+.IP \[bu]
 A table entry containing only
 .B _
 or
@@ -1088,7 +1088,7 @@ joining its
 neighbors.
 .
 .
-.IP \[bu] 2n
+.IP \[bu]
 Prefixing a lone underscore or equals sign with a backslash also has
 meaning.
 .
@@ -1398,7 +1398,7 @@ removes constraints endured by users of AT&T
 .IR tbl .\" AT&T
 .
 .
-.IP \[bu] 2n
+.IP \[bu] 3n
 Region options can be specified in any lettercase.
 .
 .
diff --git a/src/roff/groff/groff.1.man b/src/roff/groff/groff.1.man
index 7b3b9a7e3..cc72e8a82 100644
--- a/src/roff/groff/groff.1.man
+++ b/src/roff/groff/groff.1.man
@@ -223,12 +223,13 @@ or are interpreted differently by
 .IR groff .
 .
 .
-.TP
+.TP 8n \" "-D enc" + 2n
 .BI \-D\~ enc
-Set fallback input encoding used by
-.MR preconv @MAN1EXT@
-to
-.IR enc ;
+Use
+.I enc
+as
+.MR preconv @MAN1EXT@ 's
+fallback input encoding;
 implies
 .BR \-k .
 .
@@ -536,7 +537,7 @@ The following options are passed as-is to the formatter 
program
 and described in more detail in its man page.
 .
 .
-.TP
+.TP 8n \" "-f fam" + 2n
 .B \-a
 Generate a plain text approximation of the typeset output.
 .
diff --git a/src/roff/troff/troff.1.man b/src/roff/troff/troff.1.man
index 17c5713af..eeeb4e42b 100644
--- a/src/roff/troff/troff.1.man
+++ b/src/roff/troff/troff.1.man
@@ -152,7 +152,7 @@ show version information;
 all exit afterward.
 .
 .
-.TP
+.TP 8n \" "-f fam" + 2n
 .B \-a
 Generate a plain text approximation of the typeset output.
 .
@@ -164,7 +164,7 @@ This option produces a sort of abstract preview of the 
formatted output.
 .
 .
 .RS
-.IP \[bu] 2n
+.IP \[bu] 3n
 Page breaks are marked by a phrase in angle brackets;
 for example,
 \[lq]<beginning of page>\[rq].
diff --git a/src/utils/indxbib/indxbib.1.man b/src/utils/indxbib/indxbib.1.man
index df02fccda..14b3ad161 100644
--- a/src/utils/indxbib/indxbib.1.man
+++ b/src/utils/indxbib/indxbib.1.man
@@ -171,7 +171,7 @@ show version information;
 all exit afterward.
 .
 .
-.TP
+.TP 8n \" "-d dir" + 2n
 .BI \-c\~ common-words-file
 Read the list of common words from
 .I common-words-file
diff --git a/tmac/groff_man.7.man.in b/tmac/groff_man.7.man.in
index 6e59cdd3a..3e4ef4e8f 100644
--- a/tmac/groff_man.7.man.in
+++ b/tmac/groff_man.7.man.in
@@ -960,7 +960,7 @@ are
 .
 .RS \" Invisibly move left margin to current .IP indentation.
 .RS 4n \" Now indent further, visibly.
-.IP (1) 4n
+.IP (1) 5n \" "(1)" + 3n
 to start a new paragraph with the same indentation as an immediately
 preceding
 .B .IP
@@ -1197,7 +1197,7 @@ produces the following output.
 Several features of the above example are of note.
 .
 .
-.IP \(bu 2n
+.IP \(bu 3n
 The empty request (.),
 which does nothing,
 is used to vertically space the input file for readability by the
@@ -3366,7 +3366,7 @@ reader preferences,
 man pages should never manipulate them.
 .
 .
-.TP
+.TP 8n \" "-rcR=1" + 2n
 .BI \-dAD= adjustment-mode
 Set line adjustment to
 .I adjustment-mode,
diff --git a/tmac/groff_www.7.man b/tmac/groff_www.7.man
index 599c3b7d5..ba898118e 100644
--- a/tmac/groff_www.7.man
+++ b/tmac/groff_www.7.man
@@ -470,7 +470,7 @@ For example:
 .
 .
 .TP
-.B .HnS n
+.BI .HnS\~ n
 Begin heading.
 .
 The numeric heading level



reply via email to

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