gbranden pushed a commit to branch master
in repository groff.
commit 0c1d91c1643d3c384c209fdc7f323a272f62d0fa
Author: G. Branden Robinson <[email protected]>
AuthorDate: Thu May 8 05:52:39 2025 -0500
doc/groff.texi.in, groff(7): Clarify \H behavior.
...and add advice. Neither AT&T nor GNU troffs adjust their notion of
the line height to accommodate `\H` usage.
---
doc/groff.texi.in | 16 +++++++++++++---
man/groff.7.man | 4 ++++
2 files changed, 17 insertions(+), 3 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 4332f7d77..ff19dcbe7 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -11875,9 +11875,19 @@ necessary in GNU @code{troff}. Nevertheless, they are
supported.
@cindex changing the font height (@code{\H})
@cindex font height, changing (@code{\H})
@cindex height, font, changing (@code{\H})
-Change (increment, decrement) the height of the current font, but not
-the width. If @var{height} is zero, restore the original height.
-Default scaling unit is @samp{z}.
+Change (increment, decrement) the height of the current font,
+but not the width.
+If
+@var{height}
+is zero,
+set the font height to the selected type size.
+The default scaling unit is @samp{z}.
+
+Changing the font height does not affect vertical spacing;
+dramatic changes may be better accompanied by an
+@code{\x}
+escape sequence to add extra pre-vertical space to the output line.
+@xref{Manipulating Spacing}.
The read-only register @code{.height} contains the font height as set by
@code{\H}.
diff --git a/man/groff.7.man b/man/groff.7.man
index c8112efee..7ce28e669 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -5608,6 +5608,10 @@ Set height of current font to
points
(or specified units).
.
+If
+.I N
+is zero,
+set the font height to the selected type size.
.
.TP
.ESC k r
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
