diff options
Diffstat (limited to 'Build/source/libs/xpdf/xpdf-src/INSTALL')
-rw-r--r-- | Build/source/libs/xpdf/xpdf-src/INSTALL | 242 |
1 files changed, 110 insertions, 132 deletions
diff --git a/Build/source/libs/xpdf/xpdf-src/INSTALL b/Build/source/libs/xpdf/xpdf-src/INSTALL index fce20fdbfa8..a292b605dc3 100644 --- a/Build/source/libs/xpdf/xpdf-src/INSTALL +++ b/Build/source/libs/xpdf/xpdf-src/INSTALL @@ -1,14 +1,14 @@ Xpdf ==== -version 3.04 -2014-may-28 +version 4.00 +2017-aug-10 The Xpdf software and documentation are -copyright 1996-2014 Glyph & Cog, LLC. +copyright 1996-2017 Glyph & Cog, LLC. -Email: derekn@foolabs.com -WWW: http://www.foolabs.com/xpdf/ +Email: xpdf@xpdfreader.com +WWW: http://www.xpdfreader.com/ Compiling xpdf @@ -18,179 +18,157 @@ 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 Motif (or Lesstif) toolkit. +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. -************** -*** UNIX *** -************** +********************* +*** Linux, OS X *** +********************* -* Install FreeType 2 (this is required). WARNING: You must have - version 2.0.5 or newer. Some older versions of XFree86 ship with an - older version of FreeType, which means you'll need to explicitly set - include and library paths to get the correct version: +* Make sure you have the following installed: - --with-freetype2-library=PATH - --with-freetype2-includes=PATH + - 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 you have Motif (or Lesstif) installed in a non-standard place, - you can use the following options to tell configure where to find - it: + If Qt isn't found, the GUI viewer (xpdf) won't be built, but the + command line tools will still be built. - --with-Xm-library=PATH - --with-Xm-includes=PATH +* 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: -* Run the configure script: + cd ..../xpdf-X.YY + mkdir build + cd build - ./configure +* Run cmake: - This should produce a set of makefiles customized for your system. - The configure script accepts the following options (in addition to - the usual things accepted by autoconf configure scripts): + cmake -DCMAKE_BUILD_TYPE=Release {other options - see below} .. - --prefix=PREFIX - Changes the directory where xpdf is installed. The default is - /usr/local. + If your build directory isn't under the source, use the full path to + the source directory: - --enable-a4-paper - Switches the default paper size for PostScript output (xpdf - and pdftops) to A4. The default is Letter size. - - --enable-no-text-select - 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.) - - --enable-opi - Enables support for generation of OPI (Open Prepress - Interface) comments with pdftops. - - --sysconfdir=DIR - Look for the system-wide xpdfrc config file in this directory. - The default is PREFIX/etc. - - --with-appdef-dir=DIR - Use the specified app-defaults directory. The default is - /usr/lib/X11/app-defaults. - - If you need to pass specific options to the C and/or C++ compiler, - you can set the CFLAGS and/or CXXFLAGS environment variables before - running the configure script. Any options given that way will be - added to the CFLAGS/CXXFLAGS used by all of the Xpdf makefiles. - -* Type 'make'. This should build the executables: + cmake -DCMAKE_BUILD_TYPE=Release {other options} ..../xpdf-X.YY - xpdf/xpdf - xpdf/pdftops - xpdf/pdftotext - xpdf/pdfinfo - xpdf/pdffonts - xpdf/pdfdetach - xpdf/pdftoppm - xpdf/pdfimages +* 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: -* If desired, type 'make install' to install the binaries and man - pages. + -DFREETYPE_DIR=/opt/freetype -The old Makefile.config and Makefiles are no longer provided or -supported. If you really want to manually configure Xpdf (which is -not recommended), the files that need to be created are aconf.h, -Makefile, goo/Makefile, fofi/Makefile, splash/Makefile, and -xpdf/Makefile, all of which are generated from the corresponding '.in' -files. + Cmake will look for ${FREETYPE_DIR}/include. -If you want to run a quick test, there is a tiny PDF file included -with xpdf, as misc/hello.pdf . - - -************** -*** OS/2 *** -************** + You can also set the FreeType library location with: -Xpdf is known to run under OS/2 with the EMX runtime environment and -XFree86. Using a proper autoconf port you can generate a valid -configure script version. + -DFREETYPE_LIBRARY=/opt/freetype/lib/libfreetype.so +* If cmake doesn't find Qt, make sure qmake is on your executable + search path. -*************** -*** Win32 *** -*************** +* To change the xpdf install directory, use: -The non-X programs (pdftops, pdftotext, pdfinfo, pdffonts, pdfdetach, -pdfimages, and pdftoppm) will compile with both gcc (from cygwin), -djgpp (the Delorie port of gcc) and Microsoft Visual C++. + -DCMAKE_INSTALL_PREFIX=/opt/xpdf -With cygwin, the build procedure is the same as for Unix: + If you're familiar with autoconf, this is similar to the "--prefix" + option. - * Open a shell. +* Other configuration options are: - * ./configure + -DSPLASH_CMYK=ON + Enable CMYK rasterization support. - * make + -DA4_PAPER=ON + Switches the default paper size for PostScript output (xpdf + and pdftops) to A4. The default is Letter size. - * make install + -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.) -It is also possible to build the Xpdf viewer with the cygwin XFree86 -port (thanks to Michael A. Richmond for these instructions): + -DOPI_SUPPORT=ON + Enables support for generation of OPI (Open Prepress + Interface) comments with pdftops. - * make sure you have the lesstif, XFree86-base, and XFree86-prog - cygwin packages installed (all from the "XFree86" category) + -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. - * to build xpdf: - - cd xpdf-x.yy - - ./configure - --with-freetype2-library=/usr/lib - --with-freetype2-includes=/usr/include/freetype2 - --with-Xm-library=/usr/lib - --with-Xm-includes=/usr/include - (all on one line) - - make - (this should build xpdf.exe, in addition to the command line - utilities) + -DSYSTEM_XPDFRC="/etc/xpdfrc" + Look for a system-wide xpdfrc config file in this directory. -With djgpp: + -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). - * Open a DOS window. + -DCMAKE_C_FLAGS="..." + -DCMAKE_CXX_FLAGS="..." + Set additional options to pass to the C and/or C++ compilers. - * ./dj_make + -DCMAKE_EXE_LINKER_FLAGS="..." + Set additional options to pass to the linker. - * djgpp is a DOS/Windows port of gcc, available from - http://www.delorie.com/ +* Build: -With djgpp, for DOS 6 (instead of Win32): + make - * ./dj_make + This will build the executables in the build directory: - * cd xpdf + xpdf/xpdf + xpdf/pdftops + xpdf/pdftotext + xpdf/pdftohtml + xpdf/pdfinfo + xpdf/pdffonts + xpdf/pdfdetach + xpdf/pdftoppm + xpdf/pdftopng + xpdf/pdfimages + xpdf-qt/xpdf - * strip pdftops.exe +* If desired, install the binaries and man pages: - * exe2coff pdftops.exe + make install - * copy /B c:\djgpp\bin\cwsdstub.exe+pdftops pdftops.exe +If you want to run a quick test, there is a tiny PDF file included +with xpdf, as misc/hello.pdf . - * upx pdftops.exe - - if you want compressed executables - * and similarly for the other executables +***************** +*** Windows *** +***************** - * cwsdstub.exe comes from djgpp/v2misc/csdpmi5b.zip on any of the - djgpp ftp mirrors; exe2coff is part of the standard djgpp install +The Windows build procedure is essentially the same as for Unix. If +building with cygwin, the procedure is identical to Unix. - * upx comes from http://upx.sourceforge.net/ +If building with Visual Studio: -With the Microsoft tools: +* Make sure you have CMake, FreeType, libpng, and zlib installed. - * Open a DOS window. +* 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. - * Type "cl". If you get the message "Bad command or file name", you - must run VCVARS32.BAT. (The location of this BAT file can be - determined with Explorer.) + 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" + .. - * Type "ms_make" +* Build: -The dj_make and ms_make scripts don't build pdftoppm -- you'll need to -install FreeType 2 before you can compile pdftoppm. + nmake |