aboutsummaryrefslogtreecommitdiffstats
path: root/manual
diff options
context:
space:
mode:
authorJay Berkenbilt <ejb@ql.org>2020-10-15 20:52:14 +0200
committerJay Berkenbilt <ejb@ql.org>2020-10-15 20:53:06 +0200
commita1994a53438612405c1d00d7bd9b3ef78ae477ef (patch)
treebea8eea644a19b5a75def89513f5865fbe3aa612 /manual
parent88b8f8ec86c107e0d9bbe268b373917dd0ffca3c (diff)
downloadqpdf-a1994a53438612405c1d00d7bd9b3ef78ae477ef.tar.zst
Fix/clarify documentation on --rotate option (fixes #470)
Make clear that you almost always want + or - before an angle when specifying rotation.
Diffstat (limited to 'manual')
-rw-r--r--manual/qpdf-manual.xml10
1 files changed, 6 insertions, 4 deletions
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
<option>angle</option> portion of the parameter may be either
90, 180, or 270. If preceded by <option>+</option> or
<option>-</option>, 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
- <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 <command>qpdf in.pdf out.pdf --rotate=+90:2,4,6
--rotate=180:7-8</command> 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 <command>qpdf in.pdf
- out.pdf --rotate=180</command> would rotate all pages by 180
+ out.pdf --rotate=+180</command> would rotate all pages by 180
degrees.
</para>
</listitem>