[groff] 08/12: groff_tmac(5): Explain what tty-char.tmac does.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 873edddab726fa53368226061ee7b2aad82223aa
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sun Aug 23 00:37:22 2020 +1000

    groff_tmac(5): Explain what tty-char.tmac does.
    
    ...better than it did.
    
    tmac/tty-char.tmac: Wrap long comment lines.
---
 man/groff_tmac.5.man | 15 ++++++++++-----
 tmac/tty-char.tmac   | 13 +++++++------
 2 files changed, 17 insertions(+), 11 deletions(-)

diff --git a/man/groff_tmac.5.man b/man/groff_tmac.5.man
index 9dc39d9..6df8698 100644
--- a/man/groff_tmac.5.man
+++ b/man/groff_tmac.5.man
@@ -556,11 +556,16 @@ See
 .
 .TP
 .I tty\-char
-Overrides the definition of standard troff characters and some groff
-characters for TTY devices.
-.
-The optical appearance is intentionally inferior compared to that of
-normal TTY formatting to allow processing with critical equipment.
+Defines fallback definitions of
+.I roff
+special characters for terminal devices.
+.
+These definitions more poorly optically approximate typeset output
+compared to those of the
+.I tty
+file in favor of communicating more semantic information,
+which can allow easier processing with critical equipment.
+\" XXX: critical equipment like what?
 .
 .
 .TP
diff --git a/tmac/tty-char.tmac b/tmac/tty-char.tmac
index de3b231..a632347 100644
--- a/tmac/tty-char.tmac
+++ b/tmac/tty-char.tmac
@@ -2,19 +2,20 @@
 .\"
 .\" tty-char.tmac
 .\"
-.\" This file defines standard troff characters and some groff characters for
-.\" use with -Tascii, -Tlatin1, -Tutf8, and -Tcp1047.
+.\" This file defines standard troff characters and some groff
+.\" characters for use with -Tascii, -Tlatin1, -Tutf8, and -Tcp1047.
 .\"
 .\" These definitions are chosen so that, as far as possible, they:
 .\" - work with all of -Tascii, -Tlatin1, -Tutf8, and -Tcp1047.
 .\" - work on devices that display only the last overstruck character
 .\"   as well as on devices that support overstriking
 .\" - help understanding the character's meaning, only aiming to imitate
-.\"   a particular graphical shape when that doesn't hinder understanding
+.\"   a particular graphical shape when that doesn't hinder
+.\"   understanding
 .\"
-.\" Note that the optical appearance of the definitions contained in this
-.\" file is inferior compared to that of the replacement characters defined
-.\" in the file tty.tmac.
+.\" Note that the optical appearance of the definitions contained in
+.\" this file is inferior compared to those of the replacement
+.\" characters defined in the file tty.tmac.
 .\"
 .do nr *groff_tty-char_tmac_C \n[.cp]
 .cp 0