gbranden pushed a commit to branch master
in repository groff.
commit 308bb7f99052c239b7891795db427ea27e74307d
Author: G. Branden Robinson <[email protected]>
AuthorDate: Sat Dec 6 06:39:15 2025 -0600
[doc,man]: Revise, sync `cflags` req description.
Tighten wording. Tweak synopsis syntax.
---
doc/groff.texi.in | 22 ++++++++--------------
man/groff.7.man | 17 ++++++++++-------
man/groff_diff.7.man | 33 +++++++--------------------------
3 files changed, 25 insertions(+), 47 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 91e225236..b43cbc779 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -12235,18 +12235,20 @@ An escaped underscore (``low line'') is a synonym for
@code{\[ul]}
and drawn lower than the underscore @samp{_}.
@endDefesc
-@Defreq {cflags, n c1 c2 @dots{}}
+@Defreq {cflags, n c@dots{}}
@cindex glyph properties (@code{cflags}) @c obsolete terminology
@cindex character properties (@code{cflags})
@cindex properties of glyphs (@code{cflags}) @c obsolete terminology
@cindex properties of characters (@code{cflags})
-Assign properties encoded by the number
+Assign properties encoded by non-negative integer
@var{n}
-to characters
-@var{c1},
-@var{c2},
-and so on.
+to each character or class@footnote{@xref{Character Classes}.}.
+@var{c}.
+Spaces need not separate
+@var{c}
+arguments.
+@c TODO: Bust discussion of character flags into its own subsubsection?
Characters,
whether
ordinary,
@@ -12256,15 +12258,7 @@ indexed,
have certain associated properties.
The first argument is the sum of the desired flags and the remaining
arguments are the characters to be assigned those properties.
-Spaces need not separate the
-@var{cn}
arguments.
-Any argument
-@var{cn}
-can be a character class defined with the
-@code{class}
-request rather than an individual character.
-@xref{Character Classes}.
The non-negative integer
@var{n}
diff --git a/man/groff.7.man b/man/groff.7.man
index bd07c746c..bd9626157 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -3066,13 +3066,16 @@ Unsafe request;
disabled by default.
.
.TPx
-.REQ .cflags "n c1 c2 \fR\&.\|.\|.\&\fP"
-Assign properties encoded
-.RI by\~ n
-to characters
-.IR c1 ,
-.IR c2 ,
-and so on.
+.REQ .cflags "n c\fR\&.\|.\|.\&\fP"
+Assign properties encoded by non-negative integer
+.I n
+to each character or class
+.IR c .
+.
+Spaces need not separate
+.I c
+arguments.
+.\" TODO: Add subsection discussing character flags.
.
.TPx
.REQ .ch mac
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index b7283abe3..458f01324 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -2246,39 +2246,20 @@ in request form.
.
.
.TP
-.BI .cflags\~ "n c1 c2\~"\c
+.BI .cflags\~ "n c"\c
\&.\|.\|.
-Assign properties encoded by the number
+Assign properties encoded by non-negative integer
.I n
-to characters
-.IR c1 ,
-.IR c2 ,
-and so on.
-.
-Characters,
-whether
-ordinary,
-special,
-or
-indexed,
-have certain associated properties.
-.
-The first argument is the sum of the desired flags and the remaining
-arguments are the characters to be assigned those properties.
+to each character or class
+.IR c .
.
-Spaces need not separate the
-.I cn
+Spaces need not separate
+.I c
arguments.
.
-Any argument
-.I cn
-can be a character class defined with the
-.B class
-request rather than an individual character.
-.
.
+.\" TODO: Bust discussion of character flags into its own subsection?
.IP
-The non-negative integer
.I n
is the sum of any of the following.
.
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
