1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256
|
description: manpage updates
author: Michael Gilbert <mgilbert@debian.org>
--- a/doc/xpdf.1
+++ b/doc/xpdf.1
@@ -10,7 +10,7 @@ xpdf \- Portable Document Format (PDF) f
.SH DESCRIPTION
.B Xpdf
is a viewer for Portable Document Format (PDF) files. (These are also
-sometimes also called \'Acrobat' files, from the name of Adobe's PDF
+sometimes also called 'Acrobat' files, from the name of Adobe's PDF
software.) Xpdf runs under the X Window System on UNIX, VMS, and
OS/2.
.PP
@@ -29,7 +29,7 @@ specifying the page which should be disp
xpdf file.pdf 18
.RE
.PP
-You can also give a named destination, prefixed with \'+' in place of
+You can also give a named destination, prefixed with '+' in place of
the page number. (This is only useful with PDF files that provide
named destination targets.)
.PP
@@ -38,11 +38,17 @@ You can also start xpdf without opening
.RS
xpdf
.RE
+.PP
+Various compressed formats (gz, bz2, xz, and Z) are also supported, for example::
+.PP
+.RS
+xpdf file.pdf.gz
+.RE
+.PP
.SH CONFIGURATION FILE
Xpdf reads a configuration file at startup. It first tries to find
the user's private config file, ~/.xpdfrc. If that doesn't exist, it
-looks for a system-wide config file, typically /usr/local/etc/xpdfrc
-(but this location can be changed when xpdf is built). See the
+looks for a system-wide config file, /etc/xpdf/xpdfrc. See the
.BR xpdfrc (5)
man page for details.
.SH OPTIONS
@@ -54,48 +60,48 @@ description of the corresponding command
Set the initial window geometry.
.RB ( \-geometry
is equivalent.)
-.RB "[X resource: " xpdf.geometry ]
+.RB "[X resource: " Xpdf.geometry ]
.TP
.BI \-title " title"
Set the window title. By default, the title will be "xpdf: foo.pdf".
-.RB "[X resource: " xpdf.title ]
+.RB "[X resource: " Xpdf.title ]
.TP
.B \-cmap
Install a private colormap. This is ignored on TrueColor visuals.
-.RB "[X resource: " xpdf.installCmap ]
+.RB "[X resource: " Xpdf.installCmap ]
.TP
.BI \-rgb " number"
Set the size of largest RGB cube xpdf will try to allocate. The
default is 5 (for a 5x5x5 cube); set to a smaller number to conserve
color table entries. This is ignored with private colormaps and on
TrueColor visuals.
-.RB "[X resource: " xpdf.rgbCubeSize ]
+.RB "[X resource: " Xpdf.rgbCubeSize ]
.TP
.B \-rv
Set reverse video mode. This reverses the colors of everything except
images. It may not always produce great results for PDF files which
do weird things with color. This also causes the paper color to
default to black.
-.RB "[X resource: " xpdf.reverseVideo ]
+.RB "[X resource: " Xpdf.reverseVideo ]
.TP
.BI \-papercolor " color"
Set the "paper color", i.e., the background of the page display. This
will not work too well with PDF files that do things like filling in
white behind the text.
-.RB "[X resource: " xpdf.paperColor ]
+.RB "[X resource: " Xpdf.paperColor ]
.TP
.BI \-mattecolor " color"
Set the matte color, i.e., the color used for background outside the
actual page area. (There is a separate setting,
-xpdf.fullScreenMatteColor, for full-screen mode.)
-.RB "[X resource: " xpdf.matteColor ]
+Xpdf.fullScreenMatteColor, for full-screen mode.)
+.RB "[X resource: " Xpdf.matteColor ]
.TP
.BI \-z " zoom"
Set the initial zoom factor. A number specifies a zoom percentage,
where 100 means 72 dpi. You may also specify \'page', to fit the page
to the window size, or \'width', to fit the page width to the window
width.
-.RB "[config file: " initialZoom "; or X resource: " xpdf.initialZoom ]
+.RB "[config file: " initialZoom "; or X resource: " Xpdf.initialZoom ]
.TP
.B \-cont
Start in continuous view mode, i.e., with one vertical scroll bar for
@@ -118,7 +124,7 @@ Enable or disable vector anti-aliasing.
.BI \-ps " PS-file"
Set the default file name for PostScript output (i.e., the name which
will appear in the print dialog). This can also be of the form
-\'|command' to pipe the PostScript through a command.
+'|command' to pipe the PostScript through a command.
.RB "[config file: " psFile ]
.TP
.BI \-paper " size"
@@ -205,10 +211,20 @@ and
.B \-\-help
are equivalent.)
.PP
+.TP
+.BI \-m " file1 file2 ..."
+Open multiple pdf files:
+.I file1 file2 ...
+etc. NOTE: The list of files is terminated once an argument starting with
+a dash is encountered. In order to view file names starting with
+a dash, simply append "./".
+.BI \-m
+may be used multiple times.
+.PP
Several other standard X options and resources will work as expected:
.TP
.BI \-display " display"
-.RB "[X resource: " xpdf.display ]
+.RB "[X resource: " Xpdf.display ]
.TP
.BI \-fg " color"
.RB ( \-foreground
@@ -226,15 +242,15 @@ is equivalent.)
.RB "[X resource: " xpdf*fontList ]
.PP
The color and font options only affect the user interface elements,
-not the PDF display (the \'paper').
+not the PDF display (the 'paper').
.PP
The following X resources do not have command line option equivalents:
.TP
-.B xpdf.toolTipEnable
+.B Xpdf.toolTipEnable
Enables (if set to true) or disables (if set to false) the tool-tips
on the toolbar buttons.
.TP
-.B xpdf.fullScreenMatteColor
+.B Xpdf.fullScreenMatteColor
Sets the matte color to be used in full-screen mode. The default
setting is "black".
.SH CONTROLS
@@ -249,7 +265,7 @@ Move backward or forward by ten pages.
.B "dashed left/right arrow buttons"
Move backward or forward along the history path.
.TP
-.B "\'Page' entry box"
+.B "'Page' entry box"
Move to a specific page number. Click in the box to activate it, type
the page number, then hit return.
.TP
@@ -262,17 +278,17 @@ Find a text string.
.B "print button"
Bring up a dialog for generating a PostScript file. The dialog has
options to set the pages to be printed and the PostScript file name.
-The file name can be \'-' for stdout or \'|command' to pipe the
-PostScript through a command, e.g., \'|lpr'.
+The file name can be '-' for stdout or '|command' to pipe the
+PostScript through a command, e.g., '|lpr'.
.TP
-.B "\'?' button"
-Bring up the \'about xpdf' window.
+.B "'?' button"
+Bring up the 'about xpdf' window.
.TP
.B "link info"
-The space between the \'?' and \'Quit' buttons is used to show the URL
+The space between the '?' and 'Quit' buttons is used to show the URL
or external file name when the mouse is over a link.
.TP
-.B "\'Quit' button"
+.B "'Quit' button"
Quit xpdf.
.PP
.SS Menu
@@ -328,9 +344,9 @@ the X selection buffer.
.PP
.SS Links
Clicking on a hyperlink will jump to the link's destination. A link
-to another PDF document will make xpdf load that document. A
-\'launch' link to an executable program will display a dialog, and if
-you click \'ok', execute the program. URL links call an external
+to another PDF document will make xpdf load that document. A 'launch'
+link to an executable program will display a dialog, and if
+you click 'ok', execute the program. URL links call an external
command (see the
.B WEB BROWSERS
section below).
@@ -453,7 +469,7 @@ Make sure that xpdf is on your executabl
.PP
When you click on a URL link in a PDF file, xpdf will execute the
command specified by the urlCommand config file option, replacing an
-occurrence of \'%s' with the URL. For example, to call netscape with
+occurrence of '%s' with the URL. For example, to call netscape with
the URL, add this line to your config file:
.PP
.RS
@@ -829,8 +845,8 @@ Xpdf can be started in remote server mod
xpdf \-remote myServer file.pdf
.RE
.PP
-If there is currently no xpdf running in server mode with the name
-\'myServer', a new xpdf window will be opened. If another command:
+If there is currently no xpdf running in server mode with the name 'myServer',
+a new xpdf window will be opened. If another command:
.PP
.RS
xpdf \-remote myServer another.pdf 9
--- a/doc/xpdfrc.5
+++ b/doc/xpdfrc.5
@@ -7,7 +7,7 @@ All of the Xpdf tools read a single conf
.I .xpdfrc
file in your home directory, it will be read. Otherwise, a
system-wide configuration file will be read from
-.IR /usr/local/etc/xpdfrc ,
+.IR /etc/xpdf/xpdfrc ,
if it exists. (This is its default location; depending on build
options, it may be placed elsewhere.) On Win32 systems, the
.I xpdfrc
@@ -22,6 +22,9 @@ file names that contain spaces.
.PP
The following sections list all of the configuration options, sorted
into functional groups. There is an examples section at the end.
+.PP
+Note that all settings are case-sensitive; in particular, boolean options
+are "yes" and "no" (rather than "Yes" or "No").
.SH INCLUDE FILES
.TP
.BI include " config\-file"
@@ -484,7 +487,7 @@ OP/op/OPM settings in the PDF file. Ign
default value is "no".
.TP
.BI launchCommand " command"
-Sets the command executed when you click on a "launch"-type link. The
+Sets the command executed when you click on a "launch"\-type link. The
intent is for the command to be a program/script which determines the
file type and runs the appropriate viewer. The command line will
consist of the file to be launched, followed by any parameters
@@ -672,7 +675,7 @@ urlCommand "netscape \-remote 'open
.fi
.SH FILES
.TP
-.B /usr/local/etc/xpdfrc
+.B /etc/xpdf/xpdfrc
This is the default location for the system-wide configuration file.
Depending on build options, it may be placed elsewhere.
.TP
|