Merge branch 'akostadinov-patch-1'

Author: hellerbarde

README.rst

@@ -76,8 +76,9 @@ Examples:
     stapler sel a.pdf b.pdf output.pdf
 
     # generate a pdf file called output.pdf with the following pages:
-    # 1, 4-8, 20-40 from a.pdf, 1-5 from b.pdf in this order
-    stapler sel a.pdf 1 4-8 20-40 b.pdf 1-5 output.pdf
+    # 1, 4-8 in 180° (D for down), 20-40 from a.pdf, 1-5 from b.pdf in 
+    # this order
+    stapler sel a.pdf 1 4-8D 20-40 b.pdf 1-5 output.pdf
 
     # reverse some of the pages in a.pdf by specifying a negative range
     stapler sel a.pdf 1-3 9-6 10 output.pdf
@@ -130,8 +131,10 @@ Examples:
     # combine a pdf with odd pages and a pdf with even pages into output.pdf
     stapler zip odd.pdf even.pdf output.pdf
 
-    # combine a.pdf b.pdf and c.pdf, but use only some pages of c.pdf
-    stapler zip a.pdf b.pdf c.pdf 1-3 output.pdf
+    # combine a.pdf b.pdf and c.pdf, but use only some pages of c.pdf and
+    #  rotate b.pdf right (90° clockwise) and rotate c.pdf left (90° counter-
+    # clockwise)
+    stapler zip a.pdf b.pdf 1-endR c.pdf 1-3L output.pdf
 
 If one of the ranges is shorter than the others, stapler will continue
 to merge the remaining pages.

staplelib/stapler.py

@@ -14,7 +14,7 @@
 usage: %prog [options] mode input.pdf ... [output.pdf]
 
 Modes:
-cat/sel: <inputfile> [<pagerange>] ... (output needed)
+cat/sel: <inputfile> [<pagerange>[<rotation>]] ... (output needed)
     Select the given pages/ranges from input files.
     No range means all pages.
 del: <inputfile> [<pagerange>[<rotation>]] ... (output needed)