[Top][All Lists]

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

[groff] 09/35: groff(7): Fix content and style nits.

From: G. Branden Robinson
Subject: [groff] 09/35: groff(7): Fix content and style nits.
Date: Fri, 15 Jul 2022 23:11:57 -0400 (EDT)

gbranden pushed a commit to branch master
in repository groff.

commit 6c9ad16e865e1c6214cfe0ad6507e30d1ca79ab0
Author: G. Branden Robinson <>
AuthorDate: Fri Jul 8 18:00:12 2022 -0500

    groff(7): Fix content and style nits.
    * Refer to "troff" and "nroff" commands using the configured prefix.
    * Add thousands separator to numeric literal in prose.
    * Recast discussion of underlining to alleviate anguished English.
 man/ | 79 +++++++++++++++++++++------------------------------------
 1 file changed, 29 insertions(+), 50 deletions(-)

diff --git a/man/ b/man/
index 0f844d4c..1206ea41 100644
--- a/man/
+++ b/man/
@@ -4696,7 +4696,7 @@ results from request calls.
 .REG $$
 The process ID of
-.BR troff .
+.IR @g@troff .
 .REG .$
@@ -4710,11 +4710,11 @@ Post-line extra line-space most recently utilized using
 .REG .A
 Set to\~1 in
-.B troff
+.I @g@troff
 if option
 .option \-A
 is used; always\~1 in
-.BR nroff .
+.IR @g@nroff .
 .REG .b
@@ -5013,7 +5013,7 @@ The current post-vertical line spacing.
 .REG .R
 The count of available unused registers;
-always 10000 in GNU
+always 10,000 in GNU
 .IR troff . \" GNU
@@ -5999,63 +5999,42 @@ copies a named environment's contents to the current 
 .SH Underlining
 .\" ====================================================================
-In the
-language, the underlining was quite easy.
-But in
-.I roff
-this is much more difficult.
+.MR roff @MAN7EXT@ ),
+even of lengthy passages,
+was straightforward because only fixed-pitch printing devices were
-.\" ====================================================================
-.SS "Underlining with .ul"
-.\" ====================================================================
+Typesetter output posed a greater challenge.
 There exists a
 .I groff
 .B .ul
-(see above) that can underline the next or further source lines in
-.BR nroff ,
-but in
-.B troff
-it produces only a font change into
-.IR italic .
+(see above)
+that underlines subsequent source lines on terminal devices,
+but on typesetters,
+it selects an italic font style instead.
-So this request is not really useful.
-.\" ====================================================================
-.SS "Underlining with .UL from \f[I]ms\f[]"
-.\" ====================================================================
-In the \[oq]ms\[cq] macro package in tmac/s.tmac
-.MR groff_ms @MAN7EXT@ ,
-there is the macro
-.BR .UL .
-But this works only in
-.BR troff ,
-not in
-.BR nroff .
+.I ms
+macro package
+.MR groff_ms @MAN7EXT@ )
+offers a macro
+.BR .UL ,
+but it too produces the desired effect only on typesetters,
+and has other limitations.
-.\" ====================================================================
-.SS "Underlining macro definitions"
-.\" ====================================================================
-So one can use the
-.I italic
-.B nroff
-idea from
-.B .ul
-and the
-.B troff
-.I ms
-for writing a useful new macro, something like
+One could adapt
+.I ms 's
+approach to the construction of a macro as follows.

reply via email to

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