[bug #60836] [PATCH] Document erroneous CSTR #54 description of comparison conditional

[Dave]

URL:
  <https://savannah.gnu.org/bugs/?60836>

                 Summary: [PATCH] Document erroneous CSTR #54 description of
comparison conditional
                 Project: GNU troff
            Submitted by: barx
            Submitted on: Sun 27 Jun 2021 07:11:43 AM CDT
                Category: Core
                Severity: 2 - Minor
              Item Group: Documentation
                  Status: None
                 Privacy: Public
             Assigned to: None
             Open/Closed: Open
         Discussion Lock: Any
         Planned Release: None

    _______________________________________________________

Details:

The Texinfo manual is pretty scrupulous about documenting errors in CSTR #54. 
If it aims to encompass a complete errata sheet for CSTR #54 (and if others
agree this is an error in CSTR #54, not just an ambiguity), the below item
should be included.  The attached patch gives one possible solution.

This concerns the conditional operator documented as 'xxx'yyy' (though any
number of characters besides ' can be used as the delimiters).  If this
operator has a commonly accepted name, I'm unaware of it.  In the patch's
index entry I called it the "output-equivalence conditional operator."

Section 16 of CSTR #54 described this conditional as testing "if _string1_
identical to _string2_."  This makes it sound like it is testing whether the
input strings match.

As commit 356bc65d
<http://git.savannah.gnu.org/cgit/groff.git/commit/?id=356bc65d> noted when it
updated similar erroneous wording in groff(7), and as the Texinfo manual
describes at length, the operator actually tests whether the two strings
produce the same formatted output.  

(Bug #58962 mentions this in passing.)



    _______________________________________________________

File Attachments:


-------------------------------------------------------
Date: Sun 27 Jun 2021 07:11:43 AM CDT  Name: cstr_erratum.patch  Size: 691B  
By: barx

<http://savannah.gnu.org/bugs/download.php?file_id=51604>

    _______________________________________________________

Reply to this item at:

  <https://savannah.gnu.org/bugs/?60836>

_______________________________________________
  Message sent via Savannah
  https://savannah.gnu.org/