Commit 131a21d36f68370c39b349b8c3628dac5ad8f73a
1 parent
a5a016cd
Document that linearize disables qdf (fixes #312)
Showing
2 changed files
with
7 additions
and
3 deletions
manual/qpdf-manual.xml
| ... | ... | @@ -1826,7 +1826,8 @@ outfile.pdf</option> |
| 1826 | 1826 | <listitem> |
| 1827 | 1827 | <para> |
| 1828 | 1828 | Turns on QDF mode. For additional information on QDF, please |
| 1829 | - see <xref linkend="ref.qdf"/>. | |
| 1829 | + see <xref linkend="ref.qdf"/>. Note that | |
| 1830 | + <option>--linearize</option> disables QDF mode. | |
| 1830 | 1831 | </para> |
| 1831 | 1832 | </listitem> |
| 1832 | 1833 | </varlistentry> |
| ... | ... | @@ -2364,7 +2365,9 @@ outfile.pdf</option> |
| 2364 | 2365 | some restrictions, in an ordinary text editor. This can be very |
| 2365 | 2366 | useful for experimenting with different PDF constructs or for |
| 2366 | 2367 | making one-off edits to PDF files (though there are other reasons |
| 2367 | - why this may not always work). | |
| 2368 | + why this may not always work). Note that QDF mode does not support | |
| 2369 | + linearized files. If you enable linearization, QDF mode is | |
| 2370 | + automatically disabled. | |
| 2368 | 2371 | </para> |
| 2369 | 2372 | <para> |
| 2370 | 2373 | It is ordinarily very difficult to edit PDF files in a text editor | ... | ... |
qpdf/qpdf.cc
| ... | ... | @@ -1378,7 +1378,8 @@ ArgParser::argHelp() |
| 1378 | 1378 | << " including DCT (JPEG)\n" |
| 1379 | 1379 | << "\n" |
| 1380 | 1380 | << "In qdf mode, by default, content normalization is turned on, and the\n" |
| 1381 | - << "stream data mode is set to uncompress.\n" | |
| 1381 | + << "stream data mode is set to uncompress. QDF mode does not support\n" | |
| 1382 | + << "linearized files. The --linearize flag disables qdf mode.\n" | |
| 1382 | 1383 | << "\n" |
| 1383 | 1384 | << "Setting the minimum PDF version of the output file may raise the version\n" |
| 1384 | 1385 | << "but will never lower it. Forcing the PDF version of the output file may\n" | ... | ... |