From 53d8e916b75b983c18d4611e91d6e74cb51a49ec Mon Sep 17 00:00:00 2001
From: Jay Berkenbilt <ejb@ql.org>
Date: Sat, 12 Jan 2019 09:21:52 -0500
Subject: Interpret . in --pages as a shortcut for the primary file

---
 manual/qpdf-manual.xml | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

(limited to 'manual/qpdf-manual.xml')

diff --git a/manual/qpdf-manual.xml b/manual/qpdf-manual.xml
index d30e8ea4..f7c528b7 100644
--- a/manual/qpdf-manual.xml
+++ b/manual/qpdf-manual.xml
@@ -955,6 +955,11 @@ make
     &ldquo;<option>--</option>&rdquo; terminates parsing of page
     selection flags.
    </para>
+   <para>
+    Starting with qpf 8.4, the special input file name
+    &ldquo;<filename>.</filename>&rdquo; can be used shortcut for the
+    primary input filename.
+   </para>
    <para>
     For each file that pages should be taken from, specify the file, a
     password needed to open the file (if any), and a page range.  The
@@ -1075,7 +1080,7 @@ make
     <filename>infile.pdf</filename> while preserving all metadata
     associated with that file, you could use
 
-    <programlisting><command>qpdf</command> <option>infile.pdf --pages infile.pdf 1-5 -- outfile.pdf</option>
+    <programlisting><command>qpdf</command> <option>infile.pdf --pages . 1-5 -- outfile.pdf</option>
 </programlisting>
     If you wanted pages 1 through 5 from
     <filename>infile.pdf</filename> but you wanted the rest of the
@@ -1087,7 +1092,7 @@ make
     <filename>file1.pdf</filename> and pages 11&ndash;15 from
     <filename>file2.pdf</filename> in reverse, you would run
 
-    <programlisting><command>qpdf</command> <option>file1.pdf --pages file1.pdf 1-5 file2.pdf 15-11 -- outfile.pdf</option>
+    <programlisting><command>qpdf</command> <option>file1.pdf --pages file1.pdf 1-5 . 15-11 -- outfile.pdf</option>
 </programlisting>
     If, for some reason, you wanted to take the first page of an
     encrypted file called <filename>encrypted.pdf</filename> with
-- 
cgit v1.2.3-54-g00ecf