aboutsummaryrefslogtreecommitdiffstats
path: root/manual
diff options
context:
space:
mode:
authorJay Berkenbilt <ejb@ql.org>2018-06-22 16:45:31 +0200
committerJay Berkenbilt <ejb@ql.org>2018-06-22 16:45:31 +0200
commitc71dc6888c69aea7a892b313e07dba377200a6c9 (patch)
treeb04fdd17c80c9f3c6c80c07110055134f4f24cf1 /manual
parent38c9ed23c3d05c6c217db287ae15c97498a69dd7 (diff)
downloadqpdf-c71dc6888c69aea7a892b313e07dba377200a6c9.tar.zst
Don't prune resource dictionaries on errors or by request
If we are unable to filter a page's content streams, don't attempt to remove objects from the page's resource dictionary. Also provide a command line option to suppress resource removal in case we ever need this as a workaround for some bug or broken PDF files.
Diffstat (limited to 'manual')
-rw-r--r--manual/qpdf-manual.xml22
1 files changed, 22 insertions, 0 deletions
diff --git a/manual/qpdf-manual.xml b/manual/qpdf-manual.xml
index 3feb9fda..49e5b838 100644
--- a/manual/qpdf-manual.xml
+++ b/manual/qpdf-manual.xml
@@ -1126,6 +1126,28 @@ outfile.pdf</option>
lengths as direct or indirect differently from the original
file, and the original file may have gaps in its numbering.
</para>
+ <para>
+ See also <option>--preserve-unreferenced-resources</option>,
+ which does something completely different.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--preserve-unreferenced-resources</option></term>
+ <listitem>
+ <para>
+ 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.
+ </para>
+ <para>
+ See also <option>--preserve-unreferenced-resources</option>,
+ which does something completely different.
+ </para>
</listitem>
</varlistentry>
<varlistentry>