gbranden pushed a commit to branch master
in repository groff.
commit c578f11b111280429f43843048aae43e41914eb7
Author: G. Branden Robinson <g.branden.robin...@gmail.com>
AuthorDate: Sun Jan 7 19:27:17 2024 -0600
gropdf(1): Clarify.
* Fix unfinished list of common pagination schemes. Motivate the
letter-prefix scheme.
* Clarify where the 'pagenumbering' device control command needs to be
placed relative to a *roff page break.
Exhibit:
$ groff -ms -Tpdf <<EOF
.pdfpagenumbering roman
.P1
.LP
Foobar.
.\"pdfpagenumbering Decimal \" WRONG
.bp
.pdfpagenumbering Decimal \" RIGHT
This is the second page.
EOF
---
src/devices/gropdf/gropdf.1.man | 16 ++++++++++------
1 file changed, 10 insertions(+), 6 deletions(-)
diff --git a/src/devices/gropdf/gropdf.1.man b/src/devices/gropdf/gropdf.1.man
index 56c949575..1a48e01f3 100644
--- a/src/devices/gropdf/gropdf.1.man
+++ b/src/devices/gropdf/gropdf.1.man
@@ -9,7 +9,7 @@ output driver for Portable Document Format
.\" Legal Terms
.\" ====================================================================
.\"
-.\" Copyright (C) 2011-2023 Free Software Foundation, Inc.
+.\" Copyright (C) 2011-2024 Free Software Foundation, Inc.
.\"
.\" Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are
@@ -1399,16 +1399,20 @@ the file,
but this might not match the desired numbering scheme.
.
A document may bear a cover sheet
-(which has no page number),
+(which has no page number);
front matter
(possibly including a table of contents)
-that uses lowercase roman numerals,
+that uses lowercase roman numerals;
the main matter,
-which uses arabic numerals.
+which uses arabic numerals;
+and back matter,
+which may include appendices that are each prefixed with a letter and
+independently numbered.
.
-Place this command where the numbering system is to change.
+Place this command prior to breaking the page to which the new numbering
+scheme is to apply.
.
-It then applies until changed again.
+It then persists until changed again.
.
.
.P
_______________________________________________
Groff-commit mailing list
Groff-commit@gnu.org
https://lists.gnu.org/mailman/listinfo/groff-commit
