Automated changes for --set-page-labels

This commit contains the changes from generate_auto_job based on
manual changes from the previous commit.

1 files changed, 39 insertions, 0 deletions

diff --git a/manual/qpdf.1 b/manual/qpdf.1
index bf5e9792..44ee538a 100644
--- a/manual/qpdf.1
+++ b/manual/qpdf.1
@@ -516,6 +516,45 @@ Prevent inline images from being considered by --optimize-images.
 .TP
 .B --remove-page-labels \-\- remove explicit page numbers
 Exclude page labels (explicit page numbers) from the output file.
+.TP
+.B --set-page-labels \-\- number pages for the entire document
+--set-page-labels label-spec ... --
+
+Set page labels (explicit page numbers) for the entire file.
+Each label-spec has the form
+
+first-page:[type][/start[/prefix]]
+
+where
+
+.IP \[bu]
+"first-page" represents a sequential page number using the
+same format as page ranges: a number, a number preceded by "r"
+to indicate counting from the end, or "z" indicating the last
+page
+.IP \[bu]
+"type" is one of
+- D: Arabic numerals (digits)
+- A: Upper-case alphabetic characters
+- a: Lower-case alphabetic characters
+- R: Upper-case Roman numerals
+- r: Lower-case Roman numerals
+- omitted: the page number does not appear, though the prefix,
+  if specified will still appear
+.IP \[bu]
+"prefix"` may be any string and is prepended to each page
+label
+
+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
+numbering starting at a certain page, you can use first-page: as
+the spec.
+
+Example: "1:r 5:D" would number the first four pages i through
+iv, then the remaining pages with Arabic numerals starting with
+1 and continuing sequentially until the end of the document. For
+additional examples, please consult the manual.
 .SH ENCRYPTION (create encrypted files)
 Create encrypted files. Usage: