[groff] 05/09: doc/groff.texi: Tighten admonition about refer(1).

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit e5144a5851c2652c5ea63b35c81037f1e5cd98d2
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Tue Nov 23 23:01:28 2021 +1100

    doc/groff.texi: Tighten admonition about refer(1).
    
    It's not a matter of backward compatibility, but present-day
    compatibility.
---
 doc/groff.texi | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index b5f2b70..9e9c77b 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -5915,11 +5915,9 @@ for glyph @samp{foo]}.
 @cindex @code{[}, macro names starting with, and @code{refer}
 @cindex @code{]}, macro names starting with, and @code{refer}
 @cindex macro names, starting with @code{[} or @code{]}, and @code{refer}
-To avoid problems with the @code{refer} preprocessor, macro names should
-not start with @samp{[} or @samp{]}.  Due to backwards compatibility,
-everything after @samp{.[} and @samp{.]} is handled as a special
-argument to @code{refer}.  For example, @samp{.[foo} makes @code{refer}
-to start a reference, using @samp{foo} as a parameter.
+If you name macros beginning with the characters @samp{[} or @samp{]},
+you foreclose use of the @code{refer} preprocessor, which recognizes
+@samp{.[} and @samp{.]} as bilbilographic reference delimiters.
 
 @Defesc {\\A, @code{'}, ident, @code{'}}
 Test whether an identifier @var{ident} is valid in @code{gtroff}.  It