[groff] 04/07: [docs]: Fix Savannah #63812.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 9df2e2ea425663167496ba340f850c0b9aa37990
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sun Mar 5 03:10:48 2023 -0600

    [docs]: Fix Savannah #63812.
    
    * doc/groff.texi (Operators in Conditionals):
    * man/groff.7.in (Conditional expressions): Clarify how the output
      comparison operator is recognized.
    
    Fixes <https://savannah.gnu.org/bugs/?63812>.  Thanks to John Gardner
    for the report.
    
    ANNOUNCE: Update bug counts.
---
 ANNOUNCE        |  6 +++---
 ChangeLog       |  9 +++++++++
 doc/groff.texi  | 11 +++++++++++
 man/groff.7.man | 17 ++++++++++++++---
 4 files changed, 37 insertions(+), 6 deletions(-)

diff --git a/ANNOUNCE b/ANNOUNCE
index 8185dae6d..ef2bb59fd 100644
--- a/ANNOUNCE
+++ b/ANNOUNCE
@@ -57,7 +57,7 @@ release shipped with three automated unit tests; this one 
ships with
 over 160 unit and regression tests.
 
 As of this writing, per the GNU Savannah bug tracker, the groff project
-has resolved 417 problems as fixed for the 1.23.0 release.  Some of the
+has resolved 418 problems as fixed for the 1.23.0 release.  Some of the
 bugs we've corrected were over 30 years old.
 
 Classifying these issues by type and the component of the project to
@@ -65,9 +65,9 @@ which they apply, we find the following.
 
   Type                              Component
   ----                              ---------
-  Build/installation           39   Core                           96
+  Build/installation           39   Core                           97
   Crash/unresponsive           11   Driver: grohtml                 7
-  Documentation               102   Driver: gropdf                 10
+  Documentation               103   Driver: gropdf                 10
   Feature change               40   Driver: grops                   2
   Incorrect behavior          128   Driver: grotty                  4
   Lint                         15   Driver: others/general          7
diff --git a/ChangeLog b/ChangeLog
index 36c7200a3..c29e8579c 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,12 @@
+2023-03-07  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+       * doc/groff.texi (Operators in Conditionals):
+       * man/groff.7.in (Conditional expressions): Clarify how the
+       output comparison operator is recognized.
+
+       Fixes <https://savannah.gnu.org/bugs/?63812>.  Thanks to John
+       Gardner for the report.
+
 2023-03-06  G. Branden Robinson <g.branden.robinson@gmail.com>
 
        Use a better type for symbol hashes.
diff --git a/doc/groff.texi b/doc/groff.texi
index 5c4af4fc9..7e300dbef 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -12571,8 +12571,19 @@ certain other @code{troff} 
implementations.@footnote{This refers to
 @code{vtroff}, a translator that would convert the C/A/T output from
 early-vintage @acronym{AT&T} @code{troff} to a form suitable for
 Versatec and Benson-Varian plotters.}
+@end table
+
+If the first argument to an @code{if}, @code{ie}, or @code{while}
+request begins with a non-alphanumeric character apart from @code{!}
+(see below); it performs an @slanted{output comparison test}.
+@footnote{Strictly, letters not otherwise recognized @emph{are} treated
+as output comparison delimiters.  For portability, it is wise to avoid
+using letters not in the list above; for example, Plan@tie{}9
+@code{troff} uses @samp{h} to test a mode it calls @code{htmlroff}, and
+GNU @code{troff} may provide additional operators in the future.}
 
 @cindex output comparison operator
+@table @code
 @item @code{'}@var{xxx}@code{'}@var{yyy}@code{'}
 True if formatting the comparands @var{xxx} and @var{yyy} produces the
 same output commands.  The delimiter need not be a neutral apostrophe:
diff --git a/man/groff.7.man b/man/groff.7.man
index 0d0539a98..e16ec458f 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -10,7 +10,7 @@ language reference
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 2000-2018, 2020-2022 Free Software Foundation, Inc.
+.\" Copyright (C) 2000-2023 Free Software Foundation, Inc.
 .\"
 .\" This file is part of groff, the GNU roff type-setting system.
 .\"
@@ -2099,9 +2099,20 @@ T}
 .
 .
 .P
-The first of the above,
+If the first argument to an
+.BR .if ,
+.BR .ie ,
+or
+.B .while
+request begins with a non-alphanumeric character apart from
+.B !\&
+(see below);
+it performs an
+.I output comparison test.
+.
+Shown first in the table above,
 the
-.I "output comparison operator,"
+.I output comparison operator
 interpolates a true value if formatting its comparands
 .I s1
 and