gbranden pushed a commit to branch master
in repository groff.
commit c1ec5a20fff17fa39e03e94853a7eaab38ff3657
Author: G. Branden Robinson <[email protected]>
AuthorDate: Sat Dec 20 23:11:57 2025 -0600
[doc,man]: Slightly update "Delimiters" material.
---
doc/groff.texi.in | 19 +++++++++++++------
man/groff.7.man | 9 ++++-----
2 files changed, 17 insertions(+), 11 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index b7d68dd9d..4f2c7d268 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -7922,12 +7922,19 @@ macro is called, its contents are interpreted literally.
@cindex @code{'}, as delimiter
@cindex @code{"}, as delimiter
-Some escape sequences that require parameters use delimiters. The
-neutral apostrophe @code{'} is a popular choice and shown in this
-document. The neutral double quote @code{"} is also commonly seen.
-Letters, numerals, and leaders can be used. Punctuation characters
-are likely better choices, except for those meaningful in numeric
-expressions; see below.
+Some escape sequences that require parameters delimit them.
+The neutral apostrophe
+@code{'}
+is a popular delimiter choice and shown in this document.
+The neutral double quote
+@code{"}
+is also commonly seen.
+Punctuation characters are the best choice
+(and most portable to other
+@command{troff}s), @c generic
+except for those meaningful in numeric expressions;
+see below.
+@c GNU troff happily accepts tabs and leaders; AT&T troff doesn't.
@Example
\l'1.5i\[bu]' \" draw 1.5 inches of bullet glyphs
diff --git a/man/groff.7.man b/man/groff.7.man
index fec568e0d..cf5573f26 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -1850,13 +1850,12 @@ The neutral double quote
.B \[dq]
is also commonly seen.
.
-Letters,
-numerals,
-and leaders can be used.
-.
-Punctuation characters are likely better choices,
+Punctuation characters are the best choice
+(and most portable to other
+.IR troff s, \" generic
except for those meaningful in numeric expressions;
see below.
+.\" GNU troff happily accepts tabs and leaders; AT&T troff doesn't.
.
.
.br
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
