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

                 Summary: [groff(7)] Bad advice for grouping of '\}'
                   Group: GNU roff
               Submitter: bjarniig
               Submitted: Sun 24 Aug 2025 09:57:33 PM GMT
                Category: General
                Severity: 3 - Normal
              Item Group: Documentation
                  Status: None
                 Privacy: Public
             Assigned to: None
             Open/Closed: Open
         Discussion Lock: Any
         Planned Release: None


    _______________________________________________________

Follow-up Comments:


-------------------------------------------------------
Date: Sun 24 Aug 2025 09:57:33 PM GMT By: Bjarni Ingi Gislason <bjarniig>
Subject: [groff(7)] Bad advice for grouping of '\}'

File: man/groff.7.man

In chapter "Control structures", fourth paragraph:

"\} should appear on a line with other occurrences of itself as necessary
to match \{ sequences."

  With '\}\}..." the end of a structure (with indentation) is not clearly
visible.

  A better practice is to have each "end of a block" on its own line,
like:

.    \}
.  \}
.\}

matching the beginning of each corresponding block of text.

  With

grep -n -F -e '\{\' -e '\}' <file>

  the structure is made visible to check for mismatched delimiters.

N.B.

  Counting the number of "delimiters" (grep -c -F ...) is a first measure
to check for a possible mismatch.








    _______________________________________________________

Reply to this item at:

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

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

Attachment: signature.asc
Description: PGP signature

Reply via email to