groff-commit
[Top][All Lists]
Advanced

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

[groff] 37/122: [man pages]: Use empty requests consistently.


From: G. Branden Robinson
Subject: [groff] 37/122: [man pages]: Use empty requests consistently.
Date: Wed, 11 Nov 2020 02:59:14 -0500 (EST)

gbranden pushed a commit to branch master
in repository groff.

commit 8cc7790f55eb6d695b804fa3fca4e47f868f5b76
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sun Nov 8 11:38:02 2020 +1100

    [man pages]: Use empty requests consistently.
    
    * man/groff.7.man:
    * man/groff_font.5.man:
    * src/preproc/pic/pic.1.man:
    * src/preproc/soelim/soelim.1.man:
    * src/preproc/tbl/tbl.1.man:
    * src/roff/grog/grog.1.man:
    * src/roff/troff/troff.1.man:
    * src/utils/hpftodit/hpftodit.1.man:
    * src/utils/indxbib/indxbib.1.man:
    * src/utils/lookbib/lookbib.1.man:
    * tmac/groff_trace.7.man:
      Use an empty request between sentences.  Use two empty requests where
      inter-paragraph space is expected.
---
 man/groff.7.man                   |  1 +
 man/groff_font.5.man              |  4 ++++
 src/preproc/pic/pic.1.man         | 39 +++++++++++++++++++++++++++++++++++++++
 src/preproc/soelim/soelim.1.man   |  2 ++
 src/preproc/tbl/tbl.1.man         |  2 ++
 src/roff/grog/grog.1.man          |  2 ++
 src/roff/troff/troff.1.man        |  1 +
 src/utils/hpftodit/hpftodit.1.man |  3 +++
 src/utils/indxbib/indxbib.1.man   | 12 ++++++++++++
 src/utils/lookbib/lookbib.1.man   |  1 +
 tmac/groff_trace.7.man            |  4 ++++
 11 files changed, 71 insertions(+)

diff --git a/man/groff.7.man b/man/groff.7.man
index a80789c..1f26513 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -5047,6 +5047,7 @@ t after
 .ft R
 .RE
 .
+.
 .\" ====================================================================
 .SH Compatibility
 .\" ====================================================================
diff --git a/man/groff_font.5.man b/man/groff_font.5.man
index 9a121ce..2b63820 100644
--- a/man/groff_font.5.man
+++ b/man/groff_font.5.man
@@ -124,6 +124,7 @@ Under GNU/Linux this is usually
 but under other systems (notably cygwin) it might be set to another
 name.
 .
+.
 .TP
 .BI "paperlength " n
 The physical vertical dimension of the output medium in machine units.
@@ -139,6 +140,7 @@ Use
 .B papersize
 instead.
 .
+.
 .TP
 .BI "papersize " string
 Select a paper size.
@@ -204,6 +206,7 @@ More than one argument can be specified;
 .I groff
 scans from left to right and uses the first valid paper specification.
 .
+.
 .TP
 .BI "paperwidth " n
 The physical horizontal dimension of the output medium in machine units.
@@ -219,6 +222,7 @@ This isn't used by
 itself,
 but by output devices.
 .
+.
 .TP
 .B pass_filenames
 Make troff tell the driver the source file name being processed.
diff --git a/src/preproc/pic/pic.1.man b/src/preproc/pic/pic.1.man
index b3941ca..26d1bbf 100644
--- a/src/preproc/pic/pic.1.man
+++ b/src/preproc/pic/pic.1.man
@@ -144,6 +144,7 @@ Be more compatible with
 .
 Implies
 .BR \-t .
+.
 Lines beginning with
 .B \[rs]
 are not passed through transparently.
@@ -308,11 +309,15 @@ You must yourself print that vbox using, for example, the 
command
 Actually, since the vbox has a height of zero (it is defined with
 \[rs]vtop) this will produce slightly more vertical space above the
 picture than below it;
+.
+.
 .RS
 .LP
 .B
 \[rs]centerline{\[rs]raise 1em\[rs]box\[rs]graph}
 .RE
+.
+.
 .LP
 would avoid this.
 .
@@ -322,12 +327,16 @@ To make the vbox having a positive height and a depth of 
zero
 (as used e.g., by \*[lx]'s
 .BR \%graphics.sty ),
 define the following macro in your document:
+.
+.
 .RS
 .LP
 .B \[rs]def\[rs]gpicbox#1{%
 .br
 .B "   \[rs]vbox{\[rs]unvbox\[rs]csname #1\[rs]endcsname\[rs]kern 0pt}}
 .RE
+.
+.
 .LP
 Now you can simply say
 .B \[rs]gpicbox{graph}
@@ -505,12 +514,14 @@ to a shell.
 can be any character not occurring in
 .IR command .
 .
+.
 .TP
 \fBcopy\fR \fB"\,\fIfilename\/\fB"\fR
 Include
 .I filename
 at this point in the file.
 .
+.
 .TP
 .BR copy\~ [ \[dq]\c
 .IB filename \[dq]\c
@@ -620,6 +631,7 @@ Assigning a value to
 also causes all pre-defined variables that control dimensions to be
 reset to their default values times the new value of scale.
 .
+.
 .TP
 \fBplot\fR \fIexpr\fR [\fB"\,\fItext\*(ic\fB"\fR]
 This is a text object which is constructed by using
@@ -639,6 +651,7 @@ object.
 Be very careful that you specify an appropriate format string;
 .I \%@g@pic
 does only very limited checking of the string.
+.
 This is deprecated in favour of
 .BR sprintf .
 .
@@ -829,6 +842,8 @@ these have values 8.5 and 11.
 .LP
 Scientific notation is allowed for numbers.
 For example
+.
+.
 .RS
 .LP
 .B
@@ -840,11 +855,14 @@ x = 5e\-2
 Text attributes can be compounded.
 .
 For example,
+.
 .RS
 .LP
 .B
 "foo" above ljust
 .RE
+.
+.
 .LP
 is valid.
 .
@@ -861,6 +879,8 @@ For example,
 .B
 circle at last [\^].A.B.C
 .RE
+.
+.
 .LP
 is acceptable.
 .
@@ -958,8 +978,12 @@ have a value of 0.
 .LP
 In (almost all) places where a quoted text string can be used,
 an expression of the form
+.
+.
 .IP
 .BI sprintf(\[dq] format \[dq],\  arg ,\fR.\|.\|.\fB)
+.
+.
 .LP
 can also be used;
 this will produce the arguments formatted according to
@@ -967,6 +991,7 @@ this will produce the arguments formatted according to
 which should be a string as described in
 .IR printf (3)
 appropriate for the number of arguments supplied.
+.
 Only the flags
 .RB \[lq] # \[rq],
 .RB \[lq] \- \[rq],
@@ -1013,10 +1038,14 @@ There is also a
 attribute.
 .
 For example,
+.
+.
 .RS
 .LP
 .B circle thickness 1.5
 .RE
+.
+.
 .LP
 would draw a circle using a line with a thickness of 1.5 points.
 .
@@ -1068,6 +1097,8 @@ the fill color, and
 sets both.
 .
 All three keywords expect a suffix specifying the color, for example
+.
+.
 .RS
 .LP
 .B circle shaded """green""" outline """black"""
@@ -1264,16 +1295,24 @@ Moreover, the PostScript interpreter
 .B ghostscript
 .RI ( gs (1))
 has built-in graphics conversion devices that are called with the option
+.
+.
 .LP
 .RS
 .BI "gs \-sDEVICE=" <devname>
 .RE
+.
+.
 .LP
 Call
+.
+.
 .LP
 .RS
 .B gs \-\-help
 .RE
+.
+.
 .LP
 for a list of the available devices.
 .
diff --git a/src/preproc/soelim/soelim.1.man b/src/preproc/soelim/soelim.1.man
index 1d5635e..ad9a9ce 100644
--- a/src/preproc/soelim/soelim.1.man
+++ b/src/preproc/soelim/soelim.1.man
@@ -326,6 +326,7 @@ at the appropriate place.
 .IP
 No directory search is performed for files with an absolute file name.
 .
+.
 .TP
 .B \-r
 Do not add
@@ -336,6 +337,7 @@ with
 .RI non- groff
 files).
 .
+.
 .TP
 .B \-t
 Emit \*[tx] comment lines starting with
diff --git a/src/preproc/tbl/tbl.1.man b/src/preproc/tbl/tbl.1.man
index cf73002..bcdcc27 100644
--- a/src/preproc/tbl/tbl.1.man
+++ b/src/preproc/tbl/tbl.1.man
@@ -1010,6 +1010,8 @@ an \[oq]end-of-macro\[cq] macro.
 Additionally, the escape character has to be switched off.
 .
 Here an example.
+.
+.
 .IP
 .EX
 \&.eo
diff --git a/src/roff/grog/grog.1.man b/src/roff/grog/grog.1.man
index 32a47fc..c6c7ca7 100644
--- a/src/roff/grog/grog.1.man
+++ b/src/roff/grog/grog.1.man
@@ -140,11 +140,13 @@ within the generated
 .B groff
 command line.
 .
+.
 .TP
 .B \-\-run
 with this option, the command line is output at standard error and
 then run on the computer.
 .
+.
 .TP
 .B \-\-warnings
 with this option, some more warnings are output to standard error.
diff --git a/src/roff/troff/troff.1.man b/src/roff/troff/troff.1.man
index 7e1b5d4..43f2d75 100644
--- a/src/roff/troff/troff.1.man
+++ b/src/roff/troff/troff.1.man
@@ -696,6 +696,7 @@ The main program of the
 system, a wrapper around
 .IR @g@troff .
 .
+.
 .TP
 .BR groff (@MAN7EXT@)
 A description of the
diff --git a/src/utils/hpftodit/hpftodit.1.man 
b/src/utils/hpftodit/hpftodit.1.man
index 1350c97..a797257 100644
--- a/src/utils/hpftodit/hpftodit.1.man
+++ b/src/utils/hpftodit/hpftodit.1.man
@@ -329,6 +329,7 @@ and
 .I output-font
 is ignored if given.
 .
+.
 .TP
 .BI \-i\~ n
 Generate an italic correction for each character so that the character's
@@ -360,6 +361,7 @@ The left italic correction may be negative.
 This option normally is needed only with italic or oblique fonts;
 a value of 50 (0.05\~em) usually is a reasonable choice.
 .
+.
 .TP
 .B \-q
 Suppress warnings about characters in the map file that were not found
@@ -388,6 +390,7 @@ Without the
 option,
 the \[lq]text\[rq] sets are searched before the \[lq]mathematical\[rq]
 symbol sets.
+.
 With the
 .B \-s
 option,
diff --git a/src/utils/indxbib/indxbib.1.man b/src/utils/indxbib/indxbib.1.man
index 55b8a47..d566dbc 100644
--- a/src/utils/indxbib/indxbib.1.man
+++ b/src/utils/indxbib/indxbib.1.man
@@ -140,6 +140,7 @@ and
 show version information;
 all exit afterward.
 .
+.
 .TP
 .BI \-c\~ file
 Read the list of common words from
@@ -147,6 +148,7 @@ Read the list of common words from
 instead of
 .IR \%@COMMON_WORDS_FILE@ .
 .
+.
 .TP
 .BI \-d\~ dir
 Use
@@ -175,6 +177,7 @@ The
 .B \-f
 option can be given at most once.
 .
+.
 .TP
 .BI \-i\~ string
 Don't index the contents of fields whose names are in
@@ -185,6 +188,7 @@ Initially,
 is
 .BR XYZ .
 .
+.
 .TP
 .BI \-h\~ n
 Use the first prime greater than or equal to
@@ -203,6 +207,7 @@ Initially,
 .I n
 is 997.
 .
+.
 .TP
 .BI \-k\~ n
 Use at most
@@ -213,6 +218,7 @@ Initially,
 .I n
 is 100.
 .
+.
 .TP
 .BI \-l\~ n
 Discard keys that are shorter than
@@ -222,6 +228,7 @@ Initially,
 .I n
 is 3.
 .
+.
 .TP
 .BI \-n\~ n
 Discard the
@@ -232,11 +239,13 @@ Initially,
 .I n
 is 100.
 .
+.
 .TP
 .BI \-o\~ basename
 The index should be named
 .RI basename @INDEX_SUFFIX@ .
 .
+.
 .TP
 .BI \-t\~ n
 Truncate keys to
@@ -262,14 +271,17 @@ Each file is a separate record.
 .RI \%filename @INDEX_SUFFIX@
 Index.
 .
+.
 .TP
 .I \%@DEFAULT_INDEX_NAME@@INDEX_SUFFIX@
 Default index name.
 .
+.
 .TP
 .I \%@COMMON_WORDS_FILE@
 List of common words.
 .
+.
 .TP
 .IR \%indxbib XXXXXX
 Temporary file.
diff --git a/src/utils/lookbib/lookbib.1.man b/src/utils/lookbib/lookbib.1.man
index d760cae..077f4a2 100644
--- a/src/utils/lookbib/lookbib.1.man
+++ b/src/utils/lookbib/lookbib.1.man
@@ -106,6 +106,7 @@ ignore the contents of fields whose names are in
 Only require the first
 .I n
 characters of keys to be given.
+.
 Initially,
 .I n
 is\~6.
diff --git a/tmac/groff_trace.7.man b/tmac/groff_trace.7.man
index e5f33e3..7cb731b 100644
--- a/tmac/groff_trace.7.man
+++ b/tmac/groff_trace.7.man
@@ -306,19 +306,23 @@ You can browse it interactively with \[lq]info groff\[rq].
 .BR groff (@MAN1EXT@)
 An overview of the groff system.
 .
+.
 .TP
 .BR troff (@MAN1EXT@)
 For details on option
 .BR \-m .
 .
+.
 .TP
 .BR groff_tmac (@MAN5EXT@)
 A general description of groff macro packages.
 .
+.
 .TP
 .BR groff (@MAN7EXT@)
 A short reference for the groff formatting language.
 .
+.
 .\" Restore compatibility mode (for, e.g., Solaris 10/11).
 .cp \n[*groff_groff_trace_7_man_C]
 .



reply via email to

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