gbranden pushed a commit to branch master
in repository groff.
commit e72a7230d74cfa396662d3eb9b8b7ae497eaa73f
Author: G. Branden Robinson <[email protected]>
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/\:\
_______________________________________________
Groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
