[Top][All Lists]

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

[groff] 01/01: groff_out(5): Fix content, style, and markup nits.

From: G. Branden Robinson
Subject: [groff] 01/01: groff_out(5): Fix content, style, and markup nits.
Date: Mon, 8 May 2023 21:36:53 -0400 (EDT)

gbranden pushed a commit to branch master
in repository groff.

commit 51a03db0d768b55320023a5750db3b8759c7ca37
Author: G. Branden Robinson <>
AuthorDate: Mon May 8 15:35:25 2023 -0500

    groff_out(5): Fix content, style, and markup nits.
    * Say "break" instead of "line break".
    * Say "GNU troff" instead of "groff" where we are specifically
      describing the formatter's behavior.
    * Clarify that "w" command applies only to "normal" inter-word spaces.
    * Simplify internal cross references to other commands.
    * Clarify contextuality of positioning, writing, and drawing commands.
    * Drop unnecessary macro agument quotation.
    * Fix missing input line break after macro call.
 man/ | 40 +++++++++++++++++++++++-----------------
 1 file changed, 23 insertions(+), 17 deletions(-)

diff --git a/man/ b/man/
index bc5662fb9..e2555a8f2 100644
--- a/man/
+++ b/man/
@@ -616,7 +616,7 @@ black in most cases).
-.command mg "gray"
+.command mg gray
 Use a grayscale color scheme with a component ranging
 between 0 (black) and \n[@maxcolor] (white).
@@ -645,7 +645,8 @@ Typeset the glyph with
 .RI index\~ n
 in the current font.
-.IR n\~ is normally a non-negative integer.
+.IR n\~ is
+normally a non-negative integer.
 The drawing position is not advanced.
@@ -662,8 +663,8 @@ is taken and interpreted in basic units.
-.command n b\ a
-Describe a line break.
+.command n b\~a
+Describe a break.
 In AT&T
 .IR troff ,
@@ -674,13 +675,14 @@ describe the vertical space amounts before and after the 
 to make the output more readable by humans.
-.I groff
+.I troff \" GNU
 reports these values but its output driver library ignores them.
-Vertical space is applied with
-.B V
-.RB or\~ v
+.B v
+.BR V .
@@ -696,10 +698,10 @@ The vertical drawing position is set to\~0.
 All positioning,
-and drawing command are done in the context of a page,
+and drawing commands are interpreted in the context of a page,
 so a
 .BR p \~command
-must precede any of these.
+must precede them.
@@ -818,15 +820,19 @@ output driver library handles them.
 .command w
-Describe an adjustable space.
+Describe an inter-word space.
 This performs no action;
-it is present for documentary purposes.
+it is present to make the output more readable by humans.
-Horizontal space is applied with
-.B H
-.RB or\~ h
+Only adjustable,
+breakable inter-word spaces are thus described;
+those resulting from horizontal motion escape sequences are not.
+.B h
+.BR H .
 .\" ====================================================================

reply via email to

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