summaryrefslogtreecommitdiff
path: root/Build/source/libs/xpdf/xpdf-3.02/doc
diff options
context:
space:
mode:
Diffstat (limited to 'Build/source/libs/xpdf/xpdf-3.02/doc')
-rw-r--r--Build/source/libs/xpdf/xpdf-3.02/doc/pdffonts.1142
-rw-r--r--Build/source/libs/xpdf/xpdf-3.02/doc/pdffonts.cat112
-rw-r--r--Build/source/libs/xpdf/xpdf-3.02/doc/pdffonts.hlp122
-rw-r--r--Build/source/libs/xpdf/xpdf-3.02/doc/pdfimages.1102
-rw-r--r--Build/source/libs/xpdf/xpdf-3.02/doc/pdfimages.cat92
-rw-r--r--Build/source/libs/xpdf/xpdf-3.02/doc/pdfimages.hlp101
-rw-r--r--Build/source/libs/xpdf/xpdf-3.02/doc/pdfinfo.1158
-rw-r--r--Build/source/libs/xpdf/xpdf-3.02/doc/pdfinfo.cat119
-rw-r--r--Build/source/libs/xpdf/xpdf-3.02/doc/pdfinfo.hlp129
-rw-r--r--Build/source/libs/xpdf/xpdf-3.02/doc/pdftoppm.1119
-rw-r--r--Build/source/libs/xpdf/xpdf-3.02/doc/pdftoppm.cat108
-rw-r--r--Build/source/libs/xpdf/xpdf-3.02/doc/pdftoppm.hlp118
-rw-r--r--Build/source/libs/xpdf/xpdf-3.02/doc/pdftops.1235
-rw-r--r--Build/source/libs/xpdf/xpdf-3.02/doc/pdftops.cat229
-rw-r--r--Build/source/libs/xpdf/xpdf-3.02/doc/pdftops.hlp239
-rw-r--r--Build/source/libs/xpdf/xpdf-3.02/doc/pdftotext.1137
-rw-r--r--Build/source/libs/xpdf/xpdf-3.02/doc/pdftotext.cat120
-rw-r--r--Build/source/libs/xpdf/xpdf-3.02/doc/pdftotext.hlp133
-rw-r--r--Build/source/libs/xpdf/xpdf-3.02/doc/sample-xpdfrc91
-rw-r--r--Build/source/libs/xpdf/xpdf-3.02/doc/xpdf.1863
-rw-r--r--Build/source/libs/xpdf/xpdf-3.02/doc/xpdf.cat809
-rw-r--r--Build/source/libs/xpdf/xpdf-3.02/doc/xpdf.hlp823
-rw-r--r--Build/source/libs/xpdf/xpdf-3.02/doc/xpdfrc.5617
-rw-r--r--Build/source/libs/xpdf/xpdf-3.02/doc/xpdfrc.cat614
-rw-r--r--Build/source/libs/xpdf/xpdf-3.02/doc/xpdfrc.hlp619
25 files changed, 6951 insertions, 0 deletions
diff --git a/Build/source/libs/xpdf/xpdf-3.02/doc/pdffonts.1 b/Build/source/libs/xpdf/xpdf-3.02/doc/pdffonts.1
new file mode 100644
index 00000000000..4cb3059c95d
--- /dev/null
+++ b/Build/source/libs/xpdf/xpdf-3.02/doc/pdffonts.1
@@ -0,0 +1,142 @@
+.\" Copyright 1999-2007 Glyph & Cog, LLC
+.TH pdffonts 1 "27 February 2007"
+.SH NAME
+pdffonts \- Portable Document Format (PDF) font analyzer (version
+3.02)
+.SH SYNOPSIS
+.B pdffonts
+[options]
+.RI [ PDF-file ]
+.SH DESCRIPTION
+.B Pdffonts
+lists the fonts used in a Portable Document Format (PDF) file along
+with various information for each font.
+.PP
+The following information is listed for each font:
+.TP
+.B name
+the font name, exactly as given in the PDF file (potentially including
+a subset prefix)
+.TP
+.B type
+the font type -- see below for details
+.TP
+.B emb
+"yes" if the font is embedded in the PDF file
+.TP
+.B sub
+"yes" if the font is a subset
+.TP
+.B uni
+"yes" if there is an explicit "ToUnicode" map in the PDF file (the
+absence of a ToUnicode map doesn't necessarily mean that the text
+can't be converted to Unicode)
+.TP
+.B object ID
+the font dictionary object ID (number and generation)
+.PP
+PDF files can contain the following types of fonts:
+.PP
+.RS
+Type 1
+.RE
+.RS
+Type 1C -- aka Compact Font Format (CFF)
+.RE
+.RS
+Type 1C (OT) -- OpenType with 8-bit CFF data
+.RE
+.RS
+Type 3
+.RE
+.RS
+TrueType
+.RE
+.RS
+TrueType (OT) -- OpenType with 8-bit TrueType data
+.RE
+.RS
+CID Type 0 -- 16-bit font with no specified type
+.RE
+.RS
+CID Type 0C -- 16-bit PostScript CFF font
+.RE
+.RS
+CID Type 0C (OT) -- OpenType with CID CFF data
+.RE
+.RS
+CID TrueType -- 16-bit TrueType font
+.RE
+.RS
+CID TrueType (OT) -- OpenType with CID TrueType data
+.RE
+.SH CONFIGURATION FILE
+Pdffonts 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 pdffonts
+is built). See the
+.BR xpdfrc (5)
+man page for details.
+.SH OPTIONS
+Many of the following options can be set with configuration file
+commands. These are listed in square brackets with the description of
+the corresponding command line option.
+.TP
+.BI \-f " number"
+Specifies the first page to analyze.
+.TP
+.BI \-l " number"
+Specifies the last page to analyze.
+.TP
+.BI \-opw " password"
+Specify the owner password for the PDF file. Providing this will
+bypass all security restrictions.
+.TP
+.BI \-upw " password"
+Specify the user password for the PDF file.
+.TP
+.BI \-cfg " config-file"
+Read
+.I config-file
+in place of ~/.xpdfrc or the system-wide config file.
+.TP
+.B \-v
+Print copyright and version information.
+.TP
+.B \-h
+Print usage information.
+.RB ( \-help
+and
+.B \-\-help
+are equivalent.)
+.SH EXIT CODES
+The Xpdf tools use the following exit codes:
+.TP
+0
+No error.
+.TP
+1
+Error opening a PDF file.
+.TP
+2
+Error opening an output file.
+.TP
+3
+Error related to PDF permissions.
+.TP
+99
+Other error.
+.SH AUTHOR
+The pdffonts software and documentation are copyright 1996-2007 Glyph
+& Cog, LLC.
+.SH "SEE ALSO"
+.BR xpdf (1),
+.BR pdftops (1),
+.BR pdftotext (1),
+.BR pdfinfo (1),
+.BR pdftoppm (1),
+.BR pdfimages (1),
+.BR xpdfrc (5)
+.br
+.B http://www.foolabs.com/xpdf/
diff --git a/Build/source/libs/xpdf/xpdf-3.02/doc/pdffonts.cat b/Build/source/libs/xpdf/xpdf-3.02/doc/pdffonts.cat
new file mode 100644
index 00000000000..fa50dcfeb89
--- /dev/null
+++ b/Build/source/libs/xpdf/xpdf-3.02/doc/pdffonts.cat
@@ -0,0 +1,112 @@
+pdffonts(1) pdffonts(1)
+
+
+
+NAME
+ pdffonts - Portable Document Format (PDF) font analyzer
+ (version 3.02)
+
+SYNOPSIS
+ pdffonts [options] [PDF-file]
+
+DESCRIPTION
+ Pdffonts lists the fonts used in a Portable Document For-
+ mat (PDF) file along with various information for each
+ font.
+
+ The following information is listed for each font:
+
+ name the font name, exactly as given in the PDF file
+ (potentially including a subset prefix)
+
+ type the font type -- see below for details
+
+ emb "yes" if the font is embedded in the PDF file
+
+ sub "yes" if the font is a subset
+
+ uni "yes" if there is an explicit "ToUnicode" map in
+ the PDF file (the absence of a ToUnicode map
+ doesn't necessarily mean that the text can't be
+ converted to Unicode)
+
+ object ID
+ the font dictionary object ID (number and genera-
+ tion)
+
+ PDF files can contain the following types of fonts:
+
+ Type 1
+ Type 1C -- aka Compact Font Format (CFF)
+ Type 1C (OT) -- OpenType with 8-bit CFF data
+ Type 3
+ TrueType
+ TrueType (OT) -- OpenType with 8-bit TrueType data
+ CID Type 0 -- 16-bit font with no specified type
+ CID Type 0C -- 16-bit PostScript CFF font
+ CID Type 0C (OT) -- OpenType with CID CFF data
+ CID TrueType -- 16-bit TrueType font
+ CID TrueType (OT) -- OpenType with CID TrueType
+ data
+
+CONFIGURATION FILE
+ Pdffonts 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 pdffonts is built). See the xpdfrc(5)
+ man page for details.
+
+OPTIONS
+ Many of the following options can be set with configura-
+ tion file commands. These are listed in square brackets
+ with the description of the corresponding command line
+ option.
+
+ -f number
+ Specifies the first page to analyze.
+
+ -l number
+ Specifies the last page to analyze.
+
+ -opw password
+ Specify the owner password for the PDF file. Pro-
+ viding this will bypass all security restrictions.
+
+ -upw password
+ Specify the user password for the PDF file.
+
+ -cfg config-file
+ Read config-file in place of ~/.xpdfrc or the sys-
+ tem-wide config file.
+
+ -v Print copyright and version information.
+
+ -h Print usage information. (-help and --help are
+ equivalent.)
+
+EXIT CODES
+ The Xpdf tools use the following exit codes:
+
+ 0 No error.
+
+ 1 Error opening a PDF file.
+
+ 2 Error opening an output file.
+
+ 3 Error related to PDF permissions.
+
+ 99 Other error.
+
+AUTHOR
+ The pdffonts software and documentation are copyright
+ 1996-2007 Glyph & Cog, LLC.
+
+SEE ALSO
+ xpdf(1), pdftops(1), pdftotext(1), pdfinfo(1),
+ pdftoppm(1), pdfimages(1), xpdfrc(5)
+ http://www.foolabs.com/xpdf/
+
+
+
+ 27 February 2007 pdffonts(1)
diff --git a/Build/source/libs/xpdf/xpdf-3.02/doc/pdffonts.hlp b/Build/source/libs/xpdf/xpdf-3.02/doc/pdffonts.hlp
new file mode 100644
index 00000000000..f964dc1abfe
--- /dev/null
+++ b/Build/source/libs/xpdf/xpdf-3.02/doc/pdffonts.hlp
@@ -0,0 +1,122 @@
+! Generated automatically by mantohlp
+1 pdffonts
+
+ pdffonts - Portable Document Format (PDF) font analyzer
+ (version
+
+ pdffonts [options] [PDF-file]
+
+ Pdffonts lists the fonts used in a Portable Document For-
+ mat (PDF) file along with various information for each
+ font.
+
+ The following information is listed for each font:
+
+ name the font name, exactly as given in the PDF file
+ (potentially including a subset prefix)
+
+ type the font type -- see below for details
+
+ emb "yes" if the font is embedded in the PDF file
+
+ sub "yes" if the font is a subset
+
+ uni "yes" if there is an explicit "ToUnicode" map in
+ the PDF file (the absence of a ToUnicode map
+ doesn't necessarily mean that the text can't be
+ converted to Unicode)
+
+ object ID
+ the font dictionary object ID (number and genera-
+ tion)
+
+ PDF files can contain the following types of fonts:
+
+ Type 1
+ Type 1C -- aka Compact Font Format (CFF)
+ Type 1C (OT) -- OpenType with 8-bit CFF data
+ Type 3
+ TrueType
+ TrueType (OT) -- OpenType with 8-bit TrueType data
+ CID Type 0 -- 16-bit font with no specified type
+ CID Type 0C -- 16-bit PostScript CFF font
+ CID Type 0C (OT) -- OpenType with CID CFF data
+ CID TrueType -- 16-bit TrueType font
+ CID TrueType (OT) -- OpenType with CID TrueType
+ data
+
+ ()
+
+2 ONFIGURATION_FIL
+
+ Pdffonts 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 pdffonts is built). See the xpdfrc(5)
+ man page for details.
+
+ ()
+
+2 OPTIONS
+
+ Many of the following options can be set with configura-
+ tion file commands. These are listed in square brackets
+ with the description of the corresponding command line
+ option.
+
+ -f number
+ Specifies the first page to analyze.
+
+ -l number
+ Specifies the last page to analyze.
+
+ -opw password
+ Specify the owner password for the PDF file. Pro-
+ viding this will bypass all security restrictions.
+
+ -upw password
+ Specify the user password for the PDF file.
+
+ -cfg config-file
+ Read config-file in place of ~/.xpdfrc or the sys-
+ tem-wide config file.
+
+ -v Print copyright and version information.
+
+ -h Print usage information. (-help and --help are
+ equivalent.)
+
+ ()
+
+2 XIT_CODE
+
+ The Xpdf tools use the following exit codes:
+
+ 0 No error.
+
+ 1 Error opening a PDF file.
+
+ 2 Error opening an output file.
+
+ 3 Error related to PDF permissions.
+
+ 99 Other error.
+
+ ()
+
+2 AUTHOR
+
+ The pdffonts software and documentation are copyright
+ 1996-2007 Glyph & Cog, LLC.
+
+ ()
+
+2 SEE_ALSO
+
+ xpdf(1), pdftops(1), pdftotext(1), pdfinfo(1),
+ pdftoppm(1), pdfimages(1), xpdfrc(5)
+ http://www.foolabs.com/xpdf/
+
+ ()
+
diff --git a/Build/source/libs/xpdf/xpdf-3.02/doc/pdfimages.1 b/Build/source/libs/xpdf/xpdf-3.02/doc/pdfimages.1
new file mode 100644
index 00000000000..844014799a7
--- /dev/null
+++ b/Build/source/libs/xpdf/xpdf-3.02/doc/pdfimages.1
@@ -0,0 +1,102 @@
+.\" Copyright 1998-2007 Glyph & Cog, LLC
+.TH pdfimages 1 "27 February 2007"
+.SH NAME
+pdfimages \- Portable Document Format (PDF) image extractor
+(version 3.02)
+.SH SYNOPSIS
+.B pdfimages
+[options]
+.I PDF-file image-root
+.SH DESCRIPTION
+.B Pdfimages
+saves images from a Portable Document Format (PDF) file as Portable
+Pixmap (PPM), Portable Bitmap (PBM), or JPEG files.
+.PP
+Pdfimages reads the PDF file, scans one or more pages,
+.IR PDF-file ,
+and writes one PPM, PBM, or JPEG file for each image,
+.IR image-root - nnn . xxx ,
+where
+.I nnn
+is the image number and
+.I xxx
+is the image type (.ppm, .pbm, .jpg).
+.PP
+NB: pdfimages extracts the raw image data from the PDF file, without
+performing any additional transforms. Any rotation, clipping,
+color inversion, etc. done by the PDF content stream is ignored.
+.SH CONFIGURATION FILE
+Pdfimages 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 pdfimages
+is built). See the
+.BR xpdfrc (5)
+man page for details.
+.SH OPTIONS
+Many of the following options can be set with configuration file
+commands. These are listed in square brackets with the description of
+the corresponding command line option.
+.TP
+.BI \-f " number"
+Specifies the first page to scan.
+.TP
+.BI \-l " number"
+Specifies the last page to scan.
+.TP
+.B \-j
+Normally, all images are written as PBM (for monochrome images) or PPM
+(for non-monochrome images) files. With this option, images in DCT
+format are saved as JPEG files. All non-DCT images are saved in
+PBM/PPM format as usual.
+.TP
+.BI \-opw " password"
+Specify the owner password for the PDF file. Providing this will
+bypass all security restrictions.
+.TP
+.BI \-upw " password"
+Specify the user password for the PDF file.
+.TP
+.B \-q
+Don't print any messages or errors.
+.RB "[config file: " errQuiet ]
+.TP
+.B \-v
+Print copyright and version information.
+.TP
+.B \-h
+Print usage information.
+.RB ( \-help
+and
+.B \-\-help
+are equivalent.)
+.SH EXIT CODES
+The Xpdf tools use the following exit codes:
+.TP
+0
+No error.
+.TP
+1
+Error opening a PDF file.
+.TP
+2
+Error opening an output file.
+.TP
+3
+Error related to PDF permissions.
+.TP
+99
+Other error.
+.SH AUTHOR
+The pdfimages software and documentation are copyright 1998-2007 Glyph
+& Cog, LLC.
+.SH "SEE ALSO"
+.BR xpdf (1),
+.BR pdftops (1),
+.BR pdftotext (1),
+.BR pdfinfo (1),
+.BR pdffonts (1),
+.BR pdftoppm (1),
+.BR xpdfrc (5)
+.br
+.B http://www.foolabs.com/xpdf/
diff --git a/Build/source/libs/xpdf/xpdf-3.02/doc/pdfimages.cat b/Build/source/libs/xpdf/xpdf-3.02/doc/pdfimages.cat
new file mode 100644
index 00000000000..b5ae119a2d2
--- /dev/null
+++ b/Build/source/libs/xpdf/xpdf-3.02/doc/pdfimages.cat
@@ -0,0 +1,92 @@
+pdfimages(1) pdfimages(1)
+
+
+
+NAME
+ pdfimages - Portable Document Format (PDF) image extractor
+ (version 3.02)
+
+SYNOPSIS
+ pdfimages [options] PDF-file image-root
+
+DESCRIPTION
+ Pdfimages saves images from a Portable Document Format
+ (PDF) file as Portable Pixmap (PPM), Portable Bitmap
+ (PBM), or JPEG files.
+
+ Pdfimages reads the PDF file, scans one or more pages,
+ PDF-file, and writes one PPM, PBM, or JPEG file for each
+ image, image-root-nnn.xxx, where nnn is the image number
+ and xxx is the image type (.ppm, .pbm, .jpg).
+
+ NB: pdfimages extracts the raw image data from the PDF
+ file, without performing any additional transforms. Any
+ rotation, clipping, color inversion, etc. done by the PDF
+ content stream is ignored.
+
+CONFIGURATION FILE
+ Pdfimages 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 pdfimages is built). See the
+ xpdfrc(5) man page for details.
+
+OPTIONS
+ Many of the following options can be set with configura-
+ tion file commands. These are listed in square brackets
+ with the description of the corresponding command line
+ option.
+
+ -f number
+ Specifies the first page to scan.
+
+ -l number
+ Specifies the last page to scan.
+
+ -j Normally, all images are written as PBM (for
+ monochrome images) or PPM (for non-monochrome
+ images) files. With this option, images in DCT
+ format are saved as JPEG files. All non-DCT images
+ are saved in PBM/PPM format as usual.
+
+ -opw password
+ Specify the owner password for the PDF file. Pro-
+ viding this will bypass all security restrictions.
+
+ -upw password
+ Specify the user password for the PDF file.
+
+ -q Don't print any messages or errors. [config file:
+ errQuiet]
+
+ -v Print copyright and version information.
+
+ -h Print usage information. (-help and --help are
+ equivalent.)
+
+EXIT CODES
+ The Xpdf tools use the following exit codes:
+
+ 0 No error.
+
+ 1 Error opening a PDF file.
+
+ 2 Error opening an output file.
+
+ 3 Error related to PDF permissions.
+
+ 99 Other error.
+
+AUTHOR
+ The pdfimages software and documentation are copyright
+ 1998-2007 Glyph & Cog, LLC.
+
+SEE ALSO
+ xpdf(1), pdftops(1), pdftotext(1), pdfinfo(1), pdf-
+ fonts(1), pdftoppm(1), xpdfrc(5)
+ http://www.foolabs.com/xpdf/
+
+
+
+ 27 February 2007 pdfimages(1)
diff --git a/Build/source/libs/xpdf/xpdf-3.02/doc/pdfimages.hlp b/Build/source/libs/xpdf/xpdf-3.02/doc/pdfimages.hlp
new file mode 100644
index 00000000000..9706099a616
--- /dev/null
+++ b/Build/source/libs/xpdf/xpdf-3.02/doc/pdfimages.hlp
@@ -0,0 +1,101 @@
+! Generated automatically by mantohlp
+1 pdfimages
+
+ pdfimages - Portable Document Format (PDF) image extractor
+
+ pdfimages [options] PDF-file image-root
+
+ Pdfimages saves images from a Portable Document Format
+ (PDF) file as Portable Pixmap (PPM), Portable Bitmap
+ (PBM), or JPEG files.
+
+ Pdfimages reads the PDF file, scans one or more pages,
+ PDF-file, and writes one PPM, PBM, or JPEG file for each
+ image, image-root-nnn.xxx, where nnn is the image number
+ and xxx is the image type (.ppm, .pbm, .jpg).
+
+ NB: pdfimages extracts the raw image data from the PDF
+ file, without performing any additional transforms. Any
+ rotation, clipping, color inversion, etc. done by the PDF
+ content stream is ignored.
+
+ ()
+
+2 ONFIGURATION_FIL
+
+ Pdfimages 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 pdfimages is built). See the
+ xpdfrc(5) man page for details.
+
+ ()
+
+2 OPTIONS
+
+ Many of the following options can be set with configura-
+ tion file commands. These are listed in square brackets
+ with the description of the corresponding command line
+ option.
+
+ -f number
+ Specifies the first page to scan.
+
+ -l number
+ Specifies the last page to scan.
+
+ -j Normally, all images are written as PBM (for
+ monochrome images) or PPM (for non-monochrome
+ images) files. With this option, images in DCT
+ format are saved as JPEG files. All non-DCT images
+ are saved in PBM/PPM format as usual.
+
+ -opw password
+ Specify the owner password for the PDF file. Pro-
+ viding this will bypass all security restrictions.
+
+ -upw password
+ Specify the user password for the PDF file.
+
+ -q Don't print any messages or errors. [config file:
+ errQuiet]
+
+ -v Print copyright and version information.
+
+ -h Print usage information. (-help and --help are
+ equivalent.)
+
+ ()
+
+2 XIT_CODE
+
+ The Xpdf tools use the following exit codes:
+
+ 0 No error.
+
+ 1 Error opening a PDF file.
+
+ 2 Error opening an output file.
+
+ 3 Error related to PDF permissions.
+
+ 99 Other error.
+
+ ()
+
+2 AUTHOR
+
+ The pdfimages software and documentation are copyright
+ 1998-2007 Glyph & Cog, LLC.
+
+ ()
+
+2 SEE_ALSO
+
+ xpdf(1), pdftops(1), pdftotext(1), pdfinfo(1), pdf-
+ fonts(1), pdftoppm(1), xpdfrc(5)
+ http://www.foolabs.com/xpdf/
+
+ ()
+
diff --git a/Build/source/libs/xpdf/xpdf-3.02/doc/pdfinfo.1 b/Build/source/libs/xpdf/xpdf-3.02/doc/pdfinfo.1
new file mode 100644
index 00000000000..ca2a81374b9
--- /dev/null
+++ b/Build/source/libs/xpdf/xpdf-3.02/doc/pdfinfo.1
@@ -0,0 +1,158 @@
+.\" Copyright 1999-2007 Glyph & Cog, LLC
+.TH pdfinfo 1 "27 February 2007"
+.SH NAME
+pdfinfo \- Portable Document Format (PDF) document information
+extractor (version 3.02)
+.SH SYNOPSIS
+.B pdfinfo
+[options]
+.RI [ PDF-file ]
+.SH DESCRIPTION
+.B Pdfinfo
+prints the contents of the \'Info' dictionary (plus some other useful
+information) from a Portable Document Format (PDF) file.
+.PP
+The \'Info' dictionary contains the following values:
+.PP
+.RS
+title
+.RE
+.RS
+subject
+.RE
+.RS
+keywords
+.RE
+.RS
+author
+.RE
+.RS
+creator
+.RE
+.RS
+producer
+.RE
+.RS
+creation date
+.RE
+.RS
+modification date
+.RE
+.PP
+In addition, the following information is printed:
+.PP
+.RS
+tagged (yes/no)
+.RE
+.RS
+page count
+.RE
+.RS
+encrypted flag (yes/no)
+.RE
+.RS
+print and copy permissions (if encrypted)
+.RE
+.RS
+page size
+.RE
+.RS
+file size
+.RE
+.RS
+linearized (yes/no)
+.RE
+.RS
+PDF version
+.RE
+.RS
+metadata (only if requested)
+.RE
+.SH CONFIGURATION FILE
+Pdfinfo 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 pdfinfo is built). See the
+.BR xpdfrc (5)
+man page for details.
+.SH OPTIONS
+Many of the following options can be set with configuration file
+commands. These are listed in square brackets with the description of
+the corresponding command line option.
+.TP
+.BI \-f " number"
+Specifies the first page to examine. If multiple pages are requested
+using the "-f" and "-l" options, the size of each requested page (and,
+optionally, the bounding boxes for each requested page) are printed.
+Otherwise, only page one is examined.
+.TP
+.BI \-l " number"
+Specifies the last page to examine.
+.TP
+.B \-box
+Prints the page box bounding boxes: MediaBox, CropBox, BleedBox,
+TrimBox, and ArtBox.
+.TP
+.B \-meta
+Prints document-level metadata. (This is the "Metadata" stream from
+the PDF file's Catalog object.)
+.TP
+.BI \-enc " encoding-name"
+Sets the encoding to use for text output. The
+.I encoding\-name
+must be defined with the unicodeMap command (see
+.BR xpdfrc (5)).
+This defaults to "Latin1" (which is a built-in encoding).
+.RB "[config file: " textEncoding ]
+.TP
+.BI \-opw " password"
+Specify the owner password for the PDF file. Providing this will
+bypass all security restrictions.
+.TP
+.BI \-upw " password"
+Specify the user password for the PDF file.
+.TP
+.BI \-cfg " config-file"
+Read
+.I config-file
+in place of ~/.xpdfrc or the system-wide config file.
+.TP
+.B \-v
+Print copyright and version information.
+.TP
+.B \-h
+Print usage information.
+.RB ( \-help
+and
+.B \-\-help
+are equivalent.)
+.SH EXIT CODES
+The Xpdf tools use the following exit codes:
+.TP
+0
+No error.
+.TP
+1
+Error opening a PDF file.
+.TP
+2
+Error opening an output file.
+.TP
+3
+Error related to PDF permissions.
+.TP
+99
+Other error.
+.SH AUTHOR
+The pdfinfo software and documentation are copyright 1996-2007 Glyph &
+Cog, LLC.
+.SH "SEE ALSO"
+.BR xpdf (1),
+.BR pdftops (1),
+.BR pdftotext (1),
+.BR pdffonts (1),
+.BR pdftoppm (1),
+.BR pdfimages (1),
+.BR xpdfrc (5)
+.br
+.B http://www.foolabs.com/xpdf/
diff --git a/Build/source/libs/xpdf/xpdf-3.02/doc/pdfinfo.cat b/Build/source/libs/xpdf/xpdf-3.02/doc/pdfinfo.cat
new file mode 100644
index 00000000000..4b429abbc23
--- /dev/null
+++ b/Build/source/libs/xpdf/xpdf-3.02/doc/pdfinfo.cat
@@ -0,0 +1,119 @@
+pdfinfo(1) pdfinfo(1)
+
+
+
+NAME
+ pdfinfo - Portable Document Format (PDF) document informa-
+ tion extractor (version 3.02)
+
+SYNOPSIS
+ pdfinfo [options] [PDF-file]
+
+DESCRIPTION
+ Pdfinfo prints the contents of the 'Info' dictionary (plus
+ some other useful information) from a Portable Document
+ Format (PDF) file.
+
+ The 'Info' dictionary contains the following values:
+
+ title
+ subject
+ keywords
+ author
+ creator
+ producer
+ creation date
+ modification date
+
+ In addition, the following information is printed:
+
+ tagged (yes/no)
+ page count
+ encrypted flag (yes/no)
+ print and copy permissions (if encrypted)
+ page size
+ file size
+ linearized (yes/no)
+ PDF version
+ metadata (only if requested)
+
+CONFIGURATION FILE
+ Pdfinfo 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 pdfinfo is built). See the xpdfrc(5)
+ man page for details.
+
+OPTIONS
+ Many of the following options can be set with configura-
+ tion file commands. These are listed in square brackets
+ with the description of the corresponding command line
+ option.
+
+ -f number
+ Specifies the first page to examine. If multiple
+ pages are requested using the "-f" and "-l"
+ options, the size of each requested page (and,
+ optionally, the bounding boxes for each requested
+ page) are printed. Otherwise, only page one is
+ examined.
+
+ -l number
+ Specifies the last page to examine.
+
+ -box Prints the page box bounding boxes: MediaBox, Crop-
+ Box, BleedBox, TrimBox, and ArtBox.
+
+ -meta Prints document-level metadata. (This is the
+ "Metadata" stream from the PDF file's Catalog
+ object.)
+
+ -enc encoding-name
+ Sets the encoding to use for text output. The
+ encoding-name must be defined with the unicodeMap
+ command (see xpdfrc(5)). This defaults to "Latin1"
+ (which is a built-in encoding). [config file: tex-
+ tEncoding]
+
+ -opw password
+ Specify the owner password for the PDF file. Pro-
+ viding this will bypass all security restrictions.
+
+ -upw password
+ Specify the user password for the PDF file.
+
+ -cfg config-file
+ Read config-file in place of ~/.xpdfrc or the sys-
+ tem-wide config file.
+
+ -v Print copyright and version information.
+
+ -h Print usage information. (-help and --help are
+ equivalent.)
+
+EXIT CODES
+ The Xpdf tools use the following exit codes:
+
+ 0 No error.
+
+ 1 Error opening a PDF file.
+
+ 2 Error opening an output file.
+
+ 3 Error related to PDF permissions.
+
+ 99 Other error.
+
+AUTHOR
+ The pdfinfo software and documentation are copyright
+ 1996-2007 Glyph & Cog, LLC.
+
+SEE ALSO
+ xpdf(1), pdftops(1), pdftotext(1), pdffonts(1),
+ pdftoppm(1), pdfimages(1), xpdfrc(5)
+ http://www.foolabs.com/xpdf/
+
+
+
+ 27 February 2007 pdfinfo(1)
diff --git a/Build/source/libs/xpdf/xpdf-3.02/doc/pdfinfo.hlp b/Build/source/libs/xpdf/xpdf-3.02/doc/pdfinfo.hlp
new file mode 100644
index 00000000000..559a123210c
--- /dev/null
+++ b/Build/source/libs/xpdf/xpdf-3.02/doc/pdfinfo.hlp
@@ -0,0 +1,129 @@
+! Generated automatically by mantohlp
+1 pdfinfo
+
+ pdfinfo - Portable Document Format (PDF) document informa-
+ tion
+
+ pdfinfo [options] [PDF-file]
+
+ Pdfinfo prints the contents of the 'Info' dictionary (plus
+ some other useful information) from a Portable Document
+ Format (PDF) file.
+
+ The 'Info' dictionary contains the following values:
+
+ title
+ subject
+ keywords
+ author
+ creator
+ producer
+ creation date
+ modification date
+
+ In addition, the following information is printed:
+
+ tagged (yes/no)
+ page count
+ encrypted flag (yes/no)
+ print and copy permissions (if encrypted)
+ page size
+ file size
+ linearized (yes/no)
+ PDF version
+ metadata (only if requested)
+
+ ()
+
+2 ONFIGURATION_FIL
+
+ Pdfinfo 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 pdfinfo is built). See the xpdfrc(5)
+ man page for details.
+
+ ()
+
+2 OPTIONS
+
+ Many of the following options can be set with configura-
+ tion file commands. These are listed in square brackets
+ with the description of the corresponding command line
+ option.
+
+ -f number
+ Specifies the first page to examine. If multiple
+ pages are requested using the "-f" and "-l"
+ options, the size of each requested page (and,
+ optionally, the bounding boxes for each requested
+ page) are printed. Otherwise, only page one is
+ examined.
+
+ -l number
+ Specifies the last page to examine.
+
+ -box Prints the page box bounding boxes: MediaBox, Crop-
+ Box, BleedBox, TrimBox, and ArtBox.
+
+ -meta Prints document-level metadata. (This is the
+ "Metadata" stream from the PDF file's Catalog
+ object.)
+
+ -enc encoding-name
+ Sets the encoding to use for text output. The
+ encoding-name must be defined with the unicodeMap
+ command (see xpdfrc(5)). This defaults to "Latin1"
+ (which is a built-in encoding). [config file: tex-
+ tEncoding]
+
+ -opw password
+ Specify the owner password for the PDF file. Pro-
+ viding this will bypass all security restrictions.
+
+ -upw password
+ Specify the user password for the PDF file.
+
+ -cfg config-file
+ Read config-file in place of ~/.xpdfrc or the sys-
+ tem-wide config file.
+
+ -v Print copyright and version information.
+
+ -h Print usage information. (-help and --help are
+ equivalent.)
+
+ ()
+
+2 XIT_CODE
+
+ The Xpdf tools use the following exit codes:
+
+ 0 No error.
+
+ 1 Error opening a PDF file.
+
+ 2 Error opening an output file.
+
+ 3 Error related to PDF permissions.
+
+ 99 Other error.
+
+ ()
+
+2 AUTHOR
+
+ The pdfinfo software and documentation are copyright
+ 1996-2007 Glyph & Cog, LLC.
+
+ ()
+
+2 SEE_ALSO
+
+ xpdf(1), pdftops(1), pdftotext(1), pdffonts(1),
+ pdftoppm(1), pdfimages(1), xpdfrc(5)
+ http://www.foolabs.com/xpdf/
+
+ ()
+
diff --git a/Build/source/libs/xpdf/xpdf-3.02/doc/pdftoppm.1 b/Build/source/libs/xpdf/xpdf-3.02/doc/pdftoppm.1
new file mode 100644
index 00000000000..f1594900221
--- /dev/null
+++ b/Build/source/libs/xpdf/xpdf-3.02/doc/pdftoppm.1
@@ -0,0 +1,119 @@
+.\" Copyright 2005-2007 Glyph & Cog, LLC
+.TH pdftoppm 1 "27 February 2007"
+.SH NAME
+pdftoppm \- Portable Document Format (PDF) to Portable Pixmap (PPM)
+converter (version 3.02)
+.SH SYNOPSIS
+.B pdftoppm
+[options]
+.I PDF-file PPM-root
+.SH DESCRIPTION
+.B Pdftoppm
+converts Portable Document Format (PDF) files to color image files in
+Portable Pixmap (PPM) format, grayscale image files in Portable
+Graymap (PGM) format, or monochrome image files in Portable Bitmap
+(PBM) format.
+.PP
+Pdftoppm reads the PDF file,
+.IR PDF-file ,
+and writes one PPM file for each page,
+.IR PPM-root - nnnnnn .ppm,
+where
+.I nnnnnn
+is the page number.
+.SH CONFIGURATION FILE
+Pdftoppm 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 pdftoppm
+is built). See the
+.BR xpdfrc (5)
+man page for details.
+.SH OPTIONS
+Many of the following options can be set with configuration file
+commands. These are listed in square brackets with the description of
+the corresponding command line option.
+.TP
+.BI \-f " number"
+Specifies the first page to convert.
+.TP
+.BI \-l " number"
+Specifies the last page to convert.
+.TP
+.BI \-r " number"
+Specifies the resolution, in DPI. The default is 150 DPI.
+.TP
+.B \-mono
+Generate a monochrome PBM file (instead of a color PPM file).
+.TP
+.B \-gray
+Generate a grayscale PGM file (instead of a color PPM file).
+.TP
+.BI \-t1lib " yes | no"
+Enable or disable t1lib (a Type 1 font rasterizer). This defaults to
+"yes".
+.RB "[config file: " enableT1lib ]
+.TP
+.BI \-freetype " yes | no"
+Enable or disable FreeType (a TrueType / Type 1 font rasterizer).
+This defaults to "yes".
+.RB "[config file: " enableFreeType ]
+.TP
+.BI \-aa " yes | no"
+Enable or disable font anti-aliasing. This defaults to "yes".
+.RB "[config file: " antialias ]
+.TP
+.BI \-aaVector " yes | no"
+Enable or disable vector anti-aliasing. This defaults to "yes".
+.RB "[config file: " vectorAntialias ]
+.TP
+.BI \-opw " password"
+Specify the owner password for the PDF file. Providing this will
+bypass all security restrictions.
+.TP
+.BI \-upw " password"
+Specify the user password for the PDF file.
+.TP
+.B \-q
+Don't print any messages or errors.
+.RB "[config file: " errQuiet ]
+.TP
+.B \-v
+Print copyright and version information.
+.TP
+.B \-h
+Print usage information.
+.RB ( \-help
+and
+.B \-\-help
+are equivalent.)
+.SH EXIT CODES
+The Xpdf tools use the following exit codes:
+.TP
+0
+No error.
+.TP
+1
+Error opening a PDF file.
+.TP
+2
+Error opening an output file.
+.TP
+3
+Error related to PDF permissions.
+.TP
+99
+Other error.
+.SH AUTHOR
+The pdftoppm software and documentation are copyright 1996-2007 Glyph
+& Cog, LLC.
+.SH "SEE ALSO"
+.BR xpdf (1),
+.BR pdftops (1),
+.BR pdftotext (1),
+.BR pdfinfo (1),
+.BR pdffonts (1),
+.BR pdfimages (1),
+.BR xpdfrc (5)
+.br
+.B http://www.foolabs.com/xpdf/
diff --git a/Build/source/libs/xpdf/xpdf-3.02/doc/pdftoppm.cat b/Build/source/libs/xpdf/xpdf-3.02/doc/pdftoppm.cat
new file mode 100644
index 00000000000..af7d3c95dfb
--- /dev/null
+++ b/Build/source/libs/xpdf/xpdf-3.02/doc/pdftoppm.cat
@@ -0,0 +1,108 @@
+pdftoppm(1) pdftoppm(1)
+
+
+
+NAME
+ pdftoppm - Portable Document Format (PDF) to Portable
+ Pixmap (PPM) converter (version 3.02)
+
+SYNOPSIS
+ pdftoppm [options] PDF-file PPM-root
+
+DESCRIPTION
+ Pdftoppm converts Portable Document Format (PDF) files to
+ color image files in Portable Pixmap (PPM) format,
+ grayscale image files in Portable Graymap (PGM) format, or
+ monochrome image files in Portable Bitmap (PBM) format.
+
+ Pdftoppm reads the PDF file, PDF-file, and writes one PPM
+ file for each page, PPM-root-nnnnnn.ppm, where nnnnnn is
+ the page number.
+
+CONFIGURATION FILE
+ Pdftoppm 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 pdftoppm is built). See the xpdfrc(5)
+ man page for details.
+
+OPTIONS
+ Many of the following options can be set with configura-
+ tion file commands. These are listed in square brackets
+ with the description of the corresponding command line
+ option.
+
+ -f number
+ Specifies the first page to convert.
+
+ -l number
+ Specifies the last page to convert.
+
+ -r number
+ Specifies the resolution, in DPI. The default is
+ 150 DPI.
+
+ -mono Generate a monochrome PBM file (instead of a color
+ PPM file).
+
+ -gray Generate a grayscale PGM file (instead of a color
+ PPM file).
+
+ -t1lib yes | no
+ Enable or disable t1lib (a Type 1 font rasterizer).
+ This defaults to "yes". [config file: enableT1lib]
+
+ -freetype yes | no
+ Enable or disable FreeType (a TrueType / Type 1
+ font rasterizer). This defaults to "yes". [config
+ file: enableFreeType]
+
+ -aa yes | no
+ Enable or disable font anti-aliasing. This
+ defaults to "yes". [config file: antialias]
+
+ -aaVector yes | no
+ Enable or disable vector anti-aliasing. This
+ defaults to "yes". [config file: vectorAntialias]
+
+ -opw password
+ Specify the owner password for the PDF file. Pro-
+ viding this will bypass all security restrictions.
+
+ -upw password
+ Specify the user password for the PDF file.
+
+ -q Don't print any messages or errors. [config file:
+ errQuiet]
+
+ -v Print copyright and version information.
+
+ -h Print usage information. (-help and --help are
+ equivalent.)
+
+EXIT CODES
+ The Xpdf tools use the following exit codes:
+
+ 0 No error.
+
+ 1 Error opening a PDF file.
+
+ 2 Error opening an output file.
+
+ 3 Error related to PDF permissions.
+
+ 99 Other error.
+
+AUTHOR
+ The pdftoppm software and documentation are copyright
+ 1996-2007 Glyph & Cog, LLC.
+
+SEE ALSO
+ xpdf(1), pdftops(1), pdftotext(1), pdfinfo(1), pdf-
+ fonts(1), pdfimages(1), xpdfrc(5)
+ http://www.foolabs.com/xpdf/
+
+
+
+ 27 February 2007 pdftoppm(1)
diff --git a/Build/source/libs/xpdf/xpdf-3.02/doc/pdftoppm.hlp b/Build/source/libs/xpdf/xpdf-3.02/doc/pdftoppm.hlp
new file mode 100644
index 00000000000..bc83e7c52f1
--- /dev/null
+++ b/Build/source/libs/xpdf/xpdf-3.02/doc/pdftoppm.hlp
@@ -0,0 +1,118 @@
+! Generated automatically by mantohlp
+1 pdftoppm
+
+ pdftoppm - Portable Document Format (PDF) to Portable
+ Pixmap (PPM)
+
+ pdftoppm [options] PDF-file PPM-root
+
+ Pdftoppm converts Portable Document Format (PDF) files to
+ color image files in Portable Pixmap (PPM) format,
+ grayscale image files in Portable Graymap (PGM) format, or
+ monochrome image files in Portable Bitmap (PBM) format.
+
+ Pdftoppm reads the PDF file, PDF-file, and writes one PPM
+ file for each page, PPM-root-nnnnnn.ppm, where nnnnnn is
+ the page number.
+
+ ()
+
+2 ONFIGURATION_FIL
+
+ Pdftoppm 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 pdftoppm is built). See the xpdfrc(5)
+ man page for details.
+
+ ()
+
+2 OPTIONS
+
+ Many of the following options can be set with configura-
+ tion file commands. These are listed in square brackets
+ with the description of the corresponding command line
+ option.
+
+ -f number
+ Specifies the first page to convert.
+
+ -l number
+ Specifies the last page to convert.
+
+ -r number
+ Specifies the resolution, in DPI. The default is
+ 150 DPI.
+
+ -mono Generate a monochrome PBM file (instead of a color
+ PPM file).
+
+ -gray Generate a grayscale PGM file (instead of a color
+ PPM file).
+
+ -t1lib yes | no
+ Enable or disable t1lib (a Type 1 font rasterizer).
+ This defaults to "yes". [config file: enableT1lib]
+
+ -freetype yes | no
+ Enable or disable FreeType (a TrueType / Type 1
+ font rasterizer). This defaults to "yes". [config
+ file: enableFreeType]
+
+ -aa yes | no
+ Enable or disable font anti-aliasing. This
+ defaults to "yes". [config file: antialias]
+
+ -aaVector yes | no
+ Enable or disable vector anti-aliasing. This
+ defaults to "yes". [config file: vectorAntialias]
+
+ -opw password
+ Specify the owner password for the PDF file. Pro-
+ viding this will bypass all security restrictions.
+
+ -upw password
+ Specify the user password for the PDF file.
+
+ -q Don't print any messages or errors. [config file:
+ errQuiet]
+
+ -v Print copyright and version information.
+
+ -h Print usage information. (-help and --help are
+ equivalent.)
+
+ ()
+
+2 XIT_CODE
+
+ The Xpdf tools use the following exit codes:
+
+ 0 No error.
+
+ 1 Error opening a PDF file.
+
+ 2 Error opening an output file.
+
+ 3 Error related to PDF permissions.
+
+ 99 Other error.
+
+ ()
+
+2 AUTHOR
+
+ The pdftoppm software and documentation are copyright
+ 1996-2007 Glyph & Cog, LLC.
+
+ ()
+
+2 SEE_ALSO
+
+ xpdf(1), pdftops(1), pdftotext(1), pdfinfo(1), pdf-
+ fonts(1), pdfimages(1), xpdfrc(5)
+ http://www.foolabs.com/xpdf/
+
+ ()
+
diff --git a/Build/source/libs/xpdf/xpdf-3.02/doc/pdftops.1 b/Build/source/libs/xpdf/xpdf-3.02/doc/pdftops.1
new file mode 100644
index 00000000000..c9ec258f090
--- /dev/null
+++ b/Build/source/libs/xpdf/xpdf-3.02/doc/pdftops.1
@@ -0,0 +1,235 @@
+.\" Copyright 1996-2007 Glyph & Cog, LLC
+.TH pdftops 1 "27 February 2007"
+.SH NAME
+pdftops \- Portable Document Format (PDF) to PostScript converter
+(version 3.02)
+.SH SYNOPSIS
+.B pdftops
+[options]
+.RI [ PDF-file
+.RI [ PS-file ]]
+.SH DESCRIPTION
+.B Pdftops
+converts Portable Document Format (PDF) files to PostScript so they
+can be printed.
+.PP
+Pdftops reads the PDF file,
+.IR PDF-file ,
+and writes a PostScript file,
+.IR PS-file .
+If
+.I PS-file
+is not specified, pdftops converts
+.I file.pdf
+to
+.I file.ps
+(or
+.I file.eps
+with the -eps option). If
+.I PS-file
+is \'-', the PostScript is sent to stdout.
+.SH CONFIGURATION FILE
+Pdftops 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 pdftops is built). See the
+.BR xpdfrc (5)
+man page for details.
+.SH OPTIONS
+Many of the following options can be set with configuration file
+commands. These are listed in square brackets with the description of
+the corresponding command line option.
+.TP
+.BI \-f " number"
+Specifies the first page to print.
+.TP
+.BI \-l " number"
+Specifies the last page to print.
+.TP
+.B \-level1
+Generate Level 1 PostScript. The resulting PostScript files will be
+significantly larger (if they contain images), but will print on Level
+1 printers. This also converts all images to black and white. No
+more than one of the PostScript level options (-level1, -level1sep,
+-level2, -level2sep, -level3, -level3Sep) may be given.
+.RB "[config file: " psLevel ]
+.TP
+.B \-level1sep
+Generate Level 1 separable PostScript. All colors are converted to
+CMYK. Images are written with separate stream data for the four
+components.
+.RB "[config file: " psLevel ]
+.TP
+.B \-level2
+Generate Level 2 PostScript. Level 2 supports color images and image
+compression. This is the default setting.
+.RB "[config file: " psLevel ]
+.TP
+.B \-level2sep
+Generate Level 2 separable PostScript. All colors are converted to
+CMYK. The PostScript separation convention operators are used to
+handle custom (spot) colors.
+.RB "[config file: " psLevel ]
+.TP
+.B \-level3
+Generate Level 3 PostScript. This enables all Level 2 features plus
+CID font embedding and masked image generation.
+.RB "[config file: " psLevel ]
+.TP
+.B \-level3Sep
+Generate Level 3 separable PostScript. The separation handling is the
+same as for -level2Sep.
+.RB "[config file: " psLevel ]
+.TP
+.B \-eps
+Generate an Encapsulated PostScript (EPS) file. An EPS file contains
+a single image, so if you use this option with a multi-page PDF file,
+you must use -f and -l to specify a single page. No more than one of
+the mode options (-eps, -form) may be given.
+.TP
+.B \-form
+Generate a PostScript form which can be imported by software that
+understands forms. A form contains a single page, so if you use this
+option with a multi-page PDF file, you must use -f and -l to specify a
+single page. The -level1 option cannot be used with -form.
+.TP
+.B \-opi
+Generate OPI comments for all images and forms which have OPI
+information. (This option is only available if pdftops was compiled
+with OPI support.)
+.RB "[config file: " psOPI ]
+.TP
+.B \-noembt1
+By default, any Type 1 fonts which are embedded in the PDF file are
+copied into the PostScript file. This option causes pdftops to
+substitute base fonts instead. Embedded fonts make PostScript files
+larger, but may be necessary for readable output.
+.RB "[config file: " psEmbedType1Fonts ]
+.TP
+.B \-noembtt
+By default, any TrueType fonts which are embedded in the PDF file are
+copied into the PostScript file. This option causes pdftops to
+substitute base fonts instead. Embedded fonts make PostScript files
+larger, but may be necessary for readable output. Also, some
+PostScript interpreters do not have TrueType rasterizers.
+.RB "[config file: " psEmbedTrueTypeFonts ]
+.TP
+.B \-noembcidps
+By default, any CID PostScript fonts which are embedded in the PDF
+file are copied into the PostScript file. This option disables that
+embedding. No attempt is made to substitute for non-embedded CID
+PostScript fonts.
+.RB "[config file: " psEmbedCIDPostScriptFonts ]
+.TP
+.B \-noembcidtt
+By default, any CID TrueType fonts which are embedded in the PDF file
+are copied into the PostScript file. This option disables that
+embedding. No attempt is made to substitute for non-embedded CID
+TrueType fonts.
+.RB "[config file: " psEmbedCIDTrueTypeFonts ]
+.TP
+.B \-preload
+Convert PDF forms to PS procedures, and preload image data. This uses
+more memory in the PostScript interpreter, but generates significantly
+smaller PS files in situations where, e.g., the same image is drawn on
+every page of a long document.
+.TP
+.BI \-paper " size"
+Set the paper size to one of "letter", "legal", "A4", or "A3". This
+can also be set to "match", which will set the paper size to match the
+size specified in the PDF file.
+.RB "[config file: " psPaperSize ]
+.TP
+.BI \-paperw " size"
+Set the paper width, in points.
+.RB "[config file: " psPaperSize ]
+.TP
+.BI \-paperh " size"
+Set the paper height, in points.
+.RB "[config file: " psPaperSize ]
+.TP
+.B \-nocrop
+By default, output is cropped to the CropBox specified in the PDF
+file. This option disables cropping.
+.RB "[config file: " psCrop ]
+.TP
+.B \-expand
+Expand PDF pages smaller than the paper to fill the paper. By
+default, these pages are not scaled.
+.RB "[config file: " psExpandSmaller ]
+.TP
+.B \-noshrink
+Don't scale PDF pages which are larger than the paper. By default,
+pages larger than the paper are shrunk to fit.
+.RB "[config file: " psShrinkLarger ]
+.TP
+.B \-nocenter
+By default, PDF pages smaller than the paper (after any scaling) are
+centered on the paper. This option causes them to be aligned to the
+lower-left corner of the paper instead.
+.RB "[config file: " psCenter ]
+.TP
+.B \-pagecrop
+Treat the CropBox as the PDF page size. By default, the MediaBox is
+used as the page size.
+.TP
+.B \-duplex
+Set the Duplex pagedevice entry in the PostScript file. This tells
+duplex-capable printers to enable duplexing.
+.RB "[config file: " psDuplex ]
+.TP
+.BI \-opw " password"
+Specify the owner password for the PDF file. Providing this will
+bypass all security restrictions.
+.TP
+.BI \-upw " password"
+Specify the user password for the PDF file.
+.TP
+.B \-q
+Don't print any messages or errors.
+.RB "[config file: " errQuiet ]
+.TP
+.BI \-cfg " config-file"
+Read
+.I config-file
+in place of ~/.xpdfrc or the system-wide config file.
+.TP
+.B \-v
+Print copyright and version information.
+.TP
+.B \-h
+Print usage information.
+.RB ( \-help
+and
+.B \-\-help
+are equivalent.)
+.SH EXIT CODES
+The Xpdf tools use the following exit codes:
+.TP
+0
+No error.
+.TP
+1
+Error opening a PDF file.
+.TP
+2
+Error opening an output file.
+.TP
+3
+Error related to PDF permissions.
+.TP
+99
+Other error.
+.SH AUTHOR
+The pdftops software and documentation are copyright 1996-2007 Glyph &
+Cog, LLC.
+.SH "SEE ALSO"
+.BR xpdf (1),
+.BR pdftotext (1),
+.BR pdfinfo (1),
+.BR pdffonts (1),
+.BR pdftoppm (1),
+.BR pdfimages (1),
+.BR xpdfrc (5)
+.br
+.B http://www.foolabs.com/xpdf/
diff --git a/Build/source/libs/xpdf/xpdf-3.02/doc/pdftops.cat b/Build/source/libs/xpdf/xpdf-3.02/doc/pdftops.cat
new file mode 100644
index 00000000000..b370774d0fe
--- /dev/null
+++ b/Build/source/libs/xpdf/xpdf-3.02/doc/pdftops.cat
@@ -0,0 +1,229 @@
+pdftops(1) pdftops(1)
+
+
+
+NAME
+ pdftops - Portable Document Format (PDF) to PostScript
+ converter (version 3.02)
+
+SYNOPSIS
+ pdftops [options] [PDF-file [PS-file]]
+
+DESCRIPTION
+ Pdftops converts Portable Document Format (PDF) files to
+ PostScript so they can be printed.
+
+ Pdftops reads the PDF file, PDF-file, and writes a
+ PostScript file, PS-file. If PS-file is not specified,
+ pdftops converts file.pdf to file.ps (or file.eps with the
+ -eps option). If PS-file is '-', the PostScript is sent
+ to stdout.
+
+CONFIGURATION FILE
+ Pdftops 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 pdftops is built). See the xpdfrc(5)
+ man page for details.
+
+OPTIONS
+ Many of the following options can be set with configura-
+ tion file commands. These are listed in square brackets
+ with the description of the corresponding command line
+ option.
+
+ -f number
+ Specifies the first page to print.
+
+ -l number
+ Specifies the last page to print.
+
+ -level1
+ Generate Level 1 PostScript. The resulting
+ PostScript files will be significantly larger (if
+ they contain images), but will print on Level 1
+ printers. This also converts all images to black
+ and white. No more than one of the PostScript
+ level options (-level1, -level1sep, -level2,
+ -level2sep, -level3, -level3Sep) may be given.
+ [config file: psLevel]
+
+ -level1sep
+ Generate Level 1 separable PostScript. All colors
+ are converted to CMYK. Images are written with
+ separate stream data for the four components.
+ [config file: psLevel]
+
+ -level2
+ Generate Level 2 PostScript. Level 2 supports
+ color images and image compression. This is the
+ default setting. [config file: psLevel]
+
+ -level2sep
+ Generate Level 2 separable PostScript. All colors
+ are converted to CMYK. The PostScript separation
+ convention operators are used to handle custom
+ (spot) colors. [config file: psLevel]
+
+ -level3
+ Generate Level 3 PostScript. This enables all
+ Level 2 features plus CID font embedding and masked
+ image generation. [config file: psLevel]
+
+ -level3Sep
+ Generate Level 3 separable PostScript. The separa-
+ tion handling is the same as for -level2Sep. [con-
+ fig file: psLevel]
+
+ -eps Generate an Encapsulated PostScript (EPS) file. An
+ EPS file contains a single image, so if you use
+ this option with a multi-page PDF file, you must
+ use -f and -l to specify a single page. No more
+ than one of the mode options (-eps, -form) may be
+ given.
+
+ -form Generate a PostScript form which can be imported by
+ software that understands forms. A form contains a
+ single page, so if you use this option with a
+ multi-page PDF file, you must use -f and -l to
+ specify a single page. The -level1 option cannot
+ be used with -form.
+
+ -opi Generate OPI comments for all images and forms
+ which have OPI information. (This option is only
+ available if pdftops was compiled with OPI sup-
+ port.) [config file: psOPI]
+
+ -noembt1
+ By default, any Type 1 fonts which are embedded in
+ the PDF file are copied into the PostScript file.
+ This option causes pdftops to substitute base fonts
+ instead. Embedded fonts make PostScript files
+ larger, but may be necessary for readable output.
+ [config file: psEmbedType1Fonts]
+
+ -noembtt
+ By default, any TrueType fonts which are embedded
+ in the PDF file are copied into the PostScript
+ file. This option causes pdftops to substitute
+ base fonts instead. Embedded fonts make PostScript
+ files larger, but may be necessary for readable
+ output. Also, some PostScript interpreters do not
+ have TrueType rasterizers. [config file: psEm-
+ bedTrueTypeFonts]
+
+ -noembcidps
+ By default, any CID PostScript fonts which are
+ embedded in the PDF file are copied into the
+ PostScript file. This option disables that embed-
+ ding. No attempt is made to substitute for non-
+ embedded CID PostScript fonts. [config file: psEm-
+ bedCIDPostScriptFonts]
+
+ -noembcidtt
+ By default, any CID TrueType fonts which are embed-
+ ded in the PDF file are copied into the PostScript
+ file. This option disables that embedding. No
+ attempt is made to substitute for non-embedded CID
+ TrueType fonts. [config file: psEmbedCIDTrueType-
+ Fonts]
+
+ -preload
+ Convert PDF forms to PS procedures, and preload
+ image data. This uses more memory in the
+ PostScript interpreter, but generates significantly
+ smaller PS files in situations where, e.g., the
+ same image is drawn on every page of a long docu-
+ ment.
+
+ -paper size
+ Set the paper size to one of "letter", "legal",
+ "A4", or "A3". This can also be set to "match",
+ which will set the paper size to match the size
+ specified in the PDF file. [config file: psPaper-
+ Size]
+
+ -paperw size
+ Set the paper width, in points. [config file:
+ psPaperSize]
+
+ -paperh size
+ Set the paper height, in points. [config file:
+ psPaperSize]
+
+ -nocrop
+ By default, output is cropped to the CropBox speci-
+ fied in the PDF file. This option disables crop-
+ ping. [config file: psCrop]
+
+ -expand
+ Expand PDF pages smaller than the paper to fill the
+ paper. By default, these pages are not scaled.
+ [config file: psExpandSmaller]
+
+ -noshrink
+ Don't scale PDF pages which are larger than the
+ paper. By default, pages larger than the paper are
+ shrunk to fit. [config file: psShrinkLarger]
+
+ -nocenter
+ By default, PDF pages smaller than the paper (after
+ any scaling) are centered on the paper. This
+ option causes them to be aligned to the lower-left
+ corner of the paper instead. [config file: psCen-
+ ter]
+
+ -pagecrop
+ Treat the CropBox as the PDF page size. By
+ default, the MediaBox is used as the page size.
+
+ -duplex
+ Set the Duplex pagedevice entry in the PostScript
+ file. This tells duplex-capable printers to enable
+ duplexing. [config file: psDuplex]
+
+ -opw password
+ Specify the owner password for the PDF file. Pro-
+ viding this will bypass all security restrictions.
+
+ -upw password
+ Specify the user password for the PDF file.
+
+ -q Don't print any messages or errors. [config file:
+ errQuiet]
+
+ -cfg config-file
+ Read config-file in place of ~/.xpdfrc or the sys-
+ tem-wide config file.
+
+ -v Print copyright and version information.
+
+ -h Print usage information. (-help and --help are
+ equivalent.)
+
+EXIT CODES
+ The Xpdf tools use the following exit codes:
+
+ 0 No error.
+
+ 1 Error opening a PDF file.
+
+ 2 Error opening an output file.
+
+ 3 Error related to PDF permissions.
+
+ 99 Other error.
+
+AUTHOR
+ The pdftops software and documentation are copyright
+ 1996-2007 Glyph & Cog, LLC.
+
+SEE ALSO
+ xpdf(1), pdftotext(1), pdfinfo(1), pdffonts(1),
+ pdftoppm(1), pdfimages(1), xpdfrc(5)
+ http://www.foolabs.com/xpdf/
+
+
+
+ 27 February 2007 pdftops(1)
diff --git a/Build/source/libs/xpdf/xpdf-3.02/doc/pdftops.hlp b/Build/source/libs/xpdf/xpdf-3.02/doc/pdftops.hlp
new file mode 100644
index 00000000000..2cdf8daf240
--- /dev/null
+++ b/Build/source/libs/xpdf/xpdf-3.02/doc/pdftops.hlp
@@ -0,0 +1,239 @@
+! Generated automatically by mantohlp
+1 pdftops
+
+ pdftops - Portable Document Format (PDF) to PostScript
+ converter
+
+ pdftops [options] [PDF-file [PS-file]]
+
+ Pdftops converts Portable Document Format (PDF) files to
+ PostScript so they can be printed.
+
+ Pdftops reads the PDF file, PDF-file, and writes a
+ PostScript file, PS-file. If PS-file is not specified,
+ pdftops converts file.pdf to file.ps (or file.eps with the
+ -eps option). If PS-file is '-', the PostScript is sent
+ to stdout.
+
+ ()
+
+2 ONFIGURATION_FIL
+
+ Pdftops 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 pdftops is built). See the xpdfrc(5)
+ man page for details.
+
+ ()
+
+2 OPTIONS
+
+ Many of the following options can be set with configura-
+ tion file commands. These are listed in square brackets
+ with the description of the corresponding command line
+ option.
+
+ -f number
+ Specifies the first page to print.
+
+ -l number
+ Specifies the last page to print.
+
+ -level1
+ Generate Level 1 PostScript. The resulting
+ PostScript files will be significantly larger (if
+ they contain images), but will print on Level 1
+ printers. This also converts all images to black
+ and white. No more than one of the PostScript
+ level options (-level1, -level1sep, -level2,
+ -level2sep, -level3, -level3Sep) may be given.
+ [config file: psLevel]
+
+ -level1sep
+ Generate Level 1 separable PostScript. All colors
+ are converted to CMYK. Images are written with
+ separate stream data for the four components.
+ [config file: psLevel]
+
+ -level2
+ Generate Level 2 PostScript. Level 2 supports
+ color images and image compression. This is the
+ default setting. [config file: psLevel]
+
+ -level2sep
+ Generate Level 2 separable PostScript. All colors
+ are converted to CMYK. The PostScript separation
+ convention operators are used to handle custom
+ (spot) colors. [config file: psLevel]
+
+ -level3
+ Generate Level 3 PostScript. This enables all
+ Level 2 features plus CID font embedding and masked
+ image generation. [config file: psLevel]
+
+ -level3Sep
+ Generate Level 3 separable PostScript. The separa-
+ tion handling is the same as for -level2Sep. [con-
+ fig file: psLevel]
+
+ -eps Generate an Encapsulated PostScript (EPS) file. An
+ EPS file contains a single image, so if you use
+ this option with a multi-page PDF file, you must
+ use -f and -l to specify a single page. No more
+ than one of the mode options (-eps, -form) may be
+ given.
+
+ -form Generate a PostScript form which can be imported by
+ software that understands forms. A form contains a
+ single page, so if you use this option with a
+ multi-page PDF file, you must use -f and -l to
+ specify a single page. The -level1 option cannot
+ be used with -form.
+
+ -opi Generate OPI comments for all images and forms
+ which have OPI information. (This option is only
+ available if pdftops was compiled with OPI sup-
+ port.) [config file: psOPI]
+
+ -noembt1
+ By default, any Type 1 fonts which are embedded in
+ the PDF file are copied into the PostScript file.
+ This option causes pdftops to substitute base fonts
+ instead. Embedded fonts make PostScript files
+ larger, but may be necessary for readable output.
+ [config file: psEmbedType1Fonts]
+
+ -noembtt
+ By default, any TrueType fonts which are embedded
+ in the PDF file are copied into the PostScript
+ file. This option causes pdftops to substitute
+ base fonts instead. Embedded fonts make PostScript
+ files larger, but may be necessary for readable
+ output. Also, some PostScript interpreters do not
+ have TrueType rasterizers. [config file: psEm-
+ bedTrueTypeFonts]
+
+ -noembcidps
+ By default, any CID PostScript fonts which are
+ embedded in the PDF file are copied into the
+ PostScript file. This option disables that embed-
+ ding. No attempt is made to substitute for non-
+ embedded CID PostScript fonts. [config file: psEm-
+ bedCIDPostScriptFonts]
+
+ -noembcidtt
+ By default, any CID TrueType fonts which are embed-
+ ded in the PDF file are copied into the PostScript
+ file. This option disables that embedding. No
+ attempt is made to substitute for non-embedded CID
+ TrueType fonts. [config file: psEmbedCIDTrueType-
+ Fonts]
+
+ -preload
+ Convert PDF forms to PS procedures, and preload
+ image data. This uses more memory in the
+ PostScript interpreter, but generates significantly
+ smaller PS files in situations where, e.g., the
+ same image is drawn on every page of a long docu-
+ ment.
+
+ -paper size
+ Set the paper size to one of "letter", "legal",
+ "A4", or "A3". This can also be set to "match",
+ which will set the paper size to match the size
+ specified in the PDF file. [config file: psPaper-
+ Size]
+
+ -paperw size
+ Set the paper width, in points. [config file:
+ psPaperSize]
+
+ -paperh size
+ Set the paper height, in points. [config file:
+ psPaperSize]
+
+ -nocrop
+ By default, output is cropped to the CropBox speci-
+ fied in the PDF file. This option disables
+ cropping. [config file: psCrop]
+
+ -expand
+ Expand PDF pages smaller than the paper to fill the
+ paper. By default, these pages are not scaled.
+ [config file: psExpandSmaller]
+
+ -noshrink
+ Don't scale PDF pages which are larger than the
+ paper. By default, pages larger than the paper are
+ shrunk to fit. [config file: psShrinkLarger]
+
+ -nocenter
+ By default, PDF pages smaller than the paper (after
+ any scaling) are centered on the paper. This
+ option causes them to be aligned to the lower-left
+ corner of the paper instead. [config file: psCen-
+ ter]
+
+ -pagecrop
+ Treat the CropBox as the PDF page size. By
+ default, the MediaBox is used as the page size.
+
+ -duplex
+ Set the Duplex pagedevice entry in the PostScript
+ file. This tells duplex-capable printers to enable
+ duplexing. [config file: psDuplex]
+
+ -opw password
+ Specify the owner password for the PDF file. Pro-
+ viding this will bypass all security restrictions.
+
+ -upw password
+ Specify the user password for the PDF file.
+
+ -q Don't print any messages or errors. [config file:
+ errQuiet]
+
+ -cfg config-file
+ Read config-file in place of ~/.xpdfrc or the sys-
+ tem-wide config file.
+
+ -v Print copyright and version information.
+
+ -h Print usage information. (-help and --help are
+ equivalent.)
+
+ ()
+
+2 XIT_CODE
+
+ The Xpdf tools use the following exit codes:
+
+ 0 No error.
+
+ 1 Error opening a PDF file.
+
+ 2 Error opening an output file.
+
+ 3 Error related to PDF permissions.
+
+ 99 Other error.
+
+ ()
+
+2 AUTHOR
+
+ The pdftops software and documentation are copyright
+ 1996-2007 Glyph & Cog, LLC.
+
+ ()
+
+2 SEE_ALSO
+
+ xpdf(1), pdftotext(1), pdfinfo(1), pdffonts(1),
+ pdftoppm(1), pdfimages(1), xpdfrc(5)
+ http://www.foolabs.com/xpdf/
+
+ ()
+
diff --git a/Build/source/libs/xpdf/xpdf-3.02/doc/pdftotext.1 b/Build/source/libs/xpdf/xpdf-3.02/doc/pdftotext.1
new file mode 100644
index 00000000000..c16a1ea495e
--- /dev/null
+++ b/Build/source/libs/xpdf/xpdf-3.02/doc/pdftotext.1
@@ -0,0 +1,137 @@
+.\" Copyright 1997-2007 Glyph & Cog, LLC
+.TH pdftotext 1 "27 Febuary 2007"
+.SH NAME
+pdftotext \- Portable Document Format (PDF) to text converter
+(version 3.02)
+.SH SYNOPSIS
+.B pdftotext
+[options]
+.RI [ PDF-file
+.RI [ text-file ]]
+.SH DESCRIPTION
+.B Pdftotext
+converts Portable Document Format (PDF) files to plain text.
+.PP
+Pdftotext reads the PDF file,
+.IR PDF-file ,
+and writes a text file,
+.IR text-file .
+If
+.I text-file
+is not specified, pdftotext converts
+.I file.pdf
+to
+.IR file.txt .
+If
+.I text-file
+is \'-', the text is sent to stdout.
+.SH CONFIGURATION FILE
+Pdftotext 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 pdftotext
+is built). See the
+.BR xpdfrc (5)
+man page for details.
+.SH OPTIONS
+Many of the following options can be set with configuration file
+commands. These are listed in square brackets with the description of
+the corresponding command line option.
+.TP
+.BI \-f " number"
+Specifies the first page to convert.
+.TP
+.BI \-l " number"
+Specifies the last page to convert.
+.TP
+.B \-layout
+Maintain (as best as possible) the original physical layout of the
+text. The default is to \'undo' physical layout (columns,
+hyphenation, etc.) and output the text in reading order.
+.TP
+.B \-raw
+Keep the text in content stream order. This is a hack which often
+"undoes" column formatting, etc. Use of raw mode is no longer
+recommended.
+.TP
+.B \-htmlmeta
+Generate a simple HTML file, including the meta information. This
+simply wraps the text in <pre> and </pre> and prepends the meta
+headers.
+.TP
+.BI \-enc " encoding-name"
+Sets the encoding to use for text output. The
+.I encoding\-name
+must be defined with the unicodeMap command (see
+.BR xpdfrc (5)).
+The encoding name is case-sensitive. This defaults to "Latin1" (which
+is a built-in encoding).
+.RB "[config file: " textEncoding ]
+.TP
+.BI \-eol " unix | dos | mac"
+Sets the end-of-line convention to use for text output.
+.RB "[config file: " textEOL ]
+.TP
+.B \-nopgbrk
+Don't insert page breaks (form feed characters) between pages.
+.RB "[config file: " textPageBreaks ]
+.TP
+.BI \-opw " password"
+Specify the owner password for the PDF file. Providing this will
+bypass all security restrictions.
+.TP
+.BI \-upw " password"
+Specify the user password for the PDF file.
+.TP
+.B \-q
+Don't print any messages or errors.
+.RB "[config file: " errQuiet ]
+.TP
+.BI \-cfg " config-file"
+Read
+.I config-file
+in place of ~/.xpdfrc or the system-wide config file.
+.TP
+.B \-v
+Print copyright and version information.
+.TP
+.B \-h
+Print usage information.
+.RB ( \-help
+and
+.B \-\-help
+are equivalent.)
+.SH BUGS
+Some PDF files contain fonts whose encodings have been mangled beyond
+recognition. There is no way (short of OCR) to extract text from
+these files.
+.SH EXIT CODES
+The Xpdf tools use the following exit codes:
+.TP
+0
+No error.
+.TP
+1
+Error opening a PDF file.
+.TP
+2
+Error opening an output file.
+.TP
+3
+Error related to PDF permissions.
+.TP
+99
+Other error.
+.SH AUTHOR
+The pdftotext software and documentation are copyright 1996-2007 Glyph
+& Cog, LLC.
+.SH "SEE ALSO"
+.BR xpdf (1),
+.BR pdftops (1),
+.BR pdfinfo (1),
+.BR pdffonts (1),
+.BR pdftoppm (1),
+.BR pdfimages (1),
+.BR xpdfrc (5)
+.br
+.B http://www.foolabs.com/xpdf/
diff --git a/Build/source/libs/xpdf/xpdf-3.02/doc/pdftotext.cat b/Build/source/libs/xpdf/xpdf-3.02/doc/pdftotext.cat
new file mode 100644
index 00000000000..9990226248a
--- /dev/null
+++ b/Build/source/libs/xpdf/xpdf-3.02/doc/pdftotext.cat
@@ -0,0 +1,120 @@
+pdftotext(1) pdftotext(1)
+
+
+
+NAME
+ pdftotext - Portable Document Format (PDF) to text con-
+ verter (version 3.02)
+
+SYNOPSIS
+ pdftotext [options] [PDF-file [text-file]]
+
+DESCRIPTION
+ Pdftotext converts Portable Document Format (PDF) files to
+ plain text.
+
+ Pdftotext reads the PDF file, PDF-file, and writes a text
+ file, text-file. If text-file is not specified, pdftotext
+ converts file.pdf to file.txt. If text-file is '-', the
+ text is sent to stdout.
+
+CONFIGURATION FILE
+ Pdftotext 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 pdftotext is built). See the
+ xpdfrc(5) man page for details.
+
+OPTIONS
+ Many of the following options can be set with configura-
+ tion file commands. These are listed in square brackets
+ with the description of the corresponding command line
+ option.
+
+ -f number
+ Specifies the first page to convert.
+
+ -l number
+ Specifies the last page to convert.
+
+ -layout
+ Maintain (as best as possible) the original physi-
+ cal layout of the text. The default is to 'undo'
+ physical layout (columns, hyphenation, etc.) and
+ output the text in reading order.
+
+ -raw Keep the text in content stream order. This is a
+ hack which often "undoes" column formatting, etc.
+ Use of raw mode is no longer recommended.
+
+ -htmlmeta
+ Generate a simple HTML file, including the meta
+ information. This simply wraps the text in <pre>
+ and </pre> and prepends the meta headers.
+
+ -enc encoding-name
+ Sets the encoding to use for text output. The
+ encoding-name must be defined with the unicodeMap
+ command (see xpdfrc(5)). The encoding name is
+ case-sensitive. This defaults to "Latin1" (which
+ is a built-in encoding). [config file: textEncod-
+ ing]
+
+ -eol unix | dos | mac
+ Sets the end-of-line convention to use for text
+ output. [config file: textEOL]
+
+ -nopgbrk
+ Don't insert page breaks (form feed characters)
+ between pages. [config file: textPageBreaks]
+
+ -opw password
+ Specify the owner password for the PDF file. Pro-
+ viding this will bypass all security restrictions.
+
+ -upw password
+ Specify the user password for the PDF file.
+
+ -q Don't print any messages or errors. [config file:
+ errQuiet]
+
+ -cfg config-file
+ Read config-file in place of ~/.xpdfrc or the sys-
+ tem-wide config file.
+
+ -v Print copyright and version information.
+
+ -h Print usage information. (-help and --help are
+ equivalent.)
+
+BUGS
+ Some PDF files contain fonts whose encodings have been
+ mangled beyond recognition. There is no way (short of
+ OCR) to extract text from these files.
+
+EXIT CODES
+ The Xpdf tools use the following exit codes:
+
+ 0 No error.
+
+ 1 Error opening a PDF file.
+
+ 2 Error opening an output file.
+
+ 3 Error related to PDF permissions.
+
+ 99 Other error.
+
+AUTHOR
+ The pdftotext software and documentation are copyright
+ 1996-2007 Glyph & Cog, LLC.
+
+SEE ALSO
+ xpdf(1), pdftops(1), pdfinfo(1), pdffonts(1), pdftoppm(1),
+ pdfimages(1), xpdfrc(5)
+ http://www.foolabs.com/xpdf/
+
+
+
+ 27 Febuary 2007 pdftotext(1)
diff --git a/Build/source/libs/xpdf/xpdf-3.02/doc/pdftotext.hlp b/Build/source/libs/xpdf/xpdf-3.02/doc/pdftotext.hlp
new file mode 100644
index 00000000000..f527172504c
--- /dev/null
+++ b/Build/source/libs/xpdf/xpdf-3.02/doc/pdftotext.hlp
@@ -0,0 +1,133 @@
+! Generated automatically by mantohlp
+1 pdftotext
+
+ pdftotext - Portable Document Format (PDF) to text con-
+ verter
+
+ pdftotext [options] [PDF-file [text-file]]
+
+ Pdftotext converts Portable Document Format (PDF) files to
+ plain text.
+
+ Pdftotext reads the PDF file, PDF-file, and writes a text
+ file, text-file. If text-file is not specified, pdftotext
+ converts file.pdf to file.txt. If text-file is '-', the
+ text is sent to stdout.
+
+ ()
+
+2 ONFIGURATION_FIL
+
+ Pdftotext 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 pdftotext is built). See the
+ xpdfrc(5) man page for details.
+
+ ()
+
+2 OPTIONS
+
+ Many of the following options can be set with configura-
+ tion file commands. These are listed in square brackets
+ with the description of the corresponding command line
+ option.
+
+ -f number
+ Specifies the first page to convert.
+
+ -l number
+ Specifies the last page to convert.
+
+ -layout
+ Maintain (as best as possible) the original physi-
+ cal layout of the text. The default is to 'undo'
+ physical layout (columns, hyphenation, etc.) and
+ output the text in reading order.
+
+ -raw Keep the text in content stream order. This is a
+ hack which often "undoes" column formatting, etc.
+ Use of raw mode is no longer recommended.
+
+ -htmlmeta
+ Generate a simple HTML file, including the meta
+ information. This simply wraps the text in <pre>
+ and </pre> and prepends the meta headers.
+
+ -enc encoding-name
+ Sets the encoding to use for text output. The
+ encoding-name must be defined with the unicodeMap
+ command (see xpdfrc(5)). The encoding name is
+ case-sensitive. This defaults to "Latin1" (which
+ is a built-in encoding). [config file: textEncod-
+ ing]
+
+ -eol unix | dos | mac
+ Sets the end-of-line convention to use for text
+ output. [config file: textEOL]
+
+ -nopgbrk
+ Don't insert page breaks (form feed characters)
+ between pages. [config file: textPageBreaks]
+
+ -opw password
+ Specify the owner password for the PDF file. Pro-
+ viding this will bypass all security restrictions.
+
+ -upw password
+ Specify the user password for the PDF file.
+
+ -q Don't print any messages or errors. [config file:
+ errQuiet]
+
+ -cfg config-file
+ Read config-file in place of ~/.xpdfrc or the sys-
+ tem-wide config file.
+
+ -v Print copyright and version information.
+
+ -h Print usage information. (-help and --help are
+ equivalent.)
+
+ ()
+
+2 BUGS
+
+ Some PDF files contain fonts whose encodings have been
+ mangled beyond recognition. There is no way (short of
+ OCR) to extract text from these files.
+
+ ()
+
+2 XIT_CODE
+
+ The Xpdf tools use the following exit codes:
+
+ 0 No error.
+
+ 1 Error opening a PDF file.
+
+ 2 Error opening an output file.
+
+ 3 Error related to PDF permissions.
+
+ 99 Other error.
+
+ ()
+
+2 AUTHOR
+
+ The pdftotext software and documentation are copyright
+ 1996-2007 Glyph & Cog, LLC.
+
+ ()
+
+2 SEE_ALSO
+
+ xpdf(1), pdftops(1), pdfinfo(1), pdffonts(1), pdftoppm(1),
+ pdfimages(1), xpdfrc(5)
+ http://www.foolabs.com/xpdf/
+
+ ()
+
diff --git a/Build/source/libs/xpdf/xpdf-3.02/doc/sample-xpdfrc b/Build/source/libs/xpdf/xpdf-3.02/doc/sample-xpdfrc
new file mode 100644
index 00000000000..481e4179ecc
--- /dev/null
+++ b/Build/source/libs/xpdf/xpdf-3.02/doc/sample-xpdfrc
@@ -0,0 +1,91 @@
+#========================================================================
+#
+# Sample xpdfrc file
+#
+# The Xpdf tools look for a config file in two places:
+# 1. ~/.xpdfrc
+# 2. in a system-wide directory, typically /usr/local/etc/xpdfrc
+#
+# This sample config file demonstrates some of the more common
+# configuration options. Everything here is commented out. You
+# should edit things (especially the file/directory paths, since
+# they'll likely be different on your system), and uncomment whichever
+# options you want to use. For complete details on config file syntax
+# and available options, please see the xpdfrc(5) man page.
+#
+# Also, the Xpdf language support packages each include a set of
+# options to be added to the xpdfrc file.
+#
+# http://www.foolabs.com/xpdf/
+#
+#========================================================================
+
+#----- display fonts
+
+# These map the Base-14 fonts to the Type 1 fonts that ship with
+# ghostscript. You'll almost certainly want to use something like
+# this, but you'll need to adjust this to point to wherever
+# ghostscript is installed on your system. (But if the fonts are
+# installed in a "standard" location, xpdf will find them
+# automatically.)
+
+#displayFontT1 Times-Roman /usr/local/share/ghostscript/fonts/n021003l.pfb
+#displayFontT1 Times-Italic /usr/local/share/ghostscript/fonts/n021023l.pfb
+#displayFontT1 Times-Bold /usr/local/share/ghostscript/fonts/n021004l.pfb
+#displayFontT1 Times-BoldItalic /usr/local/share/ghostscript/fonts/n021024l.pfb
+#displayFontT1 Helvetica /usr/local/share/ghostscript/fonts/n019003l.pfb
+#displayFontT1 Helvetica-Oblique /usr/local/share/ghostscript/fonts/n019023l.pfb
+#displayFontT1 Helvetica-Bold /usr/local/share/ghostscript/fonts/n019004l.pfb
+#displayFontT1 Helvetica-BoldOblique /usr/local/share/ghostscript/fonts/n019024l.pfb
+#displayFontT1 Courier /usr/local/share/ghostscript/fonts/n022003l.pfb
+#displayFontT1 Courier-Oblique /usr/local/share/ghostscript/fonts/n022023l.pfb
+#displayFontT1 Courier-Bold /usr/local/share/ghostscript/fonts/n022004l.pfb
+#displayFontT1 Courier-BoldOblique /usr/local/share/ghostscript/fonts/n022024l.pfb
+#displayFontT1 Symbol /usr/local/share/ghostscript/fonts/s050000l.pfb
+#displayFontT1 ZapfDingbats /usr/local/share/ghostscript/fonts/d050000l.pfb
+
+# If you need to display PDF files that refer to non-embedded fonts,
+# you should add one or more fontDir options to point to the
+# directories containing the font files. Xpdf will only look at .pfa,
+# .pfb, and .ttf files in those directories (other files will simply
+# be ignored).
+
+#fontDir /usr/local/fonts/bakoma
+
+#----- 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).
+
+#psPaperSize letter
+
+#----- text output control
+
+# Choose a text encoding for copy-and-paste and for pdftotext output.
+# The Latin1, ASCII7, and UTF-8 encodings are built into Xpdf. Other
+# encodings are available in the language support packages.
+
+#textEncoding UTF-8
+
+# Choose the end-of-line convention for multi-line copy-and-past and
+# for pdftotext output. The available options are unix, mac, and dos.
+
+#textEOL unix
+
+#----- misc settings
+
+# Enable t1lib, FreeType, and anti-aliased text.
+
+#enableT1lib yes
+#enableFreeType yes
+#antialias yes
+
+# Set the command used to run a web browser when a URL hyperlink is
+# clicked.
+
+#urlCommand "netscape -remote 'openURL(%s)'"
diff --git a/Build/source/libs/xpdf/xpdf-3.02/doc/xpdf.1 b/Build/source/libs/xpdf/xpdf-3.02/doc/xpdf.1
new file mode 100644
index 00000000000..654855717c0
--- /dev/null
+++ b/Build/source/libs/xpdf/xpdf-3.02/doc/xpdf.1
@@ -0,0 +1,863 @@
+.\" Copyright 1996-2007 Glyph & Cog, LLC
+.TH xpdf 1 "27 February 2007"
+.SH NAME
+xpdf \- Portable Document Format (PDF) file viewer for X (version 3.02)
+.SH SYNOPSIS
+.B xpdf
+[options]
+.RI [ PDF-file
+.RI [ page " | +" dest ]]
+.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
+software.) Xpdf runs under the X Window System on UNIX, VMS, and
+OS/2.
+.PP
+To run xpdf, simply type:
+.PP
+.RS
+xpdf file.pdf
+.RE
+.PP
+where
+.I file.pdf
+is your PDF file. The file name can be followed by a number
+specifying the page which should be displayed first, e.g.:
+.PP
+.RS
+xpdf file.pdf 18
+.RE
+.PP
+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
+You can also start xpdf without opening any files:
+.PP
+.RS
+xpdf
+.RE
+.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
+.BR xpdfrc (5)
+man page for details.
+.SH OPTIONS
+Many of the following options can be set with configuration file
+commands or X resources. These are listed in square brackets with the
+description of the corresponding command line option.
+.TP
+.BI \-g " geometry"
+Set the initial window geometry.
+.RB ( \-geometry
+is equivalent.)
+.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 ]
+.TP
+.B \-cmap
+Install a private colormap. This is ignored on TrueColor visuals.
+.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 ]
+.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 ]
+.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 ]
+.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 ]
+.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 ]
+.TP
+.B \-cont
+Start in continuous view mode, i.e., with one vertical scroll bar for
+the whole document.
+.RB "[config file: " continuousView ]
+.TP
+.BI \-t1lib " yes | no"
+Enable or disable t1lib (a Type 1 font rasterizer). This defaults to
+"yes".
+.RB "[config file: " enableT1lib ]
+.TP
+.BI \-freetype " yes | no"
+Enable or disable FreeType (a TrueType / Type 1 font rasterizer).
+This defaults to "yes".
+.RB "[config file: " enableFreeType ]
+.TP
+.BI \-aa " yes | no"
+Enable or disable font anti-aliasing. This defaults to "yes".
+.RB "[config file: " antialias ]
+.TP
+.BI \-aaVector " yes | no"
+Enable or disable vector anti-aliasing. This defaults to "yes".
+.RB "[config file: " vectorAntialias ]
+.TP
+.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.
+.RB "[config file: " psFile ]
+.TP
+.BI \-paper " size"
+Set the paper size to one of "letter", "legal", "A4", or "A3". This
+can also be set to "match", which will set the paper size to match the
+size specified in the PDF file.
+.RB "[config file: " psPaperSize ]
+.TP
+.BI \-paperw " size"
+Set the paper width, in points.
+.RB "[config file: " psPaperSize ]
+.TP
+.BI \-paperh " size"
+Set the paper height, in points.
+.RB "[config file: " psPaperSize ]
+.TP
+.B \-level1
+Generate Level 1 PostScript. The resulting PostScript files will be
+significantly larger (if they contain images), but will print on Level
+1 printers. This also converts all images to black and white.
+.RB "[config file: " psLevel ]
+.TP
+.BI \-enc " encoding-name"
+Sets the encoding to use for text output. The
+.I encoding\-name
+must be defined with the unicodeMap command (see
+.BR xpdfrc (5)).
+This defaults to "Latin1" (which is a built-in encoding).
+.RB "[config file: " textEncoding ]
+.TP
+.BI \-eol " unix | dos | mac"
+Sets the end-of-line convention to use for text output.
+.RB "[config file: " textEOL ]
+.TP
+.BI \-opw " password"
+Specify the owner password for the PDF file. Providing this will
+bypass all security restrictions.
+.TP
+.BI \-upw " password"
+Specify the user password for the PDF file.
+.TP
+.B \-fullscreen
+Open xpdf in full-screen mode, useful for presentations.
+.TP
+.BI \-remote " name"
+Start/contact xpdf remote server with specified name (see the
+.B "REMOTE SERVER MODE"
+section below).
+.TP
+.BI \-exec " command"
+Execute a command (see the
+.B COMMANDS
+section below) in an xpdf remote server window (with -remote only).
+.TP
+.B \-reload
+Reload xpdf remote server window (with -remote only).
+.TP
+.B \-raise
+Raise xpdf remote server window (with -remote only).
+.TP
+.B \-quit
+Kill xpdf remote server (with -remote only).
+.TP
+.B \-cmd
+Print commands as they're executed (useful for debugging).
+.RB "[config file: " printCommands ]
+.TP
+.B \-q
+Don't print any messages or errors.
+.RB "[config file: " errQuiet ]
+.TP
+.BI \-cfg " config-file"
+Read
+.I config-file
+in place of ~/.xpdfrc or the system-wide config file.
+.TP
+.B \-v
+Print copyright and version information.
+.TP
+.B \-h
+Print usage information.
+.RB ( \-help
+and
+.B \-\-help
+are equivalent.)
+.PP
+Several other standard X options and resources will work as expected:
+.TP
+.BI \-display " display"
+.RB "[X resource: " xpdf.display ]
+.TP
+.BI \-fg " color"
+.RB ( \-foreground
+is equivalent.)
+.RB "[X resource: " xpdf*Foreground ]
+.TP
+.BI \-bg " color"
+.RB ( \-background
+is equivalent.)
+.RB "[X resource: " xpdf*Background ]
+.TP
+.BI \-font " font"
+.RB ( \-fn
+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').
+.PP
+The following X resources do not have command line option equivalents:
+.TP
+.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
+Sets the matte color to be used in full-screen mode. The default
+setting is "black".
+.SH CONTROLS
+.SS On-screen controls, at the bottom of the xpdf window
+.TP
+.B "left/right arrow buttons"
+Move to the previous/next page.
+.TP
+.B "double left/right arrow buttons"
+Move backward or forward by ten pages.
+.TP
+.B "dashed left/right arrow buttons"
+Move backward or forward along the history path.
+.TP
+.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
+.B "zoom popup menu"
+Change the zoom factor (see the description of the -z option above).
+.TP
+.B "binoculars button"
+Find a text string.
+.TP
+.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'.
+.TP
+.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
+or external file name when the mouse is over a link.
+.TP
+.B "\'Quit' button"
+Quit xpdf.
+.PP
+.SS Menu
+Pressing the right mouse button will post a popup menu with the
+following commands:
+.TP
+.B "Open..."
+Open a new PDF file via a file requester.
+.TP
+.B "Open in new window..."
+Create a new window and open a new PDF file via a file requester.
+.TP
+.B "Reload"
+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.
+.TP
+.B "Save as..."
+Save the current file via a file requester.
+.TP
+.B "Continuous view"
+Toggles between single page and continuous view modes.
+.TP
+.B "Rotate counterclockwise"
+Rotate the page 90 degrees counterclockwise.
+.TP
+.B "Rotate clockwise"
+Rotate the page 90 degrees clockwise. The two rotate commands are
+intended primarily for PDF files where the rotation isn't correctly
+specified in the file.
+.TP
+.B "Zoom to selection"
+Zoom in to the currently selected rectangle.
+.TP
+.B "Close"
+Close the current window. If this is the only open window, the
+document is closed, but the window is left open (i.e., this menu
+command won't quit xpdf).
+.TP
+.B "Quit"
+Quit xpdf.
+.PP
+.SS Outline
+If the PDF contains an outline (a.k.a., bookmarks), there will be an
+outline pane on the left side of the window. The width of the outline
+pane is adjustable with a vertical split bar via the knob near its
+bottom end.
+.PP
+.SS Text selection
+Dragging the mouse with the left button held down will highlight an
+arbitrary rectangle. Any text inside this rectangle will be copied to
+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
+command (see the
+.B WEB BROWSERS
+section below).
+.PP
+.SS Panning
+Dragging the mouse with the middle button held down pans the window.
+.PP
+.SS Key bindings
+.TP
+.B o
+Open a new PDF file via a file requester.
+.TP
+.B r
+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.
+.TP
+.B control-L
+Redraw the current page.
+.TP
+.B control-W
+Close the current window.
+.TP
+.B f or control-F
+Find a text string.
+.TP
+.B control-G
+Find next occurrence.
+.TP
+.B control-P
+Print.
+.TP
+.B n
+Move to the next page. Scrolls to the top of the page, unless scroll
+lock is turned on.
+.TP
+.B p
+Move to the previous page. Scrolls to the top of the page, unless
+scroll lock is turned on.
+.TP
+.BR <Space> " or " <PageDown> " or " <Next>
+Scroll down on the current page; if already at bottom, move to next
+page.
+.TP
+.BR <Backspace> " or " <Delete> " or " <PageUp> " or " <Previous>
+Scroll up on the current page; if already at top, move to previous
+page.
+.TP
+.B v
+Move forward along the history path.
+.TP
+.B b
+Move backward along the history path.
+.TP
+.B <Home>
+Scroll to top of current page.
+.TP
+.B <End>
+Scroll to bottom of current page.
+.TP
+.B control-<Home>
+Scroll to first page of document.
+.TP
+.B control-<End>
+Scroll to last page of document.
+.TP
+.B arrows
+Scroll the current page.
+.TP
+.B g
+Activate the page number text field ("goto page").
+.TP
+.B 0
+Set the zoom factor to 125%.
+.TP
+.B +
+Zoom in (increment the zoom factor by 1).
+.TP
+.B -
+Zoom out (decrement the zoom factor by 1).
+.TP
+.B z
+Set the zoom factor to 'page' (fit page to window).
+.TP
+.B w
+Set the zoom factor to 'width' (fit page width to window).
+.TP
+.B alt-F
+Toggle full-screen mode.
+.TP
+.B q
+Quit xpdf.
+.SH "WEB BROWSERS"
+If you want to run xpdf automatically from netscape or mosaic (and
+probably other browsers) when you click on a link to a PDF file, you
+need to edit (or create) the files
+.I .mime.types
+and
+.I .mailcap
+in your home directory. In
+.I .mime.types
+add the line:
+.PP
+.RS
+application/pdf pdf
+.RE
+.PP
+In
+.I .mailcap
+add the lines:
+.PP
+.RS
+# Use xpdf to view PDF files.
+.RE
+.RS
+application/pdf; xpdf -q %s
+.RE
+.PP
+Make sure that xpdf is on your executable search path.
+.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
+the URL, add this line to your config file:
+.PP
+.RS
+urlCommand "netscape -remote 'openURL(%s)'"
+.RE
+.SH COMMANDS
+Xpdf's key and mouse bindings are user-configurable, using the bind and
+unbind options in the config file (see
+.BR xpdfrc (5)).
+The bind command allows you to bind a key or mouse button to a
+sequence of one or more commands.
+.SS Available Commands
+The following commands are supported:
+.TP
+.BI gotoPage( page )
+Go to the specified page.
+.TP
+.BI gotoPageNoScroll( page )
+Go to the specified page, with the current relative scroll position.
+.TP
+.BI gotoDest( dest )
+Go to a named destination.
+.TP
+.B gotoLastPage
+Go to the last page in the PDF file.
+.TP
+.B gotoLastPageNoScroll
+Go to the last page in the PDF file, with the current relative scroll
+position.
+.TP
+.B nextPage
+Go to the next page.
+.TP
+.B nextPageNoScroll
+Go to the next page, with the current relative scroll position.
+.TP
+.B prevPage
+Go to the previous page.
+.TP
+.B prevPageNoScroll
+Go to the previous page, with the current relative scroll position.
+.TP
+.B pageUp
+Scroll up by one screenful.
+.TP
+.B pageDown
+Scroll down by one screenful.
+.TP
+.BI scrollLeft( n )
+Scroll left by
+.I n
+pixels.
+.TP
+.BI scrollRight( n )
+Scroll right by
+.I n
+pixels.
+.TP
+.BI scrollUp( n )
+Scroll up by
+.I n
+pixels.
+.TP
+.BI scrollDown( n )
+Scroll down by
+.I n
+pixels.
+.TP
+.BI scrollUpPrevPage( n )
+Scroll up by
+.I n
+pixels, moving to the previous page if appropriate.
+.TP
+.BI scrollDownPrevPage( n )
+Scroll down by
+.I n
+pixels, moving to the next page if appropriate.
+.TP
+.B scrollToTopEdge
+Scroll to the top edge of the current page, with no horizontal
+movement.
+.TP
+.B scrollToBottomEdge
+Scroll to the bottom edge of the current page, with no horizontal
+movement.
+.TP
+.B scrollToLeftEdge
+Scroll to the left edge of the current page, with no vertical
+movement.
+.TP
+.B scrollToRightEdge
+Scroll to the right edge of the current page, with no vertical
+movement.
+.TP
+.B scrollToTopLeft
+Scroll to the top-left corner of the current page.
+.TP
+.B scrollToBottomRight
+Scroll to the bottom-right corner of the current page.
+.TP
+.B goForward
+Move forward along the history path.
+.TP
+.B goBackward
+Move backward along the history path.
+.TP
+.BI zoomPercent( z )
+Set the zoom factor to
+.IR z %.
+.TP
+.B zoomFitPage
+Set the zoom factor to fit-page.
+.TP
+.B zoomFitWidth
+Set the zoom factor to fit-width.
+.TP
+.B zoomIn
+Zoom in - go to the next higher zoom factor.
+.TP
+.B zoomOut
+Zoom out - go the next lower zoom factor.
+.TP
+.B continuousMode
+Go to continuous view mode.
+.TP
+.B singlePageMode
+Go to single-page view mode.
+.TP
+.B toggleContinuousMode
+Toggle between continuous and single page view modes.
+.TP
+.B fullScreenMode
+Go to full-screen mode.
+.TP
+.B windowMode
+Go to window (non-full-screen) mode.
+.TP
+.B toggleFullScreenMode
+Toggle between full-screen and window modes.
+.TP
+.B open
+Open a PDF file in this window, using the open dialog.
+.TP
+.B openInNewWin
+Open a PDF file in a new window, using the open dialog.
+.TP
+.BI openFile( file )
+Open a specified PDF file in this window.
+.TP
+.BI openFileInNewWin( file )
+Open a specified PDF file in a new window.
+.TP
+.BI openFileAtDest( file , dest )
+Open a specified PDF file in this window and go to a named
+destination.
+.TP
+.BI openFileAtDestInNewWin( file , dest )
+Open a specified PDF file in a new window and go to a named
+destination.
+.TP
+.B reload
+Reload the current PDF file.
+.TP
+.B redraw
+Redraw the window.
+.TP
+.B raise
+Raise the window to the front.
+.TP
+.B closeWindow
+Close the window.
+.TP
+.BI run( external-command-string )
+Run an external command. The following escapes are allowed in the
+command string:
+.nf
+
+ %f => PDF file name (or an empty string if no
+ file is open)
+ %b => PDF file base name, i.e., file name minus
+ the extension (or an empty string if no
+ file is open)
+ %u => link URL (or an empty string if not over
+ a URL link)
+ %x => selection upper-left x coordinate
+ (or 0 if there is no selection)
+ %y => selection upper-left y coordinate
+ (or 0 if there is no selection)
+ %X => selection lower-right x coordinate
+ (or 0 if there is no selection)
+ %Y => selection lower-right y coordinate
+ (or 0 if there is no selection)
+ %% => %
+
+.fi
+.TP
+.B openOutline
+Open the outline pane.
+.TP
+.B closeOutline
+Close the outline pane.
+.TP
+.B toggleOutline
+Toggle the outline pane between open and closed.
+.TP
+.BI scrollOutlineDown( n )
+Scroll the outline down by
+.I n
+increments.
+.TP
+.BI scrollOutlineUp( n )
+Scroll the outline up by
+.I n
+increments.
+.TP
+.B focusToDocWin
+Set the keyboard focus to the main document window.
+.TP
+.B focusToPageNum
+Set the keyboard focus to the page number text box.
+.TP
+.B find
+Open the 'find' dialog.
+.TP
+.B findNext
+Finds the next occurrence of the search string (no dialog).
+.TP
+.B print
+Open the 'print' dialog.
+.TP
+.B about
+Open the 'about' dialog.
+.TP
+.B quit
+Quit from xpdf.
+.PP
+The following commands depend on the current mouse position:
+.TP
+.B startSelection
+Start a selection, which will be extended as the mouse moves.
+.TP
+.B endSelection
+End a selection.
+.TP
+.B startPan
+Start a pan, which will scroll the document as the mouse moves
+.TP
+.B endPan
+End a pan.
+.TP
+.B postPopupMenu
+Display the popup menu.
+.TP
+.B followLink
+Follow a hyperlink (does nothing if the mouse is not over a link).
+.TP
+.B 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 files, this
+command is identical to followLink.
+.TP
+.B followLinkNoSel
+Same as followLink, but does nothing if there is a non-empty selection.
+(This is useful as a mouse button binding.)
+.TP
+.B followLinkInNewWinNoSel
+Same as followLinkInNewWin, but does nothing if there is a non-empty
+selection. (This is useful as a mouse button binding.)
+.SS Default Bindings
+The default mouse bindings are as follows:
+.nf
+
+ bind mousePress1 any startSelection
+ bind mouseRelease1 any endSelection followLinkNoSel
+ bind mousePress2 any startPan
+ bind mouseRelease2 any endPan
+ bind mousePress3 any postPopupMenu
+ bind mousePress4 any scrollUpPrevPage(16)
+ bind mousePress5 any scrollDownNextPage(16)
+ bind mousePress6 any scrollLeft(16)
+ bind mousePress7 any scrollRight(16)
+
+.fi
+The default key bindings are as follows:
+.nf
+
+ bind ctrl-home any gotoPage(1)
+ bind home any scrollToTopLeft
+ bind ctrl-end any gotoLastPage
+ bind end any scrollToBottomRight
+ bind pgup any pageUp
+ bind backspace any pageUp
+ bind delete any pageUp
+ bind pgdn any pageDown
+ bind space any pageDown
+ bind left any scrollLeft(16)
+ bind right any scrollRight(16)
+ bind up any scrollUp(16)
+ bind down any scrollDown(16)
+ bind o any open
+ bind O any open
+ bind r any reload
+ bind R any reload
+ bind f any find
+ bind F any find
+ bind ctrl-f any find
+ bind ctrl-g any findNext
+ bind ctrl-p any print
+ bind n scrLockOff nextPage
+ bind N scrLockOff nextPage
+ bind n scrLockOn nextPageNoScroll
+ bind N scrLockOn nextPageNoScroll
+ bind p scrLockOff prevPage
+ bind P scrLockOff prevPage
+ bind p scrLockOn prevPageNoScroll
+ bind P scrLockOn prevPageNoScroll
+ bind v any goForward
+ bind b any goBackward
+ bind g any focusToPageNum
+ bind 0 any zoomPercent(125)
+ bind + any zoomIn
+ bind - any zoomOut
+ bind z any zoomFitPage
+ bind w any zoomFitWidth
+ bind alt-f any toggleFullScreenMode
+ bind ctrl-l any redraw
+ bind ctrl-w any closeWindow
+ bind ? any about
+ bind q any quit
+ bind Q any quit
+
+.fi
+Previous versions of xpdf included a "viKeys" X resource. It is no
+longer available, but the following bindings are equivalent:
+.nf
+
+ bind h any scrollLeft(16)
+ bind l any scrollRight(16)
+ bind k any scrollUp(16)
+ bind j any scrollDown(16)
+
+.fi
+.SH "REMOTE SERVER MODE"
+Xpdf can be started in remote server mode by specifying a server name
+(in addition to the file name and page number). For example:
+.PP
+.RS
+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:
+.PP
+.RS
+xpdf -remote myServer another.pdf 9
+.RE
+.PP
+is issued, a new copy of xpdf will not be started. Instead, the first
+xpdf (the server) will load
+.I another.pdf
+and display page nine. If the file name is the same:
+.PP
+.RS
+xpdf -remote myServer another.pdf 4
+.RE
+.PP
+the xpdf server will simply display the specified page.
+.PP
+The -raise option tells the server to raise its window; it can be
+specified with or without a file name and page number.
+.PP
+The -quit option tells the server to close its window and exit.
+.SH EXIT CODES
+The Xpdf tools use the following exit codes:
+.TP
+0
+No error.
+.TP
+1
+Error opening a PDF file.
+.TP
+2
+Error opening an output file.
+.TP
+3
+Error related to PDF permissions.
+.TP
+99
+Other error.
+.SH AUTHOR
+The xpdf software and documentation are copyright 1996-2007 Glyph &
+Cog, LLC.
+.SH "SEE ALSO"
+.BR pdftops (1),
+.BR pdftotext (1),
+.BR pdfinfo (1),
+.BR pdffonts (1),
+.BR pdftoppm (1),
+.BR pdfimages (1),
+.BR xpdfrc (5)
+.br
+.B http://www.foolabs.com/xpdf/
diff --git a/Build/source/libs/xpdf/xpdf-3.02/doc/xpdf.cat b/Build/source/libs/xpdf/xpdf-3.02/doc/xpdf.cat
new file mode 100644
index 00000000000..8ab72913edf
--- /dev/null
+++ b/Build/source/libs/xpdf/xpdf-3.02/doc/xpdf.cat
@@ -0,0 +1,809 @@
+xpdf(1) xpdf(1)
+
+
+
+NAME
+ xpdf - Portable Document Format (PDF) file viewer for X
+ (version 3.02)
+
+SYNOPSIS
+ xpdf [options] [PDF-file [page | +dest]]
+
+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 PDF software.) Xpdf runs under
+ the X Window System on UNIX, VMS, and OS/2.
+
+ To run xpdf, simply type:
+
+ xpdf file.pdf
+
+ where file.pdf is your PDF file. The file name can be
+ followed by a number specifying the page which should be
+ displayed first, e.g.:
+
+ xpdf file.pdf 18
+
+ 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.)
+
+ You can also start xpdf without opening any files:
+
+ xpdf
+
+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 xpdfrc(5) man
+ page for details.
+
+OPTIONS
+ Many of the following options can be set with configura-
+ tion file commands or X resources. These are listed in
+ square brackets with the description of the corresponding
+ command line option.
+
+ -g geometry
+ Set the initial window geometry. (-geometry is
+ equivalent.) [X resource: xpdf.geometry]
+
+ -title title
+ Set the window title. By default, the title will
+ be "xpdf: foo.pdf". [X resource: xpdf.title]
+
+ -cmap Install a private colormap. This is ignored on
+ TrueColor visuals. [X resource: xpdf.installCmap]
+
+ -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. [X resource:
+ xpdf.rgbCubeSize]
+
+ -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. [X resource:
+ xpdf.reverseVideo]
+
+ -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. [X resource: xpdf.paperColor]
+
+ -mattecolor color
+ Set the matte color, i.e., the color used for back-
+ ground outside the actual page area. (There is a
+ separate setting, xpdf.fullScreenMatteColor, for
+ full-screen mode.) [X resource: xpdf.matteColor]
+
+ -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 win-
+ dow width. [config file: initialZoom; or X
+ resource: xpdf.initialZoom]
+
+ -cont Start in continuous view mode, i.e., with one ver-
+ tical scroll bar for the whole document. [config
+ file: continuousView]
+
+ -t1lib yes | no
+ Enable or disable t1lib (a Type 1 font rasterizer).
+ This defaults to "yes". [config file: enableT1lib]
+
+ -freetype yes | no
+ Enable or disable FreeType (a TrueType / Type 1
+ font rasterizer). This defaults to "yes". [config
+ file: enableFreeType]
+
+ -aa yes | no
+ Enable or disable font anti-aliasing. This
+ defaults to "yes". [config file: antialias]
+
+ -aaVector yes | no
+ Enable or disable vector anti-aliasing. This
+ defaults to "yes". [config file: vectorAntialias]
+
+ -ps PS-file
+ Set the default file name for PostScript output
+ (i.e., the name which will appear in the print dia-
+ log). This can also be of the form '|command' to
+ pipe the PostScript through a command. [config
+ file: psFile]
+
+ -paper size
+ Set the paper size to one of "letter", "legal",
+ "A4", or "A3". This can also be set to "match",
+ which will set the paper size to match the size
+ specified in the PDF file. [config file: psPaper-
+ Size]
+
+ -paperw size
+ Set the paper width, in points. [config file:
+ psPaperSize]
+
+ -paperh size
+ Set the paper height, in points. [config file:
+ psPaperSize]
+
+ -level1
+ Generate Level 1 PostScript. The resulting
+ PostScript files will be significantly larger (if
+ they contain images), but will print on Level 1
+ printers. This also converts all images to black
+ and white. [config file: psLevel]
+
+ -enc encoding-name
+ Sets the encoding to use for text output. The
+ encoding-name must be defined with the unicodeMap
+ command (see xpdfrc(5)). This defaults to "Latin1"
+ (which is a built-in encoding). [config file: tex-
+ tEncoding]
+
+ -eol unix | dos | mac
+ Sets the end-of-line convention to use for text
+ output. [config file: textEOL]
+
+ -opw password
+ Specify the owner password for the PDF file. Pro-
+ viding this will bypass all security restrictions.
+
+ -upw password
+ Specify the user password for the PDF file.
+
+ -fullscreen
+ Open xpdf in full-screen mode, useful for presenta-
+ tions.
+
+ -remote name
+ Start/contact xpdf remote server with specified
+ name (see the REMOTE SERVER MODE section below).
+
+ -exec command
+ Execute a command (see the COMMANDS section below)
+ in an xpdf remote server window (with -remote
+ only).
+
+ -reload
+ Reload xpdf remote server window (with -remote
+ only).
+
+ -raise Raise xpdf remote server window (with -remote
+ only).
+
+ -quit Kill xpdf remote server (with -remote only).
+
+ -cmd Print commands as they're executed (useful for
+ debugging). [config file: printCommands]
+
+ -q Don't print any messages or errors. [config file:
+ errQuiet]
+
+ -cfg config-file
+ Read config-file in place of ~/.xpdfrc or the sys-
+ tem-wide config file.
+
+ -v Print copyright and version information.
+
+ -h Print usage information. (-help and --help are
+ equivalent.)
+
+ Several other standard X options and resources will work
+ as expected:
+
+ -display display
+ [X resource: xpdf.display]
+
+ -fg color
+ (-foreground is equivalent.) [X resource:
+ xpdf*Foreground]
+
+ -bg color
+ (-background is equivalent.) [X resource:
+ xpdf*Background]
+
+ -font font
+ (-fn is equivalent.) [X resource: xpdf*fontList]
+
+ The color and font options only affect the user interface
+ elements, not the PDF display (the 'paper').
+
+ The following X resources do not have command line option
+ equivalents:
+
+ xpdf.toolTipEnable
+ Enables (if set to true) or disables (if set to
+ false) the tool-tips on the toolbar buttons.
+
+ xpdf.fullScreenMatteColor
+ Sets the matte color to be used in full-screen
+ mode. The default setting is "black".
+
+CONTROLS
+ On-screen controls, at the bottom of the xpdf window
+ left/right arrow buttons
+ Move to the previous/next page.
+
+ double left/right arrow buttons
+ Move backward or forward by ten pages.
+
+ dashed left/right arrow buttons
+ Move backward or forward along the history path.
+
+ 'Page' entry box
+ Move to a specific page number. Click in the box
+ to activate it, type the page number, then hit
+ return.
+
+ zoom popup menu
+ Change the zoom factor (see the description of the
+ -z option above).
+
+ binoculars button
+ Find a text string.
+
+ 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'.
+
+ '?' button
+ Bring up the 'about xpdf' window.
+
+ link info
+ The space between the '?' and 'Quit' buttons is
+ used to show the URL or external file name when the
+ mouse is over a link.
+
+ 'Quit' button
+ Quit xpdf.
+
+
+ Menu
+ Pressing the right mouse button will post a popup menu
+ with the following commands:
+
+ Open...
+ Open a new PDF file via a file requester.
+
+ Open in new window...
+ Create a new window and open a new PDF file via a
+ file requester.
+
+ Reload 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.
+
+ Save as...
+ Save the current file via a file requester.
+
+ Continuous view
+ Toggles between single page and continuous view
+ modes.
+
+ Rotate counterclockwise
+ Rotate the page 90 degrees counterclockwise.
+
+ Rotate clockwise
+ Rotate the page 90 degrees clockwise. The two
+ rotate commands are intended primarily for PDF
+ files where the rotation isn't correctly specified
+ in the file.
+
+ Zoom to selection
+ Zoom in to the currently selected rectangle.
+
+ Close Close the current window. If this is the only open
+ window, the document is closed, but the window is
+ left open (i.e., this menu command won't quit
+ xpdf).
+
+ Quit Quit xpdf.
+
+
+ Outline
+ If the PDF contains an outline (a.k.a., bookmarks), there
+ will be an outline pane on the left side of the window.
+ The width of the outline pane is adjustable with a verti-
+ cal split bar via the knob near its bottom end.
+
+
+ Text selection
+ Dragging the mouse with the left button held down will
+ highlight an arbitrary rectangle. Any text inside this
+ rectangle will be copied to the X selection buffer.
+
+
+ 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', exe-
+ cute the program. URL links call an external command (see
+ the WEB BROWSERS section below).
+
+
+ Panning
+ Dragging the mouse with the middle button held down pans
+ the window.
+
+
+ Key bindings
+ o Open a new PDF file via a file requester.
+
+ r 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-L
+ Redraw the current page.
+
+ control-W
+ Close the current window.
+
+ f or control-F
+ Find a text string.
+
+ control-G
+ Find next occurrence.
+
+ control-P
+ Print.
+
+ n Move to the next page. Scrolls to the top of the
+ page, unless scroll lock is turned on.
+
+ p Move to the previous page. Scrolls to the top of
+ the page, unless scroll lock is turned on.
+
+ <Space> or <PageDown> or <Next>
+ Scroll down on the current page; if already at bot-
+ tom, move to next page.
+
+ <Backspace> or <Delete> or <PageUp> or <Previous>
+ Scroll up on the current page; if already at top,
+ move to previous page.
+
+ v Move forward along the history path.
+
+ b Move backward along the history path.
+
+ <Home> Scroll to top of current page.
+
+ <End> Scroll to bottom of current page.
+
+ control-<Home>
+ Scroll to first page of document.
+
+ control-<End>
+ Scroll to last page of document.
+
+ arrows Scroll the current page.
+
+ g Activate the page number text field ("goto page").
+
+ 0 Set the zoom factor to 125%.
+
+ + Zoom in (increment the zoom factor by 1).
+
+ - Zoom out (decrement the zoom factor by 1).
+
+ z Set the zoom factor to 'page' (fit page to window).
+
+ w Set the zoom factor to 'width' (fit page width to
+ window).
+
+ alt-F Toggle full-screen mode.
+
+ q Quit xpdf.
+
+WEB BROWSERS
+ If you want to run xpdf automatically from netscape or
+ mosaic (and probably other browsers) when you click on a
+ link to a PDF file, you need to edit (or create) the files
+ .mime.types and .mailcap in your home directory. In
+ .mime.types add the line:
+
+ application/pdf pdf
+
+ In .mailcap add the lines:
+
+ # Use xpdf to view PDF files.
+ application/pdf; xpdf -q %s
+
+ Make sure that xpdf is on your executable search path.
+
+ When you click on a URL link in a PDF file, xpdf will exe-
+ cute the command specified by the urlCommand config file
+ option, replacing an occurrence of '%s' with the URL. For
+ example, to call netscape with the URL, add this line to
+ your config file:
+
+ urlCommand "netscape -remote 'openURL(%s)'"
+
+COMMANDS
+ Xpdf's key and mouse bindings are user-configurable, using
+ the bind and unbind options 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.
+
+ Available Commands
+ The following commands are supported:
+
+ gotoPage(page)
+ Go to the specified page.
+
+ gotoPageNoScroll(page)
+ Go to the specified page, with the current relative
+ scroll position.
+
+ gotoDest(dest)
+ Go to a named destination.
+
+ gotoLastPage
+ Go to the last page in the PDF file.
+
+ gotoLastPageNoScroll
+ Go to the last page in the PDF file, with the cur-
+ rent relative scroll position.
+
+ nextPage
+ Go to the next page.
+
+ nextPageNoScroll
+ Go to the next page, with the current relative
+ scroll position.
+
+ prevPage
+ Go to the previous page.
+
+ prevPageNoScroll
+ Go to the previous page, with the current relative
+ scroll position.
+
+ pageUp Scroll up by one screenful.
+
+ pageDown
+ Scroll down by one screenful.
+
+ scrollLeft(n)
+ Scroll left by n pixels.
+
+ scrollRight(n)
+ Scroll right by n pixels.
+
+ scrollUp(n)
+ Scroll up by n pixels.
+
+ scrollDown(n)
+ Scroll down by n pixels.
+
+ scrollUpPrevPage(n)
+ Scroll up by n pixels, moving to the previous page
+ if appropriate.
+
+ scrollDownPrevPage(n)
+ Scroll down by n pixels, moving to the next page if
+ appropriate.
+
+ scrollToTopEdge
+ Scroll to the top edge of the current page, with no
+ horizontal movement.
+
+ scrollToBottomEdge
+ Scroll to the bottom edge of the current page, with
+ no horizontal movement.
+
+ scrollToLeftEdge
+ 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 movement.
+
+ scrollToTopLeft
+ Scroll to the top-left corner of the current page.
+
+ scrollToBottomRight
+ Scroll to the bottom-right corner of the current
+ page.
+
+ goForward
+ Move forward along the history path.
+
+ goBackward
+ Move backward along the history path.
+
+ zoomPercent(z)
+ Set the zoom factor to z%.
+
+ zoomFitPage
+ Set the zoom factor to fit-page.
+
+ zoomFitWidth
+ Set the zoom factor to fit-width.
+
+ zoomIn Zoom in - go to the next higher zoom factor.
+
+ zoomOut
+ Zoom out - go the next lower zoom factor.
+
+ continuousMode
+ Go to continuous view mode.
+
+ singlePageMode
+ Go to single-page view mode.
+
+ toggleContinuousMode
+ Toggle between continuous and single page view
+ modes.
+
+ fullScreenMode
+ Go to full-screen mode.
+
+ windowMode
+ Go to window (non-full-screen) mode.
+
+ toggleFullScreenMode
+ Toggle between full-screen and window modes.
+
+ open Open a PDF file in this window, using the open dia-
+ log.
+
+ openInNewWin
+ Open a PDF file in a new window, using the open
+ dialog.
+
+ openFile(file)
+ Open a specified PDF file in this window.
+
+ openFileInNewWin(file)
+ Open a specified PDF file in a new window.
+
+ openFileAtDest(file,dest)
+ Open a specified PDF file in this window and go to
+ a named destination.
+
+ openFileAtDestInNewWin(file,dest)
+ Open a specified PDF file in a new window and go to
+ a named destination.
+
+ reload Reload the current PDF file.
+
+ redraw Redraw the window.
+
+ raise Raise the window to the front.
+
+ closeWindow
+ Close the window.
+
+ run(external-command-string)
+ Run an external command. The following escapes are
+ allowed in the command string:
+
+ %f => PDF file name (or an empty string if no
+ file is open)
+ %b => PDF file base name, i.e., file name minus
+ the extension (or an empty string if no
+ file is open)
+ %u => link URL (or an empty string if not over
+ a URL link)
+ %x => selection upper-left x coordinate
+ (or 0 if there is no selection)
+ %y => selection upper-left y coordinate
+ (or 0 if there is no selection)
+ %X => selection lower-right x coordinate
+ (or 0 if there is no selection)
+ %Y => selection lower-right y coordinate
+ (or 0 if there is no selection)
+ %% => %
+
+
+ openOutline
+ Open the outline pane.
+
+ closeOutline
+ Close the outline pane.
+
+ toggleOutline
+ Toggle the outline pane between open and closed.
+
+ scrollOutlineDown(n)
+ Scroll the outline down by n increments.
+
+ scrollOutlineUp(n)
+ Scroll the outline up by n increments.
+
+ focusToDocWin
+ Set the keyboard focus to the main document window.
+
+ focusToPageNum
+ Set the keyboard focus to the page number text box.
+
+ find Open the 'find' dialog.
+
+ findNext
+ Finds the next occurrence of the search string (no
+ dialog).
+
+ print Open the 'print' dialog.
+
+ about Open the 'about' dialog.
+
+ quit Quit from xpdf.
+
+ The following commands depend on the current mouse posi-
+ tion:
+
+ startSelection
+ Start a selection, which will be extended as the
+ mouse moves.
+
+ endSelection
+ End a selection.
+
+ startPan
+ Start a pan, which will scroll the document as the
+ mouse moves
+
+ endPan End a pan.
+
+ postPopupMenu
+ Display the popup menu.
+
+ followLink
+ Follow a hyperlink (does nothing if the mouse is
+ not over a link).
+
+ followLinkInNewWin
+ Follow a hyperlink, opening PDF files in a new win-
+ dow (does nothing if the mouse is not over a link).
+ For links to non-PDF files, this command is identi-
+ cal to followLink.
+
+ followLinkNoSel
+ Same as followLink, but does nothing if there is a
+ non-empty selection. (This is useful as a mouse
+ button binding.)
+
+ followLinkInNewWinNoSel
+ Same as followLinkInNewWin, but does nothing if
+ there is a non-empty selection. (This is useful as
+ a mouse button binding.)
+
+ Default Bindings
+ The default mouse bindings are as follows:
+
+ bind mousePress1 any startSelection
+ bind mouseRelease1 any endSelection followLinkNoSel
+ bind mousePress2 any startPan
+ bind mouseRelease2 any endPan
+ bind mousePress3 any postPopupMenu
+ bind mousePress4 any scrollUpPrevPage(16)
+ bind mousePress5 any scrollDownNextPage(16)
+ bind mousePress6 any scrollLeft(16)
+ bind mousePress7 any scrollRight(16)
+
+ The default key bindings are as follows:
+
+ bind ctrl-home any gotoPage(1)
+ bind home any scrollToTopLeft
+ bind ctrl-end any gotoLastPage
+ bind end any scrollToBottomRight
+ bind pgup any pageUp
+ bind backspace any pageUp
+ bind delete any pageUp
+ bind pgdn any pageDown
+ bind space any pageDown
+ bind left any scrollLeft(16)
+ bind right any scrollRight(16)
+ bind up any scrollUp(16)
+ bind down any scrollDown(16)
+ bind o any open
+ bind O any open
+ bind r any reload
+ bind R any reload
+ bind f any find
+ bind F any find
+ bind ctrl-f any find
+ bind ctrl-g any findNext
+ bind ctrl-p any print
+ bind n scrLockOff nextPage
+ bind N scrLockOff nextPage
+ bind n scrLockOn nextPageNoScroll
+ bind N scrLockOn nextPageNoScroll
+ bind p scrLockOff prevPage
+ bind P scrLockOff prevPage
+ bind p scrLockOn prevPageNoScroll
+ bind P scrLockOn prevPageNoScroll
+ bind v any goForward
+ bind b any goBackward
+ bind g any focusToPageNum
+ bind 0 any zoomPercent(125)
+ bind + any zoomIn
+ bind - any zoomOut
+ bind z any zoomFitPage
+ bind w any zoomFitWidth
+ bind alt-f any toggleFullScreenMode
+ bind ctrl-l any redraw
+ bind ctrl-w any closeWindow
+ bind ? any about
+ bind q any quit
+ bind Q any quit
+
+ Previous versions of xpdf included a "viKeys" X resource.
+ It is no longer available, but the following bindings are
+ equivalent:
+
+ bind h any scrollLeft(16)
+ bind l any scrollRight(16)
+ bind k any scrollUp(16)
+ bind j any scrollDown(16)
+
+
+REMOTE SERVER MODE
+ Xpdf can be started in remote server mode by specifying a
+ server name (in addition to the file name and page num-
+ ber). For example:
+
+ xpdf -remote myServer file.pdf
+
+ If there is currently no xpdf running in server mode with
+ the name 'myServer', a new xpdf window will be opened. If
+ another command:
+
+ xpdf -remote myServer another.pdf 9
+
+ is issued, a new copy of xpdf will not be started.
+ Instead, the first xpdf (the server) will load another.pdf
+ and display page nine. If the file name is the same:
+
+ xpdf -remote myServer another.pdf 4
+
+ the xpdf server will simply display the specified page.
+
+ The -raise option tells the server to raise its window; it
+ can be specified with or without a file name and page num-
+ ber.
+
+ The -quit option tells the server to close its window and
+ exit.
+
+EXIT CODES
+ The Xpdf tools use the following exit codes:
+
+ 0 No error.
+
+ 1 Error opening a PDF file.
+
+ 2 Error opening an output file.
+
+ 3 Error related to PDF permissions.
+
+ 99 Other error.
+
+AUTHOR
+ The xpdf software and documentation are copyright
+ 1996-2007 Glyph & Cog, LLC.
+
+SEE ALSO
+ pdftops(1), pdftotext(1), pdfinfo(1), pdffonts(1),
+ pdftoppm(1), pdfimages(1), xpdfrc(5)
+ http://www.foolabs.com/xpdf/
+
+
+
+ 27 February 2007 xpdf(1)
diff --git a/Build/source/libs/xpdf/xpdf-3.02/doc/xpdf.hlp b/Build/source/libs/xpdf/xpdf-3.02/doc/xpdf.hlp
new file mode 100644
index 00000000000..1f90bab755e
--- /dev/null
+++ b/Build/source/libs/xpdf/xpdf-3.02/doc/xpdf.hlp
@@ -0,0 +1,823 @@
+! Generated automatically by mantohlp
+1 xpdf
+
+ xpdf - Portable Document Format (PDF) file viewer for X
+ (version 3.02)
+
+ xpdf [options] [PDF-file [page | +dest]]
+
+ 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 software.) Xpdf runs under
+ the X Window System on UNIX, VMS, and OS/2.
+
+ To run xpdf, simply type:
+
+ xpdf file.pdf
+
+ where file.pdf is your PDF file. The file name can be
+ followed by a number specifying the page which should be
+ displayed first, e.g.:
+
+ xpdf file.pdf 18
+
+ 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.)
+
+ You can also start xpdf without opening any files:
+
+ xpdf
+
+ ()
+
+2 ONFIGURATION_FIL
+
+ 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 xpdfrc(5) man
+ page for details.
+
+ ()
+
+2 OPTIONS
+
+ Many of the following options can be set with configura-
+ tion file commands or X resources. These are listed in
+ square brackets with the description of the corresponding
+ command line option.
+
+ -g geometry
+ Set the initial window geometry. (-geometry is
+ equivalent.) [X resource: xpdf.geometry]
+
+ -title title
+ Set the window title. By default, the title will
+ be "xpdf: foo.pdf". [X resource: xpdf.title]
+
+ -cmap Install a private colormap. This is ignored on
+ TrueColor visuals. [X resource: xpdf.installCmap]
+
+ -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. [X resource:
+ xpdf.rgbCubeSize]
+
+ -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. [X resource:
+ xpdf.reverseVideo]
+
+ -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. [X resource: xpdf.paperColor]
+
+ -mattecolor color
+ Set the matte color, i.e., the color used for back-
+ ground outside the actual page area. (There is a
+ separate setting, xpdf.fullScreenMatteColor, for
+ full-screen mode.) [X resource: xpdf.matteColor]
+
+ -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 win-
+ dow width. [config file: initialZoom; or X
+ resource: xpdf.initialZoom]
+
+ -cont Start in continuous view mode, i.e., with one ver-
+ tical scroll bar for the whole document. [config
+ file: continuousView]
+
+ -t1lib yes | no
+ Enable or disable t1lib (a Type 1 font rasterizer).
+ This defaults to "yes". [config file: enableT1lib]
+
+ -freetype yes | no
+ Enable or disable FreeType (a TrueType / Type 1
+ font rasterizer). This defaults to "yes". [config
+ file: enableFreeType]
+
+ -aa yes | no
+ Enable or disable font anti-aliasing. This
+ defaults to "yes". [config file: antialias]
+
+ -aaVector yes | no
+ Enable or disable vector anti-aliasing. This
+ defaults to "yes". [config file: vectorAntialias]
+
+ -ps PS-file
+ Set the default file name for PostScript output
+ (i.e., the name which will appear in the print dia-
+ log). This can also be of the form '|command' to
+ pipe the PostScript through a command. [config
+ file: psFile]
+
+ -paper size
+ Set the paper size to one of "letter", "legal",
+ "A4", or "A3". This can also be set to "match",
+ which will set the paper size to match the size
+ specified in the PDF file. [config file: psPaper-
+ Size]
+
+ -paperw size
+ Set the paper width, in points. [config file:
+ psPaperSize]
+
+ -paperh size
+ Set the paper height, in points. [config file:
+ psPaperSize]
+
+ -level1
+ Generate Level 1 PostScript. The resulting
+ PostScript files will be significantly larger (if
+ they contain images), but will print on Level 1
+ printers. This also converts all images to black
+ and white. [config file: psLevel]
+
+ -enc encoding-name
+ Sets the encoding to use for text output. The
+ encoding-name must be defined with the unicodeMap
+ command (see xpdfrc(5)). This defaults to "Latin1"
+ (which is a built-in encoding). [config file: tex-
+ tEncoding]
+
+ -eol unix | dos | mac
+ Sets the end-of-line convention to use for text
+ output. [config file: textEOL]
+
+ -opw password
+ Specify the owner password for the PDF file. Pro-
+ viding this will bypass all security restrictions.
+
+ -upw password
+ Specify the user password for the PDF file.
+
+ -fullscreen
+ Open xpdf in full-screen mode, useful for presenta-
+ tions.
+
+ -remote name
+ Start/contact xpdf remote server with specified
+ name (see the REMOTE SERVER MODE section below).
+
+ -exec command
+ Execute a command (see the COMMANDS section below)
+ in an xpdf remote server window (with -remote
+ only).
+
+ -reload
+ Reload xpdf remote server window (with -remote
+ only).
+
+ -raise Raise xpdf remote server window (with -remote
+ only).
+
+ -quit Kill xpdf remote server (with -remote only).
+
+ -cmd Print commands as they're executed (useful for
+ debugging). [config file: printCommands]
+
+ -q Don't print any messages or errors. [config file:
+ errQuiet]
+
+ -cfg config-file
+ Read config-file in place of ~/.xpdfrc or the sys-
+ tem-wide config file.
+
+ -v Print copyright and version information.
+
+ -h Print usage information. (-help and --help are
+ equivalent.)
+
+ Several other standard X options and resources will work
+ as expected:
+
+ -display display
+ [X resource: xpdf.display]
+
+ -fg color
+ (-foreground is equivalent.) [X resource:
+ xpdf*Foreground]
+
+ -bg color
+ (-background is equivalent.) [X resource:
+ xpdf*Background]
+
+ -font font
+ (-fn is equivalent.) [X resource: xpdf*fontList]
+
+ The color and font options only affect the user interface
+ elements, not the PDF display (the 'paper').
+
+ The following X resources do not have command line option
+ equivalents:
+
+ xpdf.toolTipEnable
+ Enables (if set to true) or disables (if set to
+ false) the tool-tips on the toolbar buttons.
+
+ xpdf.fullScreenMatteColor
+ Sets the matte color to be used in full-screen
+ mode. The default setting is "black".
+
+ ()
+
+2 CONTROLS
+
+ On-screen controls, at the bottom of the xpdf window
+ left/right arrow buttons
+ Move to the previous/next page.
+
+ double left/right arrow buttons
+ Move backward or forward by ten pages.
+
+ dashed left/right arrow buttons
+ Move backward or forward along the history path.
+
+ 'Page' entry box
+ Move to a specific page number. Click in the box
+ to activate it, type the page number, then hit
+ return.
+
+ zoom popup menu
+ Change the zoom factor (see the description of the
+ -z option above).
+
+ binoculars button
+ Find a text string.
+
+ 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'.
+
+ '?' button
+ Bring up the 'about xpdf' window.
+
+ link info
+ The space between the '?' and 'Quit' buttons is
+ used to show the URL or external file name when the
+ mouse is over a link.
+
+ 'Quit' button
+ Quit xpdf.
+
+ Menu
+ Pressing the right mouse button will post a popup menu
+ with the following commands:
+
+ Open...
+ Open a new PDF file via a file requester.
+
+ Open in new window...
+ Create a new window and open a new PDF file via a
+ file requester.
+
+ Reload 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.
+
+ Save as...
+ Save the current file via a file requester.
+
+ Continuous view
+ Toggles between single page and continuous view
+ modes.
+
+ Rotate counterclockwise
+ Rotate the page 90 degrees counterclockwise.
+
+ Rotate clockwise
+ Rotate the page 90 degrees clockwise. The two
+ rotate commands are intended primarily for PDF
+ files where the rotation isn't correctly specified
+ in the file.
+
+ Zoom to selection
+ Zoom in to the currently selected rectangle.
+
+ Close Close the current window. If this is the only open
+ window, the document is closed, but the window is
+ left open (i.e., this menu command won't quit
+ xpdf).
+
+ Quit Quit xpdf.
+
+ Outline
+ If the PDF contains an outline (a.k.a., bookmarks), there
+ will be an outline pane on the left side of the window.
+ The width of the outline pane is adjustable with a verti-
+ cal split bar via the knob near its bottom end.
+
+ Text selection
+ Dragging the mouse with the left button held down will
+ highlight an arbitrary rectangle. Any text inside this
+ rectangle will be copied to the X selection buffer.
+
+ Links
+ Clicking on a hyperlink will jump to the link's destina-
+ tion. 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 command (see the WEB
+ BROWSERS section below).
+
+ Panning
+ Dragging the mouse with the middle button held down pans
+ the window.
+
+ Key bindings
+ o Open a new PDF file via a file requester.
+
+ r 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-L
+ Redraw the current page.
+
+ control-W
+ Close the current window.
+
+ f or control-F
+ Find a text string.
+
+ control-G
+ Find next occurrence.
+
+ control-P
+ Print.
+
+ n Move to the next page. Scrolls to the top of the
+ page, unless scroll lock is turned on.
+
+ p Move to the previous page. Scrolls to the top of
+ the page, unless scroll lock is turned on.
+
+ <Space> or <PageDown> or <Next>
+ Scroll down on the current page; if already at bot-
+ tom, move to next page.
+
+ <Backspace> or <Delete> or <PageUp> or <Previous>
+ Scroll up on the current page; if already at top,
+ move to previous page.
+
+ v Move forward along the history path.
+
+ b Move backward along the history path.
+
+ <Home> Scroll to top of current page.
+
+ <End> Scroll to bottom of current page.
+
+ control-<Home>
+ Scroll to first page of document.
+
+ control-<End>
+ Scroll to last page of document.
+
+ arrows Scroll the current page.
+
+ g Activate the page number text field ("goto page").
+
+ 0 Set the zoom factor to 125%.
+
+ + Zoom in (increment the zoom factor by 1).
+
+ - Zoom out (decrement the zoom factor by 1).
+
+ z Set the zoom factor to 'page' (fit page to window).
+
+ w Set the zoom factor to 'width' (fit page width to
+ window).
+
+ alt-F Toggle full-screen mode.
+
+ q Quit xpdf.
+
+ ()
+
+2 WEB_BROWSERS
+
+ If you want to run xpdf automatically from netscape or
+ mosaic (and probably other browsers) when you click on a
+ link to a PDF file, you need to edit (or create) the files
+ .mime.types and .mailcap in your home directory. In
+ .mime.types add the line:
+
+ application/pdf pdf
+
+ In .mailcap add the lines:
+
+ # Use xpdf to view PDF files.
+ application/pdf; xpdf -q %s
+
+ Make sure that xpdf is on your executable search path.
+
+ When you click on a URL link in a PDF file, xpdf will exe-
+ cute the command specified by the urlCommand config file
+ option, replacing an occurrence of '%s' with the URL. For
+ example, to call netscape with the URL, add this line to
+ your config file:
+
+ urlCommand "netscape -remote 'openURL(%s)'"
+
+ ()
+
+2 COMMANDS
+
+ Xpdf's key and mouse bindings are user-configurable, using
+ the bind and unbind options 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.
+
+ Available Commands
+ The following commands are supported:
+
+ gotoPage(page)
+ Go to the specified page.
+
+ gotoPageNoScroll(page)
+ Go to the specified page, with the current relative
+ scroll position.
+
+ gotoDest(dest)
+ Go to a named destination.
+
+ gotoLastPage
+ Go to the last page in the PDF file.
+
+ gotoLastPageNoScroll
+ Go to the last page in the PDF file, with the cur-
+ rent relative scroll position.
+
+ nextPage
+ Go to the next page.
+
+ nextPageNoScroll
+ Go to the next page, with the current relative
+ scroll position.
+
+ prevPage
+ Go to the previous page.
+
+ prevPageNoScroll
+ Go to the previous page, with the current relative
+ scroll position.
+
+ pageUp Scroll up by one screenful.
+
+ pageDown
+ Scroll down by one screenful.
+
+ scrollLeft(n)
+ Scroll left by n pixels.
+
+ scrollRight(n)
+ Scroll right by n pixels.
+
+ scrollUp(n)
+ Scroll up by n pixels.
+
+ scrollDown(n)
+ Scroll down by n pixels.
+
+ scrollUpPrevPage(n)
+ Scroll up by n pixels, moving to the previous page
+ if appropriate.
+
+ scrollDownPrevPage(n)
+ Scroll down by n pixels, moving to the next page if
+ appropriate.
+
+ scrollToTopEdge
+ Scroll to the top edge of the current page, with no
+ horizontal movement.
+
+ scrollToBottomEdge
+ Scroll to the bottom edge of the current page, with
+ no horizontal movement.
+
+ scrollToLeftEdge
+ 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 movement.
+
+ scrollToTopLeft
+ Scroll to the top-left corner of the current page.
+
+ scrollToBottomRight
+ Scroll to the bottom-right corner of the current
+ page.
+
+ goForward
+ Move forward along the history path.
+
+ goBackward
+ Move backward along the history path.
+
+ zoomPercent(z)
+ Set the zoom factor to z%.
+
+ zoomFitPage
+ Set the zoom factor to fit-page.
+
+ zoomFitWidth
+ Set the zoom factor to fit-width.
+
+ zoomIn Zoom in - go to the next higher zoom factor.
+
+ zoomOut
+ Zoom out - go the next lower zoom factor.
+
+ continuousMode
+ Go to continuous view mode.
+
+ singlePageMode
+ Go to single-page view mode.
+
+ toggleContinuousMode
+ Toggle between continuous and single page view
+ modes.
+
+ fullScreenMode
+ Go to full-screen mode.
+
+ windowMode
+ Go to window (non-full-screen) mode.
+
+ toggleFullScreenMode
+ Toggle between full-screen and window modes.
+
+ open Open a PDF file in this window, using the open
+ dialog.
+
+ openInNewWin
+ Open a PDF file in a new window, using the open
+ dialog.
+
+ openFile(file)
+ Open a specified PDF file in this window.
+
+ openFileInNewWin(file)
+ Open a specified PDF file in a new window.
+
+ openFileAtDest(file,dest)
+ Open a specified PDF file in this window and go to
+ a named destination.
+
+ openFileAtDestInNewWin(file,dest)
+ Open a specified PDF file in a new window and go to
+ a named destination.
+
+ reload Reload the current PDF file.
+
+ redraw Redraw the window.
+
+ raise Raise the window to the front.
+
+ closeWindow
+ Close the window.
+
+ run(external-command-string)
+ Run an external command. The following escapes are
+ allowed in the command string:
+
+ %f => PDF file name (or an empty string if no
+ file is open)
+ %b => PDF file base name, i.e., file name minus
+ the extension (or an empty string if no
+ file is open)
+ %u => link URL (or an empty string if not over
+ a URL link)
+ %x => selection upper-left x coordinate
+ (or 0 if there is no selection)
+ %y => selection upper-left y coordinate
+ (or 0 if there is no selection)
+ %X => selection lower-right x coordinate
+ (or 0 if there is no selection)
+ %Y => selection lower-right y coordinate
+ (or 0 if there is no selection)
+ %% => %
+
+ openOutline
+ Open the outline pane.
+
+ closeOutline
+ Close the outline pane.
+
+ toggleOutline
+ Toggle the outline pane between open and closed.
+
+ scrollOutlineDown(n)
+ Scroll the outline down by n increments.
+
+ scrollOutlineUp(n)
+ Scroll the outline up by n increments.
+
+ focusToDocWin
+ Set the keyboard focus to the main document window.
+
+ focusToPageNum
+ Set the keyboard focus to the page number text box.
+
+ find Open the 'find' dialog.
+
+ findNext
+ Finds the next occurrence of the search string (no
+ dialog).
+
+ print Open the 'print' dialog.
+
+ about Open the 'about' dialog.
+
+ quit Quit from xpdf.
+
+ The following commands depend on the current mouse posi-
+ tion:
+
+ startSelection
+ Start a selection, which will be extended as the
+ mouse moves.
+
+ endSelection
+ End a selection.
+
+ startPan
+ Start a pan, which will scroll the document as the
+ mouse moves
+
+ endPan End a pan.
+
+ postPopupMenu
+ Display the popup menu.
+
+ followLink
+ Follow a hyperlink (does nothing if the mouse is
+ not over a link).
+
+ followLinkInNewWin
+ Follow a hyperlink, opening PDF files in a new win-
+ dow (does nothing if the mouse is not over a link).
+ For links to non-PDF files, this command is identi-
+ cal to followLink.
+
+ followLinkNoSel
+ Same as followLink, but does nothing if there is a
+ non-empty selection. (This is useful as a mouse
+ button binding.)
+
+ followLinkInNewWinNoSel
+ Same as followLinkInNewWin, but does nothing if
+ there is a non-empty selection. (This is useful as
+ a mouse button binding.)
+
+ Default Bindings
+ The default mouse bindings are as follows:
+
+ bind mousePress1 any startSelection
+ bind mouseRelease1 any endSelection followLinkNoSel
+ bind mousePress2 any startPan
+ bind mouseRelease2 any endPan
+ bind mousePress3 any postPopupMenu
+ bind mousePress4 any scrollUpPrevPage(16)
+ bind mousePress5 any scrollDownNextPage(16)
+ bind mousePress6 any scrollLeft(16)
+ bind mousePress7 any scrollRight(16)
+
+ The default key bindings are as follows:
+
+ bind ctrl-home any gotoPage(1)
+ bind home any scrollToTopLeft
+ bind ctrl-end any gotoLastPage
+ bind end any scrollToBottomRight
+ bind pgup any pageUp
+ bind backspace any pageUp
+ bind delete any pageUp
+ bind pgdn any pageDown
+ bind space any pageDown
+ bind left any scrollLeft(16)
+ bind right any scrollRight(16)
+ bind up any scrollUp(16)
+ bind down any scrollDown(16)
+ bind o any open
+ bind O any open
+ bind r any reload
+ bind R any reload
+ bind f any find
+ bind F any find
+ bind ctrl-f any find
+ bind ctrl-g any findNext
+ bind ctrl-p any print
+ bind n scrLockOff nextPage
+ bind N scrLockOff nextPage
+ bind n scrLockOn nextPageNoScroll
+ bind N scrLockOn nextPageNoScroll
+ bind p scrLockOff prevPage
+ bind P scrLockOff prevPage
+ bind p scrLockOn prevPageNoScroll
+ bind P scrLockOn prevPageNoScroll
+ bind v any goForward
+ bind b any goBackward
+ bind g any focusToPageNum
+ bind 0 any zoomPercent(125)
+ bind + any zoomIn
+ bind - any zoomOut
+ bind z any zoomFitPage
+ bind w any zoomFitWidth
+ bind alt-f any toggleFullScreenMode
+ bind ctrl-l any redraw
+ bind ctrl-w any closeWindow
+ bind ? any about
+ bind q any quit
+ bind Q any quit
+
+ Previous versions of xpdf included a "viKeys" X resource.
+ It is no longer available, but the following bindings are
+ equivalent:
+
+ bind h any scrollLeft(16)
+ bind l any scrollRight(16)
+ bind k any scrollUp(16)
+ bind j any scrollDown(16)
+
+ ()
+
+2 REMOTE_SERVER_MODE
+
+ Xpdf can be started in remote server mode by specifying a
+ server name (in addition to the file name and page num-
+ ber). For example:
+
+ xpdf -remote myServer file.pdf
+
+ If there is currently no xpdf running in server mode with
+ the name 'myServer', a new xpdf window will be opened. If
+ another command:
+
+ xpdf -remote myServer another.pdf 9
+
+ is issued, a new copy of xpdf will not be started.
+ Instead, the first xpdf (the server) will load another.pdf
+ and display page nine. If the file name is the same:
+
+ xpdf -remote myServer another.pdf 4
+
+ the xpdf server will simply display the specified page.
+
+ The -raise option tells the server to raise its window; it
+ can be specified with or without a file name and page num-
+ ber.
+
+ The -quit option tells the server to close its window and
+ exit.
+
+ ()
+
+2 XIT_CODE
+
+ The Xpdf tools use the following exit codes:
+
+ 0 No error.
+
+ 1 Error opening a PDF file.
+
+ 2 Error opening an output file.
+
+ 3 Error related to PDF permissions.
+
+ 99 Other error.
+
+ ()
+
+2 AUTHOR
+
+ The xpdf software and documentation are copyright
+ 1996-2007 Glyph & Cog, LLC.
+
+ ()
+
+2 SEE_ALSO
+
+ pdftops(1), pdftotext(1), pdfinfo(1), pdffonts(1),
+ pdftoppm(1), pdfimages(1), xpdfrc(5)
+ http://www.foolabs.com/xpdf/
+
+ ()
+
diff --git a/Build/source/libs/xpdf/xpdf-3.02/doc/xpdfrc.5 b/Build/source/libs/xpdf/xpdf-3.02/doc/xpdfrc.5
new file mode 100644
index 00000000000..4e1545527c9
--- /dev/null
+++ b/Build/source/libs/xpdf/xpdf-3.02/doc/xpdfrc.5
@@ -0,0 +1,617 @@
+.\" Copyright 2002-2007 Glyph & Cog, LLC
+.TH xpdfrc 5 "27 February 2007"
+.SH NAME
+xpdfrc \- configuration file for Xpdf tools (version 3.02)
+.SH DESCRIPTION
+All of the Xpdf tools read a single configuration file. If you have a
+.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 ,
+if it exists. (This is its default location; depending on build
+options, it may be placed elsewhere.) On Win32 systems, the
+.I xpdfrc
+file should be placed in the same directory as the executables.
+.PP
+The xpdfrc file consists of a series of configuration options, one
+per line. Blank lines and lines starting with a \'#' (comments) are
+ignored.
+.PP
+The following sections list all of the configuration options, sorted
+into functional groups. There is an examples section at the end.
+.SH INCLUDE FILES
+.TP
+.BI include " config\-file"
+Includes the specified config file. The effect of this is equivalent
+to inserting the contents of
+.I config\-file
+directly into the parent config file in place of the
+.I include
+command. Config files can be nested arbitrarily deeply.
+.SH CHARACTER MAPPING
+.TP
+.BI nameToUnicode " map\-file"
+Specifies a file with the mapping from character names to Unicode.
+This is used to handle PDF fonts that have valid encodings but no
+ToUnicode entry. Each line of a nameToUnicode file looks like this:
+
+.I " " hex\-string name
+
+The
+.I hex\-string
+is the Unicode (UCS-2) character index, and
+.I name
+is the corresponding character name. Multiple nameToUnicode files can
+be used; if a character name is given more than once, the code in the
+last specified file is used. There is a built-in default
+nameToUnicode table with all of Adobe's standard character names.
+.TP
+.BI cidToUnicode " registry\-ordering map\-file"
+Specifies the file with the mapping from character collection to
+Unicode. Each line of a cidToUnicode file represents one character:
+
+.I " " hex\-string
+
+The
+.I hex\-string
+is the Unicode (UCS-2) index for that character. The first line maps
+CID 0, the second line CID 1, etc. File size is determined by size of
+the character collection. Only one file is allowed per character
+collection; the last specified file is used. There are no built-in
+cidToUnicode mappings.
+.TP
+.BI unicodeToUnicode " font\-name\-substring map\-file"
+This is used to work around PDF fonts which have incorrect Unicode
+information. It specifies a file which maps from the given
+(incorrect) Unicode indexes to the correct ones. The mapping will be
+used for any font whose name contains
+.IR font\-name\-substring .
+Each line of a unicodeToUnicode file represents one Unicode character:
+
+.RI " " in\-hex " " out\-hex1 " " out\-hex2 " ..."
+
+The
+.I in\-hex
+field is an input (incorrect) Unicode index, and the rest of the
+fields are one or more output (correct) Unicode indexes. Each
+occurrence of
+.I in\-hex
+will be converted to the specified output sequence.
+.TP
+.BI unicodeMap " encoding\-name map\-file"
+Specifies the file with mapping from Unicode to
+.IR encoding\-name .
+These encodings are used for X display fonts and 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
+encoding:
+.nf
+
+.I " " in\-start\-hex in\-end\-hex out\-start\-hex
+
+.fi
+Entries for single characters can be abbreviated to:
+.nf
+
+.I " " in\-hex out\-hex
+
+.fi
+The
+.I in\-start\-hex
+and
+.I in\-end\-hex
+fields (or the single
+.I in\-hex
+field) specify the Unicode range. The
+.I out\-start\-hex
+field (or the
+.I out\-hex
+field) specifies the start of the output encoding range. The length
+of the
+.I out\-start\-hex
+(or
+.IR 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
+.IR Latin1 ,
+.IR ASCII7 ,
+.IR Symbol ,
+.IR ZapfDingbats ,
+.IR UTF-8 ,
+and
+.I UCS-2
+encodings are predefined.
+.TP
+.BI cMapDir " registry\-ordering dir"
+Specifies a search directory,
+.IR dir ,
+for CMaps for the
+.I registry\-ordering
+character collection. There can be multiple directories for a
+particular collection. There are no default CMap directories.
+.TP
+.BI toUnicodeDir " dir"
+Specifies a search directory,
+.IR dir ,
+for ToUnicode CMaps. There can be multiple ToUnicode directories.
+There are no default ToUnicode directories.
+.SH DISPLAY FONTS
+.TP
+.BI displayFontT1 " PDF\-font\-name T1\-file"
+Maps a PDF font,
+.IR PDF\-font\-name ,
+to a Type 1 font for display. The Type 1 font file,
+.IR T1\-file ,
+should be a standard .pfa or .pfb file.
+.TP
+.BI displayFontTT " PDF\-font\-name TT\-file"
+Maps a PDF font,
+.IR PDF\-font\-name ,
+to a TrueType font for display. The TrueType font file,
+.IR TT\-file ,
+should be a standard .ttf file.
+.TP
+.BI displayNamedCIDFontT1 " PDF\-font\-name T1\-file"
+Maps a specific PDF CID (16-bit) font,
+.IR PDF\-font\-name ,
+to a CID font (16-bit PostScript font), for display. There are no
+default CID font mappings.
+.TP
+.BI displayCIDFontT1 " registry\-ordering T1\-file"
+Maps the
+.I registry\-ordering
+character collection to a CID font (16-bit PostScript font), for
+display. This mapping is used if the font name doesn't match any of
+the fonts declared with displayNamedCIDFont* commands. There are no
+default CID font mappings.
+.TP
+.BI displayNamedCIDFontTT " PDF\-font\-name TT\-file"
+Maps a specific PDF CID (16-bit) font,
+.IR PDF\-font\-name ,
+to a (16-bit) TrueType font, for display. There are no default CID
+font mappings.
+.TP
+.BI displayCIDFontTT " registry\-ordering TT\-file"
+Maps the
+.I registry\-ordering
+character collection to a (16-bit) TrueType font, for display. This
+mapping is used if the font name doesn't match any of the fonts
+declared with displayNamedCIDFont* commands. There are no default CID
+font mappings.
+.TP
+.BI fontDir " dir"
+Specifies a search directory for external font files. There can be
+multiple fontDir directories. If a PDF file uses a font but doesn't
+embed it, these directories will be searched for a matching font file.
+These fonts are used by both xpdf (for display) and pdftops (for
+embedding in the generated PostScript). Type 1 fonts must have a
+suffix of ".pfa", ".pfb", ".ps", or no suffix at all. TrueType fonts
+must have a ".ttf" suffix. Other files in these directories will be
+ignored. There are no default fontDir directories.
+.SH POSTSCRIPT CONTROL
+.TP
+.BI psPaperSize " width(pts) height(pts)"
+Sets the paper size for PostScript output. The
+.I width
+and
+.I height
+parameters give the paper size in PostScript points (1 point = 1/72
+inch).
+.TP
+.BR psPaperSize " letter | legal | A4 | A3 | match"
+Sets the paper size for PostScript output to a standard size. The
+default paper size is set when xpdf and pdftops are built, typically
+to "letter" or "A4". This can also be set to "match", which will set
+the paper size to match the size specified in the PDF file.
+.TP
+.BR psImageableArea " llx lly urx ury"
+Sets the imageable area for PostScript output. The four integers are
+the coordinates of the lower-left and upper-right corners of the
+imageable region, specified in points (with the origin being the
+lower-left corner of the paper). This defaults to the full paper
+size; the psPaperSize option will reset the imageable area
+coordinates.
+.TP
+.BR psCrop " yes | no"
+If set to "yes", PostScript output is cropped to the CropBox specified
+in the PDF file; otherwise no cropping is done. This defaults to
+"yes".
+.TP
+.BR psExpandSmaller " yes | no"
+If set to "yes", PDF pages smaller than the PostScript imageable area
+are expanded to fill the imageable area. Otherwise, no scalling is
+done on smaller pages. This defaults to "no".
+.TP
+.BR psShrinkLarger " yes | no"
+If set to yes, PDF pages larger than the PostScript imageable area are
+shrunk to fit the imageable area. Otherwise, no scaling is done on
+larger pages. This defaults to "yes".
+.TP
+.BR psCenter " yes | no"
+If set to yes, PDF pages smaller than the PostScript imageable area
+(after any scaling) are centered in the imageable area. Otherwise,
+they are aligned at the lower-left corner of the imageable area. This
+defaults to "yes".
+.TP
+.BR psDuplex " yes | no"
+If set to "yes", the generated PostScript will set the "Duplex"
+pagedevice entry. This tells duplex-capable printers to enable
+duplexing. This defaults to "no".
+.TP
+.BR psLevel " level1 | level1sep | level2 | level2sep | level3 | level3Sep"
+Sets the PostScript level to generate. This defaults to "level2".
+.TP
+.BI psFont " PDF\-font\-name PS\-font\-name"
+When the
+.I PDF\-font\-name
+font is used in a PDF file, it will be translated to the PostScript
+font
+.IR PS\-font\-name ,
+which is assumed to be resident in the printer. Typically,
+.I PDF\-font\-name
+and
+.I PS\-font\-name
+are the same. By default, only the Base-14 fonts are assumed to be
+resident.
+.TP
+.BI psNamedFont16 " PDF\-font\-name wMode PS\-font\-name encoding"
+When the 16-bit font
+.I PDF\-font\-name
+is used in a PDF file with the
+.I wMode
+writing mode and is not embedded, the
+.I PS\-font\-name
+font is substituted for it. The writing mode must be either \'H' for
+horizontal or \'V' for vertical. The
+.I PS\-font\-name
+font is assumed to be resident in the printer and to use the specified
+encoding (which must have been defined with the unicodeMap command).
+.TP
+.BI psFont16 " registry\-ordering wMode PS\-font\-name encoding"
+When a 16-bit font using the
+.I registry\-ordering
+character collection and
+.I wMode
+writing mode is not embedded and does not match any of the fonts
+declared in psNamedFont16 commands, the
+.I PS\-font\-name
+font is substituted for it. The writing mode must be either \'H' for
+horizontal or \'V' for vertical. The
+.I PS\-font\-name
+font is assumed to be resident in the printer and to use the specified
+writing mode and encoding (which must have been defined with the
+unicodeMap command).
+.TP
+.BR psEmbedType1Fonts " yes | no"
+If set to "no", prevents embedding of Type 1 fonts in generated
+PostScript. This defaults to "yes".
+.TP
+.BR psEmbedTrueTypeFonts " yes | no"
+If set to "no", prevents embedding of TrueType fonts in generated
+PostScript. This defaults to "yes".
+.TP
+.BR psEmbedCIDTrueTypeFonts " yes | no"
+If set to "no", prevents embedding of CID TrueType fonts in generated
+PostScript. For Level 3 PostScript, this generates a CID font, for
+lower levels it generates a non-CID composite font.
+.TP
+.BR psEmbedCIDPostScriptFonts " yes | no"
+If set to "no", prevents embedding of CID PostScript fonts in
+generated PostScript. For Level 3 PostScript, this generates a CID
+font, for lower levels it generates a non-CID composite font.
+.TP
+.BR psPreload " yes | no"
+If set to "yes", PDF forms are converted to PS procedures, and image
+data is preloaded. This uses more memory in the PostScript
+interpreter, but generates significantly smaller PS files in
+situations where, e.g., the same image is drawn on every page of a
+long document. This defaults to "no".
+.TP
+.BR psOPI " yes | no"
+If set to "yes", generates PostScript OPI comments for all images and
+forms which have OPI information. This option is only available if
+the Xpdf tools were compiled with OPI support. This defaults to "no".
+.TP
+.BR psASCIIHex " yes | no"
+If set to "yes", the ASCIIHexEncode filter will be used instead of
+ASCII85Encode for binary data. 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.
+.TP
+.BI fontDir " dir"
+See the description above, in the DISPLAY FONTS section.
+.SH TEXT CONTROL
+.TP
+.BI textEncoding " encoding\-name"
+Sets the encoding to use for text output. (This can be overridden
+with the "-enc" switch on the command line.) The
+.I encoding\-name
+must be defined with the unicodeMap command (see above). This
+defaults to "Latin1".
+.TP
+.BR textEOL " unix | dos | mac"
+Sets the end-of-line convention to use for text output. The options
+are:
+.nf
+
+ unix = LF
+ dos = CR+LF
+ mac = CR
+
+.fi
+(This can be overridden with the "-eol" switch on the command line.)
+The default value is based on the OS where xpdf and pdftotext were
+built.
+.TP
+.BR textPageBreaks " yes | no"
+If set to "yes", text extraction will insert page breaks (form feed
+characters) between pages. This defaults to "yes".
+.TP
+.BR textKeepTinyChars " yes | no"
+If set to "yes", text extraction will keep all characters. If set to
+"no", text extraction will discard tiny (smaller than 3 point)
+characters after the first 50000 per page, avoiding extremely slow run
+times for PDF files that use special fonts to do shading or
+cross-hatching. This defaults to "no".
+.SH MISCELLANEOUS SETTINGS
+.TP
+.BR initialZoom " \fIpercentage\fR | page | width"
+Sets 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.
+.TP
+.BR continuousView " yes | no"
+If set to "yes", xpdf will start in continuous view mode, i.e., with
+one vertical screoll bar for the whole document. This defaults to
+"no".
+.TP
+.BR enableT1lib " yes | no"
+Enables or disables use of t1lib (a Type 1 font rasterizer). This is
+only relevant if the Xpdf tools were built with t1lib support.
+("enableT1lib" replaces the old "t1libControl" option.) This option
+defaults to "yes".
+.TP
+.BR enableFreeType " yes | no"
+Enables or disables use of FreeType (a TrueType / Type 1 font
+rasterizer). This is only relevant if the Xpdf tools were built with
+FreeType support. ("enableFreeType" replaces the old
+"freetypeControl" option.) This option defaults to "yes".
+.TP
+.BR antialias " yes | no"
+Enables or disables font anti-aliasing in the PDF rasterizer. This
+option affects all font rasterizers. ("antialias" replaces the
+anti-aliasing control provided by the old "t1libControl" and
+"freetypeControl" options.) This default to "yes".
+.TP
+.BR vectorAntialias " yes | no"
+Enables or disables anti-aliasing of vector graphics in the PDF
+rasterizer. This defaults to "yes".
+.TP
+.BR strokeAdjust " yes | no"
+Enables or disables stroke adjustment. This defaults to "yes".
+.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
+dithering, clustered-dot dithering (with a round dot and 45-degree
+screen angle), and stochastic clustered-dot dithering. By default,
+"stochasticClustered" is used for resolutions of 300 dpi and higher,
+and "dispersed" is used for resolutions lower then 300 dpi.
+.TP
+.BI screenSize " integer"
+Sets the size of the (square) halftone screen threshold matrix. By
+default, this is 4 for dispersed-dot dithering, 10 for clustered-dot
+dithering, and 100 for stochastic clustered-dot dithering.
+.TP
+.BI screenDotRadius " integer"
+Sets the halftone screen dot radius. This is only used when
+screenType is set to stochasticClustered, and it defaults to 2. In
+clustered-dot mode, the dot radius is half of the screen size.
+Dispersed-dot dithering doesn't have a dot radius.
+.TP
+.BI screenGamma " float"
+Sets the halftone screen gamma correction parameter. Gamma values
+greater than 1 make the output brighter; gamma values less than 1 make
+it darker. The default value is 1.
+.TP
+.BI screenBlackThreshold " float"
+When halftoning, all values below this threshold are forced to solid
+black. This parameter is a floating point value between 0 (black) and
+1 (white). The default value is 0.
+.TP
+.BI screenWhiteThreshold " float"
+When halftoning, all values above this threshold are forced to solid
+white. This parameter is a floating point value between 0 (black) and
+1 (white). The default value is 1.
+.TP
+.BI urlCommand " command"
+Sets the command executed when you click on a URL link. The string
+"%s" will be replaced with the URL. (See the example below.) This
+has no default value.
+.TP
+.BI movieCommand " command"
+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 mapNumericCharNames " yes | no"
+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 gibberish --
+there is no way for Xpdf to tell. This defaults to "yes".
+.TP
+.BI 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. 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".
+.TP
+.BI bind " modifiers-key context command ..."
+Add a key or mouse button binding.
+.I Modifiers
+can be zero or more of:
+.nf
+
+ shift-
+ ctrl-
+ alt-
+
+.fi
+.I Key
+can be a regular ASCII character, or any one of:
+.nf
+
+ space
+ tab
+ return
+ enter
+ backspace
+ insert
+ delete
+ home
+ end
+ pgup
+ pgdn
+ left / right / up / down (arrow keys)
+ f1 .. f35 (function keys)
+ mousePress1 .. mousePress7 (mouse buttons)
+ mouseRelease1 .. mouseRelease7 (mouse buttons)
+
+.fi
+.I Context
+is either "any" or a comma-separated combination of:
+.nf
+
+ fullScreen / window (full screen mode on/off)
+ continuous / singlePage (continuous mode on/off)
+ overLink / offLink (mouse over link or not)
+ scrLockOn / scrLockOff (scroll lock on/off)
+
+.fi
+The context string can include only one of each pair in the above
+list.
+
+.I Command
+is an Xpdf command (see the COMMANDS section of the
+.BR xpdf (1)
+man page for details). Multiple commands are separated by whitespace.
+
+The bind command replaces any existing binding, but only if it was
+defined for the exact same modifiers, key, and context. All tokens
+(modifiers, key, context, commands) are case-sensitive.
+
+Example key bindings:
+.nf
+
+ # bind ctrl-a in any context to the nextPage
+ # command
+ bind ctrl-a any nextPage
+
+ # bind uppercase B, when in continuous mode
+ # with scroll lock on, to the reload command
+ # followed by the prevPage command
+ bind B continuous,scrLockOn reload prevPage
+
+.fi
+See the
+.BR xpdf (1)
+man page for more examples.
+.TP
+.BI unbind " modifiers-key context"
+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 printCommands " yes | no"
+If set to "yes", drawing commands are printed as they're executed
+(useful for debugging). This defaults to "no".
+.TP
+.BI errQuiet " yes | no"
+If set to "yes", this suppresses all error and warning messages from
+all of the Xpdf tools. This defaults to "no".
+.SH EXAMPLES
+The following is a sample xpdfrc file.
+.nf
+
+# from the Thai support package
+nameToUnicode /usr/local/share/xpdf/Thai.nameToUnicode
+
+# from the Japanese support package
+cidToUnicode Adobe-Japan1 /usr/local/share/xpdf/Adobe-Japan1.cidToUnicode
+unicodeMap JISX0208 /usr/local/share/xpdf/JISX0208.unicodeMap
+cMapDir Adobe-Japan1 /usr/local/share/xpdf/cmap/Adobe-Japan1
+
+# use the Base-14 Type 1 fonts from ghostscript
+displayFontT1 Times-Roman /usr/local/share/ghostscript/fonts/n021003l.pfb
+displayFontT1 Times-Italic /usr/local/share/ghostscript/fonts/n021023l.pfb
+displayFontT1 Times-Bold /usr/local/share/ghostscript/fonts/n021004l.pfb
+displayFontT1 Times-BoldItalic /usr/local/share/ghostscript/fonts/n021024l.pfb
+displayFontT1 Helvetica /usr/local/share/ghostscript/fonts/n019003l.pfb
+displayFontT1 Helvetica-Oblique /usr/local/share/ghostscript/fonts/n019023l.pfb
+displayFontT1 Helvetica-Bold /usr/local/share/ghostscript/fonts/n019004l.pfb
+displayFontT1 Helvetica-BoldOblique /usr/local/share/ghostscript/fonts/n019024l.pfb
+displayFontT1 Courier /usr/local/share/ghostscript/fonts/n022003l.pfb
+displayFontT1 Courier-Oblique /usr/local/share/ghostscript/fonts/n022023l.pfb
+displayFontT1 Courier-Bold /usr/local/share/ghostscript/fonts/n022004l.pfb
+displayFontT1 Courier-BoldOblique /usr/local/share/ghostscript/fonts/n022024l.pfb
+displayFontT1 Symbol /usr/local/share/ghostscript/fonts/s050000l.pfb
+displayFontT1 ZapfDingbats /usr/local/share/ghostscript/fonts/d050000l.pfb
+
+# use the Bakoma Type 1 fonts
+# (this assumes they happen to be installed in /usr/local/fonts/bakoma)
+fontDir /usr/local/fonts/bakoma
+
+# set some PostScript options
+psPaperSize letter
+psDuplex no
+psLevel level2
+psEmbedType1Fonts yes
+psEmbedTrueTypeFonts yes
+psFile "| lpr -Pprinter5"
+
+# assume that the PostScript printer has the Univers and
+# Univers-Bold fonts
+psFont Univers Univers
+psFont Univers-Bold Univers-Bold
+
+# set the text output options
+textEncoding UTF-8
+textEOL unix
+
+# misc options
+t1libControl low
+freetypeControl low
+urlCommand "netscape -remote 'openURL(%s)'"
+
+.fi
+.SH FILES
+.TP
+.B /usr/local/etc/xpdfrc
+This is the default location for the system-wide configuration file.
+Depending on build options, it may be placed elsewhere.
+.TP
+.B $HOME/.xpdfrc
+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-2007 Glyph &
+Cog, LLC.
+.SH "SEE ALSO"
+.BR xpdf (1),
+.BR pdftops (1),
+.BR pdftotext (1),
+.BR pdfinfo (1),
+.BR pdftoppm (1),
+.BR pdfimages (1)
+.br
+.B http://www.foolabs.com/xpdf/
diff --git a/Build/source/libs/xpdf/xpdf-3.02/doc/xpdfrc.cat b/Build/source/libs/xpdf/xpdf-3.02/doc/xpdfrc.cat
new file mode 100644
index 00000000000..3201f091c5a
--- /dev/null
+++ b/Build/source/libs/xpdf/xpdf-3.02/doc/xpdfrc.cat
@@ -0,0 +1,614 @@
+xpdfrc(5) xpdfrc(5)
+
+
+
+NAME
+ xpdfrc - configuration file for Xpdf tools (version 3.02)
+
+DESCRIPTION
+ All of the Xpdf tools read a single configuration file.
+ If you have a .xpdfrc file in your home directory, it will
+ be read. Otherwise, a system-wide configuration file will
+ be read from /usr/local/etc/xpdfrc, if it exists. (This
+ is its default location; depending on build options, it
+ may be placed elsewhere.) On Win32 systems, the xpdfrc
+ file should be placed in the same directory as the exe-
+ cutables.
+
+ The xpdfrc file consists of a series of configuration
+ options, one per line. Blank lines and lines starting
+ with a '#' (comments) are ignored.
+
+ The following sections list all of the configuration
+ options, sorted into functional groups. There is an exam-
+ ples section at the end.
+
+INCLUDE FILES
+ include config-file
+ Includes the specified config file. The effect of
+ this is equivalent to inserting the contents of
+ config-file directly into the parent config file in
+ place of the include command. Config files can be
+ nested arbitrarily deeply.
+
+CHARACTER MAPPING
+ nameToUnicode map-file
+ Specifies a file with the mapping from character
+ names to Unicode. This is used to handle PDF fonts
+ that have valid encodings but no ToUnicode entry.
+ Each line of a nameToUnicode file looks like this:
+
+ hex-string name
+
+ The hex-string is the Unicode (UCS-2) character
+ index, and name is the corresponding character
+ name. Multiple nameToUnicode files can be used; if
+ a character name is given more than once, the code
+ in the last specified file is used. There is a
+ built-in default nameToUnicode table with all of
+ Adobe's standard character names.
+
+ cidToUnicode registry-ordering map-file
+ Specifies the file with the mapping from character
+ collection to Unicode. Each line of a cidToUnicode
+ file represents one character:
+
+ hex-string
+
+ The hex-string is the Unicode (UCS-2) index for
+ that character. The first line maps CID 0, the
+ second line CID 1, etc. File size is determined by
+ size of the character collection. Only one file is
+ allowed per character collection; the last speci-
+ fied file is used. There are no built-in cidToUni-
+ code mappings.
+
+ unicodeToUnicode font-name-substring map-file
+ This is used to work around PDF fonts which have
+ incorrect Unicode information. It specifies a file
+ which maps from the given (incorrect) Unicode
+ indexes to the correct ones. The mapping will be
+ used for any font whose name contains
+ font-name-substring. Each line of a unicodeToUni-
+ code file represents one Unicode character:
+
+ in-hex out-hex1 out-hex2 ...
+
+ The in-hex field is an input (incorrect) Unicode
+ index, and the rest of the fields are one or more
+ output (correct) Unicode indexes. Each occurrence
+ of in-hex will be converted to the specified output
+ sequence.
+
+ unicodeMap encoding-name map-file
+ Specifies the file with mapping from Unicode to
+ encoding-name. These encodings are used for X dis-
+ play fonts and 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 encoding:
+
+ in-start-hex in-end-hex out-start-hex
+
+ Entries for single characters can be abbreviated
+ to:
+
+ in-hex out-hex
+
+ The in-start-hex and in-end-hex fields (or the sin-
+ gle in-hex field) specify the Unicode range. The
+ out-start-hex field (or the out-hex field) speci-
+ fies 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 speci-
+ fied file is used. The Latin1, ASCII7, Symbol,
+ ZapfDingbats, UTF-8, and UCS-2 encodings are prede-
+ fined.
+
+ cMapDir registry-ordering dir
+ Specifies a search directory, dir, for CMaps for
+ the registry-ordering character collection. There
+ can be multiple directories for a particular col-
+ lection. There are no default CMap directories.
+
+ toUnicodeDir dir
+ Specifies a search directory, dir, for ToUnicode
+ CMaps. There can be multiple ToUnicode directo-
+ ries. There are no default ToUnicode directories.
+
+DISPLAY FONTS
+ displayFontT1 PDF-font-name T1-file
+ Maps a PDF font, PDF-font-name, to a Type 1 font
+ for display. The Type 1 font file, T1-file, should
+ be a standard .pfa or .pfb file.
+
+ displayFontTT PDF-font-name TT-file
+ Maps a PDF font, PDF-font-name, to a TrueType font
+ for display. The TrueType font file, TT-file,
+ should be a standard .ttf file.
+
+ displayNamedCIDFontT1 PDF-font-name T1-file
+ Maps a specific PDF CID (16-bit) font,
+ PDF-font-name, to a CID font (16-bit PostScript
+ font), for display. There are no default CID font
+ mappings.
+
+ displayCIDFontT1 registry-ordering T1-file
+ Maps the registry-ordering character collection to
+ a CID font (16-bit PostScript font), for display.
+ This mapping is used if the font name doesn't match
+ any of the fonts declared with displayNamedCIDFont*
+ commands. There are no default CID font mappings.
+
+ displayNamedCIDFontTT PDF-font-name TT-file
+ Maps a specific PDF CID (16-bit) font,
+ PDF-font-name, to a (16-bit) TrueType font, for
+ display. There are no default CID font mappings.
+
+ displayCIDFontTT registry-ordering TT-file
+ Maps the registry-ordering character collection to
+ a (16-bit) TrueType font, for display. This map-
+ ping is used if the font name doesn't match any of
+ the fonts declared with displayNamedCIDFont* com-
+ mands. There are no default CID font mappings.
+
+ fontDir dir
+ Specifies a search directory for external font
+ files. There can be multiple fontDir directories.
+ If a PDF file uses a font but doesn't embed it,
+ these directories will be searched for a matching
+ font file. These fonts are used by both xpdf (for
+ display) and pdftops (for embedding in the gener-
+ ated PostScript). Type 1 fonts must have a suffix
+ of ".pfa", ".pfb", ".ps", or no suffix at all.
+ TrueType fonts must have a ".ttf" suffix. Other
+ files in these directories will be ignored. There
+ are no default fontDir directories.
+
+POSTSCRIPT CONTROL
+ psPaperSize width(pts) height(pts)
+ Sets the paper size for PostScript output. The
+ width and height parameters give the paper size in
+ PostScript points (1 point = 1/72 inch).
+
+ psPaperSize letter | legal | A4 | A3 | match
+ Sets the paper size for PostScript output to a
+ standard size. The default paper size is set when
+ xpdf and pdftops are built, typically to "letter"
+ or "A4". This can also be set to "match", which
+ will set the paper size to match the size specified
+ in the PDF file.
+
+ psImageableArea llx lly urx ury
+ Sets the imageable area for PostScript output. The
+ four integers are the coordinates of the lower-left
+ and upper-right corners of the imageable region,
+ specified in points (with the origin being the
+ lower-left corner of the paper). This defaults to
+ the full paper size; the psPaperSize option will
+ reset the imageable area coordinates.
+
+ psCrop yes | no
+ If set to "yes", PostScript output is cropped to
+ the CropBox specified in the PDF file; otherwise no
+ cropping is done. This defaults to "yes".
+
+ psExpandSmaller yes | no
+ If set to "yes", PDF pages smaller than the
+ PostScript imageable area are expanded to fill the
+ imageable area. Otherwise, no scalling is done on
+ smaller pages. This defaults to "no".
+
+ psShrinkLarger yes | no
+ If set to yes, PDF pages larger than the PostScript
+ imageable area are shrunk to fit the imageable
+ area. Otherwise, no scaling is done on larger
+ pages. This defaults to "yes".
+
+ psCenter yes | no
+ If set to yes, PDF pages smaller than the
+ PostScript imageable area (after any scaling) are
+ centered in the imageable area. Otherwise, they
+ are aligned at the lower-left corner of the image-
+ able area. This defaults to "yes".
+
+ psDuplex yes | no
+ If set to "yes", the generated PostScript will set
+ the "Duplex" pagedevice entry. This tells duplex-
+ capable printers to enable duplexing. This
+ defaults to "no".
+
+ psLevel level1 | level1sep | level2 | level2sep | level3 |
+ level3Sep
+ Sets the PostScript level to generate. This
+ defaults to "level2".
+
+ psFont PDF-font-name PS-font-name
+ When the PDF-font-name font is used in a PDF file,
+ it will be translated to the PostScript font
+ PS-font-name, which is assumed to be resident in
+ the printer. Typically, PDF-font-name and
+ PS-font-name are the same. By default, only the
+ Base-14 fonts are assumed to be resident.
+
+ psNamedFont16 PDF-font-name wMode PS-font-name encoding
+ When the 16-bit font PDF-font-name is used in a PDF
+ file with the wMode writing mode and is not embed-
+ ded, the PS-font-name font is substituted for it.
+ The writing mode must be either 'H' for horizontal
+ or 'V' for vertical. The PS-font-name font is
+ assumed to be resident in the printer and to use
+ the specified encoding (which must have been
+ defined with the unicodeMap command).
+
+ psFont16 registry-ordering wMode PS-font-name encoding
+ When a 16-bit font using the registry-ordering
+ character collection and wMode writing mode is not
+ embedded and does not match any of the fonts
+ declared in psNamedFont16 commands, the
+ PS-font-name font is substituted for it. The writ-
+ ing mode must be either 'H' for horizontal or 'V'
+ for vertical. The PS-font-name font is assumed to
+ be resident in the printer and to use the specified
+ writing mode and encoding (which must have been
+ defined with the unicodeMap command).
+
+ psEmbedType1Fonts yes | no
+ If set to "no", prevents embedding of Type 1 fonts
+ in generated PostScript. This defaults to "yes".
+
+ psEmbedTrueTypeFonts yes | no
+ If set to "no", prevents embedding of TrueType
+ fonts in generated PostScript. This defaults to
+ "yes".
+
+ psEmbedCIDTrueTypeFonts yes | no
+ If set to "no", prevents embedding of CID TrueType
+ fonts in generated PostScript. For Level 3
+ PostScript, this generates a CID font, for lower
+ levels it generates a non-CID composite font.
+
+ psEmbedCIDPostScriptFonts yes | no
+ If set to "no", prevents embedding of CID
+ PostScript fonts in generated PostScript. For
+ Level 3 PostScript, this generates a CID font, for
+ lower levels it generates a non-CID composite font.
+
+ psPreload yes | no
+ If set to "yes", PDF forms are converted to PS pro-
+ cedures, and image data is preloaded. This uses
+ more memory in the PostScript interpreter, but gen-
+ erates significantly smaller PS files in situations
+ where, e.g., the same image is drawn on every page
+ of a long document. This defaults to "no".
+
+ psOPI yes | no
+ If set to "yes", generates PostScript OPI comments
+ for all images and forms which have OPI informa-
+ tion. This option is only available if the Xpdf
+ tools were compiled with OPI support. This
+ defaults to "no".
+
+ psASCIIHex yes | no
+ If set to "yes", the ASCIIHexEncode filter will be
+ used instead of ASCII85Encode for binary data.
+ 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 com-
+ mand 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.
+
+TEXT CONTROL
+ textEncoding encoding-name
+ Sets the encoding to use for text output. (This
+ can be overridden with the "-enc" switch on the
+ command line.) The encoding-name must be defined
+ with the unicodeMap command (see above). This
+ defaults to "Latin1".
+
+ textEOL unix | dos | mac
+ Sets the end-of-line convention to use for text
+ output. The options are:
+
+ unix = LF
+ dos = CR+LF
+ mac = CR
+
+ (This can be overridden with the "-eol" switch on
+ the command line.) The default value is based on
+ the OS where xpdf and pdftotext were built.
+
+ textPageBreaks yes | no
+ If set to "yes", text extraction will insert page
+ breaks (form feed characters) between pages. This
+ defaults to "yes".
+
+ textKeepTinyChars yes | no
+ If set to "yes", text extraction will keep all
+ characters. If set to "no", text extraction will
+ discard tiny (smaller than 3 point) characters
+ after the first 50000 per page, avoiding extremely
+ slow run times for PDF files that use special fonts
+ to do shading or cross-hatching. This defaults to
+ "no".
+
+MISCELLANEOUS SETTINGS
+ initialZoom percentage | page | width
+ Sets 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 win-
+ dow width.
+
+ continuousView yes | no
+ If set to "yes", xpdf will start in continuous view
+ mode, i.e., with one vertical screoll bar for the
+ whole document. This defaults to "no".
+
+ enableT1lib yes | no
+ Enables or disables use of t1lib (a Type 1 font
+ rasterizer). This is only relevant if the Xpdf
+ tools were built with t1lib support.
+ ("enableT1lib" replaces the old "t1libControl"
+ option.) This option defaults to "yes".
+
+ enableFreeType yes | no
+ Enables or disables use of FreeType (a TrueType /
+ Type 1 font rasterizer). This is only relevant if
+ the Xpdf tools were built with FreeType support.
+ ("enableFreeType" replaces the old "freetypeCon-
+ trol" option.) This option defaults to "yes".
+
+ antialias yes | no
+ Enables or disables font anti-aliasing in the PDF
+ rasterizer. This option affects all font rasteriz-
+ ers. ("antialias" replaces the anti-aliasing con-
+ trol provided by the old "t1libControl" and
+ "freetypeControl" options.) This default to "yes".
+
+ vectorAntialias yes | no
+ Enables or disables anti-aliasing of vector graph-
+ ics in the PDF rasterizer. This defaults to "yes".
+
+ strokeAdjust yes | no
+ Enables or disables stroke adjustment. This
+ defaults to "yes".
+
+ 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 dithering, clus-
+ tered-dot dithering (with a round dot and 45-degree
+ screen angle), and stochastic clustered-dot dither-
+ ing. By default, "stochasticClustered" is used for
+ resolutions of 300 dpi and higher, and "dispersed"
+ is used for resolutions lower then 300 dpi.
+
+ screenSize integer
+ Sets the size of the (square) halftone screen
+ threshold matrix. By default, this is 4 for dis-
+ persed-dot dithering, 10 for clustered-dot dither-
+ ing, and 100 for stochastic clustered-dot dither-
+ ing.
+
+ screenDotRadius integer
+ Sets the halftone screen dot radius. This is only
+ used when screenType is set to stochasticClustered,
+ and it defaults to 2. In clustered-dot mode, the
+ dot radius is half of the screen size. Dispersed-
+ dot dithering doesn't have a dot radius.
+
+ screenGamma float
+ Sets the halftone screen gamma correction parame-
+ ter. Gamma values greater than 1 make the output
+ brighter; gamma values less than 1 make it darker.
+ The default value is 1.
+
+ screenBlackThreshold float
+ When halftoning, all values below this threshold
+ are forced to solid black. This parameter is a
+ floating point value between 0 (black) and 1
+ (white). The default value is 0.
+
+ screenWhiteThreshold float
+ When halftoning, all values above this threshold
+ are forced to solid white. This parameter is a
+ floating point value between 0 (black) and 1
+ (white). The default value is 1.
+
+ urlCommand command
+ Sets the command executed when you click on a URL
+ link. The string "%s" will be replaced with the
+ URL. (See the example below.) This has no default
+ value.
+
+ movieCommand command
+ 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.
+
+ mapNumericCharNames yes | no
+ 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 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. 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".
+
+ bind modifiers-key context command ...
+ Add a key or mouse button binding. Modifiers can
+ be zero or more of:
+
+ shift-
+ ctrl-
+ alt-
+
+ Key can be a regular ASCII character, or any one
+ of:
+
+ space
+ tab
+ return
+ enter
+ backspace
+ insert
+ delete
+ home
+ end
+ pgup
+ pgdn
+ left / right / up / down (arrow keys)
+ f1 .. f35 (function keys)
+ mousePress1 .. mousePress7 (mouse buttons)
+ mouseRelease1 .. mouseRelease7 (mouse buttons)
+
+ Context is either "any" or a comma-separated combi-
+ nation of:
+
+ fullScreen / window (full screen mode on/off)
+ continuous / singlePage (continuous mode on/off)
+ overLink / offLink (mouse over link or not)
+ scrLockOn / scrLockOff (scroll lock on/off)
+
+ The context string can include only one of each
+ pair in the above list.
+
+ Command is an Xpdf command (see the COMMANDS sec-
+ tion of the xpdf(1) man page for details). Multi-
+ ple commands are separated by whitespace.
+
+ The bind command replaces any existing binding, but
+ only if it was defined for the exact same modi-
+ fiers, key, and context. All tokens (modifiers,
+ key, context, commands) are case-sensitive.
+
+ Example key bindings:
+
+ # bind ctrl-a in any context to the nextPage
+ # command
+ bind ctrl-a any nextPage
+
+ # bind uppercase B, when in continuous mode
+ # with scroll lock on, to the reload command
+ # followed by the prevPage command
+ bind B continuous,scrLockOn reload prevPage
+
+ See the xpdf(1) man page for more examples.
+
+ unbind modifiers-key context
+ 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).
+
+ printCommands yes | no
+ If set to "yes", drawing commands are printed as
+ they're executed (useful for debugging). This
+ defaults to "no".
+
+ errQuiet yes | no
+ If set to "yes", this suppresses all error and
+ warning messages from all of the Xpdf tools. This
+ defaults to "no".
+
+EXAMPLES
+ The following is a sample xpdfrc file.
+
+ # from the Thai support package
+ nameToUnicode /usr/local/share/xpdf/Thai.nameToUnicode
+
+ # from the Japanese support package
+ cidToUnicode Adobe-Japan1 /usr/local/share/xpdf/Adobe-Japan1.cidToUnicode
+ unicodeMap JISX0208 /usr/local/share/xpdf/JISX0208.unicodeMap
+ cMapDir Adobe-Japan1 /usr/local/share/xpdf/cmap/Adobe-Japan1
+
+ # use the Base-14 Type 1 fonts from ghostscript
+ displayFontT1 Times-Roman /usr/local/share/ghostscript/fonts/n021003l.pfb
+ displayFontT1 Times-Italic /usr/local/share/ghostscript/fonts/n021023l.pfb
+ displayFontT1 Times-Bold /usr/local/share/ghostscript/fonts/n021004l.pfb
+ displayFontT1 Times-BoldItalic /usr/local/share/ghostscript/fonts/n021024l.pfb
+ displayFontT1 Helvetica /usr/local/share/ghostscript/fonts/n019003l.pfb
+ displayFontT1 Helvetica-Oblique /usr/local/share/ghostscript/fonts/n019023l.pfb
+ displayFontT1 Helvetica-Bold /usr/local/share/ghostscript/fonts/n019004l.pfb
+ displayFontT1 Helvetica-BoldOblique /usr/local/share/ghostscript/fonts/n019024l.pfb
+ displayFontT1 Courier /usr/local/share/ghostscript/fonts/n022003l.pfb
+ displayFontT1 Courier-Oblique /usr/local/share/ghostscript/fonts/n022023l.pfb
+ displayFontT1 Courier-Bold /usr/local/share/ghostscript/fonts/n022004l.pfb
+ displayFontT1 Courier-BoldOblique /usr/local/share/ghostscript/fonts/n022024l.pfb
+ displayFontT1 Symbol /usr/local/share/ghostscript/fonts/s050000l.pfb
+ displayFontT1 ZapfDingbats /usr/local/share/ghostscript/fonts/d050000l.pfb
+
+ # use the Bakoma Type 1 fonts
+ # (this assumes they happen to be installed in /usr/local/fonts/bakoma)
+ fontDir /usr/local/fonts/bakoma
+
+ # set some PostScript options
+ psPaperSize letter
+ psDuplex no
+ psLevel level2
+ psEmbedType1Fonts yes
+ psEmbedTrueTypeFonts yes
+ psFile "| lpr -Pprinter5"
+
+ # assume that the PostScript printer has the Univers and
+ # Univers-Bold fonts
+ psFont Univers Univers
+ psFont Univers-Bold Univers-Bold
+
+ # set the text output options
+ textEncoding UTF-8
+ textEOL unix
+
+ # misc options
+ t1libControl low
+ freetypeControl low
+ urlCommand "netscape -remote 'openURL(%s)'"
+
+
+FILES
+ /usr/local/etc/xpdfrc
+ This is the default location for the system-wide
+ configuration file. Depending on build options, it
+ may be placed elsewhere.
+
+ $HOME/.xpdfrc
+ This is the user's configuration file. If it
+ exists, it will be read in place of the system-wide
+ file.
+
+AUTHOR
+ The Xpdf software and documentation are copyright
+ 1996-2007 Glyph & Cog, LLC.
+
+SEE ALSO
+ xpdf(1), pdftops(1), pdftotext(1), pdfinfo(1),
+ pdftoppm(1), pdfimages(1)
+ http://www.foolabs.com/xpdf/
+
+
+
+ 27 February 2007 xpdfrc(5)
diff --git a/Build/source/libs/xpdf/xpdf-3.02/doc/xpdfrc.hlp b/Build/source/libs/xpdf/xpdf-3.02/doc/xpdfrc.hlp
new file mode 100644
index 00000000000..deb9fb4e45a
--- /dev/null
+++ b/Build/source/libs/xpdf/xpdf-3.02/doc/xpdfrc.hlp
@@ -0,0 +1,619 @@
+! Generated automatically by mantohlp
+1 xpdfrc
+2 NCLUDE_FILE
+
+ xpdfrc - configuration file for Xpdf tools (version 3.02)
+
+ include config-file
+ Includes the specified config file. The effect of
+ this is equivalent to inserting the contents of
+ config-file directly into the parent config file in
+ place of the include command. Config files can be
+ nested arbitrarily deeply.
+
+ ()
+
+2 HARACTER_MAPPIN
+
+ nameToUnicode map-file
+ Specifies a file with the mapping from character
+ names to Unicode. This is used to handle PDF fonts
+ that have valid encodings but no ToUnicode entry.
+ Each line of a nameToUnicode file looks like this:
+
+ hex-string name
+
+ The hex-string is the Unicode (UCS-2) character
+ index, and name is the corresponding character
+ name. Multiple nameToUnicode files can be used; if
+ a character name is given more than once, the code
+ in the last specified file is used. There is a
+ built-in default nameToUnicode table with all of
+ Adobe's standard character names.
+
+ cidToUnicode registry-ordering map-file
+ Specifies the file with the mapping from character
+ collection to Unicode. Each line of a cidToUnicode
+ file represents one character:
+
+ hex-string
+
+ The hex-string is the Unicode (UCS-2) index for
+ that character. The first line maps CID 0, the
+ second line CID 1, etc. File size is determined by
+ size of the character collection. Only one file is
+ allowed per character collection; the last speci-
+ fied file is used. There are no built-in cidToUni-
+ code mappings.
+
+ unicodeToUnicode font-name-substring map-file
+ This is used to work around PDF fonts which have
+ incorrect Unicode information. It specifies a file
+ which maps from the given (incorrect) Unicode
+ indexes to the correct ones. The mapping will be
+ used for any font whose name contains
+ font-name-substring. Each line of a unicodeToUni-
+ code file represents one Unicode character:
+
+ in-hex out-hex1 out-hex2 ...
+
+ The in-hex field is an input (incorrect) Unicode
+ index, and the rest of the fields are one or more
+ output (correct) Unicode indexes. Each occurrence
+ of in-hex will be converted to the specified output
+ sequence.
+
+ unicodeMap encoding-name map-file
+ Specifies the file with mapping from Unicode to
+ encoding-name. These encodings are used for X dis-
+ play fonts and 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 encoding:
+
+ in-start-hex in-end-hex out-start-hex
+
+ Entries for single characters can be abbreviated
+ to:
+
+ in-hex out-hex
+
+ The in-start-hex and in-end-hex fields (or the sin-
+ gle in-hex field) specify the Unicode range. The
+ out-start-hex field (or the out-hex field) speci-
+ fies 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 speci-
+ fied file is used. The Latin1, ASCII7, Symbol,
+ ZapfDingbats, UTF-8, and UCS-2 encodings are prede-
+ fined.
+
+ cMapDir registry-ordering dir
+ Specifies a search directory, dir, for CMaps for
+ the registry-ordering character collection. There
+ can be multiple directories for a particular col-
+ lection. There are no default CMap directories.
+
+ toUnicodeDir dir
+ Specifies a search directory, dir, for ToUnicode
+ CMaps. There can be multiple ToUnicode directo-
+ ries. There are no default ToUnicode directories.
+
+ ()
+
+2 ISPLAY_FONT
+
+ displayFontT1 PDF-font-name T1-file
+ Maps a PDF font, PDF-font-name, to a Type 1 font
+ for display. The Type 1 font file, T1-file, should
+ be a standard .pfa or .pfb file.
+
+ displayFontTT PDF-font-name TT-file
+ Maps a PDF font, PDF-font-name, to a TrueType font
+ for display. The TrueType font file, TT-file,
+ should be a standard .ttf file.
+
+ displayNamedCIDFontT1 PDF-font-name T1-file
+ Maps a specific PDF CID (16-bit) font,
+ PDF-font-name, to a CID font (16-bit PostScript
+ font), for display. There are no default CID font
+ mappings.
+
+ displayCIDFontT1 registry-ordering T1-file
+ Maps the registry-ordering character collection to
+ a CID font (16-bit PostScript font), for display.
+ This mapping is used if the font name doesn't match
+ any of the fonts declared with displayNamedCIDFont*
+ commands. There are no default CID font mappings.
+
+ displayNamedCIDFontTT PDF-font-name TT-file
+ Maps a specific PDF CID (16-bit) font,
+ PDF-font-name, to a (16-bit) TrueType font, for
+ display. There are no default CID font mappings.
+
+ displayCIDFontTT registry-ordering TT-file
+ Maps the registry-ordering character collection to
+ a (16-bit) TrueType font, for display. This map-
+ ping is used if the font name doesn't match any of
+ the fonts declared with displayNamedCIDFont* com-
+ mands. There are no default CID font mappings.
+
+ fontDir dir
+ Specifies a search directory for external font
+ files. There can be multiple fontDir directories.
+ If a PDF file uses a font but doesn't embed it,
+ these directories will be searched for a matching
+ font file. These fonts are used by both xpdf (for
+ display) and pdftops (for embedding in the gener-
+ ated PostScript). Type 1 fonts must have a suffix
+ of ".pfa", ".pfb", ".ps", or no suffix at all.
+ TrueType fonts must have a ".ttf" suffix. Other
+ files in these directories will be ignored. There
+ are no default fontDir directories.
+
+ ()
+
+2 OSTSCRIPT_CONTRO
+
+ psPaperSize width(pts) height(pts)
+ Sets the paper size for PostScript output. The
+ width and height parameters give the paper size in
+ PostScript points (1 point = 1/72 inch).
+
+ psPaperSize letter | legal | A4 | A3 | match
+ Sets the paper size for PostScript output to a
+ standard size. The default paper size is set when
+ xpdf and pdftops are built, typically to "letter"
+ or "A4". This can also be set to "match", which
+ will set the paper size to match the size specified
+ in the PDF file.
+
+ psImageableArea llx lly urx ury
+ Sets the imageable area for PostScript output. The
+ four integers are the coordinates of the lower-left
+ and upper-right corners of the imageable region,
+ specified in points (with the origin being the
+ lower-left corner of the paper). This defaults to
+ the full paper size; the psPaperSize option will
+ reset the imageable area coordinates.
+
+ psCrop yes | no
+ If set to "yes", PostScript output is cropped to
+ the CropBox specified in the PDF file; otherwise no
+ cropping is done. This defaults to "yes".
+
+ psExpandSmaller yes | no
+ If set to "yes", PDF pages smaller than the
+ PostScript imageable area are expanded to fill the
+ imageable area. Otherwise, no scalling is done on
+ smaller pages. This defaults to "no".
+
+ psShrinkLarger yes | no
+ If set to yes, PDF pages larger than the PostScript
+ imageable area are shrunk to fit the imageable
+ area. Otherwise, no scaling is done on larger
+ pages. This defaults to "yes".
+
+ psCenter yes | no
+ If set to yes, PDF pages smaller than the
+ PostScript imageable area (after any scaling) are
+ centered in the imageable area. Otherwise, they
+ are aligned at the lower-left corner of the image-
+ able area. This defaults to "yes".
+
+ psDuplex yes | no
+ If set to "yes", the generated PostScript will set
+ the "Duplex" pagedevice entry. This tells duplex-
+ capable printers to enable duplexing. This
+ defaults to "no".
+
+ psLevel level1 | level1sep | level2 | level2sep | level3 |
+ level3Sep
+ Sets the PostScript level to generate. This
+ defaults to "level2".
+
+ psFont PDF-font-name PS-font-name
+ When the PDF-font-name font is used in a PDF file,
+ it will be translated to the PostScript font
+ PS-font-name, which is assumed to be resident in
+ the printer. Typically, PDF-font-name and
+ PS-font-name are the same. By default, only the
+ Base-14 fonts are assumed to be resident.
+
+ psNamedFont16 PDF-font-name wMode PS-font-name encoding
+ When the 16-bit font PDF-font-name is used in a PDF
+ file with the wMode writing mode and is not embed-
+ ded, the PS-font-name font is substituted for it.
+ The writing mode must be either 'H' for horizontal
+ or 'V' for vertical. The PS-font-name font is
+ assumed to be resident in the printer and to use
+ the specified encoding (which must have been
+ defined with the unicodeMap command).
+
+ psFont16 registry-ordering wMode PS-font-name encoding
+ When a 16-bit font using the registry-ordering
+ character collection and wMode writing mode is not
+ embedded and does not match any of the fonts
+ declared in psNamedFont16 commands, the
+ PS-font-name font is substituted for it. The writ-
+ ing mode must be either 'H' for horizontal or 'V'
+ for vertical. The PS-font-name font is assumed to
+ be resident in the printer and to use the specified
+ writing mode and encoding (which must have been
+ defined with the unicodeMap command).
+
+ psEmbedType1Fonts yes | no
+ If set to "no", prevents embedding of Type 1 fonts
+ in generated PostScript. This defaults to "yes".
+
+ psEmbedTrueTypeFonts yes | no
+ If set to "no", prevents embedding of TrueType
+ fonts in generated PostScript. This defaults to
+ "yes".
+
+ psEmbedCIDTrueTypeFonts yes | no
+ If set to "no", prevents embedding of CID TrueType
+ fonts in generated PostScript. For Level 3
+ PostScript, this generates a CID font, for lower
+ levels it generates a non-CID composite font.
+
+ psEmbedCIDPostScriptFonts yes | no
+ If set to "no", prevents embedding of CID
+ PostScript fonts in generated PostScript. For
+ Level 3 PostScript, this generates a CID font, for
+ lower levels it generates a non-CID composite font.
+
+ psPreload yes | no
+ If set to "yes", PDF forms are converted to PS pro-
+ cedures, and image data is preloaded. This uses
+ more memory in the PostScript interpreter, but gen-
+ erates significantly smaller PS files in situations
+ where, e.g., the same image is drawn on every page
+ of a long document. This defaults to "no".
+
+ psOPI yes | no
+ If set to "yes", generates PostScript OPI comments
+ for all images and forms which have OPI informa-
+ tion. This option is only available if the Xpdf
+ tools were compiled with OPI support. This
+ defaults to "no".
+
+ psASCIIHex yes | no
+ If set to "yes", the ASCIIHexEncode filter will be
+ used instead of ASCII85Encode for binary data.
+ 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 com-
+ mand 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.
+
+ ()
+
+2 EXT_CONTRO
+
+ textEncoding encoding-name
+ Sets the encoding to use for text output. (This
+ can be overridden with the "-enc" switch on the
+ command line.) The encoding-name must be defined
+ with the unicodeMap command (see above). This
+ defaults to "Latin1".
+
+ textEOL unix | dos | mac
+ Sets the end-of-line convention to use for text
+ output. The options are:
+
+ unix = LF
+ dos = CR+LF
+ mac = CR
+
+ (This can be overridden with the "-eol" switch on
+ the command line.) The default value is based on
+ the OS where xpdf and pdftotext were built.
+
+ textPageBreaks yes | no
+ If set to "yes", text extraction will insert page
+ breaks (form feed characters) between pages. This
+ defaults to "yes".
+
+ textKeepTinyChars yes | no
+ If set to "yes", text extraction will keep all
+ characters. If set to "no", text extraction will
+ discard tiny (smaller than 3 point) characters
+ after the first 50000 per page, avoiding extremely
+ slow run times for PDF files that use special fonts
+ to do shading or cross-hatching. This defaults to
+ "no".
+
+ ()
+
+2 ISCELLANEOUS_SETTING
+
+ initialZoom percentage | page | width
+ Sets 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 win-
+ dow width.
+
+ continuousView yes | no
+ If set to "yes", xpdf will start in continuous view
+ mode, i.e., with one vertical screoll bar for the
+ whole document. This defaults to "no".
+
+ enableT1lib yes | no
+ Enables or disables use of t1lib (a Type 1 font
+ rasterizer). This is only relevant if the Xpdf
+ tools were built with t1lib support.
+ ("enableT1lib" replaces the old "t1libControl"
+ option.) This option defaults to "yes".
+
+ enableFreeType yes | no
+ Enables or disables use of FreeType (a TrueType /
+ Type 1 font rasterizer). This is only relevant if
+ the Xpdf tools were built with FreeType support.
+ ("enableFreeType" replaces the old "freetypeCon-
+ trol" option.) This option defaults to "yes".
+
+ antialias yes | no
+ Enables or disables font anti-aliasing in the PDF
+ rasterizer. This option affects all font rasteriz-
+ ers. ("antialias" replaces the anti-aliasing con-
+ trol provided by the old "t1libControl" and
+ "freetypeControl" options.) This default to "yes".
+
+ vectorAntialias yes | no
+ Enables or disables anti-aliasing of vector graph-
+ ics in the PDF rasterizer. This defaults to "yes".
+
+ strokeAdjust yes | no
+ Enables or disables stroke adjustment. This
+ defaults to "yes".
+
+ 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 dithering, clus-
+ tered-dot dithering (with a round dot and 45-degree
+ screen angle), and stochastic clustered-dot dither-
+ ing. By default, "stochasticClustered" is used for
+ resolutions of 300 dpi and higher, and "dispersed"
+ is used for resolutions lower then 300 dpi.
+
+ screenSize integer
+ Sets the size of the (square) halftone screen
+ threshold matrix. By default, this is 4 for dis-
+ persed-dot dithering, 10 for clustered-dot dither-
+ ing, and 100 for stochastic clustered-dot dither-
+ ing.
+
+ screenDotRadius integer
+ Sets the halftone screen dot radius. This is only
+ used when screenType is set to stochasticClustered,
+ and it defaults to 2. In clustered-dot mode, the
+ dot radius is half of the screen size. Dispersed-
+ dot dithering doesn't have a dot radius.
+
+ screenGamma float
+ Sets the halftone screen gamma correction parame-
+ ter. Gamma values greater than 1 make the output
+ brighter; gamma values less than 1 make it darker.
+ The default value is 1.
+
+ screenBlackThreshold float
+ When halftoning, all values below this threshold
+ are forced to solid black. This parameter is a
+ floating point value between 0 (black) and 1
+ (white). The default value is 0.
+
+ screenWhiteThreshold float
+ When halftoning, all values above this threshold
+ are forced to solid white. This parameter is a
+ floating point value between 0 (black) and 1
+ (white). The default value is 1.
+
+ urlCommand command
+ Sets the command executed when you click on a URL
+ link. The string "%s" will be replaced with the
+ URL. (See the example below.) This has no default
+ value.
+
+ movieCommand command
+ 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.
+
+ mapNumericCharNames yes | no
+ 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 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. 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".
+
+ bind modifiers-key context command ...
+ Add a key or mouse button binding. Modifiers can
+ be zero or more of:
+
+ shift-
+ ctrl-
+ alt-
+
+ Key can be a regular ASCII character, or any one
+ of:
+
+ space
+ tab
+ return
+ enter
+ backspace
+ insert
+ delete
+ home
+ end
+ pgup
+ pgdn
+ left / right / up / down (arrow keys)
+ f1 .. f35 (function keys)
+ mousePress1 .. mousePress7 (mouse buttons)
+ mouseRelease1 .. mouseRelease7 (mouse buttons)
+
+ Context is either "any" or a comma-separated combi-
+ nation of:
+
+ fullScreen / window (full screen mode on/off)
+ continuous / singlePage (continuous mode on/off)
+ overLink / offLink (mouse over link or not)
+ scrLockOn / scrLockOff (scroll lock on/off)
+
+ The context string can include only one of each
+ pair in the above list.
+
+ Command is an Xpdf command (see the COMMANDS sec-
+ tion of the xpdf(1) man page for details). Multi-
+ ple commands are separated by whitespace.
+
+ The bind command replaces any existing binding, but
+ only if it was defined for the exact same modi-
+ fiers, key, and context. All tokens (modifiers,
+ key, context, commands) are case-sensitive.
+
+ Example key bindings:
+
+ # bind ctrl-a in any context to the nextPage
+ # command
+ bind ctrl-a any nextPage
+
+ # bind uppercase B, when in continuous mode
+ # with scroll lock on, to the reload command
+ # followed by the prevPage command
+ bind B continuous,scrLockOn reload prevPage
+
+ See the xpdf(1) man page for more examples.
+
+ unbind modifiers-key context
+ 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).
+
+ printCommands yes | no
+ If set to "yes", drawing commands are printed as
+ they're executed (useful for debugging). This
+ defaults to "no".
+
+ errQuiet yes | no
+ If set to "yes", this suppresses all error and
+ warning messages from all of the Xpdf tools. This
+ defaults to "no".
+
+ ()
+
+2 EXAMPLES
+
+ The following is a sample xpdfrc file.
+
+ # from the Thai support package
+ nameToUnicode /usr/local/share/xpdf/Thai.nameToUnicode
+
+ # from the Japanese support package
+ cidToUnicode Adobe-Japan1 /usr/local/share/xpdf/Adobe-Japan1.cidToUnicode
+ unicodeMap JISX0208 /usr/local/share/xpdf/JISX0208.unicodeMap
+ cMapDir Adobe-Japan1 /usr/local/share/xpdf/cmap/Adobe-Japan1
+
+ # use the Base-14 Type 1 fonts from ghostscript
+ displayFontT1 Times-Roman /usr/local/share/ghostscript/fonts/n021003l.pfb
+ displayFontT1 Times-Italic /usr/local/share/ghostscript/fonts/n021023l.pfb
+ displayFontT1 Times-Bold /usr/local/share/ghostscript/fonts/n021004l.pfb
+ displayFontT1 Times-BoldItalic /usr/local/share/ghostscript/fonts/n021024l.pfb
+ displayFontT1 Helvetica /usr/local/share/ghostscript/fonts/n019003l.pfb
+ displayFontT1 Helvetica-Oblique /usr/local/share/ghostscript/fonts/n019023l.pfb
+ displayFontT1 Helvetica-Bold /usr/local/share/ghostscript/fonts/n019004l.pfb
+ displayFontT1 Helvetica-BoldOblique /usr/local/share/ghostscript/fonts/n019024l.pfb
+ displayFontT1 Courier /usr/local/share/ghostscript/fonts/n022003l.pfb
+ displayFontT1 Courier-Oblique /usr/local/share/ghostscript/fonts/n022023l.pfb
+ displayFontT1 Courier-Bold /usr/local/share/ghostscript/fonts/n022004l.pfb
+ displayFontT1 Courier-BoldOblique /usr/local/share/ghostscript/fonts/n022024l.pfb
+ displayFontT1 Symbol /usr/local/share/ghostscript/fonts/s050000l.pfb
+ displayFontT1 ZapfDingbats /usr/local/share/ghostscript/fonts/d050000l.pfb
+
+ # use the Bakoma Type 1 fonts
+ # (this assumes they happen to be installed in /usr/local/fonts/bakoma)
+ fontDir /usr/local/fonts/bakoma
+
+ # set some PostScript options
+ psPaperSize letter
+ psDuplex no
+ psLevel level2
+ psEmbedType1Fonts yes
+ psEmbedTrueTypeFonts yes
+ psFile "| lpr -Pprinter5"
+
+ # assume that the PostScript printer has the Univers and
+ # Univers-Bold fonts
+ psFont Univers Univers
+ psFont Univers-Bold Univers-Bold
+
+ # set the text output options
+ textEncoding UTF-8
+ textEOL unix
+
+ # misc options
+ t1libControl low
+ freetypeControl low
+ urlCommand "netscape -remote 'openURL(%s)'"
+
+ ()
+
+2 FILES
+
+ /usr/local/etc/xpdfrc
+ This is the default location for the system-wide
+ configuration file. Depending on build options, it
+ may be placed elsewhere.
+
+ $HOME/.xpdfrc
+ This is the user's configuration file. If it
+ exists, it will be read in place of the system-wide
+ file.
+
+ ()
+
+2 AUTHOR
+
+ The Xpdf software and documentation are copyright
+ 1996-2007 Glyph & Cog, LLC.
+
+ ()
+
+2 SEE_ALSO
+
+ xpdf(1), pdftops(1), pdftotext(1), pdfinfo(1),
+ pdftoppm(1), pdfimages(1)
+ http://www.foolabs.com/xpdf/
+
+ ()
+