[groff] 11/32: groff_out(5): Fix content nits.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 0a18a0419234890b07d174fcca29508f34e9792b
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sat Jun 17 17:19:55 2023 -0500

    groff_out(5): Fix content nits.
    
    Content:
    * We're documenting a file format, so speak in terms of characters
      rather than "line breaks".
    * Synopsize both forms of `u` command, for parity with `t`.
    * Stop offering the *roff language scaling unit to explicate basic
      units; all quantities in troff output are in basic units except where
      noted and the reader must be aware of this.  There is no need to offer
      the scaling unit as a "reminder" as is done with scaled and unscaled
      points, which come up in the presentation of the `s` command.
    
    Style:
    * Tighten wording.
---
 man/groff_out.5.man | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/man/groff_out.5.man b/man/groff_out.5.man
index 13412428a..732aa433b 100644
--- a/man/groff_out.5.man
+++ b/man/groff_out.5.man
@@ -722,7 +722,7 @@ see section \[lq]Compatibility\[rq] below.
 .command t xyz\f[R]\|.\|.\|.\& \f[R]\[la]white-space\[ra]
 .TQ
 .command t "xyz\f[R]\|.\|.\|.\&\f[] dummy-arg" \[la]white-space\[ra]
-Typeset a word
+Typeset word
 .IR xyz ;
 that is,
 set a sequence of ordinary glyphs named
@@ -730,7 +730,7 @@ set a sequence of ordinary glyphs named
 .IR y ,
 .IR z ,
 \&.\|.\|.\|,
-terminated by a space character or a line break;
+terminated by a space or newline;
 an optional second integer argument is ignored
 (this allows the formatter to generate an even number of arguments).
 .\" XXX: Why?
@@ -742,7 +742,8 @@ A glyph's width is read from its metrics in the font 
description file,
 scaled to the current type size,
 and rounded to a multiple of the horizontal motion quantum.
 .
-Only ordinary characters can be set using this command;
+Only ordinary characters can be set with
+.BR t ;
 use the
 .B C
 command to emplace special characters.
@@ -761,7 +762,9 @@ see
 .
 .
 .TP
-.command u xyz\f[R]\|.\|.\|.\& \f[R]\[la]white-space\[ra]
+.command u "n xyz"\f[R]\|.\|.\|.\& \f[R]\[la]white-space\[ra]
+.TQ
+.command u "xyz\f[R]\|.\|.\|.\&\f[] dummy-arg" \[la]white-space\[ra]
 Typeset word
 .I xyz
 with track kerning.
@@ -771,8 +774,7 @@ As
 but after placing each glyph,
 the drawing position is further advanced horizontally
 .RI by\~ n
-basic units
-.RB ( u ).
+basic units.
 .
 The
 .BR u \~command