From a1994a53438612405c1d00d7bd9b3ef78ae477ef Mon Sep 17 00:00:00 2001 From: Jay Berkenbilt Date: Thu, 15 Oct 2020 14:52:14 -0400 Subject: Fix/clarify documentation on --rotate option (fixes #470) Make clear that you almost always want + or - before an angle when specifying rotation. --- manual/qpdf-manual.xml | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) (limited to 'manual') diff --git a/manual/qpdf-manual.xml b/manual/qpdf-manual.xml index 48262e70..74f0279a 100644 --- a/manual/qpdf-manual.xml +++ b/manual/qpdf-manual.xml @@ -936,14 +936,16 @@ make portion of the parameter may be either 90, 180, or 270. If preceded by or , the angle is added to or subtracted from - the specified pages' original rotations. Otherwise the pages' - rotations are set to the exact value. For example, the command - qpdf in.pdf out.pdf --rotate=+90:2,4,6 + the specified pages' original rotations. This is almost always + what you want. Otherwise the pages' rotations are set to the + exact value, which may cause the appearances of the pages to + be inconsistent, especially for scans. For example, the + command qpdf in.pdf out.pdf --rotate=+90:2,4,6 --rotate=180:7-8 would rotate pages 2, 4, and 6 90 degrees clockwise from their original rotation and force the rotation of pages 7 through 9 to 180 degrees regardless of their original rotation, and the command qpdf in.pdf - out.pdf --rotate=180 would rotate all pages by 180 + out.pdf --rotate=+180 would rotate all pages by 180 degrees. -- cgit v1.2.3-70-g09d2