gbranden pushed a commit to branch master
in repository groff.
commit 8c0ba71897ef2afc5c5185f4e04861d58ff84021
Author: G. Branden Robinson <[email protected]>
AuthorDate: Sat Apr 12 06:47:58 2025 -0500
[doc],groff_diff(7): Update `cflags` description.
Reinforce the three character types: ordinary, special, indexed.
Drop footnote/parenthetical regarding glyphs. We've gradually gotten
better about distinguishing them from characters throughout the rest of
groff's documentation.
Parallelize wording and input line breaks between Texinfo and man page.
---
doc/groff.texi.in | 49 +++++++++++++++++++++++++++++++++----------------
man/groff_diff.7.man | 17 +++++++----------
2 files changed, 40 insertions(+), 26 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index af6472727..2b4178ea2 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -11378,26 +11378,43 @@ and drawn lower than the underscore @samp{_}.
@endDefesc
@Defreq {cflags, n c1 c2 @dots{}}
-@cindex glyph properties (@code{cflags})
+@cindex glyph properties (@code{cflags}) @c obsolete terminology
@cindex character properties (@code{cflags})
-@cindex properties of glyphs (@code{cflags})
+@cindex properties of glyphs (@code{cflags}) @c obsolete terminology
@cindex properties of characters (@code{cflags})
-Assign properties encoded by the number @var{n} to characters @var{c1},
-@var{c2}, and so on.
-
-Input characters, including special characters introduced by an escape,
-have certain properties associated with them.@footnote{Output glyphs
-have different properties. The only ones known to GNU @code{troff} are
-those in its font's description file. Recall @ref{Using Fonts}.} These
-properties can be modified with this request. 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.
+Assign properties encoded by the number
+@var{n}
+to characters
+@var{c1},
+@var{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.
+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} is the sum of any of the following.
-Some combinations are nonsensical, such as @samp{33} (1 + 32).
+The non-negative integer
+@var{n}
+is the sum of any of the following.
+Some combinations are nonsensical,
+such as
+@samp{33}
+(1 + 32).
@table @code
@item 1
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index b45543162..6232e7e3c 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -1893,16 +1893,13 @@ to characters
.IR c2 ,
and so on.
.
-Ordinary and special characters have certain associated properties.
-.
-(Glyphs don't:
-to GNU
-.IR troff , \" GNU
-like AT&T device-independent
-.IR troff , \" AT&T
-a glyph is an identifier corresponding to a rectangle with some metrics;
-see
-.MR groff_font @MAN5EXT@ .)
+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.
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
