[groff] 01/02: Pick documentation nits.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 9c853f2b796149b3acc473503b67907f66dc0ac9
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Mon Jul 27 07:52:51 2020 +1000

    Pick documentation nits.
    
    doc/groff.texi:
    man/groff_diff.7.man: Fix scrambled word order.
    
    man/groff_char.7.man: Set "AT&T troff" as an unbroken phrase as is done
    elsewhere.  Use correct glyphs in examples of ASCII characters that get
    mapped surprisingly (to programmers) by default.
---
 doc/groff.texi       |  8 ++++----
 man/groff_char.7.man | 11 +++++------
 man/groff_diff.7.man |  2 +-
 3 files changed, 10 insertions(+), 11 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index ba399f0..586bc9a 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -6690,8 +6690,8 @@ The hyphenation character is associated with the current 
environment
 @cindex @code{char} request, and soft hyphen character
 @cindex @code{tr} request, and soft hyphen character
 Set the @dfn{soft hyphen character} to @var{glyph}.@footnote{``Soft
-hyphen @emph{character}'' is a misnomer since it is an output glyph.} If
-the argument is omitted, the soft hyphen character is set to the
+hyphen @emph{character}'' is a misnomer since it is an output glyph.}
+If the argument is omitted, the soft hyphen character is set to the
 default, @code{\[hy]}.  The @dfn{soft hyphen character} is the glyph
 that is inserted when a word is automatically hyphenated at a line
 break.@footnote{It is ``soft'' because it only appears in output where
@@ -6909,8 +6909,8 @@ codes---integers from 0 to@tie{}255.  The request maps 
character
 code@tie{}@var{a} to code@tie{}@var{b}, code@tie{}@var{c} to
 code@tie{}@var{d}, and so on.  Character codes that would otherwise be
 invalid in GNU @code{troff} can be used.  By default, every code maps to
-itself except those for letters `A' to `Z', which map those for to `a'
-to `z'.
+itself except those for letters `A' to `Z', which map those for `a' to
+`z'.
 
 @pindex troffrc
 @pindex troffrc-end
diff --git a/man/groff_char.7.man b/man/groff_char.7.man
index e3e7cc2..3a8164e 100644
--- a/man/groff_char.7.man
+++ b/man/groff_char.7.man
@@ -59,8 +59,7 @@ printable code points.
 .
 .
 .P
-AT&T
-.I troff
+.RI AT&T\~ troff
 in the 1970s faced a similar problem of typesetter devices with a glyph
 repertoire differing from that of the computers that controlled them.
 .
@@ -304,7 +303,7 @@ as themselves; the only exceptions are the following 
characters:
 .
 .
 .TP
-.B \`
+.B \[ga]
 the ISO \%latin1 \[oq]Grave Accent\[cq] (code\ 96) prints as \[oq], a
 left single quotation mark (Unicode u2018).
 The same output glyph can be requested explicitly
@@ -325,7 +324,7 @@ The original character can be obtained with
 .
 .
 .TP
-.B -
+.B \-
 the ISO \%latin1 \[oq]Hyphen, Minus Sign\[cq] (code\ 45) prints as a
 hyphen (Unicode u2010).
 The same output glyph can be requested explicitly
@@ -334,7 +333,7 @@ A minus sign can be obtained with \[oq]\e-\[cq] (Unicode 
u2212).
 .
 .
 .TP
-.B ~
+.B \[ti]
 the ISO \%latin1 \[oq]Tilde\[cq] (code\ 126) is reduced in size to be
 usable as a diacritic (Unicode u02DC).
 A larger glyph can be obtained with
@@ -342,7 +341,7 @@ A larger glyph can be obtained with
 .
 .
 .TP
-.B ^
+.B \[ha]
 the ISO \%latin1 \[oq]Circumflex Accent\[cq] (code\ 94) is reduced in
 size to be usable as a diacritic (Unicode u02C6); a larger glyph
 can be obtained with \[oq]\e(ha\[cq] (Unicode u005E).
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 4635e2b..af07a66 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -2267,7 +2267,7 @@ Character codes that would otherwise be invalid in
 can be used.
 .
 By default,
-every code maps to itself those for except letters \[lq]A\[rq] to
+every code maps to itself except those for letters \[lq]A\[rq] to
 \[lq]Z\[rq],
 which map to those for \[lq]a\[rq] to \[lq]z\[rq].
 .