From df33c368b472b6e2c2f011fc111c637b3dfca720 Mon Sep 17 00:00:00 2001
From: Jay Berkenbilt <ejb@ql.org>
Date: Sat, 12 Aug 2017 11:49:04 -0400
Subject: Change --single-pages to --split-pages

This is in preparation for implementing page groups.
---
 manual/qpdf-manual.xml | 38 +++++++++++++++++++++-----------------
 1 file changed, 21 insertions(+), 17 deletions(-)

(limited to 'manual')

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>
-- 
cgit v1.2.3-54-g00ecf