[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]
.
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 37/122: [man pages]: Use empty requests consistently.,
G. Branden Robinson <=