[groff] 06/39: [docs]: Fix content and style nits.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 0118689b0ccf39ef90ca0c55fd072a41f741214c
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sun May 29 11:33:30 2022 -0500

    [docs]: Fix content and style nits.
    
    Content:
    * Restore subtraction from zero as an identified means of expression
      negation.  Thanks to Dave Kemper for the discussion.
    * Identify streams as an identifier name space.  Sync groff(7) list of
      these with our Texinfo manual.
    
    Style:
    * Add comma to set off attributive participial phrase.
    * Drop spurious hyphen.
---
 doc/groff.texi  | 14 +++++++-------
 man/groff.7.man |  9 ++++++---
 2 files changed, 13 insertions(+), 10 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index 729f92af..50f1565b 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -5980,8 +5980,8 @@ requests and escape sequences:@: @code{bp}, @code{in}, 
@code{ll},
 @code{ps}, @code{pvs}, @code{rt}, @code{ti}, @code{\H}, @code{\R}, and
 @code{\s}.  Here, leading plus and minus signs serve as incrementation
 and decrementation operators, respectively.  To negate an expression,
-include the unary minus in parentheses with its argument.  @xref{Setting
-Registers}, for examples.
+subtract it from zero or include the unary minus in parentheses with its
+argument.  @xref{Setting Registers}, for examples.
 
 @opindex |
 @cindex @code{|}, and page motion
@@ -6105,9 +6105,9 @@ not qualify, so our first attempt got a warning.
 GNU @code{troff} has rules for properly formed
 @dfn{identifiers}---labels for objects with syntactical importance, like
 registers, names (macros, strings, or diversions), environments, fonts,
-styles, colors, and glyphs.  An identifier consists of one or more
-characters with the exception of spaces, tabs, newlines, and invalid
-input characters.
+styles, colors, character classes, glyphs, and streams.  An identifier
+consists of one or more characters with the exception of spaces, tabs,
+newlines, and invalid input characters.
 
 @cindex invalid input characters
 @cindex input characters, invalid
@@ -6118,7 +6118,7 @@ sets ``C0 Controls'' and ``C1 Controls'' as Unicode 
describes them).
 When GNU @code{troff} encounters one in an identifier, it produces a
 warning in category @samp{input} (@pxref{Debugging}).  They are removed
 during intepretation; an identifier @samp{foo}, followed by an invalid
-character and then @samp{bar} is processed as @samp{foobar}.
+character and then @samp{bar}, is processed as @samp{foobar}.
 
 On a machine using the ISO 646, 8859, or 10646 character encodings,
 invalid input characters are @code{0x00}, @code{0x08}, @code{0x0B},
@@ -13264,7 +13264,7 @@ indicate continuation of a footnote or something 
similar.
 
 A few escape sequences that produce vertical motion are unusual.  They
 are thought to originate early in AT&T @code{nroff} history to achieve
-super- and sub-scripting by half-line motions on line printers and
+super- and subscripting by half-line motions on line printers and
 teletypewriters before the phototypesetter made more precise positioning
 available.  They are reckoned in ems---not vees---to maintain continuity
 with their original purpose of moving relative to the size of the type
diff --git a/man/groff.7.man b/man/groff.7.man
index 81e42413..542bcd56 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -1050,7 +1050,8 @@ operators,
 respectively.
 .
 To negate an expression,
-include the unary minus in parentheses with its argument.
+subtract it from zero
+or include the unary minus in parentheses with its argument.
 .\" @xref{Setting Registers}, for examples.
 .
 .
@@ -4411,7 +4412,9 @@ or diversion),
 an environment,
 a font,
 a style,
-or a glyph,
+a character class,
+a glyph,
+or a stream,
 comprising a sequence of one or more characters with the following
 exceptions.
 .
@@ -4480,7 +4483,7 @@ Invalid characters are removed during interpretation;
 an identifier
 .RB \[lq] foo \[rq],
 followed by an invalid character and then
-.RB \[lq] bar \[rq]
+.RB \[lq] bar \[rq],
 is processed as
 .RB \[lq] foobar \[rq] .
 .