octoleo
/
qpdf
mirror of https://github.com/qpdf/qpdf.git
2
1
Fork 0
Code Issues Releases Wiki Activity

Fix/clarify documentation on --rotate option (fixes #470) 

Make clear that you almost always want + or - before an angle when
specifying rotation.
This commit is contained in:
Jay Berkenbilt 2020-10-15 14:52:14 -04:00
parent 88b8f8ec86
commit a1994a5343
3 changed files with 9 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
TODO
View File

@ -2,7 +2,6 @@ Candidates for upcoming release
===============================
* Trivial fixes:
* #470: odd/even -- doc bug
* #468: doc typo
* Remove travisci
* Update manual to clearly state qpdf's exit codes including mention

10
manual/qpdf-manual.xml
View File

@ -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>

4
qpdf/qpdf.cc
View File

@ -1276,7 +1276,9 @@ ArgParser::argHelp()
<< "format as with the --pages option, described below. Repeat the option\n"
<< "to rotate multiple groups of pages. If the angle is preceded by + or -,\n"
<< "it is added to or subtracted from the original rotation. Otherwise, the\n"
<< "rotation angle is set explicitly to the given value.\n"
<< "rotation angle is set explicitly to the given value. You almost always\n"
<< "want to use + or - unless you are certain about the internals of the PDF\n"
<< "you are working with.\n"
<< "\n"
<< "If --split-pages is specified, each page is written to a separate output\n"
<< "file. File names are generated as follows:\n"