Created separate Debian mupdf-utils package for debugging tools.

7 files changed, 121 insertions, 0 deletions

diff --git a/debian/changelog b/debian/changelog
index fcbe14eb..45a55289 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,3 +1,10 @@
+mupdf (1.0-2) unstable; urgency=low
+
+  * Added mupdf-utils package, including debugging utilities pdfshow and
+    pdfdraw as well as the corresponding manpages.
+
+ -- Sebastian Rasmussen <sebras@hotmail.com>  Sun, 21 Mar 2010 21:49:09 +0100
+
 mupdf (1.0-1) unstable; urgency=low
 
   * Initial release, thank you debhelper.
diff --git a/debian/control b/debian/control
index 43bb3555..4dfee540 100644
--- a/debian/control
+++ b/debian/control
@@ -25,3 +25,13 @@ Description: MuPDF is a lightweight PDF viewer written in portable C.
  PDF document. Example code for navigating interactive links and bookmarks,
  encrypting PDF files, extracting fonts, images, and searchable text, and
  rendering pages to image files is provided.
+
+Package: mupdf-utils
+Architecture: any
+Depends: ${shlibs:Depends}
+Description: Debugging utils for MuPDF, a lightweight PDF renderer in C.
+ MuPDF is a lightweight PDF viewer and toolkit written in portable C.
+ .
+ These are the utilites used when developing and debugging the MuPDF
+ renderer. Included is pdfdraw that renders and outputs the result to a PNM
+ file and pdfshow that prints the contents of PDF objects.
diff --git a/debian/mupdf-utils.docs b/debian/mupdf-utils.docs
new file mode 100644
index 00000000..e845566c
--- /dev/null
+++ b/debian/mupdf-utils.docs
@@ -0,0 +1 @@
+README
diff --git a/debian/mupdf-utils.install b/debian/mupdf-utils.install
new file mode 100644
index 00000000..4c74170b
--- /dev/null
+++ b/debian/mupdf-utils.install
@@ -0,0 +1,2 @@
+build/debug/pdfdraw usr/bin
+build/debug/pdfshow usr/bin
diff --git a/debian/mupdf-utils.manpages b/debian/mupdf-utils.manpages
new file mode 100644
index 00000000..d398dc6f
--- /dev/null
+++ b/debian/mupdf-utils.manpages
@@ -0,0 +1,2 @@
+debian/pdfdraw.1
+debian/pdfshow.1
diff --git a/debian/pdfdraw.1 b/debian/pdfdraw.1
new file mode 100644
index 00000000..c1b9e150
--- /dev/null
+++ b/debian/pdfdraw.1
@@ -0,0 +1,56 @@
+.TH PDFDRAW 1 "March 21, 2010"
+.\" Please adjust this date whenever revising the manpage.
+.SH NAME
+pdfdraw \- renderer tool to convert a PDF file to PNM image files.
+.SH SYNOPSIS
+.B pdfdraw
+.RI [ options ]
+.RI [ PDFfile\ pages ]
+.B ...
+.SH DESCRIPTION
+This manual page briefly describes the
+.B pdfdraw
+command. Unless any options that modify the behaviour are specified each
+page of each PDF file is rendered and a MD5 checksum over the resulting
+pixels is computed and printed. If the
+.RI pages
+argument is missing all pages will be rendered, but it could be specified
+and in that case this controls what pages to render. The argument can be
+given as a single integer representing the page number, by a range, e.g.
+1-3, comma-separates page numbers and ranges, e.g. 1-3,5,7-9. Additionally
+the last element in the comma-separated list can be specified as an open
+range, e.g. 9-, which means that all pages in the PDF file starting from
+that page ar rendered.
+.PP
+.SH OPTIONS
+A description of each of the supported options is included below.
+.TP
+.B \-b bands
+Each page is rendered in the given number of separate bands. The default is
+to render the entire page in one go.
+.TP
+.B \-d password
+Uses the given password during decryption of an encrypted PDF file.
+The password is tried both as user and owner password.
+.TP
+.B \-o pattern
+Enables generation of PNM files, one per page. Each file is given a name
+represented by the specified pattern where %d represents the page number,
+e.g. output%03d.pnm.
+.TP
+.B \-r resolution
+Specified the resolution when rendering each page, specified in dots per
+inch. The deafult is 72dpi.
+.TP
+.B \-m
+Enables benchmarking, causing rendering time to be printed for each page as
+well as summary statistics after all pages in each PDF file have been
+rendered.
+.SH SEE ALSO
+.BR mupdf (1),
+.BR pdfshow (1).
+.SH AUTHOR
+MuPDF was written by Tor Andersson <tor@ghostscript.com>.
+MuPDF is Copyright 2006-2010 Artifex Software, Inc.
+.PP
+This manual page was written by Sebastian Rasmussen <sebras@hotmail.com>.
diff --git a/debian/pdfshow.1 b/debian/pdfshow.1
new file mode 100644
index 00000000..063634ff
--- /dev/null
+++ b/debian/pdfshow.1
@@ -0,0 +1,43 @@
+.TH PDFSHOW 1 "March 21, 2010"
+.\" Please adjust this date whenever revising the manpage.
+.SH NAME
+pdfshow \- PDF file debugging tool used to show PDF objects
+.SH SYNOPSIS
+.B pdfshow
+.RI [ options ]
+.RI PDFfile
+.RI [ xref ]
+.RI [ trailer ]
+.RI [ object-number ]
+.B ...
+.SH DESCRIPTION
+This manual page briefly describes the
+.B pdfshow
+command. The default action taken if only a PDF file name is given is to
+print the PDF trailer. An alternative is to specify xref as an argument,
+causing
+.B pdfshow
+to print the trailer section of the file. The most useful operation
+however is to give one or more whitespace separated integers referring to
+PDF objects, causing each to be printed.
+.PP
+.SH OPTIONS
+A description of each of the supported options is included below.
+.TP
+.B \-b
+Causes pdfshow to print all object streams as raw binary data
+.TP
+.B \-d password
+Uses the given password during decryption of an encrypted PDF file.
+The password is tried both as user and owner password.
+.TP
+.B \-x
+Enables decompression of object stream contents before printing them.
+.SH SEE ALSO
+.BR mupdf (1),
+.BR pdfdraw (1).
+.SH AUTHOR
+MuPDF was written by Tor Andersson <tor@ghostscript.com>.
+MuPDF is Copyright 2006-2010 Artifex Software, Inc.
+.PP
+This manual page was written by Sebastian Rasmussen <sebras@hotmail.com>.