openbsd-ports/textproc/mupdf/files/mupdf.1
sthen 1123385d33 import Fitz/MuPDF. incomplete copyright notices so PERMIT_* are
disabled for now. "i'm stunned by the quality and that it doesn't
choke on a recent document[0] where xpdf had issues with" simon@
(who also helped tracking down the key bindings, thanks!).


Fitz is a project to create a new and modern graphics library.
At the core of Fitz is the display tree: a scene graph of vector
graphics, images and text making up the contents of a page.

The standard components of Fitz are:

    * Base runtime (thin memory and error handling layer)
    * Streams and filters (standard postscript, pdf and tiff filters)
    * World model (display trees and resources)
    * Drawing (draw the tree to a bitmap raster) 

MuPDF is a PDF parser that reads PDF files and creates Fitz trees.

MuPDF also has an API to modify internal objects in the PDF files
and write PDF files. For instance, it is possible to use the MuPDF
library to encrypt existing PDF files, or to rearrange the pages.

pdftool is a commandline demo of this functionality; it is a portable
pdf swiss army knife for fixing broken pdf files, changing permissions,
merging and extracting pages, and examining the internal object
structure of a PDF file.

The mupdf binary (aka pdfview) is a bare bones PDF viewer.
2009-06-02 22:15:08 +00:00

78 lines
1.2 KiB
Groff

.\" $OpenBSD: mupdf.1,v 1.1.1.1 2009/06/02 22:15:08 sthen Exp $
.Dd $Mdocdate: June 2 2009 $
.Dt MUPDF 1
.Os
.Sh NAME
.Nm mupdf
.Nd "display PDF files"
.Sh SYNOPSIS
.Nm mupdf
.Bk -words
.Op Fl d Ar password
.Op Fl p Ar pagenumber
.Op Fl z Ar zoom
.Ar file.pdf
.Sh DESCRIPTION
.Nm
is a viewer for Portable Document Format (pdf) files.
.Pp
The options are as follows:
.Bl -tag -width Ds
.It Fl d Ar password
Use
.Ar password
as the password to open the document.
.It Fl p Ar pagenumber
Open the document at page
.Ar pagenumber .
.It Fl z Ar zoom
Open the document zoomed by
.Ar zoom
times.
The value is taken as a multiplier, not a percentage.
.El
.Sh KEY BINDINGS
The following key bindings are available.
.Pp
.Bl -tag -width xxxxxxxxxxxx -compact
.It l <
rotate left
.It r >
rotate right
.It u
scroll up
.\" .It up
.\" scroll up
.It d
scroll down
.\" .It down
.\" scroll down
.It + =
zoom in
.It -
zoom out
.It w
shrinkwrap
.It b backspace
previous page
.\" .It pgup left
.\" previous page
.It n space
next page
.\" .It pgdn right
.\" next page
.It N F
forward 10 pages
.It B
back 10 pages
.It m
mark page for snap back
.It t
pop back to last mark
.It 123g
move to page 123
.El
.Pp
.Sh SEE ALSO
.Xr xpdf 1