[groff] 14/28: groff_char(7): Shift material between sections.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 1df6f354732919a055291d17b99b05ef715a7cce
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Mon Aug 31 21:41:10 2020 +1000

    groff_char(7): Shift material between sections.
    
    * Move descriptions of "+" and "***" annotations in Notes column of
      glyph tables, and material about text and special font variants from
      subsection "Special character escape forms" to subsection "Glyph
      tables".
    
    * Drop "Code" column description, as it is absent from all the
      subsequent tables.  (And the 8-bit table before it is not long for
      this world.)
    
    * Recast some wording.
    * Set "groff" in italics.
    * Break input lines after commas and semicolons.
---
 man/groff_char.7.man | 111 +++++++++++++++++++++++++++++----------------------
 1 file changed, 64 insertions(+), 47 deletions(-)

diff --git a/man/groff_char.7.man b/man/groff_char.7.man
index 14b5dbe..00c0298 100644
--- a/man/groff_char.7.man
+++ b/man/groff_char.7.man
@@ -736,33 +736,8 @@ request;
 see
 .IR groff (@MAN7EXT@).
 .
-.P
-In the following,
-a plus sign \[lq]+\[rq] in the \[lq]Notes\[rq] column indicates that
-the glyph name appears in the AT&T
-.I troff
-user's manual,
-CSTR\~#54
-(1992 revision).
-.
-When using the AT&T special character syntax
-.BI \[rs]( xx\c
-, portability can be expected from such names.
 .
 .P
-Entries marked with \[lq]***\[rq] denote glyphs used for mathematical
-purposes.
-.
-Historically,
-such glyphs were typically drawn from a different font,
-the \[lq]special\[rq] font.
-.
-Often,
-such glyphs have metrics which look incongruous in normal text.
-.
-A few which are not uncommon in running prose have \[lq]text
-variants\[rq],
-and should work well in such contexts.
 .
 Conversely,
 a handful of glyphs that are normally drawn from a regular font are
@@ -776,32 +751,34 @@ Both sets of exceptions are noted in the tables where 
they appear
 .SH "Glyph Tables"
 .\" ====================================================================
 .
-In this section, the glyphs in groff are specified in tabular
-form.
+In this section,
+.IR groff 's
+glyph name repertoire is presented in tabular form.
 .
-The meaning of the columns is as follows.
+The meanings of the columns are as follows.
 .
 .
 .TP
-.I "Output"
-shows how the glyph is printed for the current device; although
-this can have quite a different shape on other devices, it always
-represents the same glyph.
+.I Output
+shows the glyph as it appears on the device used to render this
+document;
+although it can have a notably different shape on other devices
+(and is subject to user-directed translation and replacement),
+.I groff
+attempts reasonable equivalency on all output devices.
 .
 .
 .TP
-.I "Input"
-specifies how the glyph is input either directly by a key on the
-keyboard, or by a groff escape sequence.
+.I Input
+shows the
+.I groff
+character
+(ordinary or special)
+that normally produces the glyph.
 .
 .
-.TP
-.I "Code"
-applies to glyphs which can be input with a single character, and
-gives the ISO \%latin1 decimal code of that input character.
-.
-Note that this code is equivalent to the lowest 256 Unicode characters,
-including \%7-bit ASCII in the range 0 to\ 127.
+.IP
+Some code points have multiple glyph names.
 .
 .
 .TP
@@ -811,18 +788,58 @@ gives the name of the glyph from the Adobe Glyph List 
(AGL).
 .
 .TP
 .I Unicode
-is the glyph name used in composite glyph names.
+is the glyph name used in Unicode special character escapes.
 .
 The names in the Unicode column look like
 .B u0021
 or
 .BR u0041_0300 .
 .
-In groff, the corresponding Unicode characters can be constructed
-by adding a backslash and a pair of square brackets, for example
-.B \e[u0021]
+In
+.IR groff ,
+the corresponding Unicode characters can be constructed by adding a
+backslash and a pair of square brackets,
+for example
+.B \[rs][u0021]
 or
-.BR \e[u0041_0300] .
+.BR \[rs][u0041_0300] .
+.
+.
+.P
+In the following,
+a plus sign \[lq]+\[rq] in the \[lq]Notes\[rq] column indicates that
+the glyph name appears in the AT&T
+.I troff
+user's manual,
+CSTR\~#54
+(1992 revision).
+.
+When using the AT&T special character syntax
+.BI \[rs]( xx\c
+, portability can be expected from such names.
+.
+.
+.P
+Entries marked with \[lq]***\[rq] denote glyphs used for mathematical
+purposes.
+.
+Historically,
+such glyphs were typically drawn from a different font,
+the \[lq]special\[rq] font.
+.
+Often,
+such glyphs have metrics which look incongruous in normal text.
+.
+A few which are not uncommon in running prose have \[lq]text
+variants\[rq],
+and should work well in such contexts.
+.
+Conversely,
+a handful of glyphs that are normally drawn from a regular font are
+required in mathematical text.
+.
+Both sets of exceptions are noted in the tables where they appear
+(\[lq]Logical symbols\[rq] and \[lq]Mathematical symbols\[rq]).
 .
 .
 .\" ====================================================================