gbranden pushed a commit to branch master
in repository groff.
commit 038d8f1ec3c01cc17bffdf7624fd22dd0dd473f2
Author: G. Branden Robinson <[email protected]>
AuthorDate: Wed Aug 16 01:08:23 2023 -0500
[man pages]: Fix style and markup nits.
* Set example in `EX`/`EE` to get a monospaced font family on
typesetters.
* Tighten wording.
* Adjust tagged paragraph indentation in "Options" lists to buy back
space, in one case an entire page due to a stranded line.
* Protect literals from hyphenation.
---
src/devices/grodvi/grodvi.1.man | 2 +-
src/preproc/eqn/eqn.1.man | 7 ++++---
src/preproc/grn/grn.1.man | 15 ++++++++++-----
src/roff/groff/groff.1.man | 25 +++++++++++--------------
4 files changed, 26 insertions(+), 23 deletions(-)
diff --git a/src/devices/grodvi/grodvi.1.man b/src/devices/grodvi/grodvi.1.man
index c9a5f0875..e748793fa 100644
--- a/src/devices/grodvi/grodvi.1.man
+++ b/src/devices/grodvi/grodvi.1.man
@@ -404,7 +404,7 @@ the ordering of dimensions differs from that used by
.I papersize.tmac
and
.MR @g@troff @MAN1EXT@ 's
-.RB \[lq] "\-d paper" \[rq]
+.RB \[lq] "\-d \%paper" \[rq]
option.
.
.
diff --git a/src/preproc/eqn/eqn.1.man b/src/preproc/eqn/eqn.1.man
index 1eb3fc4a9..b8b30f6e0 100644
--- a/src/preproc/eqn/eqn.1.man
+++ b/src/preproc/eqn/eqn.1.man
@@ -1763,7 +1763,7 @@ show version information;
all exit afterward.
.
.
-.TP 8n \" "-M dir" + 2n
+.TP 8.125n \" "-M dir" + 2n + hand-tuned for PDF
.B \-C
Recognize
.B .EQ
@@ -2132,8 +2132,9 @@ delim off
.
.
.P
-The quadratic formula illustrates use of fractions and radicals,
-and affords an opportunity to use the full space token
+The quadratic formula affords an opportunity to use fractions,
+radicals,
+and the full space token
.BR \[ti] .
.
.
diff --git a/src/preproc/grn/grn.1.man b/src/preproc/grn/grn.1.man
index cd969e89a..5ae394332 100644
--- a/src/preproc/grn/grn.1.man
+++ b/src/preproc/grn/grn.1.man
@@ -554,6 +554,7 @@ Files representing the same picture are shown below.
.
.
.PP
+.EX
.ie t .ne 18v
.el .ne 19v
.TS
@@ -578,6 +579,7 @@ POLYGON@@6
0@@0
\-1@@\-1
.TE
+.EE
.
.
.IP \[bu] 3n
@@ -682,11 +684,14 @@ AED Number@Sun/X11 Name@Description
.
.
.IP \[bu]
-After the object type comes a variable number of lines,
-each specifying a point used to display the element.
+Each line after the object type specifies a point used to display the
+element.
.
-Each line contains an x-coordinate and a y-coordinate in floating-point
-format,
+It contains an
+.I x
+and a
+.I y
+coordinate in floating-point format,
separated by spaces.
.
The list of points is terminated by a line containing the string
@@ -858,7 +863,7 @@ show version information;
all exit afterward.
.
.
-.TP 8n \" "-F dir" + 2n
+.TP 8.125n \" "-F dir" + 2n + hand-tuned for PDF
.B \-C
Recognize
.B .GS
diff --git a/src/roff/groff/groff.1.man b/src/roff/groff/groff.1.man
index a7cc50596..240cc9396 100644
--- a/src/roff/groff/groff.1.man
+++ b/src/roff/groff/groff.1.man
@@ -907,23 +907,20 @@ groff \-Tps \-dpaper=a4l \-P\-pa4 \-P\-l \-ms foo.ms >
foo.ps
.
The
.I groff
-program is a wrapper around the
-.MR @g@troff @MAN1EXT@
-program.
-.
-It allows one to specify preprocessors via command-line options and
-automatically runs the appropriate postprocessor for the selected
-output device.
+program wraps
+.MR @g@troff @MAN1EXT@ ,
+allowing one to specify preprocessors via command-line options and
+running the appropriate output driver for the selected output device.
.
-Doing so,
+This convenience avoids
the manual construction of pipelines or management of temporary files
required of users of traditional
.MR roff @MAN7EXT@
-systems can be avoided.
+systems.
.
-Use the
+Use
.MR grog @MAN1EXT@
-program to infer an appropriate
+to infer an appropriate
.I groff
command line to format a document.
.
@@ -956,7 +953,7 @@ can be found in
GNU
.I roff
extensions to the AT&T
-.I troff
+.I troff \" AT&T
language,
a common subset of
.I roff
@@ -1253,7 +1250,7 @@ It can be specified on the command line as
.
A
.MR man 1
-librarian program \" such as man-db, since 2001
+librarian \" such as man-db, since 2001
may use this macro file to delegate loading of the correct macro
package;
it is thus unnecessary for
@@ -1902,7 +1899,7 @@ systems are best known for formatting man pages.
.
Once a
.MR man 1
-librarian program has located a man page,
+librarian has located a man page,
it may execute a
.I groff
command much like the following.
_______________________________________________
Groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
