gbranden pushed a commit to branch master
in repository groff.
commit 78fc3cc5a34f1ebc7ff161e38256b1a1b3b62bb6
Author: G. Branden Robinson <[email protected]>
AuthorDate: Fri Jul 10 03:41:51 2026 -0500
[ms]: Revise doc abstract and introduction.
* Tighten introduction of `PDFFEAT` register.
* Note PDF feature support in abstract and introduction.
* Add comment to "ms.ms" illustrating how to generate PDF version of it.
* Commit vertical management sin for the sake of example economy.
* Drop introduction to `PDFFEAT` register in man page. We want the man
page to be a (relatively) terse reference, and this material is
already covered later in its "Using PDF features with ms" section.
---
doc/groff.texi.in | 8 +++++++-
doc/ms.ms.in | 18 +++++++++---------
tmac/groff_ms.7.man | 12 +++---------
3 files changed, 19 insertions(+), 19 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 3fb10e7bd..57e4e8677 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -3049,7 +3049,9 @@ automatically numbered headings,
several paragraph styles,
a variety of text styling options,
footnotes,
-and multi-column page layouts.
+multi-column page layouts,
+and support for PDF features when using
+@samp{-T pdf}.
@file{ms}
supports the
@command{tbl},
@@ -3112,6 +3114,10 @@ numerals,
and
@samp{-}.
Macro arguments surrounded by [brackets] are optional.
+Setting the register
+@code{PDFFEAT}
+to 1 on the command line enables PDF features.
+@c We don't mess with red text in the Texinfo version of this material.
@menu
* ms basic information::
diff --git a/doc/ms.ms.in b/doc/ms.ms.in
index a489028c5..b127c4e10 100644
--- a/doc/ms.ms.in
+++ b/doc/ms.ms.in
@@ -1,4 +1,5 @@
.\" groff -ept -ms
+.\" groff -ept -r PDFFEAT=1 -ms -T pdf
.\" nroff -t -rLL=$(stty size | cut -f2 -d' ')n -ms
.\"
.\" Copyright 2001-2026 Free Software Foundation, Inc.
@@ -99,7 +100,8 @@ several paragraph styles,
a variety of text styling options,
footnotes,
multi-column page layouts,
-and support for PDF features when using -Tpdf.
+and support for PDF features when using
+.CW -Tpdf . \" omitting the space after "T" fits better
.
.I ms
supports the
@@ -125,6 +127,8 @@ and Research Tenth Edition Unix.
.
.
.\" ------------------------- End of cover page ------------------------
+.\" I feel so dirty, but this fits both example boxes on the page.
+.if t .sp -0.5625v
.NH 1
Introduction
.XS
@@ -180,14 +184,10 @@ and
.
Macro arguments surrounded by [brackets] are optional.
.
-.
-.PP
-To turn on PDF features please use
-.CW -rPDFFEAT=1
-in the groff command.
-Changes to the operation of
-.I ms
-when PDFFEAT is on are shown in \m[red]red\m[] below.
+Setting the register
+.CW PDFFEAT
+to 1 on the command line enables PDF features,
+shown in \m[red]red\m[] below.
.
.
.KS
diff --git a/tmac/groff_ms.7.man b/tmac/groff_ms.7.man
index 9c3215b97..f65250640 100644
--- a/tmac/groff_ms.7.man
+++ b/tmac/groff_ms.7.man
@@ -91,7 +91,9 @@ automatically numbered headings,
several paragraph styles,
a variety of text styling options,
footnotes,
-and multi-column page layouts.
+multi-column page layouts,
+and support for PDF features when using
+.RB \[lq] "\-T pdf" \|\[rq].
.
.I ms
supports the
@@ -104,14 +106,6 @@ preprocessors for inclusion of tables,
mathematical equations,
diagrams,
and consistently formatted bibliographic citations.
-If the document is intended to be a pdf (by
-using
-.BR -Tpdf ),
-extra pdf features can be enabled by using
-.B -rPDFFEAT=1
-on the command line.
-This will turn on a bookmark panel, clickable
-TOC entries, and other pdf features described below.
.
.P
.I "groff ms"
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
