diff options
author | Akira Kakuto <kakuto@fuk.kindai.ac.jp> | 2019-02-25 03:01:12 +0000 |
---|---|---|
committer | Akira Kakuto <kakuto@fuk.kindai.ac.jp> | 2019-02-25 03:01:12 +0000 |
commit | 3112e1aed533fe7ee58dd8cba2e4cd768372dfd6 (patch) | |
tree | 02077f80cf4a13a6c571bace448a53a38a9b6768 /Build/source/libs/xpdf/xpdf-src/doc | |
parent | 73052dd2c8e70e61b653151192fe1f000fcf626d (diff) |
xpdf-4.01
git-svn-id: svn://tug.org/texlive/trunk@50122 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Build/source/libs/xpdf/xpdf-src/doc')
23 files changed, 401 insertions, 216 deletions
diff --git a/Build/source/libs/xpdf/xpdf-src/doc/pdfdetach.1 b/Build/source/libs/xpdf/xpdf-src/doc/pdfdetach.1 index 0ef891d6bc2..bed56b58b56 100644 --- a/Build/source/libs/xpdf/xpdf-src/doc/pdfdetach.1 +++ b/Build/source/libs/xpdf/xpdf-src/doc/pdfdetach.1 @@ -1,8 +1,8 @@ -.\" Copyright 2013-2017 Glyph & Cog, LLC -.TH pdfdetach 1 "10 Aug 2017" +.\" Copyright 2013-2019 Glyph & Cog, LLC +.TH pdfdetach 1 "18 Feb 2019" .SH NAME pdfdetach \- Portable Document Format (PDF) document embedded file -extractor (version 4.00) +extractor (version 4.01) .SH SYNOPSIS .B pdfdetach [options] @@ -90,7 +90,7 @@ Error related to PDF permissions. 99 Other error. .SH AUTHOR -The pdfinfo software and documentation are copyright 1996-2017 Glyph & +The pdfinfo software and documentation are copyright 1996-2019 Glyph & Cog, LLC. .SH "SEE ALSO" .BR xpdf (1), diff --git a/Build/source/libs/xpdf/xpdf-src/doc/pdfdetach.cat b/Build/source/libs/xpdf/xpdf-src/doc/pdfdetach.cat index 66c812df6a4..30fc3ce53ed 100644 --- a/Build/source/libs/xpdf/xpdf-src/doc/pdfdetach.cat +++ b/Build/source/libs/xpdf/xpdf-src/doc/pdfdetach.cat @@ -4,7 +4,7 @@ pdfdetach(1) General Commands Manual pdfdetach(1) NAME pdfdetach - Portable Document Format (PDF) document embedded file - extractor (version 4.00) + extractor (version 4.01) SYNOPSIS pdfdetach [options] [PDF-file] @@ -79,7 +79,7 @@ EXIT CODES 99 Other error. AUTHOR - The pdfinfo software and documentation are copyright 1996-2017 Glyph & + The pdfinfo software and documentation are copyright 1996-2019 Glyph & Cog, LLC. SEE ALSO @@ -89,4 +89,4 @@ SEE ALSO - 10 Aug 2017 pdfdetach(1) + 18 Feb 2019 pdfdetach(1) diff --git a/Build/source/libs/xpdf/xpdf-src/doc/pdffonts.1 b/Build/source/libs/xpdf/xpdf-src/doc/pdffonts.1 index 3812c6b50b7..c57ce66706e 100644 --- a/Build/source/libs/xpdf/xpdf-src/doc/pdffonts.1 +++ b/Build/source/libs/xpdf/xpdf-src/doc/pdffonts.1 @@ -1,8 +1,8 @@ -.\" Copyright 1999-2017 Glyph & Cog, LLC -.TH pdffonts 1 "10 Aug 2017" +.\" Copyright 1999-2019 Glyph & Cog, LLC +.TH pdffonts 1 "18 Feb 2019" .SH NAME pdffonts \- Portable Document Format (PDF) font analyzer (version -4.00) +4.01) .SH SYNOPSIS .B pdffonts [options] @@ -147,7 +147,7 @@ Error related to PDF permissions. 99 Other error. .SH AUTHOR -The pdffonts software and documentation are copyright 1996-2017 Glyph +The pdffonts software and documentation are copyright 1996-2019 Glyph & Cog, LLC. .SH "SEE ALSO" .BR xpdf (1), diff --git a/Build/source/libs/xpdf/xpdf-src/doc/pdffonts.cat b/Build/source/libs/xpdf/xpdf-src/doc/pdffonts.cat index c11910b977c..a1dab79714d 100644 --- a/Build/source/libs/xpdf/xpdf-src/doc/pdffonts.cat +++ b/Build/source/libs/xpdf/xpdf-src/doc/pdffonts.cat @@ -3,7 +3,7 @@ pdffonts(1) General Commands Manual pdffonts(1) NAME - pdffonts - Portable Document Format (PDF) font analyzer (version 4.00) + pdffonts - Portable Document Format (PDF) font analyzer (version 4.01) SYNOPSIS pdffonts [options] [PDF-file] @@ -105,7 +105,7 @@ EXIT CODES 99 Other error. AUTHOR - The pdffonts software and documentation are copyright 1996-2017 Glyph & + The pdffonts software and documentation are copyright 1996-2019 Glyph & Cog, LLC. SEE ALSO @@ -115,4 +115,4 @@ SEE ALSO - 10 Aug 2017 pdffonts(1) + 18 Feb 2019 pdffonts(1) diff --git a/Build/source/libs/xpdf/xpdf-src/doc/pdfimages.1 b/Build/source/libs/xpdf/xpdf-src/doc/pdfimages.1 index a220d30b151..cc16c197d90 100644 --- a/Build/source/libs/xpdf/xpdf-src/doc/pdfimages.1 +++ b/Build/source/libs/xpdf/xpdf-src/doc/pdfimages.1 @@ -1,8 +1,8 @@ -.\" Copyright 1998-2017 Glyph & Cog, LLC -.TH pdfimages 1 "10 Aug 2017" +.\" Copyright 1998-2019 Glyph & Cog, LLC +.TH pdfimages 1 "18 Feb 2019" .SH NAME pdfimages \- Portable Document Format (PDF) image extractor -(version 4.00) +(version 4.01) .SH SYNOPSIS .B pdfimages [options] @@ -102,7 +102,7 @@ Error related to PDF permissions. 99 Other error. .SH AUTHOR -The pdfimages software and documentation are copyright 1998-2017 Glyph +The pdfimages software and documentation are copyright 1998-2019 Glyph & Cog, LLC. .SH "SEE ALSO" .BR xpdf (1), diff --git a/Build/source/libs/xpdf/xpdf-src/doc/pdfimages.cat b/Build/source/libs/xpdf/xpdf-src/doc/pdfimages.cat index 5f9397b06f2..0830f1d86e8 100644 --- a/Build/source/libs/xpdf/xpdf-src/doc/pdfimages.cat +++ b/Build/source/libs/xpdf/xpdf-src/doc/pdfimages.cat @@ -4,7 +4,7 @@ pdfimages(1) General Commands Manual pdfimages(1) NAME pdfimages - Portable Document Format (PDF) image extractor (version - 4.00) + 4.01) SYNOPSIS pdfimages [options] PDF-file image-root @@ -85,7 +85,7 @@ EXIT CODES 99 Other error. AUTHOR - The pdfimages software and documentation are copyright 1998-2017 Glyph + The pdfimages software and documentation are copyright 1998-2019 Glyph & Cog, LLC. SEE ALSO @@ -95,4 +95,4 @@ SEE ALSO - 10 Aug 2017 pdfimages(1) + 18 Feb 2019 pdfimages(1) diff --git a/Build/source/libs/xpdf/xpdf-src/doc/pdfinfo.1 b/Build/source/libs/xpdf/xpdf-src/doc/pdfinfo.1 index 2a3a1d9f645..9811ac01b96 100644 --- a/Build/source/libs/xpdf/xpdf-src/doc/pdfinfo.1 +++ b/Build/source/libs/xpdf/xpdf-src/doc/pdfinfo.1 @@ -1,8 +1,8 @@ -.\" Copyright 1999-2017 Glyph & Cog, LLC -.TH pdfinfo 1 "10 Aug 2017" +.\" Copyright 1999-2019 Glyph & Cog, LLC +.TH pdfinfo 1 "18 Feb 2019" .SH NAME pdfinfo \- Portable Document Format (PDF) document information -extractor (version 4.00) +extractor (version 4.01) .SH SYNOPSIS .B pdfinfo [options] @@ -150,7 +150,7 @@ Error related to PDF permissions. 99 Other error. .SH AUTHOR -The pdfinfo software and documentation are copyright 1996-2017 Glyph & +The pdfinfo software and documentation are copyright 1996-2019 Glyph & Cog, LLC. .SH "SEE ALSO" .BR xpdf (1), diff --git a/Build/source/libs/xpdf/xpdf-src/doc/pdfinfo.cat b/Build/source/libs/xpdf/xpdf-src/doc/pdfinfo.cat index 4c001beb789..6fce0425b7c 100644 --- a/Build/source/libs/xpdf/xpdf-src/doc/pdfinfo.cat +++ b/Build/source/libs/xpdf/xpdf-src/doc/pdfinfo.cat @@ -4,7 +4,7 @@ pdfinfo(1) General Commands Manual pdfinfo(1) NAME pdfinfo - Portable Document Format (PDF) document information extractor - (version 4.00) + (version 4.01) SYNOPSIS pdfinfo [options] [PDF-file] @@ -104,7 +104,7 @@ EXIT CODES 99 Other error. AUTHOR - The pdfinfo software and documentation are copyright 1996-2017 Glyph & + The pdfinfo software and documentation are copyright 1996-2019 Glyph & Cog, LLC. SEE ALSO @@ -114,4 +114,4 @@ SEE ALSO - 10 Aug 2017 pdfinfo(1) + 18 Feb 2019 pdfinfo(1) diff --git a/Build/source/libs/xpdf/xpdf-src/doc/pdftohtml.1 b/Build/source/libs/xpdf/xpdf-src/doc/pdftohtml.1 index a6c56177fe6..5217b268d0a 100644 --- a/Build/source/libs/xpdf/xpdf-src/doc/pdftohtml.1 +++ b/Build/source/libs/xpdf/xpdf-src/doc/pdftohtml.1 @@ -1,8 +1,8 @@ -.\" Copyright 1997-2017 Glyph & Cog, LLC -.TH pdftohtml 1 "10 Aug 2017" +.\" Copyright 1997-2019 Glyph & Cog, LLC +.TH pdftohtml 1 "18 Feb 2019" .SH NAME pdftohtml \- Portable Document Format (PDF) to HTML converter -(version 4.00) +(version 4.01) .SH SYNOPSIS .B pdftohtml [options] @@ -109,7 +109,7 @@ Error related to PDF permissions. 99 Other error. .SH AUTHOR -The pdftohtml software and documentation are copyright 1996-2017 Glyph +The pdftohtml software and documentation are copyright 1996-2019 Glyph & Cog, LLC. .SH "SEE ALSO" .BR xpdf (1), diff --git a/Build/source/libs/xpdf/xpdf-src/doc/pdftohtml.cat b/Build/source/libs/xpdf/xpdf-src/doc/pdftohtml.cat index 4999a589631..d29a01ecdad 100644 --- a/Build/source/libs/xpdf/xpdf-src/doc/pdftohtml.cat +++ b/Build/source/libs/xpdf/xpdf-src/doc/pdftohtml.cat @@ -4,7 +4,7 @@ pdftohtml(1) General Commands Manual pdftohtml(1) NAME pdftohtml - Portable Document Format (PDF) to HTML converter (version - 4.00) + 4.01) SYNOPSIS pdftohtml [options] PDF-file HTML-dir @@ -97,7 +97,7 @@ EXIT CODES 99 Other error. AUTHOR - The pdftohtml software and documentation are copyright 1996-2017 Glyph + The pdftohtml software and documentation are copyright 1996-2019 Glyph & Cog, LLC. SEE ALSO @@ -107,4 +107,4 @@ SEE ALSO - 10 Aug 2017 pdftohtml(1) + 18 Feb 2019 pdftohtml(1) diff --git a/Build/source/libs/xpdf/xpdf-src/doc/pdftopng.1 b/Build/source/libs/xpdf/xpdf-src/doc/pdftopng.1 index a75704f0ae7..5d9cd44a7e7 100644 --- a/Build/source/libs/xpdf/xpdf-src/doc/pdftopng.1 +++ b/Build/source/libs/xpdf/xpdf-src/doc/pdftopng.1 @@ -1,8 +1,8 @@ -.\" Copyright 2017 Glyph & Cog, LLC -.TH pdftopng 1 "10 Aug 2017" +.\" Copyright 2017-2019 Glyph & Cog, LLC +.TH pdftopng 1 "18 Feb 2019" .SH NAME pdftopng \- Portable Document Format (PDF) to Portable Network Graphics -(PNG) converter (version 4.00) +(PNG) converter (version 4.01) .SH SYNOPSIS .B pdftopng [options] @@ -107,7 +107,7 @@ Error related to PDF permissions. 99 Other error. .SH AUTHOR -The pdftopng software and documentation are copyright 1996-2017 Glyph +The pdftopng software and documentation are copyright 1996-2019 Glyph & Cog, LLC. .SH "SEE ALSO" .BR xpdf (1), diff --git a/Build/source/libs/xpdf/xpdf-src/doc/pdftopng.cat b/Build/source/libs/xpdf/xpdf-src/doc/pdftopng.cat index c403c7b8926..7e6de4654a8 100644 --- a/Build/source/libs/xpdf/xpdf-src/doc/pdftopng.cat +++ b/Build/source/libs/xpdf/xpdf-src/doc/pdftopng.cat @@ -4,7 +4,7 @@ pdftopng(1) General Commands Manual pdftopng(1) NAME pdftopng - Portable Document Format (PDF) to Portable Network Graphics - (PNG) converter (version 4.00) + (PNG) converter (version 4.01) SYNOPSIS pdftopng [options] PDF-file PNG-root @@ -87,7 +87,7 @@ EXIT CODES 99 Other error. AUTHOR - The pdftopng software and documentation are copyright 1996-2017 Glyph & + The pdftopng software and documentation are copyright 1996-2019 Glyph & Cog, LLC. SEE ALSO @@ -97,4 +97,4 @@ SEE ALSO - 10 Aug 2017 pdftopng(1) + 18 Feb 2019 pdftopng(1) diff --git a/Build/source/libs/xpdf/xpdf-src/doc/pdftoppm.1 b/Build/source/libs/xpdf/xpdf-src/doc/pdftoppm.1 index 6eb614024d7..05424a3a9fa 100644 --- a/Build/source/libs/xpdf/xpdf-src/doc/pdftoppm.1 +++ b/Build/source/libs/xpdf/xpdf-src/doc/pdftoppm.1 @@ -1,8 +1,8 @@ -.\" Copyright 2005-2017 Glyph & Cog, LLC -.TH pdftoppm 1 "10 Aug 2017" +.\" Copyright 2005-2019 Glyph & Cog, LLC +.TH pdftoppm 1 "18 Feb 2019" .SH NAME pdftoppm \- Portable Document Format (PDF) to Portable Pixmap (PPM) -converter (version 4.00) +converter (version 4.01) .SH SYNOPSIS .B pdftoppm [options] @@ -107,7 +107,7 @@ Error related to PDF permissions. 99 Other error. .SH AUTHOR -The pdftoppm software and documentation are copyright 1996-2017 Glyph +The pdftoppm software and documentation are copyright 1996-2019 Glyph & Cog, LLC. .SH "SEE ALSO" .BR xpdf (1), diff --git a/Build/source/libs/xpdf/xpdf-src/doc/pdftoppm.cat b/Build/source/libs/xpdf/xpdf-src/doc/pdftoppm.cat index 86d2e4b0165..cad6636e274 100644 --- a/Build/source/libs/xpdf/xpdf-src/doc/pdftoppm.cat +++ b/Build/source/libs/xpdf/xpdf-src/doc/pdftoppm.cat @@ -4,7 +4,7 @@ pdftoppm(1) General Commands Manual pdftoppm(1) NAME pdftoppm - Portable Document Format (PDF) to Portable Pixmap (PPM) con- - verter (version 4.00) + verter (version 4.01) SYNOPSIS pdftoppm [options] PDF-file PPM-root @@ -86,7 +86,7 @@ EXIT CODES 99 Other error. AUTHOR - The pdftoppm software and documentation are copyright 1996-2017 Glyph & + The pdftoppm software and documentation are copyright 1996-2019 Glyph & Cog, LLC. SEE ALSO @@ -96,4 +96,4 @@ SEE ALSO - 10 Aug 2017 pdftoppm(1) + 18 Feb 2019 pdftoppm(1) diff --git a/Build/source/libs/xpdf/xpdf-src/doc/pdftops.1 b/Build/source/libs/xpdf/xpdf-src/doc/pdftops.1 index 59fb3af9da5..6089566d528 100644 --- a/Build/source/libs/xpdf/xpdf-src/doc/pdftops.1 +++ b/Build/source/libs/xpdf/xpdf-src/doc/pdftops.1 @@ -1,8 +1,8 @@ -.\" Copyright 1996-2017 Glyph & Cog, LLC -.TH pdftops 1 "10 Aug 2017" +.\" Copyright 1996-2019 Glyph & Cog, LLC +.TH pdftops 1 "18 Feb 2019" .SH NAME pdftops \- Portable Document Format (PDF) to PostScript converter -(version 4.00) +(version 4.01) .SH SYNOPSIS .B pdftops [options] @@ -236,7 +236,7 @@ Error related to PDF permissions. 99 Other error. .SH AUTHOR -The pdftops software and documentation are copyright 1996-2017 Glyph & +The pdftops software and documentation are copyright 1996-2019 Glyph & Cog, LLC. .SH "SEE ALSO" .BR xpdf (1), diff --git a/Build/source/libs/xpdf/xpdf-src/doc/pdftops.cat b/Build/source/libs/xpdf/xpdf-src/doc/pdftops.cat index de656d5f8da..5669e050500 100644 --- a/Build/source/libs/xpdf/xpdf-src/doc/pdftops.cat +++ b/Build/source/libs/xpdf/xpdf-src/doc/pdftops.cat @@ -4,7 +4,7 @@ pdftops(1) General Commands Manual pdftops(1) NAME pdftops - Portable Document Format (PDF) to PostScript converter (ver- - sion 4.00) + sion 4.01) SYNOPSIS pdftops [options] [PDF-file [PS-file]] @@ -201,7 +201,7 @@ EXIT CODES 99 Other error. AUTHOR - The pdftops software and documentation are copyright 1996-2017 Glyph & + The pdftops software and documentation are copyright 1996-2019 Glyph & Cog, LLC. SEE ALSO @@ -211,4 +211,4 @@ SEE ALSO - 10 Aug 2017 pdftops(1) + 18 Feb 2019 pdftops(1) diff --git a/Build/source/libs/xpdf/xpdf-src/doc/pdftotext.1 b/Build/source/libs/xpdf/xpdf-src/doc/pdftotext.1 index 7fef78e742a..96b6a68ea3f 100644 --- a/Build/source/libs/xpdf/xpdf-src/doc/pdftotext.1 +++ b/Build/source/libs/xpdf/xpdf-src/doc/pdftotext.1 @@ -1,8 +1,8 @@ -.\" Copyright 1997-2017 Glyph & Cog, LLC -.TH pdftotext 1 "10 Aug 2017" +.\" Copyright 1997-2019 Glyph & Cog, LLC +.TH pdftotext 1 "18 Feb 2019" .SH NAME pdftotext \- Portable Document Format (PDF) to text converter -(version 4.00) +(version 4.01) .SH SYNOPSIS .B pdftotext [options] @@ -172,7 +172,7 @@ Error related to PDF permissions. 99 Other error. .SH AUTHOR -The pdftotext software and documentation are copyright 1996-2017 Glyph +The pdftotext software and documentation are copyright 1996-2019 Glyph & Cog, LLC. .SH "SEE ALSO" .BR xpdf (1), diff --git a/Build/source/libs/xpdf/xpdf-src/doc/pdftotext.cat b/Build/source/libs/xpdf/xpdf-src/doc/pdftotext.cat index ffe7ebc08b1..2de518cb3b0 100644 --- a/Build/source/libs/xpdf/xpdf-src/doc/pdftotext.cat +++ b/Build/source/libs/xpdf/xpdf-src/doc/pdftotext.cat @@ -4,7 +4,7 @@ pdftotext(1) General Commands Manual pdftotext(1) NAME pdftotext - Portable Document Format (PDF) to text converter (version - 4.00) + 4.01) SYNOPSIS pdftotext [options] [PDF-file [text-file]] @@ -138,7 +138,7 @@ EXIT CODES 99 Other error. AUTHOR - The pdftotext software and documentation are copyright 1996-2017 Glyph + The pdftotext software and documentation are copyright 1996-2019 Glyph & Cog, LLC. SEE ALSO @@ -148,4 +148,4 @@ SEE ALSO - 10 Aug 2017 pdftotext(1) + 18 Feb 2019 pdftotext(1) diff --git a/Build/source/libs/xpdf/xpdf-src/doc/sample-xpdfrc b/Build/source/libs/xpdf/xpdf-src/doc/sample-xpdfrc index 21e6c995b6a..76b45c66fbb 100644 --- a/Build/source/libs/xpdf/xpdf-src/doc/sample-xpdfrc +++ b/Build/source/libs/xpdf/xpdf-src/doc/sample-xpdfrc @@ -54,10 +54,6 @@ #----- PostScript output control -# Set the default PostScript file or command. - -#psFile "|lpr -Pmyprinter" - # Set the default PostScript paper size -- this can be letter, legal, # A4, or A3. You can also specify a paper size as width and height # (in points). @@ -88,4 +84,3 @@ # clicked. #launchCommand viewer-script -#urlCommand "netscape -remote 'openURL(%s)'" diff --git a/Build/source/libs/xpdf/xpdf-src/doc/xpdf.1 b/Build/source/libs/xpdf/xpdf-src/doc/xpdf.1 index b463d0fab43..63f3efd3fc9 100644 --- a/Build/source/libs/xpdf/xpdf-src/doc/xpdf.1 +++ b/Build/source/libs/xpdf/xpdf-src/doc/xpdf.1 @@ -1,12 +1,17 @@ -.\" Copyright 1996-2017 Glyph & Cog, LLC -.TH xpdf 1 "10 Aug 2017" +.\" Copyright 1996-2019 Glyph & Cog, LLC +.TH xpdf 1 "18 Feb 2019" .SH NAME -xpdf \- Portable Document Format (PDF) file viewer (version 4.00) +xpdf \- Portable Document Format (PDF) file viewer (version 4.01) .SH SYNOPSIS .B xpdf [options] .RI [ PDF-file .RI [: page " | +" dest "]] ..." +.PP +.B xpdf +[options] +.B -remote +.IR remote-name " [" command " ...]" .SH DESCRIPTION .B Xpdf is a viewer for Portable Document Format (PDF) files. (These are also @@ -124,6 +129,9 @@ password. .B \-fullscreen Open xpdf in full-screen mode, useful for presentations. .TP +.BI \-remote " remote-name" +Start Xpdf in remote server mode. See the REMOVE SERVER MODE section. +.TP .BI \-display " display" Set the X display (only available with X11). .TP @@ -349,7 +357,8 @@ Xpdf can be placed into full-screen mode via the command line option, the \'full screen' menu item, or a binding to the .B fullScreenMode or -.BR toggleFullScreenMode command . +.B toggleFullScreenMode +command. .PP Entering full-screen mode automatically switches to single-page view mode and to the fit-page zoom factor. @@ -376,6 +385,23 @@ Set block selection mode. In this mode, the selection is a simple rectangle. Any part of the page can be selected, regardless of the content on the page. .TP +.BI checkOpenFile( file ) +Check that +.I file +is open in the current tab, and open it if not. +.TP +.BI checkOpenFileAtDest( file, dest ) +Check that +.I file +is open in the current tab, and open it if not. In either case go to +the specified named destination. +.TP +.BI checkOpenFileAtPage( file, page ) +Check that +.I file +is open in the current tab, and open it if not. In either case go to +the specified page. +.TP .B closeSidebar Close the sidebar. .TP @@ -478,6 +504,12 @@ Switch to horizontal continuous view mode. Set linear selection mode. In this mode, the selection follows text. Non-text regions cannot be selected. .TP +.BI loadTabState +Load the tab state file (which was written via the saveTabState +command), and restore the tabs listed in that file. The path for the +tab state file is specified with the tabStateFile setting (see +.BR xpdfrc (5)). +.TP .B newTab Open an empty new tab. .TP @@ -499,6 +531,16 @@ Open a PDF file in this tab, using the open dialog. .B openErrorWindow Open the error window. .TP +.BI openFile( file ) +Open the specified file in the current tab. +.TP +.BI openFileAtDest( file, dest ) +Open the specified file in the current tab at the specified named +destination. +.TP +.BI openFileAtPage( file, page ) +Open the specified file in the current tab at the specified page. +.TP .B openSidebar Open the sidebar. .TP @@ -579,6 +621,10 @@ command must be quoted in the xpdfrc file: bind x "run(ls -l)" .fi +The command string may not be run through a shell. It is recommended +to keep the command simple, so that it doesn't depend on specific +shell functionality. For complex things, you can have the command +string run a shell script. .TP .B saveAs Save PDF via a file requester. @@ -586,12 +632,20 @@ Save PDF via a file requester. .B saveImage Open the \'save image' dialog. .TP +.BI saveTabState +Save a list of all tabs open in this window to the tab state file. +For each tab, this writes the PDF file name and page number (on +separate lines). This file can be loaded later with the loadTabState +command. The path for the tab state file is specified with the +tabStateFile setting (see +.BR xpdfrc (5)). +.TP .BI scrollDown( n ) Scroll down by .I n pixels. .TP -.BI scrollDownPrevPage( n ) +.BI scrollDownNextPage( n ) Scroll down by .I n pixels, moving to the next page if appropriate. @@ -617,11 +671,11 @@ Scroll right by pixels. .TP .B scrollToBottomEdge -Scroll to the bottom edge of the current page, with no horizontal -movement. +Scroll to the bottom edge of the last displayed page, with no +horizontal movement. .TP .B scrollToBottomRight -Scroll to the bottom-right corner of the current page. +Scroll to the bottom-right corner of the last displayed page. .TP .B scrollToLeftEdge Scroll to the left edge of the current page, with no vertical @@ -632,11 +686,11 @@ Scroll to the right edge of the current page, with no vertical movement. .TP .B scrollToTopEdge -Scroll to the top edge of the current page, with no horizontal +Scroll to the top edge of the first displayed page, with no horizontal movement. .TP .B scrollToTopLeft -Scroll to the top-left corner of the current page. +Scroll to the top-left corner of the first displayed page. .TP .BI scrollUp( n ) Scroll up by @@ -710,6 +764,25 @@ Set the zoom factor to .TP .B zoomToSelection Zoom to the current selection. +.SH REMOTE SERVER MODE +Starting xpdf with the "-remote" switch puts it into remote server +mode. All remaining command line options are commands (see the +COMMANDS section). Subsequent invocations of "xpdf -remote" with the +same remote server name will send commands to the already-running +instance of xpdf. The "checkOpenFile" commands are useful here for +things like changing pages. +For example: +.PP +.RS + # Start up xpdf, and open something.pdf. + xpdf -remote foo 'openFile(something.pdf)' + + # Switch to page 7 in the already-open something.pdf. If the user + # has closed xpdf in the meantime, this will restart it and reopen + # the file. + xpdf -remote foo 'checkOpenFileAtPage(something.pdf, 7)' +.RE +.PP .SH EXIT CODES The Xpdf tools use the following exit codes: .TP @@ -728,7 +801,7 @@ Error related to PDF permissions. 99 Other error. .SH AUTHOR -The xpdf software and documentation are copyright 1996-2017 Glyph & +The xpdf software and documentation are copyright 1996-2019 Glyph & Cog, LLC. .SH "SEE ALSO" .BR pdftops (1), diff --git a/Build/source/libs/xpdf/xpdf-src/doc/xpdf.cat b/Build/source/libs/xpdf/xpdf-src/doc/xpdf.cat index cf76e2490a5..b3c6ce7cabc 100644 --- a/Build/source/libs/xpdf/xpdf-src/doc/xpdf.cat +++ b/Build/source/libs/xpdf/xpdf-src/doc/xpdf.cat @@ -3,11 +3,13 @@ xpdf(1) General Commands Manual xpdf(1) NAME - xpdf - Portable Document Format (PDF) file viewer (version 4.00) + xpdf - Portable Document Format (PDF) file viewer (version 4.01) SYNOPSIS xpdf [options] [PDF-file [:page | +dest]] ... + xpdf [options] -remote remote-name [command ...] + DESCRIPTION Xpdf is a viewer for Portable Document Format (PDF) files. (These are also sometimes also called 'Acrobat' files, from the name of Adobe's @@ -108,10 +110,14 @@ OPTIONS -fullscreen Open xpdf in full-screen mode, useful for presentations. + -remote remote-name + Start Xpdf in remote server mode. See the REMOVE SERVER MODE + section. + -display display Set the X display (only available with X11). - -cmd Print commands as they're executed (useful for debugging). + -cmd Print commands as they're executed (useful for debugging). [config file: printCommands] -cfg config-file @@ -125,7 +131,7 @@ OPTIONS CONTROLS Tool bar 'page' entry box - Move to a specific page number. Click in the box to activate + Move to a specific page number. Click in the box to activate it, type the page number, then hit return. left/right arrow buttons @@ -135,23 +141,23 @@ CONTROLS Zoom out or in (i.e., change magnification) incrementally. zoom popup menu - Change the zoom factor (see the description of the -z option + Change the zoom factor (see the description of the -z option above). fit width button - Change the zoom factor to fit the page width to the window + Change the zoom factor to fit the page width to the window width. fit page button Change the zoom factor to fit the page to the window size. 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 + 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. 'find' box - Find a text string. Click in the box to activate it, type a + Find a text string. Click in the box to activate it, type a search string, then hit return. find next button @@ -165,41 +171,41 @@ CONTROLS whole words (on/off). Menu bar - The menu bar is above the tool bar. The menu items should be self- + The menu bar is above the tool bar. The menu items should be self- explanatory. 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 tool bar. It lists all open tabs. Outline/layers/attachments pane - This pane is on the left, below the tab list. The popup allows you to + This pane is on the left, below the tab list. The popup allows you to select from outline, layers, or attachments. - The outline is a tree-like structure of bookmarks that allows moving + The outline is a tree-like structure of bookmarks that allows moving within the PDF file. Not all PDF files have outlines. - Layers (a.k.a. optional content) allow parts of the PDF content to be + Layers (a.k.a. optional content) allow parts of the PDF content to be shown or hidden. Not all PDF files have layers. - Attachments are other files embedded within the PDF file. There is a - 'save' button for each attached file. Not all PDF files have attach- + Attachments are other files embedded within the PDF file. There is a + 'save' button for each attached file. Not all PDF files have attach- ments. Text selection - Dragging the mouse with the left button held down will highlight an - arbitrary rectangle. Selected text can be copied to the clipboard - (with the edit/copy menu item). On X11, selected text will be avail- + Dragging the mouse with the left button held down will highlight an + arbitrary rectangle. Selected text can be copied to the clipboard + (with the edit/copy menu item). On X11, selected text will be avail- able in the X selection buffer. Links - When the mouse is over a hyperlink, the link target will be shown in a + When the mouse is over a hyperlink, the link target will be shown in a popup near the bottom of the window. 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 are opened in a system-dependent + 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 are opened in a system-dependent way. (On UNIX, Qt uses the $BROWSER environment variable.) Mouse bindings @@ -209,19 +215,19 @@ CONTROLS Dragging the mouse with the middle button held down pans the window. - The right mouse button opens a popup menu (see popupMenuCmd in + The right mouse button opens a popup menu (see popupMenuCmd in xpdfrc(5)). Key bindings - This section lists the default key bindings. Bindings can be changed + This section lists the default key bindings. Bindings can be changed using the config file (see xpdfrc(5)). control-o Open a new PDF file via a file requester. control-r - Reload the current PDF file. Note that Xpdf will reload the - file automatically (on a page change or redraw) if it has + Reload the current PDF file. Note that Xpdf will reload the + file automatically (on a page change or redraw) if it has changed since it was last loaded. control-f @@ -255,8 +261,8 @@ CONTROLS Open a new window. control-w - Close the current tab. Closes the window if this was the last - open tab. Quits the application if this was the last open win- + Close the current tab. Closes the window if this was the last + open tab. Quits the application if this was the last open win- dow. control-q @@ -288,11 +294,11 @@ CONTROLS Go to the last page. <space> or <PageDown> - Scroll down on the current page; if already at bottom, move to + Scroll down on the current page; if already at bottom, move to next page. control-<PageDown> or control-<down-arrow> - Go to the next page. If <ScrollLock> is active, this maintains + Go to the next page. If <ScrollLock> is active, this maintains the relative position on the page. <PageUp> @@ -300,7 +306,7 @@ CONTROLS ous page. control-<PageUp> or control-<up-arrow> - Go to the previous page. If <ScrollLock> is active, this main- + Go to the previous page. If <ScrollLock> is active, this main- tains the relative position on the page. <esc> Exit full-screen mode. @@ -314,20 +320,20 @@ CONTROLS w Set the zoom factor to 'width' (fit page width to window). Full-screen mode - Xpdf can be placed into full-screen mode via the -fullscreen command - line option, the 'full screen' menu item, or a binding to the - fullScreenMode or toggleFullScreenModecommand. + Xpdf can be placed into full-screen mode via the -fullscreen command + line option, the 'full screen' menu item, or a binding to the + fullScreenMode or toggleFullScreenMode command. - Entering full-screen mode automatically switches to single-page view + Entering full-screen mode automatically switches to single-page view mode and to the fit-page zoom factor. - Full-screen mode can be exited via the default <esc> key binding, or + Full-screen mode can be exited via the default <esc> key binding, or via a binding to the windowMode or toggleFullScreenModecommand. COMMANDS Xpdf's key and mouse bindings are user-configurable, using the bind and - unbind commands in the config file (see xpdfrc(5)). The bind command - allows you to bind a key or mouse button to a sequence of one or more + unbind commands in the config file (see xpdfrc(5)). The bind command + allows you to bind a key or mouse button to a sequence of one or more commands. The following commands are supported: @@ -339,6 +345,17 @@ COMMANDS ple rectangle. Any part of the page can be selected, regardless of the content on the page. + checkOpenFile(file) + Check that file is open in the current tab, and open it if not. + + checkOpenFileAtDest(file,dest) + Check that file is open in the current tab, and open it if not. + In either case go to the specified named destination. + + checkOpenFileAtPage(file,page) + Check that file is open in the current tab, and open it if not. + In either case go to the specified page. + closeSidebar Close the sidebar. @@ -386,29 +403,29 @@ COMMANDS Set keyboard focus to the page number text box. followLink - Follow a hyperlink (does nothing if the mouse is not over a + Follow a hyperlink (does nothing if the mouse is not over a link). followLinkInNewTab Follow a hyperlink, opening PDF files in a new tab (does nothing - if the mouse is not over a link). For links to non-PDF files, + if the mouse is not over a link). For links to non-PDF files, this command is identical to followLink. followLinkInNewTabNoSel - Same as followLinkInNewTab, but does nothing if there is a non- + Same as followLinkInNewTab, but does nothing if there is a non- empty selection. (This is useful as a mouse button binding.) followLinkInNewWin - Follow a hyperlink, opening PDF files in a new window (does - nothing if the mouse is not over a link). For links to non-PDF + Follow a hyperlink, opening PDF files in a new window (does + nothing if the mouse is not over a link). For links to non-PDF files, this command is identical to followLink. followLinkInNewWinNoSel - Same as followLinkInNewWin, but does nothing if there is a non- + Same as followLinkInNewWin, but does nothing if there is a non- empty selection. (This is useful as a mouse button binding.) followLinkNoSel - Same as followLink, but does nothing if there is a non-empty + Same as followLink, but does nothing if there is a non-empty selection. (This is useful as a mouse button binding.) fullScreenMode @@ -435,9 +452,15 @@ COMMANDS Switch to horizontal continuous view mode. linearSelectMode - Set linear selection mode. In this mode, the selection follows + Set linear selection mode. In this mode, the selection follows text. Non-text regions cannot be selected. + loadTabState + Load the tab state file (which was written via the saveTabState + command), and restore the tabs listed in that file. The path + for the tab state file is specified with the tabStateFile set- + ting (see xpdfrc(5)). + newTab Open an empty new tab. newWindow @@ -457,6 +480,17 @@ COMMANDS openErrorWindow Open the error window. + openFile(file) + Open the specified file in the current tab. + + openFileAtDest(file,dest) + Open the specified file in the current tab at the specified + named destination. + + openFileAtPage(file,page) + Open the specified file in the current tab at the specified + page. + openSidebar Open the sidebar. @@ -530,16 +564,27 @@ COMMANDS bind x "run(ls -l)" + The command string may not be run through a shell. It is recom- + mended to keep the command simple, so that it doesn't depend on + specific shell functionality. For complex things, you can have + the command string run a shell script. saveAs Save PDF via a file requester. saveImage Open the 'save image' dialog. + saveTabState + Save a list of all tabs open in this window to the tab state + file. For each tab, this writes the PDF file name and page num- + ber (on separate lines). This file can be loaded later with the + loadTabState command. The path for the tab state file is speci- + fied with the tabStateFile setting (see xpdfrc(5)). + scrollDown(n) Scroll down by n pixels. - scrollDownPrevPage(n) + scrollDownNextPage(n) Scroll down by n pixels, moving to the next page if appropriate. scrollLeft(n) @@ -555,36 +600,36 @@ COMMANDS Scroll right by n pixels. scrollToBottomEdge - Scroll to the bottom edge of the current page, with no horizon- - tal movement. + Scroll to the bottom edge of the last displayed page, with no + horizontal movement. scrollToBottomRight - Scroll to the bottom-right corner of the current page. + Scroll to the bottom-right corner of the last displayed page. scrollToLeftEdge - Scroll to the left edge of the current page, with no vertical + Scroll to the left edge of the current page, with no vertical movement. scrollToRightEdge - Scroll to the right edge of the current page, with no vertical + Scroll to the right edge of the current page, with no vertical movement. scrollToTopEdge - Scroll to the top edge of the current page, with no horizontal - movement. + Scroll to the top edge of the first displayed page, with no hor- + izontal movement. scrollToTopLeft - Scroll to the top-left corner of the current page. + Scroll to the top-left corner of the first displayed page. scrollUp(n) Scroll up by n pixels. scrollUpPrevPage(n) - Scroll up by n pixels, moving to the previous page if appropri- + Scroll up by n pixels, moving to the previous page if appropri- ate. setSelection(pg,ulx,uly,lrx,lry) - Set the selection to the specified coordinates on the specified + Set the selection to the specified coordinates on the specified page. sideBySideContinuousMode @@ -597,11 +642,11 @@ COMMANDS Switch to single-page view mode. startPan - Start a pan operation at the current mouse position, which will + Start a pan operation at the current mouse position, which will scroll the document as the mouse moves. startSelection - Start a selection at the current mouse position, which will be + Start a selection at the current mouse position, which will be extended as the mouse moves. toggleContinuousMode @@ -617,12 +662,12 @@ COMMANDS Toggle the sidebar between open and closed. toggleSidebarMoveResizeWin - Toggle the sidebar between open and closed, resizing the window - so that the document size doesn't change, and moving the window + Toggle the sidebar between open and closed, resizing the window + so that the document size doesn't change, and moving the window so that the document stays in the same place on the screen. toggleSidebarResizeWin - Toggle the sidebar between open and closed, resizing the window + Toggle the sidebar between open and closed, resizing the window so that the document size doesn't change. windowMode @@ -645,6 +690,24 @@ COMMANDS zoomToSelection Zoom to the current selection. +REMOTE SERVER MODE + Starting xpdf with the "-remote" switch puts it into remote server + mode. All remaining command line options are commands (see the COM- + MANDS section). Subsequent invocations of "xpdf -remote" with the same + remote server name will send commands to the already-running instance + of xpdf. The "checkOpenFile" commands are useful here for things like + changing pages. For example: + + # Start up xpdf, and open something.pdf. + xpdf -remote foo 'openFile(something.pdf)' + + # Switch to page 7 in the already-open something.pdf. If + the user + # has closed xpdf in the meantime, this will restart it and + reopen + # the file. + xpdf -remote foo 'checkOpenFileAtPage(something.pdf, 7)' + EXIT CODES The Xpdf tools use the following exit codes: @@ -659,7 +722,7 @@ EXIT CODES 99 Other error. AUTHOR - The xpdf software and documentation are copyright 1996-2017 Glyph & + The xpdf software and documentation are copyright 1996-2019 Glyph & Cog, LLC. SEE ALSO @@ -669,4 +732,4 @@ SEE ALSO - 10 Aug 2017 xpdf(1) + 18 Feb 2019 xpdf(1) diff --git a/Build/source/libs/xpdf/xpdf-src/doc/xpdfrc.5 b/Build/source/libs/xpdf/xpdf-src/doc/xpdfrc.5 index 8ae83f410a5..2e440f72c59 100644 --- a/Build/source/libs/xpdf/xpdf-src/doc/xpdfrc.5 +++ b/Build/source/libs/xpdf/xpdf-src/doc/xpdfrc.5 @@ -1,7 +1,7 @@ -.\" Copyright 2002-2017 Glyph & Cog, LLC -.TH xpdfrc 5 "10 Aug 2017" +.\" Copyright 2002-2019 Glyph & Cog, LLC +.TH xpdfrc 5 "18 Feb 2019" .SH NAME -xpdfrc \- configuration file for Xpdf tools (version 4.00) +xpdfrc \- configuration file for Xpdf tools (version 4.01) .SH DESCRIPTION All of the Xpdf tools read a single configuration file. If you have a .I .xpdfrc @@ -234,17 +234,12 @@ If set to "yes", all PostScript output will be rasterized. This defaults to "no". .TP .BR psNeverRasterize " yes | no" -If set to "yes", PostScript output will never be rasterized. This -will likely result in incorrect output for PDF files that use -transparency. (If both psAlwaysRasterize and psNeverRasterize are set -to "yes", the psAlwaysRasterize setting wins.) This defaults to "no". -.TP -.BI psFile " file\-or\-command" -Sets the default PostScript file or print command for xpdf. Commands -start with a \'|' character; anything else is a file. If the file -name or command contains spaces it must be quoted. This defaults to -unset, which tells xpdf to generate a name of the form <file>.ps for a -PDF file <file>.pdf. +Pdftops rasterizes an pages that use transparency (because PostScript +doesn't support transparency). If psNeverRasterize is set to "yes", +rasterization is disabled: pages will never be rasterized, even if +they contain transparency. This will likely result in incorrect +output for PDF files that use transparency, and a warning message to +that effect will be printed. This defaults to "no". .TP .BI fontDir " dir" See the description above, in the DISPLAY FONTS section. @@ -330,6 +325,18 @@ occurrence of .I in\-hex will be converted to the specified output sequence. .TP +.BI unicodeRemapping " remap\-file" +Remap Unicode characters when doing text extraction. This specifies a +file that maps from a particular Unicode index to zero or more +replacement Unicode indexes. Each line of the remap file represents +one Unicode character: + +.RI " " in\-hex " " out\-hex1 " " out\-hex2 " ..." + +Any Unicode characters not listed will be left unchanged. This +function is typically used to remap things like non-breaking spaces, +soft hyphens, ligatures, etc. +.TP .BI unicodeMap " encoding\-name map\-file" Specifies the file with mapping from Unicode to .IR encoding\-name . @@ -412,6 +419,16 @@ use the font's Unicode cmap to map Unicode to GIDs. If mapExtTrueTypeFontsViaUnicode is set to "no", Xpdf will assume the character codes are GIDs (i.e., use an identity mapping). This defaults to "yes". +.TP +.BI dropFont " font-name" +Drop all text drawn in the specified font. To drop text drawn in +unnamed fonts, use: +.nf + + dropFont "" + +.fi +There can be any number of dropFont commands. .SH RASTERIZER SETTINGS .TP .BR enableFreeType " yes | no" @@ -450,6 +467,11 @@ used to ensure that lines of the same original width will always have the same adjusted width (at the expense of allowing gaps and overlaps between adjacent lines). This defaults to "yes". .TP +.BR forceAccurateTiling " yes | no" +If this is set to "yes", the TilingType is forced to 2 (no distortion) +for all tiling patterns, regardless of the setting in the pattern +dictionary. This defaults to "no". +.TP .BR screenType " dispersed | clustered | stochasticClustered" Sets the halftone screen type, which will be used when generating a monochrome (1-bit) bitmap. The three options are dispersed-dot @@ -518,7 +540,7 @@ based on the screen resolution. .BI initialSidebarState " yes | no" If set to "yes", xpdf opens with the sidebar (tabs, outline, etc.) visible. If set to "no", xpdf opens with the sidebar collapsed. The -default is "no". +default is "yes". .TP .BI paperColor " color" Set the "paper color", i.e., the background of the page display. The @@ -574,6 +596,9 @@ Sets the command executed when you click on a movie annotation. The string "%s" will be replaced with the movie file name. This has no default value. .TP +.BI defaultPrinter " printer" +Sets the default printer used in the viewer's print dialog. +.TP .BI bind " modifiers-key context command ..." Add a key or mouse button binding. .I Modifiers @@ -652,6 +677,12 @@ Removes a key binding established with the bind command. This is most useful to remove default key bindings before establishing new ones (e.g., if the default key binding is given for "any" context, and you want to create new key bindings for multiple contexts). +.TP +.BI tabStateFile " path" +Sets the file used by the loadTabState and saveTabState commands (see +the +.BR xpdf (1) +man page for more information). .SH MISCELLANEOUS SETTINGS .TP .BI drawAnnotations " yes | no" @@ -712,7 +743,6 @@ psDuplex no psLevel level2 psEmbedType1Fonts yes psEmbedTrueTypeFonts yes -psFile "| lpr \-Pprinter5" # assume that the PostScript printer has the Univers and # Univers-Bold fonts @@ -726,7 +756,6 @@ textEOL unix # misc options enableFreeType yes launchCommand viewer-script -urlCommand "netscape \-remote 'openURL(%s)'" .fi .SH FILES @@ -739,7 +768,7 @@ Depending on build options, it may be placed elsewhere. This is the user's configuration file. If it exists, it will be read in place of the system-wide file. .SH AUTHOR -The Xpdf software and documentation are copyright 1996-2017 Glyph & +The Xpdf software and documentation are copyright 1996-2019 Glyph & Cog, LLC. .SH "SEE ALSO" .BR xpdf (1), diff --git a/Build/source/libs/xpdf/xpdf-src/doc/xpdfrc.cat b/Build/source/libs/xpdf/xpdf-src/doc/xpdfrc.cat index 213dde746d4..d1e6e07ebce 100644 --- a/Build/source/libs/xpdf/xpdf-src/doc/xpdfrc.cat +++ b/Build/source/libs/xpdf/xpdf-src/doc/xpdfrc.cat @@ -3,7 +3,7 @@ xpdfrc(5) File Formats Manual xpdfrc(5) NAME - xpdfrc - configuration file for Xpdf tools (version 4.00) + xpdfrc - configuration file for Xpdf tools (version 4.01) DESCRIPTION All of the Xpdf tools read a single configuration file. If you have a @@ -216,19 +216,14 @@ POSTSCRIPT CONTROL defaults to "no". psNeverRasterize yes | no - If set to "yes", PostScript output will never be rasterized. - This will likely result in incorrect output for PDF files that - use transparency. (If both psAlwaysRasterize and psNeverRaster- - ize are set to "yes", the psAlwaysRasterize setting wins.) This + Pdftops rasterizes an pages that use transparency (because Post- + Script doesn't support transparency). If psNeverRasterize is + set to "yes", rasterization is disabled: pages will never be + rasterized, even if they contain transparency. This will likely + result in incorrect output for PDF files that use transparency, + and a warning message to that effect will be printed. This defaults to "no". - psFile file-or-command - Sets the default PostScript file or print command for xpdf. - Commands start with a '|' character; anything else is a file. - If the file name or command contains spaces it must be quoted. - This defaults to unset, which tells xpdf to generate a name of - the form <file>.ps for a PDF file <file>.pdf. - fontDir dir See the description above, in the DISPLAY FONTS section. @@ -305,11 +300,23 @@ TEXT CONTROL AND CHARACTER MAPPING indexes. Each occurrence of in-hex will be converted to the specified output sequence. + unicodeRemapping remap-file + Remap Unicode characters when doing text extraction. This spec- + ifies a file that maps from a particular Unicode index to zero + or more replacement Unicode indexes. Each line of the remap + file represents one Unicode character: + + in-hex out-hex1 out-hex2 ... + + Any Unicode characters not listed will be left unchanged. This + function is typically used to remap things like non-breaking + spaces, soft hyphens, ligatures, etc. + unicodeMap encoding-name map-file - Specifies the file with mapping from Unicode to encoding-name. + Specifies the file with mapping from Unicode to encoding-name. These encodings are used for text output (see below). Each line - of a unicodeMap file represents a range of one or more Unicode - characters which maps linearly to a range in the output encod- + of a unicodeMap file represents a range of one or more Unicode + characters which maps linearly to a range in the output encod- ing: in-start-hex in-end-hex out-start-hex @@ -318,54 +325,62 @@ TEXT CONTROL AND CHARACTER MAPPING in-hex out-hex - The in-start-hex and in-end-hex fields (or the single in-hex - field) specify the Unicode range. The out-start-hex field (or - the out-hex field) specifies the start of the output encoding - range. The length of the out-start-hex (or out-hex) string + The in-start-hex and in-end-hex fields (or the single in-hex + field) specify the Unicode range. The out-start-hex field (or + the out-hex field) specifies the start of the output encoding + range. The length of the out-start-hex (or out-hex) string determines the length of the output characters (e.g., UTF-8 uses - different numbers of bytes to represent characters in different - ranges). Entries must be given in increasing Unicode order. - Only one file is allowed per encoding; the last specified file - is used. The Latin1, ASCII7, Symbol, ZapfDingbats, UTF-8, and + different numbers of bytes to represent characters in different + ranges). Entries must be given in increasing Unicode order. + Only one file is allowed per encoding; the last specified file + is used. The Latin1, ASCII7, Symbol, ZapfDingbats, UTF-8, and UCS-2 encodings are predefined. cMapDir registry-ordering dir - Specifies a search directory, dir, for CMaps for the reg- - istry-ordering character collection. There can be multiple - directories for a particular collection. There are no default + Specifies a search directory, dir, for CMaps for the reg- + istry-ordering character collection. There can be multiple + directories for a particular collection. There are no default CMap directories. toUnicodeDir dir - Specifies a search directory, dir, for ToUnicode CMaps. There - can be multiple ToUnicode directories. There are no default + Specifies a search directory, dir, for ToUnicode CMaps. There + can be multiple ToUnicode directories. There are no default ToUnicode directories. mapNumericCharNames yes | no - If set to "yes", the Xpdf tools will attempt to map various + If set to "yes", the Xpdf tools will attempt to map various numeric character names sometimes used in font subsets. In some - cases this leads to usable text, and in other cases it leads to + cases this leads to usable text, and in other cases it leads to gibberish -- there is no way for Xpdf to tell. This defaults to "yes". mapUnknownCharNames yes | no - If set to "yes", and mapNumericCharNames is set to "no", the - Xpdf tools will apply a simple pass-through mapping (Unicode - index = character code) for all unrecognized glyph names. (For - CID fonts, setting mapNumericCharNames to "no" is unnecessary.) - In some cases, this leads to usable text, and in other cases it - leads to gibberish -- there is no way for Xpdf to tell. This + If set to "yes", and mapNumericCharNames is set to "no", the + Xpdf tools will apply a simple pass-through mapping (Unicode + index = character code) for all unrecognized glyph names. (For + CID fonts, setting mapNumericCharNames to "no" is unnecessary.) + In some cases, this leads to usable text, and in other cases it + leads to gibberish -- there is no way for Xpdf to tell. This defaults to "no". mapExtTrueTypeFontsViaUnicode yes | no When rasterizing text using an external TrueType font, there are - two options for handling character codes. If mapExtTrueType- - FontsViaUnicode is set to "yes", Xpdf will use the font encod- - ing/ToUnicode info to map character codes to Unicode, and then - use the font's Unicode cmap to map Unicode to GIDs. If mapExt- - TrueTypeFontsViaUnicode is set to "no", Xpdf will assume the - character codes are GIDs (i.e., use an identity mapping). This + two options for handling character codes. If mapExtTrueType- + FontsViaUnicode is set to "yes", Xpdf will use the font encod- + ing/ToUnicode info to map character codes to Unicode, and then + use the font's Unicode cmap to map Unicode to GIDs. If mapExt- + TrueTypeFontsViaUnicode is set to "no", Xpdf will assume the + character codes are GIDs (i.e., use an identity mapping). This defaults to "yes". + dropFont font-name + Drop all text drawn in the specified font. To drop text drawn + in unnamed fonts, use: + + dropFont "" + + There can be any number of dropFont commands. + RASTERIZER SETTINGS enableFreeType yes | no Enables or disables use of FreeType (a TrueType / Type 1 font @@ -404,6 +419,11 @@ RASTERIZER SETTINGS (at the expense of allowing gaps and overlaps between adjacent lines). This defaults to "yes". + forceAccurateTiling yes | no + If this is set to "yes", the TilingType is forced to 2 (no dis- + tortion) for all tiling patterns, regardless of the setting in + the pattern dictionary. This defaults to "no". + screenType dispersed | clustered | stochasticClustered Sets the halftone screen type, which will be used when generat- ing a monochrome (1-bit) bitmap. The three options are dis- @@ -476,7 +496,7 @@ VIEWER SETTINGS initialSidebarState yes | no If set to "yes", xpdf opens with the sidebar (tabs, outline, etc.) visible. If set to "no", xpdf opens with the sidebar - collapsed. The default is "no". + collapsed. The default is "yes". paperColor color Set the "paper color", i.e., the background of the page display. @@ -529,6 +549,9 @@ VIEWER SETTINGS The string "%s" will be replaced with the movie file name. This has no default value. + defaultPrinter printer + Sets the default printer used in the viewer's print dialog. + bind modifiers-key context command ... Add a key or mouse button binding. Modifiers can be zero or more of: @@ -595,26 +618,30 @@ VIEWER SETTINGS "any" context, and you want to create new key bindings for mul- tiple contexts). + tabStateFile path + Sets the file used by the loadTabState and saveTabState commands + (see the xpdf(1) man page for more information). + MISCELLANEOUS SETTINGS drawAnnotations yes | no - If set to "no", annotations will not be drawn or printed. The + If set to "no", annotations will not be drawn or printed. The default value is "yes". drawFormFields yes | no - If set to "no", form fields will not be drawn or printed. The + If set to "no", form fields will not be drawn or printed. The default value is "yes". enableXFA yes | no - If set to "yes", an XFA form (if present) will be rendered in - place of an AcroForm. If "no", an XFA form will never be ren- + If set to "yes", an XFA form (if present) will be rendered in + place of an AcroForm. If "no", an XFA form will never be ren- dered. This defaults to "yes". printCommands yes | no - If set to "yes", drawing commands are printed as they're exe- + If set to "yes", drawing commands are printed as they're exe- cuted (useful for debugging). This defaults to "no". errQuiet yes | no - If set to "yes", this suppresses all error and warning messages + If set to "yes", this suppresses all error and warning messages from all of the Xpdf tools. This defaults to "no". EXAMPLES @@ -654,7 +681,6 @@ EXAMPLES psLevel level2 psEmbedType1Fonts yes psEmbedTrueTypeFonts yes - psFile "| lpr -Pprinter5" # assume that the PostScript printer has the Univers and # Univers-Bold fonts @@ -668,12 +694,11 @@ EXAMPLES # misc options enableFreeType yes launchCommand viewer-script - urlCommand "netscape -remote 'openURL(%s)'" FILES /usr/local/etc/xpdfrc - This is the default location for the system-wide configuration + This is the default location for the system-wide configuration file. Depending on build options, it may be placed elsewhere. $HOME/.xpdfrc @@ -681,14 +706,14 @@ FILES read in place of the system-wide file. AUTHOR - The Xpdf software and documentation are copyright 1996-2017 Glyph & + The Xpdf software and documentation are copyright 1996-2019 Glyph & Cog, LLC. SEE ALSO - xpdf(1), pdftops(1), pdftotext(1), pdftohtml(1), pdfinfo(1), pdf- + xpdf(1), pdftops(1), pdftotext(1), pdftohtml(1), pdfinfo(1), pdf- fonts(1), pdfdetach(1), pdftoppm(1), pdftopng(1), pdfimages(1) http://www.xpdfreader.com/ - 10 Aug 2017 xpdfrc(5) + 18 Feb 2019 xpdfrc(5) |