summaryrefslogtreecommitdiff
path: root/Build/source/libs/xpdf/xpdf-src/doc/xpdf.1
diff options
context:
space:
mode:
Diffstat (limited to 'Build/source/libs/xpdf/xpdf-src/doc/xpdf.1')
-rw-r--r--Build/source/libs/xpdf/xpdf-src/doc/xpdf.195
1 files changed, 81 insertions, 14 deletions
diff --git a/Build/source/libs/xpdf/xpdf-src/doc/xpdf.1 b/Build/source/libs/xpdf/xpdf-src/doc/xpdf.1
index 63f3efd3fc9..c1aedbd80cc 100644
--- a/Build/source/libs/xpdf/xpdf-src/doc/xpdf.1
+++ b/Build/source/libs/xpdf/xpdf-src/doc/xpdf.1
@@ -1,7 +1,7 @@
.\" Copyright 1996-2019 Glyph & Cog, LLC
-.TH xpdf 1 "18 Feb 2019"
+.TH xpdf 1 "25 Sep 2019"
.SH NAME
-xpdf \- Portable Document Format (PDF) file viewer (version 4.01)
+xpdf \- Portable Document Format (PDF) file viewer (version 4.02)
.SH SYNOPSIS
.B xpdf
[options]
@@ -12,6 +12,11 @@ xpdf \- Portable Document Format (PDF) file viewer (version 4.01)
[options]
.B -remote
.IR remote-name " [" command " ...]"
+.PP
+.B xpdf
+[options]
+.B -open
+.RI "[" PDF-file "]"
.SH DESCRIPTION
.B Xpdf
is a viewer for Portable Document Format (PDF) files. (These are also
@@ -74,6 +79,14 @@ Set the initial window geometry.
.BI \-title " title"
Set the window title. By default, the title will be "xpdf: foo.pdf".
.TP
+.BI \-open " \fR[\fPPDF-file\fR]\fP"
+This option sets up a default remote server. If Xpdf is already
+running (with the "-open" switch), the PDF file (if any) is opened in
+a new tab. If Xpdf (with the "-open" switch) is not already running,
+starts Xpdf and opens the PDF file (if any). This is useful for GUI
+desktop environments, e.g., the typical double-click on a PDF file
+case.
+.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
@@ -155,11 +168,25 @@ and
are equivalent.)
.PP
.SH CONTROLS
-.SS Tool bar
+.SS Toolbar
.TP
-.B "\'page' entry box"
+.B "toggle sidebar button"
+Toggles (i.e., shows or hides) the sidebar.
+.TP
+.B "status indicator"
+This icon is animated while Xpdf is rendering a page. It turns red
+when an error or warning has been issued. Clicking on it opens the
+error dialog.
+.TP
+.B "selection mode"
+This icon is an "I-beam" in linear selection mode, and an arrow in
+block selection mode. Clicking on it toggles between the two
+selection modes.
+.TP
+.B "page number entry box"
Move to a specific page number. Click in the box to activate it, type
-the page number, then hit return.
+the page number, then hit return. This will instead display and
+accept page labels, if the "view - page labels" menu item is checked.
.TP
.B "left/right arrow buttons"
Go backward or forward along the history path.
@@ -176,12 +203,7 @@ Change the zoom factor to fit the page width to the window width.
.B "fit page button"
Change the zoom factor to fit the page to the window size.
.TP
-.B "working/error indicator"
-This icon is animated while Xpdf is rendering a page. It turns red
-when an error or warning has been issued. Clicking on it opens the
-error dialog.
-.TP
-.B "\'find' box"
+.B "find entry box"
Find a text string. Click in the box to activate it, type a search
string, then hit return.
.TP
@@ -196,11 +218,11 @@ Display the current find settings: case sensitive (on/off), find whole
words (on/off).
.PP
.SS Menu bar
-The menu bar is above the tool bar. The menu items should be
+The menu bar is above the toolbar. The menu items should be
self-explanatory.
.PP
.SS Tab list
-The tab list is on the left, just below the tool bar. It lists all
+The tab list is on the left, just below the toolbar. It lists all
open tabs.
.PP
.SS Outline/layers/attachments pane
@@ -291,6 +313,9 @@ Open a new window.
Close the current tab. Closes the window if this was the last open
tab. Quits the application if this was the last open window.
.TP
+.B control-l
+Toggle between full-screen and window modes.
+.TP
.B control-q
Quit.
.TP
@@ -433,6 +458,11 @@ End a pan operation.
.B endSelection
End a selection.
.TP
+.BI expandSidebar( n )
+Expand the sidebar by
+.I n
+pixels. Opens the sidebar if it is currently closed.
+.TP
.B find
Set keyboard focus to the \'find' box.
.TP
@@ -497,6 +527,9 @@ Go to the specified page.
.BI help
Open the help URL.
.TP
+.B hideToolbar
+Hide the toolbar.
+.TP
.B horizontalContinuousMode
Switch to horizontal continuous view mode.
.TP
@@ -526,7 +559,7 @@ Go to the next page, with the current relative scroll position.
Switch to the next tab.
.TP
.B open
-Open a PDF file in this tab, using the open dialog.
+Open a PDF file in the current tab, using the open dialog.
.TP
.B openErrorWindow
Open the error window.
@@ -538,9 +571,25 @@ Open the specified file in the current tab.
Open the specified file in the current tab at the specified named
destination.
.TP
+.BI openFileAtDestIn( file, dest, location )
+Open the specified file at the specified named destination. Location
+must be "win" for a new window or "tab" for a new tab.
+.TP
.BI openFileAtPage( file, page )
Open the specified file in the current tab at the specified page.
.TP
+.BI openFileAtPageIn( file, page, location )
+Open the specified file at the specified page. Location must be "win"
+for a new window or "tab" for a new tab.
+.TP
+.BI openFileIn( file, location )
+Open the specified file. Location must be "win" for a new window or
+"tab" for a new tab.
+.TP
+.BI openIn( location )
+Open a PDF file, using the open dialog. Location must be "win" for a
+new window or "tab" for a new tab.
+.TP
.B openSidebar
Open the sidebar.
.TP
@@ -705,6 +754,15 @@ pixels, moving to the previous page if appropriate.
.BI setSelection( pg , ulx , uly , lrx , lry )
Set the selection to the specified coordinates on the specified page.
.TP
+.B showToolbar
+Show the toolbar.
+.TP
+.BI shrinkSidebar( n )
+Shrink the sidebar by
+.I n
+pixels. Closes the sidebar if shrinking it would go below the minimum
+allowed side.
+.TP
.B sideBySideContinuousMode
Switch to side-by-side continuous view mode.
.TP
@@ -743,6 +801,15 @@ the document stays in the same place on the screen.
Toggle the sidebar between open and closed, resizing the window so
that the document size doesn't change.
.TP
+.B toggleToolbar
+Toggle the toolbar between shown and hidden.
+.TP
+.B viewPageLabels
+Show page labels (if the PDF file has them), rather than page numbers.
+.TP
+.B viewPageNumbers
+Show page numbers, rather than page labels.
+.TP
.B windowMode
Go to window (non-full-screen) mode.
.TP