gbranden pushed a commit to branch master
in repository groff.
commit 29ae8d90623c688885e7751822c52efe423edf06
Author: G. Branden Robinson <[email protected]>
AuthorDate: Sun Apr 12 07:16:28 2026 -0500
[doc,man]: Fix style nits in font/desc file stuff.
* Clarify wording. Bounding and containment are not identical.
* Continue killing off incoherent "intermediate output" terminology.
* Favor "recall" over "see" for for backward references.
* Recast.
* Tag the word "troff" with Texinfo's "@command", not "@code", to
satisfy semantic markup scruples and to ensure it gets set in a
consistent face.
* In our Texinfo manual, use man page cross references to material it
doesn't cover.
---
doc/groff.texi.in | 28 +++++++++++++++++++++-------
man/groff_font.5.man | 27 ++++++++++++++++-----------
2 files changed, 37 insertions(+), 18 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index fe28a671a..d5b8de34c 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -23325,8 +23325,12 @@ extend over more than one line.
@item sizescale @var{n}
@kindex sizescale
-A typographical point is subdivided into @var{n}@tie{}scaled points.
-The default is@tie{}@code{1}. @xref{Using Fractional Type Sizes}.
+A typographical point is subdivided into
+@var{n}@tie{}scaled
+points.
+The default
+is@tie{}@code{1}.
+Recall @ref{Using Fractional Type Sizes}.
@item styles @var{S1} @r{@dots{}} @var{Sm}
@kindex styles
@@ -23335,8 +23339,14 @@ The first@tie{}@var{m} mounting positions are
associated with styles
@item tcommand
@kindex tcommand
-The postprocessor can handle the @samp{t} and @samp{u} intermediate
-output commands.
+The postprocessor interprets the
+@code{t}
+and
+@code{u}
+output commands that
+GNU
+@command{troff} @c GNU
+produces.
@item unicode
@kindex unicode
@@ -23367,9 +23377,13 @@ The @code{grohtml} driver uses this directive.
@c XXX: Savannah #63074 is trying to make this obsolescent.
@item use_charnames_in_special
@kindex use_charnames_in_special
-GNU @code{troff} should encode special characters in arguments to device
-extension commands; see @ref{Postprocessor Access}. The @code{grohtml}
-driver uses this directive.
+GNU
+@command{troff} @c GNU
+should encode special characters
+in arguments to device extension commands;
+recall @ref{Postprocessor Access}.
+@cite{grohtml@r{(1)}}
+uses this directive.
@item vert @var{n}
@kindex vert
diff --git a/man/groff_font.5.man b/man/groff_font.5.man
index 375fceede..3ada6e291 100644
--- a/man/groff_font.5.man
+++ b/man/groff_font.5.man
@@ -390,13 +390,13 @@ The list can extend over more than one line.
.
.TP
.BI sizescale\~ n
-A typographical point
-is subdivided into
+A typographical point is subdivided into
.IR n \~scaled
points.
.
The default
.RB is\~ 1 .
+.\" Recall @ref{Using Fractional Type Sizes}.
.
.
.TP
@@ -412,10 +412,14 @@ font mounting positions are associated with styles
.
.TP
.B tcommand
-The postprocessor can handle the
+The postprocessor interprets the
.B t
-.RB and\~ u
-intermediate output commands.
+and
+.B u
+output commands that
+GNU
+.I troff \" GNU
+produces.
.
.
.TP
@@ -473,13 +477,14 @@ driver uses this directive.
.\" XXX: Savannah #63074 is trying to make this obsolescent.
.TP
.B use_charnames_in_special
-.I @g@troff
-should encode special characters in arguments to device extension
-commands.
+GNU
+.I troff \" GNU
+should encode special characters
+in arguments to device extension commands.
+.\" recall @ref{Postprocessor Access}.
.
-The
-.I \%grohtml
-driver uses this directive.
+.MR grohtml @MAN1EXT@
+uses this directive.
.
.
.TP
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
