gbranden pushed a commit to branch master
in repository groff.
commit 89072d7350172a83fa9f6cfa188c256cb48fce11
Author: G. Branden Robinson <[email protected]>
AuthorDate: Tue Jul 21 00:01:48 2026 -0500
[ms]: Recast doc of TOC resequencing.
* Eschew "TOC" abbreviation.
* Favor active voice over passive.
* Favor present tense over future.
---
doc/groff.texi.in | 12 ++++++++----
doc/ms.ms.in | 10 +++++++---
tmac/groff_ms.7.man | 12 ++++++++----
3 files changed, 23 insertions(+), 11 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index db646b04f..173639552 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -3373,10 +3373,14 @@ output was designed for the production of hard copy,
the traditional procedure was to manually relocate the pages containing
the table of contents between the cover page and the body text.
Today,
-page resequencing is more often done in the digital domain,
-and if you use a separate cover page with @code{RP}
-(and use @option{-T pdf}) the TOC will
-be positioned immediately after this cover page.
+page resequencing is more often done in the digital domain;
+if you mandate a separate cover page by calling
+@code{RP}
+and use the
+@code{pdf}
+output device,
+@code{groff} @file{ms}
+positions the table of contents immediately after this cover page.
An index works similarly,
but because it typically needs to be sorted after collection,
its preparation requires separate processing.
diff --git a/doc/ms.ms.in b/doc/ms.ms.in
index 7d8a913a2..ba0e04098 100644
--- a/doc/ms.ms.in
+++ b/doc/ms.ms.in
@@ -561,11 +561,15 @@ the traditional procedure was to manually relocate the
pages containing
the table of contents between the cover page and the body text.
.
Today,
-page resequencing is more often done in the digital domain,
+page resequencing is more often done in the digital domain;
.pdf-feature-begin
-and if you use a separate title page with
+if you mandate a separate cover page by calling
.XR RP "" "" RP
-the TOC will be positioned immediately after the title.
+and use the
+.B pdf \^\[rq] \[lq]
+output device,
+.I "groff ms"
+positions the table of contents immediately after this cover page.
.pdf-feature-end
.
An index works similarly,
diff --git a/tmac/groff_ms.7.man b/tmac/groff_ms.7.man
index 84723d569..85d811734 100644
--- a/tmac/groff_ms.7.man
+++ b/tmac/groff_ms.7.man
@@ -229,10 +229,14 @@ the traditional procedure was to manually relocate the
pages containing
the table of contents between the cover page and the body text.
.
Today,
-page resequencing is more often done in the digital domain,
-such as when
-.B PDFFEAT
-is turned on.
+page resequencing is more often done in the digital domain;
+if you mandate a separate cover page by calling
+.B RP
+and use the
+.RB \[lq] pdf \^\[rq]
+output device,
+.I "groff ms"
+positions the table of contents immediately after this cover page.
.
An index works similarly,
but because it typically needs to be sorted after collection,
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
