gbranden pushed a commit to branch master
in repository groff.
commit be18dd21c5eb232486328933f1985503ce3e7f64
Author: G. Branden Robinson <[email protected]>
AuthorDate: Sat Aug 2 09:33:55 2025 -0500
groff(7): Improve taxonomy.
Now that everything "string-like" is read by the formatter in the same
way, we can use the "contents" notion as a category encompassing
"command", "file", and "message", and avoid repeating ourselves
regarding handling of a leading `"`.
---
man/groff.7.man | 28 +++++++++++++++-------------
1 file changed, 15 insertions(+), 13 deletions(-)
diff --git a/man/groff.7.man b/man/groff.7.man
index 81206a96d..9cf99f5be 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -2363,8 +2363,9 @@ ordinary or special.
.
.TPx
.I command
-is a sequence of ordinary characters and/or spaces
-.\" XXX: or tabs, leaders, backspace, and delete characters
+is an instance of
+.I contents
+(see below)
to be passed to the system as a command
(potentially with arguments).
.\" ...limiting the file names you can express; see Savannah #64071.
@@ -2374,14 +2375,14 @@ allowing embedded leading spaces.
.
.TPx
.I contents
-is a sequence of ordinary characters,
-spaces,
-tabs,
-leaders,
-or escape sequences
-.\" XXX: or backspace and delete characters
-(including special characters)
-populating a string or character definition.
+is arbitrary input,
+excluding an unescaped newline,
+read in copy mode.
+.
+GNU
+.I troff \" GNU
+strips a leading neutral double quote,
+allowing embedded leading spaces.
.
.TPx
.I div
@@ -2393,8 +2394,8 @@ is an environment identifier.
.
.TPx
.I file
-is a sequence of ordinary characters and/or spaces
-.\" XXX: or tabs, leaders, backspace, and delete characters
+is an instance of
+.I contents
naming a file on the system.
.\" ...limiting the file names you can express; see Savannah #65108.
.
@@ -2431,7 +2432,8 @@ is a macro identifier.
.
.TPx
.I message
-is a sequence of ordinary characters and/or spaces
+is an instance of
+.I contents
to emit on the standard error stream.
.\" ...limiting the messages you can express; see Savannah #62787.
.
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
