gbranden pushed a commit to branch master
in repository groff.
commit e0a70d54d193563e2281bb656e7fb8aa51e2465c
Author: G. Branden Robinson <[email protected]>
AuthorDate: Sun Jan 11 06:22:58 2026 -0600
[doc,man]: Fix "Delimiters" content, style nits.
* Clarify meaning of list.
* Add footnote for forward reference.
* Shift footnote mark to follow punctuation, not precede it. Style
manuals differ on this point, but we seem to preponderantly follow
punctuation with footnote marks.
---
doc/groff.texi.in | 12 +++++++-----
man/groff.7.man | 6 +++++-
2 files changed, 12 insertions(+), 6 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 4c04519b8..9be159518 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -8311,17 +8311,20 @@ GNU
@command{troff} @c GNU
prohibits the same delimiters in the argument to the
@code{tl}
-request.
+request.@footnote{@xref{Page Layout}.}
The
@code{if},
@code{ie},
and
@code{while}
requests each interpret their first argument
-as a conditional expression@footnote{@xref{Operators in Conditionals}.};
+as a conditional expression;@footnote{@xref{Operators in Conditionals}.}
only characters that are not meaningful as operators
in that context
can be used as output comparison delimiters.
+The following inputs are therefore invalid as delimiters in
+GNU
+@command{troff}. @c GNU
@itemize @bullet
@item
@@ -8397,10 +8400,9 @@ GNU
keeps track of the nesting depth of escape sequence interpolations,
so the only characters you need to avoid using as delimiters are those
that appear in the arguments you input,
-not any that result from interpolation.
+not those that result from interpolation.
Typically,
-@code{'} works fine.
-@xref{Implementation Differences}.
+@code{'} works fine.@footnote{@xref{Implementation Differences}.}
@Example
$ groff -T ps
diff --git a/man/groff.7.man b/man/groff.7.man
index abab64717..fb1ca5f69 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -1959,6 +1959,10 @@ only characters that are not meaningful as operators
in that context
can be used as output comparison delimiters.
.
+The following inputs are therefore invalid as delimiters in
+GNU
+.IR troff . \" GNU
+.
.
.RS
.IP \[bu] 3n
@@ -2005,7 +2009,7 @@ GNU
keeps track of the nesting depth of escape sequence interpolations,
so the only characters you need to avoid using as delimiters are those
that appear in the arguments you input,
-not any that result from interpolation.
+not those that result from interpolation.
.
Typically,
.B \[aq]
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
