octoleo
/
qpdf
mirror of https://github.com/qpdf/qpdf.git
2
1
Fork 0
Code Issues Releases Wiki Activity

Emphasize --deterministic-id over --static-id in idempotency doc

This commit is contained in:
Jay Berkenbilt 2023-02-18 19:42:42 -05:00
parent 0f97e98203
commit b4c36d9b73
3 changed files with 9 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
TODO
View File

@ -12,8 +12,6 @@ Always
* Fix #874 -- make args in --encrypt to match the json and make * Fix #874 -- make args in --encrypt to match the json and make
positional fill in the gaps positional fill in the gaps
* Maybe fix #553 -- use file times for attachments * Maybe fix #553 -- use file times for attachments
* Clarify idempotency section to emphasize --deterministic-id over
--static-id
Next Next
==== ====

2
job.sums
View File

@ -14,4 +14,4 @@ libqpdf/qpdf/auto_job_json_decl.hh 06caa46eaf71db8a50c046f91866baa8087745a947431
libqpdf/qpdf/auto_job_json_init.hh 85ac7e5c66f14c767419823eac84bdea4bd72d690bfe12b533321e5708e644b7 libqpdf/qpdf/auto_job_json_init.hh 85ac7e5c66f14c767419823eac84bdea4bd72d690bfe12b533321e5708e644b7
libqpdf/qpdf/auto_job_schema.hh 5e0f5cb7d462716fe52548b2ae1a8eb6f3c900016e915140eea37f78cee45b2b libqpdf/qpdf/auto_job_schema.hh 5e0f5cb7d462716fe52548b2ae1a8eb6f3c900016e915140eea37f78cee45b2b
manual/_ext/qpdf.py 6add6321666031d55ed4aedf7c00e5662bba856dfcd66ccb526563bffefbb580 manual/_ext/qpdf.py 6add6321666031d55ed4aedf7c00e5662bba856dfcd66ccb526563bffefbb580
manual/cli.rst 255db0c62765b39de9a71d3d755479235f5bbce32f2902ec5e0e201f265e322d manual/cli.rst ab2b2feb3217151a7a7f67b1774bd7fb704d94a325282e691ea1fd0a7cbf11f0

15
manual/cli.rst
View File

@ -3397,20 +3397,21 @@ random element, as well as the interaction of stream length encoding
with dictionary key sorting. with dictionary key sorting.
It is possible to get idempotent behavior by using the It is possible to get idempotent behavior by using the
:qpdf:ref:`--static-id` or :qpdf:ref:`--deterministic-id` option with :qpdf:ref:`--deterministic-id` (or, for testing only,
qpdf and running it *three* times so that you are processing the :qpdf:ref:`--static-id`) option with qpdf and running it *three* times
output of qpdf on its own previous output. For example, in this so that you are processing the output of qpdf on its own previous
sequence of commands: output. For example, in this sequence of commands:
:: ::
qpdf any-file.pdf 1.pdf qpdf any-file.pdf 1.pdf
qpdf --static-id 1.pdf 2.pdf qpdf --deterministic-id 1.pdf 2.pdf
qpdf --static-id 2.pdf 3.pdf qpdf --deterministic-id 2.pdf 3.pdf
the files :file:`2.pdf` and :file:`3.pdf` should be *byte-for-byte* 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 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 Related Options
~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~