From c9cc83621bf383a135699e2c952713eb592ebcb7 Mon Sep 17 00:00:00 2001 From: Jay Berkenbilt Date: Sat, 9 Nov 2019 11:42:16 -0500 Subject: Add the word "slow" to preserved unreferenced resources docs (fixes #380) This makes it more likely for someone who notices a big slow-down in page splitting to discover the option. --- manual/qpdf-manual.xml | 24 +++++++++++++++--------- 1 file changed, 15 insertions(+), 9 deletions(-) (limited to 'manual/qpdf-manual.xml') diff --git a/manual/qpdf-manual.xml b/manual/qpdf-manual.xml index 0420ad33..58d21435 100644 --- a/manual/qpdf-manual.xml +++ b/manual/qpdf-manual.xml @@ -1862,10 +1862,14 @@ outfile.pdf Starting with qpdf 8.1, when splitting pages, qpdf ordinarily attempts to remove images and fonts that are not used by a page even if they are referenced in the page's resources - dictionary. This option suppresses that behavior. The only - reason to use this is if you suspect that qpdf is removing - resources it shouldn't be removing. If you encounter that - case, please report it as a bug. + dictionary. This option suppresses that behavior. There are + few reasons to use this option. One reason to use this is if + you suspect that qpdf is removing resources it shouldn't be + removing. If you encounter that case, please report it as a + bug. Another reason is that the new behavior can be much + slower for files that include a very large number of images or + other XObjects on a page. In that case, using this option will + return qpdf to the old behavior and speed. See also , which does @@ -6013,11 +6017,13 @@ print "\n"; not actually referenced and omits them from the output file. This change can cause a significant reduction in the size of split PDF files for files created by some software packages. - Prior versions of qpdf would believe the document metadata - and sometimes include all the images from all the other - pages even though the pages were no longer present. In the - unlikely event that the old behavior should be desired, it - can be enabled by specifying + In some cases, it can also make page splitting slower. Prior + versions of qpdf would believe the document metadata and + sometimes include all the images from all the other pages + even though the pages were no longer present. In the + unlikely event that the old behavior should be desired, or + if you have a case where page splitting is very slow, the + old behavior (and speed) can be enabled by specifying . For additional details, please see . -- cgit v1.2.3-54-g00ecf