diff options
author | Jay Berkenbilt <ejb@ql.org> | 2024-02-17 22:00:53 +0100 |
---|---|---|
committer | Jay Berkenbilt <ejb@ql.org> | 2024-02-17 22:13:46 +0100 |
commit | c1a48ec81dfd7252c7f414257c16b5bc522f97f5 (patch) | |
tree | 9956f33f770b8c2d61267787e67c16fc59cbcc3e /manual | |
parent | 7bc52c5728591674f864ce7ff10c4bbe24787333 (diff) | |
download | qpdf-c1a48ec81dfd7252c7f414257c16b5bc522f97f5.tar.zst |
Documentation fixes for set/remove page labels
Diffstat (limited to 'manual')
-rw-r--r-- | manual/cli.rst | 25 | ||||
-rw-r--r-- | manual/qpdf.1 | 10 |
2 files changed, 31 insertions, 4 deletions
diff --git a/manual/cli.rst b/manual/cli.rst index dc82bf88..aee2c8ec 100644 --- a/manual/cli.rst +++ b/manual/cli.rst @@ -1779,7 +1779,8 @@ Related Options Exclude page labels (explicit page numbers) from the output file. - Exclude page labels (explicit page numbers) from the output file. + Exclude page labels (explicit page numbers) from the output file by + omitting the ``/PageLabels`` dictionary in the document catalog. See also :qpdf:ref:`--set-page-labels`. .. qpdf:option:: --set-page-labels label-spec ... -- @@ -1805,9 +1806,18 @@ Related Options - r: Lower-case Roman numerals - omitted: the page number does not appear, though the prefix, if specified will still appear + - "start" must be a number >= 1 - "prefix"` may be any string and is prepended to each page label + The first label spec must have a first-page value of 1, + indicating the first page of the document. If multiple page + label specs are specified, they must be given in increasing + order. + + If multiple page label specs are specified, they must be given + in increasing order. + A given page label spec causes pages to be numbered according to that scheme starting with first-page and continuing until the next label spec or the end of the document. If you want to omit @@ -1819,8 +1829,9 @@ Related Options 1 and continuing sequentially until the end of the document. For additional examples, please consult the manual. - Set page labels (explicit page numbers) for the entire file. A PDF - file's pages can be explicitly numbered using page labels. Page + Set page labels (explicit page numbers) for the entire file. This + generates a ``/PageLabels`` dictionary in the document catalog. A + PDF file's pages can be explicitly numbered using page labels. Page labels in a PDF file have an optional type (Arabic numerals, upper/lower-case alphabetic characters, upper/lower-case Roman numerals), an optional prefix, and an optional starting value, @@ -1850,16 +1861,22 @@ Related Options - omitted: the page number does not appear, though the prefix, if specified will still appear + - :samp:`{start}` must be a number ≥ 1 + - :samp:`{prefix}` may be any string and is prepended to each page label + The first label spec must have a :samp:`{first-page}` value of + ``1``, indicating the first page of the document. If multiple page + label specs are specified, they must be given in increasing order. + A given page label spec causes pages to be numbered according to that scheme starting with :samp:`{first-page}` and continuing until the next label spec or the end of the document. If you want to omit numbering starting at a certain page, you can use :samp:`{first-page}:` as the spec. - Here are some example page labeling schemes. First these examples, + Here are some example page labeling schemes. For these examples, assume a 50-page document. - ``1:a 5:D`` diff --git a/manual/qpdf.1 b/manual/qpdf.1 index 8aa19d06..d0b2d05e 100644 --- a/manual/qpdf.1 +++ b/manual/qpdf.1 @@ -558,9 +558,19 @@ page - omitted: the page number does not appear, though the prefix, if specified will still appear .IP \[bu] +"start" must be a number >= 1 +.IP \[bu] "prefix"` may be any string and is prepended to each page label +The first label spec must have a first-page value of 1, +indicating the first page of the document. If multiple page +label specs are specified, they must be given in increasing +order. + +If multiple page label specs are specified, they must be given +in increasing order. + A given page label spec causes pages to be numbered according to that scheme starting with first-page and continuing until the next label spec or the end of the document. If you want to omit |