From b4c36d9b73bc9794ea70d935448b8555630c3004 Mon Sep 17 00:00:00 2001 From: Jay Berkenbilt Date: Sat, 18 Feb 2023 19:42:42 -0500 Subject: Emphasize --deterministic-id over --static-id in idempotency doc --- manual/cli.rst | 15 ++++++++------- 1 file changed, 8 insertions(+), 7 deletions(-) (limited to 'manual') 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 ~~~~~~~~~~~~~~~ -- cgit v1.2.3-54-g00ecf