Commit b3dfbe3cd70edcf2b63288a3c3b118699c6d88c3
1 parent
e429a2e1
Document new command-line flags
Showing
1 changed file
with
35 additions
and
1 deletions
manual/qpdf-manual.xml
| ... | ... | @@ -1123,6 +1123,40 @@ outfile.pdf</option> |
| 1123 | 1123 | </listitem> |
| 1124 | 1124 | </varlistentry> |
| 1125 | 1125 | <varlistentry> |
| 1126 | + <term><option>--linearize-pass1=<replaceable>file</replaceable></option></term> | |
| 1127 | + <listitem> | |
| 1128 | + <para> | |
| 1129 | + Write the first pass of linearization to the named file. The | |
| 1130 | + resulting file is not a valid PDF file. This option is useful | |
| 1131 | + only for debugging <classname>QPDFWriter</classname>'s | |
| 1132 | + linearization code. When qpdf linearizes files, it writes the | |
| 1133 | + file in two passes, using the first pass to calculate sizes | |
| 1134 | + and offsets that are required for hint tables and the | |
| 1135 | + linearization dictionary. Ordinarily, the first pass is | |
| 1136 | + discarded. This option enables it to be captured. | |
| 1137 | + </para> | |
| 1138 | + </listitem> | |
| 1139 | + </varlistentry> | |
| 1140 | + <varlistentry> | |
| 1141 | + <term><option>--coalesce-contents</option></term> | |
| 1142 | + <listitem> | |
| 1143 | + <para> | |
| 1144 | + When a page's contents are split across multiple streams, this | |
| 1145 | + option causes qpdf to combine them into a single stream. Use | |
| 1146 | + of this option is never necessary for ordinary usage, but it | |
| 1147 | + can help when working with some files in some cases. For | |
| 1148 | + example, some PDF writers split page contents into small | |
| 1149 | + streams at arbitrary points that may fall in the middle of | |
| 1150 | + lexical tokens within the content, and some PDF readers may | |
| 1151 | + get confused on such files. If you use qpdf to coalesce the | |
| 1152 | + content streams, such readers may be able to work with the | |
| 1153 | + file more easily. This can also be combined with QDF mode or | |
| 1154 | + content normalization to make it easier to look at all of a | |
| 1155 | + page's contents at once. | |
| 1156 | + </para> | |
| 1157 | + </listitem> | |
| 1158 | + </varlistentry> | |
| 1159 | + <varlistentry> | |
| 1126 | 1160 | <term><option>--qdf</option></term> |
| 1127 | 1161 | <listitem> |
| 1128 | 1162 | <para> |
| ... | ... | @@ -3022,7 +3056,7 @@ print "\n"; |
| 3022 | 3056 | <listitem> |
| 3023 | 3057 | <para> |
| 3024 | 3058 | Bug fix: files whose /ID fields were other than 16 bytes long |
| 3025 | - can now be properly linearlized | |
| 3059 | + can now be properly linearized | |
| 3026 | 3060 | </para> |
| 3027 | 3061 | </listitem> |
| 3028 | 3062 | <listitem> | ... | ... |