From 070ee710eb0aaf6ddc845735c6ea0c28d3b7e5a1 Mon Sep 17 00:00:00 2001 From: Jay Berkenbilt Date: Mon, 1 Jan 2024 10:14:01 -0500 Subject: Support excluding values from numeric ranges (fixes #564, #790) --- manual/qpdf.1 | 20 +++++++++++++++----- 1 file changed, 15 insertions(+), 5 deletions(-) (limited to 'manual/qpdf.1') 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 + where represents a number is the th page .IP \[bu] -a-b pages a through b inclusive; if a > b, this counts down +r is the th page from the end .IP \[bu] -r where represents a number is the 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 -- cgit v1.2.3-54-g00ecf