.TH krop 1
.SH NAME
krop \- a tool to crop PDF files
.SH SYNOPSIS
.B krop
.RI [ options ]
.RI [ file ]
.br
.SH DESCRIPTION
This manual page briefly documents the
.B krop
command.
.PP
\fBkrop\fP is a simple graphical tool to crop the pages of PDF files. It is written
in Python and relies on PyQT, python-poppler-qt5 and PyPDF2 for its functionality.
A unique feature of krop is its ability to automatically split pages into subpages
to fit the limited screen size of devices such as eReaders. This is particularly
useful, if your eReader does not support convenient scrolling.
.SH OPTIONS
A summary of options is included below.
For a complete description, use the \fB\-\-help\fP option.
.SS "Arguments:"
.TP
.B file
PDF file to open
.SS "Options:"
.TP
.B \-h, \-\-help
show help, including all options, and exit
.TP
.B \-v, \-\-version
show program's version number and exit
.TP
.B \-o OUTPUT, \-\-output OUTPUT
where to save the cropped PDF
.TP
.B \-\-whichpages WHICHPAGES
which pages (e.g. "1\-5" or "1,3\-") to include in cropped PDF (default: all)
.TP
.B \-\-rotate {0,90,180,270}
how much to rotate the cropped pdf clockwise (default: 0)
.TP
.B \-\-optimize {gs,no}
whether to optimize the final PDF using ghostscript (default: previous choice)
.TP
.B \-\-grid GRID
if set to 2x3, for instance, creates a 2x3 grid of selections on initial page; if only one number is specified, the number of columns/rows is determined according to whether the page is landscape or portrait
.TP
.B \-\-initialpage INITIALPAGE
which page to open initially (default: 1)
.TP
.B \-\-selections {all,evenodd,individual}
to which pages should selections apply
.TP
.B \-\-exceptions EXCEPTIONS
pages (e.g. "1\-5" or "1,3\-") which require individual selections
.TP
.B \-\-trim
if specified, will auto trim initial selections
.TP
.B \-\-trim-use {initial,all}
whether to inspect only the initial page or all pages (slow!) when auto trimming (default: previous value)
.TP
.B \-\-trim\-padding TRIM_PADDING
how much padding to include when auto trimming (default: previous value)
.TP
.B \-\-go
output PDF without opening the krop GUI (using the choices supplied on the command line); if used in a script without X server access, you can run krop using xvfb\-run
.TP
.B \-\-no\-kde
do not use KDE libraries (default: use if available)
.TP
.B \-\-no\-qt5
do not use PyQt5 instead of PyQt4 (default: use PyQt5 if available)
.TP
.B \-\-no\-PyPDF2
do not use PyPDF2 instead of pyPdf (default: use PyPDF2 if available)