[groff] 18/18: grotty(1): Fix style nits.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit e72a7230d74cfa396662d3eb9b8b7ae497eaa73f
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Tue Jul 25 01:33:02 2023 -0500

    grotty(1): Fix style nits.
    
    * Use thin space escape sequences around disjunctive option notation in
      synopsis (in other words, don't crowd a '|' when typesetting).
    * Use phrasal metasyntactic variable names in synopsis, for parity with
      usage message.  (Terser ones can be used in "Options" sections, where
      the meaning of the variable is immediately made clear.)
    * Note availability of `device` request.
    * Drop caveat about "characters above the first line [not being]
      rendered".  This is true in general, that is, of all output devices.
      (At the very least, such characters won't be _fully_ rendered, because
      they'll lie partially or wholly off the page.)
    * Fix bad use of phrasal hyphen.
    * Hyperlink reference to ECMA-48.
    * Protect "Ecma" from hyphenation.
    * Drop inapposite use of nonbreaking space.
---
 src/devices/grotty/grotty.1.man | 36 ++++++++++++++++--------------------
 1 file changed, 16 insertions(+), 20 deletions(-)

diff --git a/src/devices/grotty/grotty.1.man b/src/devices/grotty/grotty.1.man
index 3dcafaee7..7e47fc250 100644
--- a/src/devices/grotty/grotty.1.man
+++ b/src/devices/grotty/grotty.1.man
@@ -53,9 +53,9 @@ output driver for typewriter-like (terminal) devices
 .
 .SY grotty
 .RB [ \-dfho ]
-.RB [ \-i | \-r ]
+.RB [ \-i \||\| \-r ]
 .RB [ \-F\~\c
-.IR dir ]
+.IR font-directory ]
 .RI [ file\~ .\|.\|.]
 .YS
 .
@@ -63,7 +63,7 @@ output driver for typewriter-like (terminal) devices
 .SY "grotty \-c"
 .RB [ \-bBdfhouU ]
 .RB [ \-F\~\c
-.IR dir ]
+.IR font-directory ]
 .RI [ file\~ .\|.\|.]
 .YS
 .
@@ -292,10 +292,15 @@ There is therefore no need to filter its output through
 .\" ====================================================================
 .
 .I grotty
-understands one device control function produced by the
+supports one device control function,
+accessed with the
+.I groff
+request
+.B device
+or
 .I roff
 .B \[rs]X
-escape sequence in a document.
+escape sequence.
 .
 .
 .TP
@@ -688,13 +693,6 @@ lines are not supported.
 .
 .
 .IP \[bu]
-Characters above the first line
-(that is,
-with a vertical drawing position of\~0)
-cannot be rendered.
-.
-.
-.IP \[bu]
 Color handling differs from other output drivers.
 .
 The
@@ -719,7 +717,7 @@ varies:
 (5)\~foreground color;
 (6)\~background color;
 and
-(7)\~horizontal and vertical line-drawing.
+(7)\~horizontal and vertical line drawing.
 .
 .
 .P
@@ -763,20 +761,18 @@ $ \c
 .SH "See also"
 .\" ====================================================================
 .
+.UR http://\:www\:.ecma\-international\:.org/\:publications/\:files/\:\
+ECMA\-ST/\:\%Ecma\-048\:.pdf
 \[lq]Control Functions for Coded Character Sets\[rq]
 (ECMA-48)
 5th\~edition,
-Ecma International,
-June\~1991.
+\%Ecma International,
+June 1991.
+.UE
 .
 A gratis version of ISO\~6429,
 this document includes a normative description of SGR escape sequences.
 .
-Available at
-.UR http://\:www\:.ecma\-international\:.org/\:publications/\:files/\:\
-ECMA\-ST/\:Ecma\-048\:.pdf
-.UE .
-.
 .
 .P
 .UR https://\:gist\:.github\:.com/\:egmontkob/\:\