[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

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

From: G. Branden Robinson
Subject: [groff] 01/02: groff(7): Fix error regarding escape delimiters.
Date: Thu, 16 Jul 2020 17:42:35 -0400 (EDT)

gbranden pushed a commit to branch master
in repository groff.

commit 1abd69b231490dd7f7f56cdd1cb8e39f4934181e
Author: G. Branden Robinson <>
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
    troff: backtrace: file '<standard input>':2
    troff: <standard input>:2: error: cannot use character '(' as a starting 
    troff: backtrace: file '<standard input>':5
    troff: <standard input>:5: warning: closing delimiter does not match
    65( A A A
 man/ | 15 +++++++++------
 1 file changed, 9 insertions(+), 6 deletions(-)

diff --git a/man/ b/man/
index df80041..ea3d867 100644
--- a/man/
+++ b/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]
-.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]),

reply via email to

[Prev in Thread] Current Thread [Next in Thread]