gbranden pushed a commit to branch master
in repository groff.
commit 5b999eecc37bd83fd46ccb4bda2712fcdd1a9b0c
Author: G. Branden Robinson <[email protected]>
AuthorDate: Sun Apr 26 22:36:16 2026 -0500
[doc,man]: Update, resync `cs` request discussion.
* Recast.
* Kill off another overloading of the term "mode".
* [texinfo] Define the term "advance width".
* Break Texinfo input lines in a roff-friendly way.
---
doc/groff.texi.in | 39 +++++++++++++++++++++++++++------------
man/groff.7.man | 21 +++++++++++----------
2 files changed, 38 insertions(+), 22 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 1ed65b581..67a2daf6c 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -14443,19 +14443,34 @@ request).
@endDefreq
@Defreq {cs, font [@Var{width} [@Var{em-size}]]}
-@cindex constant glyph spacing mode (@code{cs})
+@cindex constant glyph spacing (@code{cs})
@cindex mode, constant glyph spacing (@code{cs})
-@cindex glyph mode, constant spacing (@code{cs})
-@cindex @code{ps} request, and constant glyph spacing mode
-Switch to and from @dfn{constant glyph spacing mode}. If activated, the
-width of every glyph is @math{@var{width}/36} ems. The em size is given
-absolutely by @var{em-size}; if this argument is missing, the em value
-is taken from the current font size (as set with the @code{ps} request)
-when the font is effectively in use. Without second and third argument,
-constant glyph spacing mode is deactivated.
-
-Default scaling unit for @var{em-size} is @samp{z}; @var{width} is an
-integer.
+@cindex spacing, constant glyph (@code{cs})
+@cindex @code{ps} request, and constant glyph spacing
+Apply
+@dfn{constant glyph spacing}
+to font
+@var{font}.
+@cindex advance width
+@cindex width, advance
+The
+@dfn{advance width}
+of every glyph in the font---the amount the drawing position
+moves horizontally after setting the glyph---becomes
+@math{@var{width}/36} ems.
+The
+@var{em-size}
+argument overrides the font's em size;
+omitting it preserves the formatter's usual recomputation of
+@var{font}'s
+em size from the type size in effect each time that font is selected.
+Omitting both the second and third arguments deactivates
+constant glyph spacing for font
+@var{font}.
+
+The default scaling unit for @var{em-size} is @samp{z};
+@var{width}
+is an integer.
@endDefreq
@c ---------------------------------------------------------------------
diff --git a/man/groff.7.man b/man/groff.7.man
index 6b07db2c2..d5ccc0f25 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -3386,27 +3386,28 @@ compatibility mode per Boolean expression
.
.TPx
.REQ .cs font
-Disable constant-width glyph spacing mode for font
+Disable constant glyph spacing for font
.I font.
.
.TPx
.REQ .cs "font n"
-Enable constant-width glyph spacing mode for font
-.I font
-at
+Enable constant glyph spacing for font
+.IR font ,
+overriding the advance width of every glyph in font to
.IR n /36
ems.
.
.TPx
.REQ .cs "font n p"
-Enable constant-width glyph spacing mode for font
-.I font
-at
+Enable constant glyph spacing for font
+.IR font ,
+overriding the advance width of every glyph in font to
.IR n /36
-ems,
-as if one em equals
+ems with an assumed em size of
.I p
-scaled points.
+points
+(default scaling unit\~\c
+.scaleindicator z ).
.
.TPx
.REQ .cu
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
