summaryrefslogtreecommitdiff
path: root/Build/source/libs/xpdf/xpdf-src/INSTALL
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2021-02-25 19:22:25 +0000
committerKarl Berry <karl@freefriends.org>2021-02-25 19:22:25 +0000
commitad547a6b5986815fda458221149728d9d9ab1d87 (patch)
tree16296910eb3eca724371474ea9aea3994dc69614 /Build/source/libs/xpdf/xpdf-src/INSTALL
parent947b43de3dd21d58ccc2ffadefc4441ea1c2a813 (diff)
restore Build,TODO from r57911
git-svn-id: svn://tug.org/texlive/trunk@57915 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Build/source/libs/xpdf/xpdf-src/INSTALL')
-rw-r--r--Build/source/libs/xpdf/xpdf-src/INSTALL196
1 files changed, 196 insertions, 0 deletions
diff --git a/Build/source/libs/xpdf/xpdf-src/INSTALL b/Build/source/libs/xpdf/xpdf-src/INSTALL
new file mode 100644
index 00000000000..5a7eb6423f4
--- /dev/null
+++ b/Build/source/libs/xpdf/xpdf-src/INSTALL
@@ -0,0 +1,196 @@
+Xpdf
+====
+
+version 4.03
+2021-jan-28
+
+The Xpdf software and documentation are
+copyright 1996-2021 Glyph & Cog, LLC.
+
+Email: xpdf@xpdfreader.com
+WWW: http://www.xpdfreader.com/
+
+
+Compiling xpdf
+--------------
+
+Xpdf is written in C++ (with a little bit of C). It should work with
+any ANSI-compliant C++ and C compilers. The systems and compilers
+it's been tested with are listed on the xpdf web page.
+
+Xpdf requires the Qt toolkit. The non-GUI command line tools do not
+use Qt.
+
+The following notes give specific instructions for compiling on
+different systems.
+
+
+*********************
+*** Linux, OS X ***
+*********************
+
+* Make sure you have the following installed:
+
+ - CMake 2.8.8 or newer
+ - FreeType 2.0.5 or newer
+ - Qt 4.8.x or 5.x (for xpdf only)
+ - libpng (for pdftoppm and pdftohtml)
+ - zlib (for pdftoppm and pdftohtml)
+
+ If Qt isn't found, the GUI viewer (xpdf) won't be built, but the
+ command line tools will still be built.
+
+* Create a build directory. These instructions assume that you create
+ a directory called "build" under the top-level xpdf source
+ directory, but the build directory can be anywhere you like. Create
+ the directory and cd into it:
+
+ cd ..../xpdf-X.YY
+ mkdir build
+ cd build
+
+* Run cmake:
+
+ cmake -DCMAKE_BUILD_TYPE=Release {other options - see below} ..
+
+ If your build directory isn't under the source, use the full path to
+ the source directory:
+
+ cmake -DCMAKE_BUILD_TYPE=Release {other options} ..../xpdf-X.YY
+
+* If cmake doesn't find FreeType, you can set FREETYPE_DIR to point to
+ the FreeType install directory. Add this to the cmake command line:
+
+ -DFREETYPE_DIR=/opt/freetype
+
+ Cmake will look for ${FREETYPE_DIR}/include.
+
+ You can also set the FreeType library location with:
+
+ -DFREETYPE_LIBRARY=/opt/freetype/lib/libfreetype.so
+
+* If cmake doesn't find Qt, make sure qmake is on your executable
+ search path.
+
+* To change the xpdf install directory, use:
+
+ -DCMAKE_INSTALL_PREFIX=/opt/xpdf
+
+ If you're familiar with autoconf, this is similar to the "--prefix"
+ option.
+
+* Other configuration options are:
+
+ -DSPLASH_CMYK=ON
+ Enable CMYK rasterization support.
+
+ -DA4_PAPER=ON
+ Switches the default paper size for PostScript output (xpdf
+ and pdftops) to A4. The default is Letter size.
+
+ -DNO_TEXT_SELECT=ON
+ With this option, xpdf will not copy text. (This is only
+ useful on closed systems where the user can't get at the PDF
+ file directly.)
+
+ -DOPI_SUPPORT=ON
+ Enables support for generation of OPI (Open Prepress
+ Interface) comments with pdftops.
+
+ -DNO_FONTCONFIG=ON
+ Disables use of libfontconfig, which is used to locate system
+ fonts on Linux/Unix systems. The default is to search for the
+ library, and to use it if found.
+
+ -DMULTITHREADED=0
+ Disables multithreading, which also disables building the GUI
+ viewer (xpdf). This does not affect the command line tools.
+ Disabling multithreading should only be necessary if you're
+ building with a compiler other than gcc, clang, or Microsoft
+ Visual Studio.
+
+ -DXPDFWIDGET_PRINTING=OFF
+ Disable printing support.
+
+ -DSYSTEM_XPDFRC="/etc/xpdfrc"
+ Look for a system-wide xpdfrc config file in this directory.
+
+ -DXPDFRC_DATADIR="/usr/share/xpdf"
+ The ${DATADIR} variable in xpdfrc config files will expand to
+ this string.
+
+ -DCMAKE_DISABLE_FIND_PACKAGE_Qt4=1
+ -DCMAKE_DISABLE_FIND_PACKAGE_Qt5Widgets=1
+ Do not search for the Qt4/Qt5 libraries. This will disable
+ building the GUI viewer (xpdf). Cmake will look for a "qmake"
+ binary -- make sure the first qmake binary on your executable
+ search path matches the desired version of Qt.
+
+ -DCMAKE_C_FLAGS="..."
+ -DCMAKE_CXX_FLAGS="..."
+ Set additional options to pass to the C and/or C++ compilers.
+
+ -DCMAKE_EXE_LINKER_FLAGS="..."
+ Set additional options to pass to the linker.
+
+ -DCMAKE_INSTALL_BINDIR
+ Set the bin directory, relative to CMAKE_INSTALL_PREFIX
+ (typically "bin").
+
+ -DCMAKE_INSTALL_MANDIR
+ Set the man directory, relative to CMAKE_INSTALL_PREFIX
+ (typically "man" or "share/man").
+
+* Build:
+
+ make
+
+ This will build the executables in the build directory:
+
+ xpdf/xpdf
+ xpdf/pdftops
+ xpdf/pdftotext
+ xpdf/pdftohtml
+ xpdf/pdfinfo
+ xpdf/pdffonts
+ xpdf/pdfdetach
+ xpdf/pdftoppm
+ xpdf/pdftopng
+ xpdf/pdfimages
+ xpdf-qt/xpdf
+
+* If desired, install the binaries and man pages:
+
+ make install
+
+If you want to run a quick test, there is a tiny PDF file included
+with xpdf, as misc/hello.pdf .
+
+
+*****************
+*** Windows ***
+*****************
+
+The Windows build procedure is essentially the same as for Unix. If
+building with cygwin, the procedure is identical to Unix.
+
+If building with Visual Studio:
+
+* Make sure you have CMake, FreeType, libpng, and zlib installed.
+
+* You'll need to set the FREETYPE_DIR variable to point to your
+ FreeType installation, CMAKE_INCLUDE_PATH to point to your libpng
+ includes, CMAKE_LIBRARY_PATH to point to your libpng library, and
+ ZLIB_ROOT to point to your zlib installation.
+
+ cmake -G "NMake Makefiles"
+ -DCMAKE_BUILD_TYPE=Release
+ -DFREETYPE_DIR="c:/software/freetype"
+ -DCMAKE_INCLUDE_PATH="c:/software/libpng"
+ -DCMAKE_LIBRARY_PATH="c:/software/libpng"
+ -DZLIB_ROOT="c:/software/zlib"
+ ..
+
+* Build:
+
+ nmake