diff options
| -rw-r--r-- | ANNOUNCE | 6 | ||||
| -rw-r--r-- | ChangeLog | 9 | ||||
| -rw-r--r-- | doc/groff.texi | 11 | ||||
| -rw-r--r-- | man/groff.7.man | 17 |
4 files changed, 37 insertions, 6 deletions
@@ -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 @@ -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 |