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,6 +1123,40 @@ outfile.pdf</option> | ||
| 1123 | </listitem> | 1123 | </listitem> |
| 1124 | </varlistentry> | 1124 | </varlistentry> |
| 1125 | <varlistentry> | 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 | <term><option>--qdf</option></term> | 1160 | <term><option>--qdf</option></term> |
| 1127 | <listitem> | 1161 | <listitem> |
| 1128 | <para> | 1162 | <para> |
| @@ -3022,7 +3056,7 @@ print "\n"; | @@ -3022,7 +3056,7 @@ print "\n"; | ||
| 3022 | <listitem> | 3056 | <listitem> |
| 3023 | <para> | 3057 | <para> |
| 3024 | Bug fix: files whose /ID fields were other than 16 bytes long | 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 | </para> | 3060 | </para> |
| 3027 | </listitem> | 3061 | </listitem> |
| 3028 | <listitem> | 3062 | <listitem> |