[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.
This commit is contained in:
G. Branden Robinson 2023-03-05 03:10:48 -06:00
parent bc1bde5ac9
commit 9df2e2ea42
4 changed files with 37 additions and 6 deletions

View File

@ -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

View File

@ -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.

View File

@ -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:

View File

@ -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