octoleo/qpdf
2
1
Fork 0
mirror of https://github.com/qpdf/qpdf.git synced 2025-01-22 22:58:33 +00:00
Code Issues Releases Wiki Activity

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

Browse Source 
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: * Trivial fixes:
* #470: odd/even -- doc bug
* #468: doc typo * #468: doc typo
* Remove travisci * Remove travisci
* Update manual to clearly state qpdf's exit codes including mention * 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 <option>angle</option> portion of the parameter may be either
90, 180, or 270. If preceded by <option>+</option> or 90, 180, or 270. If preceded by <option>+</option> or
<option>-</option>, the angle is added to or subtracted from <option>-</option>, the angle is added to or subtracted from
the specified pages' original rotations. Otherwise the pages' the specified pages' original rotations. This is almost always
rotations are set to the exact value. For example, the command what you want. Otherwise the pages' rotations are set to the
<command>qpdf in.pdf out.pdf --rotate=+90:2,4,6 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 --rotate=180:7-8</command> would rotate pages 2, 4, and 6 90
degrees clockwise from their original rotation and force the degrees clockwise from their original rotation and force the
rotation of pages 7 through 9 to 180 degrees regardless of rotation of pages 7 through 9 to 180 degrees regardless of
their original rotation, and the command <command>qpdf in.pdf 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. degrees.
</para> </para>
</listitem> </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" << "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" << "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" << "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" << "\n"
<< "If --split-pages is specified, each page is written to a separate output\n" << "If --split-pages is specified, each page is written to a separate output\n"
<< "file. File names are generated as follows:\n" << "file. File names are generated as follows:\n"