Support excluding values from numeric ranges (fixes #564, #790)

1 files changed, 15 insertions, 5 deletions

diff --git a/manual/qpdf.1 b/manual/qpdf.1
index 6a859c8a..d758dca3 100644
--- a/manual/qpdf.1
+++ b/manual/qpdf.1
@@ -377,16 +377,26 @@ value, even if the file uses features that may not be available
 in that version.
 .SH PAGE-RANGES (page range syntax)
 A full description of the page range syntax, with examples, can be
-found in the manual. Summary:
+found in the manual. In summary, a range is a comma-separated list
+of groups. A group is a number or a range of numbers separated by a
+dash. A group may be prepended by x to exclude its members from the
+previous group. A number may be one of
 
 .IP \[bu]
-a,b,c    pages a, b, and c
+<n>        where <n> represents a number is the <n>th page
 .IP \[bu]
-a-b      pages a through b inclusive; if a > b, this counts down
+r<n>       is the <n>th page from the end
 .IP \[bu]
-r<n>     where <n> represents a number is the <n>th page from the end
+z          the last page, same as r1
+
+.IP \[bu]
+a,b,c      pages a, b, and c
+.IP \[bu]
+a-b        pages a through b inclusive; if a > b, this counts down
+.IP \[bu]
+a-b,xc     pages a through b except page c
 .IP \[bu]
-z        the last page, same as r1
+a-b,xc-d   pages a through b except pages c through d
 
 You can append :even or :odd to select every other page from the
 resulting set of pages, where :odd starts with the first page and