[groff] 01/02: groff(7): Fix error regarding escape delimiters.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 1abd69b231490dd7f7f56cdd1cb8e39f4934181e
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Thu Jul 16 23:19:49 2020 +1000

    groff(7): Fix error regarding escape delimiters.
    
    '[' and ']' are indeed acceptable, if perhaps inadvisable, in the \e''
    escape syntax form.
    
    The error was introduced by me in
    2a9c2283c5698cc8346a327d0935f3a3821a79e8 (30 June); the previous
    material countenanced only "'" as a delimiter but didn't actually
    discuss what characters were permitted or forbidden.  Per our Texinfo
    manual, the rules for which characters are acceptable delimiters are
    complex and vary by the escape; point the user there for now.
    
    $ ./build/test-groff -Tutf8
    .pl 1v
    \N(65(
    \N[65[
    \N]65]
    \N[65]
    troff: backtrace: file '<standard input>':2
    troff: <standard input>:2: error: cannot use character '(' as a starting 
delimiter
    troff: backtrace: file '<standard input>':5
    troff: <standard input>:5: warning: closing delimiter does not match
    65( A A A
---
 man/groff.7.man | 15 +++++++++------
 1 file changed, 9 insertions(+), 6 deletions(-)

diff --git a/man/groff.7.man b/man/groff.7.man
index df80041..ea3d867 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -2855,19 +2855,22 @@ In the former convention,
 a one-character argument follows the function character immediately,
 an opening parenthesis
 .RB \[lq] ( \[rq]
-introduces a two-character argument,
+introduces a two-character argument
+(no closing parenthesis is used),
 and an argument of arbitrary length is enclosed in brackets
 .RB \[lq] [] \[rq].
 .
 In the latter convention,
-the user selects a delimiter character other than
-.RB \[lq] ( \[rq]
-or
-.RB \[lq] [] \[rq]\[em]the
-neutral apostrophe
+the user selects a delimiter character;
+the neutral apostrophe
 .RB \[lq] \[aq] \[rq]
 is a popular choice and used in this document.
 .
+Some characters cannot be used as delimiters;
+see section \[lq]Escapes\[rq] in the
+.I groff
+Texinfo manual for details.
+.
 A few escapes are idiosyncratic,
 and support both of the foregoing conventions
 .RB (\[lq] \[rs]s \[rq]),