Documented -split-max

This commit is contained in:
John Whitington 2024-01-26 13:11:38 +00:00
parent e36180a8ed
commit 31e4be2c41
2 changed files with 15 additions and 1 deletions

Binary file not shown.

View File

@ -1096,7 +1096,7 @@ the command line or configuration files. These are:
bit ASCII by dropping any high characters, or \verb!-raw! to perform no bit ASCII by dropping any high characters, or \verb!-raw! to perform no
processing. The default unless specified in the documentation for an individual operation is \verb!-stripped!. processing. The default unless specified in the documentation for an individual operation is \verb!-stripped!.
In modern usage, \texttt{-utf8} is almost always the sensible option. In modern usage, \texttt{-utf8} is almost always the sensible option. But for historical reasons it would be the default.
\begin{cpdflib} \begin{cpdflib}
\clearpage \clearpage
@ -1163,6 +1163,9 @@ cpdf -merge in1.pdf [<range>] in2.pdf [<range>] [<more names/ranges>]
\vspace{1.5mm} \vspace{1.5mm}
\noindent\verb!cpdf -split-bookmarks <level> in.pdf [-utf8] -o <format>! \noindent\verb!cpdf -split-bookmarks <level> in.pdf [-utf8] -o <format>!
\vspace{1.5mm}
\noindent\verb!cpdf -split-max <file size> in.pdf -o <format>!
\end{framed} \end{framed}
\vspace{12mm} \vspace{12mm}
@ -1281,6 +1284,17 @@ one of the output files.
\section{Splitting to Maximum Size} \section{Splitting to Maximum Size}
The \texttt{-split-max} operation splits a file into chunks of no more than the given size, starting at the beginning. The suffixes kB, KiB, MB, MiB, GB, and GiB may be used to give the size. For example:
\begin{framed}\small
\noindent\verb!cpdf -split-max 100kB in.pdf -o out%%%.pdf!
\vspace{2.5mm}
\noindent Split \texttt{in.pdf} into parts of no more than 100kB, if possible.
\end{framed}
\noindent Should the operation not be possible for the given size, an error message is printed and no output (not even partial output) is produced.
\section{Encrypting with Split operations} \section{Encrypting with Split operations}
\index{encryption} \index{encryption}
The encryption parameters described in Chapter \ref{encryption} may be added to the command line to encrypt each split PDF. Similarly, the \texttt{-recrypt} switch described in Chapter \ref{basicusage} may by given to re-encrypt each file with the existing encryption of the source PDF. The encryption parameters described in Chapter \ref{encryption} may be added to the command line to encrypt each split PDF. Similarly, the \texttt{-recrypt} switch described in Chapter \ref{basicusage} may by given to re-encrypt each file with the existing encryption of the source PDF.