gbranden pushed a commit to branch master
in repository groff.
commit 379a60b5ce293d4b00dad1beaa66f5f306985e66
Author: G. Branden Robinson <[email protected]>
AuthorDate: Fri May 8 21:44:04 2026 -0500
[doc,man,ms]: Repetition legitimizes, so they say.
Also break Texinfo input lines in convenient places for roffing and
diffing.
---
doc/groff.texi.in | 19 ++++++++++++++-----
man/roff.7.man | 7 ++++++-
tmac/groff_man.7.man.in | 2 ++
3 files changed, 22 insertions(+), 6 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 559aaaf92..c1983717c 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -3120,6 +3120,8 @@ This is an example of an
@dfn{escape sequence},
the other kind of formatting instruction.
Escape sequences can appear almost anywhere.
+@c ...but not where GNU troff expects an escape function selector or
+@c delimiter.
They begin with the escape character
(@code{\})
and are followed by at least one more character.
@@ -8065,11 +8067,18 @@ like defining macros.
@cindex escape sequence
@cindex sequence, escape
-The other is an @dfn{escape sequence}, which begins with the escape
-character and can be embedded anywhere in the input, even in arguments
-to requests and other escape sequences. Escape sequences interpolate
-special characters, strings, or registers, and handle comparatively
-minor formatting tasks like sub- and superscripting.
+The other is an
+@dfn{escape sequence},
+which begins with the escape character
+and can be embedded almost anywhere in the input,
+@c ...but not where GNU troff expects an escape function selector or
+@c delimiter.
+even in arguments to requests and other escape sequences.
+Escape sequences interpolate special characters,
+strings,
+or registers,
+and handle comparatively minor formatting tasks
+like sub- and superscripting.
Some operations, such as font selection and type size alteration, are
available via both requests and escape sequences.
diff --git a/man/roff.7.man b/man/roff.7.man
index ec5546e26..f87804f57 100644
--- a/man/roff.7.man
+++ b/man/roff.7.man
@@ -176,7 +176,10 @@ a dot
.
The other is the
.IR "escape sequence" ,
-which can occur almost anywhere and starts with the
+which can occur almost anywhere
+.\" ...but not where GNU troff expects an escape function selector or
+.\" delimiter.
+and starts with the
.IR "escape character" ,
a backslash
.RB \[lq] \[rs] \[rq].
@@ -2076,6 +2079,8 @@ start with a backslash,
.RB \[lq] \|\[rs] \[rq].
.
They can appear almost anywhere,
+.\" ...but not where GNU troff expects an escape function selector or
+.\" delimiter.
even in the midst of text on a line,
and implement various features,
including the insertion of special characters with
diff --git a/tmac/groff_man.7.man.in b/tmac/groff_man.7.man.in
index 21e40aac0..17453d902 100644
--- a/tmac/groff_man.7.man.in
+++ b/tmac/groff_man.7.man.in
@@ -2628,6 +2628,8 @@ A request appears on a control line.
An escape sequence starts with a backslash
.RB ( \[rs] )
and can appear almost anywhere.
+.\" ...but not where GNU troff expects an escape function selector or
+.\" delimiter.
.
However,
use of
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
