diff options
Diffstat (limited to 'manual/qpdf-manual.xml')
-rw-r--r-- | manual/qpdf-manual.xml | 38 |
1 files changed, 21 insertions, 17 deletions
diff --git a/manual/qpdf-manual.xml b/manual/qpdf-manual.xml index 06504d33..3f3415c8 100644 --- a/manual/qpdf-manual.xml +++ b/manual/qpdf-manual.xml @@ -350,57 +350,61 @@ make </listitem> </varlistentry> <varlistentry> - <term><option>--single-pages</option></term> + <term><option>--split-pages=[n]</option></term> <listitem> <para> - Write each page to a separate output file. Output file names - are generated as follows: + Write each group of <option>n</option> pages to a separate + output file. If <option>n</option> is not specified, create + single pages. Output file names are generated as follows: <itemizedlist> <listitem> <para> If the string <literal>%d</literal> appears in the output - file name, it is replaced with a zero-padded page number - starting from 1. + file name, it is replaced with a range of zero-padded page + numbers starting from 1. </para> </listitem> <listitem> <para> Otherwise, if the output file name ends in <filename>.pdf</filename> (case insensitive), a zero-padded - page number, preceded by a dash, is inserted before the - file extension. + page range, preceded by a dash, is inserted before the file + extension. </para> </listitem> <listitem> <para> Otherwise, the file name is appended with a zero-padded - page number preceded by a dash. + page range preceded by a dash. </para> </listitem> </itemizedlist> </para> <para> + Page ranges are a single number in the case of single-page + groups or two numbers separated by a dash otherwise. For example, if <filename>infile.pdf</filename> has 12 pages <itemizedlist> <listitem> <para> - <command>qpdf infile.pdf %d-out</command> would generate - files <filename>01-out</filename> through + <command>qpdf --split-pages infile.pdf %d-out</command> + would generate files <filename>01-out</filename> through <filename>12-out</filename> </para> </listitem> <listitem> <para> - <command>qpdf infile.pdf outfile.pdf - --single-pages</command> would generate files - <filename>outfile-01.pdf</filename> through - <filename>outfile-12.pdf</filename> + <command>qpdf --split-pages=2 infile.pdf + outfile.pdf</command> would generate files + <filename>outfile-01-02.pdf</filename> through + <filename>outfile-11-12.pdf</filename> </para> </listitem> <listitem> <para> - <command>qpdf infile.pdf something.else</command> would generate - files <filename>something.else-01</filename> through + <command>qpdf --split-pages infile.pdf + something.else</command> would generate files + <filename>something.else-01</filename> through <filename>something.else-12</filename> </para> </listitem> @@ -413,7 +417,7 @@ make the output into it. If you require the global data, you will have to run <command>qpdf</command> with the <option>--pages</option> option once for each file. Using - <option>--single-pages</option> is much faster if you don't + <option>--split-pages</option> is much faster if you don't require the global data. </para> </listitem> |