diff options
Diffstat (limited to 'manual')
| -rw-r--r-- | manual/cli.rst | 9 | ||||
| -rw-r--r-- | manual/qpdf.1 | 3 | ||||
| -rw-r--r-- | manual/release-notes.rst | 7 |
3 files changed, 17 insertions, 2 deletions
diff --git a/manual/cli.rst b/manual/cli.rst index 0ccdee8f..dc82bf88 100644 --- a/manual/cli.rst +++ b/manual/cli.rst @@ -2805,6 +2805,9 @@ Overlay and Underlay ignored. You can also give a page range with --repeat to cause those pages to be repeated after the original pages are exhausted. + This options are repeatable. Pages will be stacked in order of + appearance: first underlays, then the original page, then overlays. + Run qpdf --help=page-ranges for help with page ranges. You can use :command:`qpdf` to overlay or underlay pages from other @@ -2823,8 +2826,10 @@ are applied, possibly obscured by the original page, and overlay files are drawn on top of the page to which they are applied, possibly obscuring the page. The ability to specify the file using the :qpdf:ref:`--file` option was added in qpdf 11.9.0. You can combine -overlay and underlay, but you can only specify each option at most one -time. +overlay and underlay. Starting in qpdf 11.9.0, you can specify these +options multiple times. The final page will be a stack containing the +underlays in order of appearance, then the original page, then the +overlays in order of appearance. The default behavior of overlay and underlay is that pages are taken from the overlay/underlay file in sequence and applied to diff --git a/manual/qpdf.1 b/manual/qpdf.1 index 4832d97b..8aa19d06 100644 --- a/manual/qpdf.1 +++ b/manual/qpdf.1 @@ -849,6 +849,9 @@ of the primary output until it runs out of pages, and any extra pages are ignored. You can also give a page range with --repeat to cause those pages to be repeated after the original pages are exhausted. +This options are repeatable. Pages will be stacked in order of +appearance: first underlays, then the original page, then overlays. + Run qpdf --help=page-ranges for help with page ranges. .PP Related Options: diff --git a/manual/release-notes.rst b/manual/release-notes.rst index 938d2705..b9f7d14b 100644 --- a/manual/release-notes.rst +++ b/manual/release-notes.rst @@ -48,6 +48,13 @@ Planned changes for future 12.x (subject to change): as well. These new options can be freely intermixed with positional arguments. + - Allow :qpdf:ref:`--overlay` and :qpdf:ref:`--underlay` to be + repeated. They may appear multiple times on the command-line and + will be stacked in the order in which they appear. In QPDFJob + JSON (see :ref:`qpdf-job`), the `overlay` and `underlay` keys + may contain arrays. For compatibility, they may also contain a + single dictionary. + - Library Enhancements - Add ``file()``, ``range()``, and ``password()`` to |