diff options
| author | Jay Berkenbilt <ejb@ql.org> | 2023-02-19 01:42:42 +0100 |
|---|---|---|
| committer | Jay Berkenbilt <ejb@ql.org> | 2023-02-19 01:42:42 +0100 |
| commit | b4c36d9b73bc9794ea70d935448b8555630c3004 (patch) | |
| tree | cd01da916701948a838e9749508e7dee668df2b8 /manual/cli.rst | |
| parent | 0f97e98203dfa78cf3273005f215d2d026390e5c (diff) | |
| download | qpdf-b4c36d9b73bc9794ea70d935448b8555630c3004.tar.zst | |
Emphasize --deterministic-id over --static-id in idempotency doc
Diffstat (limited to 'manual/cli.rst')
| -rw-r--r-- | manual/cli.rst | 15 |
1 files changed, 8 insertions, 7 deletions
diff --git a/manual/cli.rst b/manual/cli.rst index 6fab24d5..ef80933e 100644 --- a/manual/cli.rst +++ b/manual/cli.rst @@ -3397,20 +3397,21 @@ random element, as well as the interaction of stream length encoding with dictionary key sorting. It is possible to get idempotent behavior by using the -:qpdf:ref:`--static-id` or :qpdf:ref:`--deterministic-id` option with -qpdf and running it *three* times so that you are processing the -output of qpdf on its own previous output. For example, in this -sequence of commands: +:qpdf:ref:`--deterministic-id` (or, for testing only, +:qpdf:ref:`--static-id`) option with qpdf and running it *three* times +so that you are processing the output of qpdf on its own previous +output. For example, in this sequence of commands: :: qpdf any-file.pdf 1.pdf - qpdf --static-id 1.pdf 2.pdf - qpdf --static-id 2.pdf 3.pdf + qpdf --deterministic-id 1.pdf 2.pdf + qpdf --deterministic-id 2.pdf 3.pdf the files :file:`2.pdf` and :file:`3.pdf` should be *byte-for-byte* identical. The qpdf test suite relies on this behavior. See also -:qpdf:ref:`--static-aes-iv`. +:qpdf:ref:`--static-aes-iv`, which should also be used only for +testing. Related Options ~~~~~~~~~~~~~~~ |