[groff] 07/08: gropdf(1): Clarify.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit c578f11b111280429f43843048aae43e41914eb7
Author: G. Branden Robinson <g.branden.robinson@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