Document -chop

cpdfmanual.tex

@@ -2672,7 +2672,7 @@ These two operations add content directly to the beginning or end of the page da
     \small\noindent\verb!cpdf -pad-multiple-before [<integer>] in.pdf -o out.pdf!
 
     \vspace{1.5mm}
-    \small\noindent\verb!cpdf [-impose <pagesize> | impose-xy <x y>]!\\
+    \small\noindent\verb!cpdf [-impose <pagesize> | impose-xy "<x> <y>"]!\\
     \small\noindent\verb!     [-impose-columns] [-impose-rtl] [-impose-btt]!\\
     \small\noindent\verb!     [-impose-margin <margin>] [-impose-spacing <spacing>]!\\
     \small\noindent\verb!     [-impose-linewidth <width>] [-fast]!\\
@@ -2684,6 +2684,9 @@ These two operations add content directly to the beginning or end of the page da
     \vspace{1.5mm}
     \small\noindent\verb!cpdf -twoup [-fast] in.pdf -o out.pdf!
 
+    \vspace{1.5mm}
+    \small\noindent\verb!cpdf -chop "<x> <y>" [-chop-columns] [-chop-rtl] [-chop-btt]!\\
+    \small\noindent\verb!     in.pdf [<range>] -o out.pdf!
   \end{framed}
 
   \section{Inserting Blank Pages}
@@ -2788,6 +2791,20 @@ that the media box is unchanged.
  
 \noindent NB: For all imposition options, see also discussion of \texttt{-fast} in Section \ref{fast}.
 
+\section{Chopping up pages}
+
+\index{chop}\index{poster}
+
+The \texttt{-chop} operation cuts up a page into multiple pages, according to the chosen grid, and those pages replace the originals in the PDF. It is a sort of de-imposition. For example:
+
+  \begin{framed}
+    \noindent\small\verb!cpdf -chop "2 3" in.pdf -o out.pdf!
+ 
+    \vspace{2.5mm}
+    \noindent Chop each page into six.
+  \end{framed}
+
+\noindent By default, the pieces are arranged in the output file row by row, and from left to right on each row. To alter this, add one or more of \texttt{-chop-columns}, \texttt{-chop-rtl} (right to left), and \texttt{-chop-btt} (bottom to top).
 
 \begin{cpdflib}
 \clearpage