arospdf/INSTALL

   1 Xpdf
   2 ====
   3
   4 version 3.02
   5 2007-feb-27
   6
   7 The Xpdf software and documentation are
   8 copyright 1996-2007 Glyph & Cog, LLC.
   9
  10 Email: derekn@foolabs.com
  11 WWW: http://www.foolabs.com/xpdf/
  12
  13
  14 Compiling xpdf
  15 --------------
  16
  17 Xpdf is written in C++ (with a little bit of C).  It should work with
  18 any ANSI-compliant C++ and C compilers.  The systems and compilers
  19 it's been tested with are listed on the xpdf web page.
  20
  21 Xpdf requires the Motif (or Lesstif) toolkit.
  22
  23 The following notes give specific instructions for compiling on
  24 different systems.
  25
  26
  27 **************
  28 ***  UNIX  ***
  29 **************
  30
  31 * Install t1lib (if desired).  The resulting library (libt1) and
  32   include files (t1lib.h and t1libx.h) should be placed somewhere on
  33   the standard search paths.  Alternatively, when you configure xpdf,
  34   you can use the following options to tell configure where to find
  35   the t1lib files:
  36
  37     --with-t1-library=PATH
  38     --with-t1-includes=PATH
  39
  40 * Install FreeType 2 (this is required).  WARNING: You must have
  41   version 2.0.5 or newer.  Some older versions of XFree86 ship with an
  42   older version of FreeType, which means you'll need to explicitly set
  43   include and library paths to get the correct version:
  44
  45     --with-freetype2-library=PATH
  46     --with-freetype2-includes=PATH
  47
  48   (The include path is the directory which contains the freetype2
  49   directory, i.e., do NOT include "freetype2" in the
  50   --with-freetype2-includes path.  For example, with the default
  51   installation, the library path is /usr/local/lib and the include
  52   path is /usr/local/include/freetype2.)
  53
  54 * If you have Motif (or Lesstif) installed in a non-standard place,
  55   you can use the following options to tell configure where to find
  56   it:
  57
  58     --with-Xm-library=PATH
  59     --with-Xm-includes=PATH
  60
  61 * Run the configure script:
  62
  63     ./configure
  64
  65   This should produce a set of makefiles customized for your system.
  66   The configure script accepts the following options (in addition to
  67   the usual things accepted by autoconf configure scripts):
  68
  69     --prefix=PREFIX
  70         Changes the directory where xpdf is installed.  The default is
  71         /usr/local.
  72
  73     --enable-a4-paper
  74         Switches the default paper size for PostScript output (xpdf
  75         and pdftops) to A4.  The default is Letter size.
  76
  77     --enable-no-text-select
  78         With this option, xpdf will not copy text.  (This is only
  79         useful on closed systems where the user can't get at the PDF
  80         file directly.)
  81
  82     --enable-opi
  83         Enables support for generation of OPI (Open Prepress
  84         Interface) comments with pdftops.
  85
  86     --sysconfdir=DIR
  87         Look for the system-wide xpdfrc config file in this directory.
  88         The default is PREFIX/etc.
  89
  90     --with-appdef-dir=DIR
  91         Use the specified app-defaults directory.  The default is
  92         /usr/lib/X11/app-defaults.
  93
  94   If you need to pass specific options to the C and/or C++ compiler,
  95   you can set the CFLAGS and/or CXXFLAGS environment variables before
  96   running the configure script.  Any options given that way will be
  97   added to the CFLAGS/CXXFLAGS used by all of the Xpdf makefiles.
  98
  99 * Type 'make'.  This should build the executables:
 100
 101     xpdf/xpdf
 102     xpdf/pdftops
 103     xpdf/pdftotext
 104     xpdf/pdfinfo
 105     xpdf/pdffonts
 106     xpdf/pdftoppm
 107     xpdf/pdfimages
 108
 109 * If desired, type 'make install' to install the binaries and man
 110   pages.
 111
 112 The old Makefile.config and Makefiles are no longer provided or
 113 supported.  If you really want to manually configure Xpdf (which is
 114 not recommended), the files that need to be created are aconf.h,
 115 Makefile, goo/Makefile, fofi/Makefile, splash/Makefile, and
 116 xpdf/Makefile, all of which are generated from the corresponding '.in'
 117 files.
 118
 119 If you want to run a quick test, there is a tiny PDF file included
 120 with xpdf, as misc/hello.pdf .
 121
 122
 123 *************
 124 ***  VMS  ***
 125 *************
 126
 127 * The 'stddef.h' include file which comes with older versions of gcc
 128   may be missing a definition for wchar_t.  In this case, add the
 129   following lines:
 130   -----
 131   File GNU_CC:[INCLUDE]STDDEF.H;2
 132    44   /* Wide characters, not yet supported by VAXCRTL [match VAXC's <stddef.
 133    45   #if !defined(_WCHAR_T) && !defined(_WCHAR_T_)
 134    46   typedef unsigned int wchar_t;
 135    47   #endif
 136    48   #define _WCHAR_T
 137    49   #define _WCHAR_T_
 138    50
 139   -----
 140
 141 * Read the instructions at the top of vms_make.com.
 142
 143 * Type '@vms_make' in the top-level directory.  You'll probably want
 144   to use some of the options described in the file.
 145
 146 * The executables will be left in '[.xpdf]'.
 147
 148 If you want to run a quick test, there is a tiny PDF file included
 149 with xpdf, as misc/hello.pdf .
 150
 151
 152 **************
 153 ***  OS/2  ***
 154 **************
 155
 156 Xpdf is known to run under OS/2 with the EMX runtime environment and
 157 XFree86.  Using a proper autoconf port you can generate a valid
 158 configure script version.
 159
 160
 161 ***************
 162 ***  Win32  ***
 163 ***************
 164
 165 The non-X programs (pdftops, pdftotext, pdfinfo, pdffonts, pdfimages,
 166 and pdftoppm) will compile with both gcc (from cygwin), djgpp (the
 167 Delorie port of gcc) and Microsoft Visual C++.
 168
 169 With cygwin, the build procedure is the same as for Unix:
 170
 171   * Open a shell.
 172
 173   * ./configure
 174
 175   * make
 176
 177   * make install
 178
 179 It is also possible to build the Xpdf viewer with the cygwin XFree86
 180 port (thanks to Michael A. Richmond for these instructions):
 181
 182   * make sure you have the lesstif, XFree86-base, and XFree86-prog
 183     cygwin packages installed (all from the "XFree86" category)
 184
 185   * to build t1lib:
 186     - cd T1Lib-x.y
 187     - ./configure --without-x
 188     - make without_doc
 189     - make install
 190     (this should install /usr/local/include/t1lib.h and
 191     /usr/local/lib/libt1.a)
 192
 193   * to build xpdf:
 194     - cd xpdf-x.yy
 195     - ./configure --with-t1-library=/usr/local/lib
 196         --with-t1-includes=/usr/local/include
 197         --with-freetype2-library=/usr/X11R6/lib
 198         --with-freetype2-includes=/usr/X11R6/include/freetype2
 199         --with-Xm-library=/usr/X11R6/lib
 200         --with-Xm-includes=/usr/X11R6/include
 201       (all on one line)
 202     - make
 203     (this should build xpdf.exe, in addition to the command line
 204     utilities)
 205
 206 With djgpp:
 207
 208   * Open a DOS window.
 209
 210   * ./dj_make
 211
 212   * djgpp is a DOS/Windows port of gcc, available from
 213     http://www.delorie.com/
 214
 215 With djgpp, for DOS 6 (instead of Win32):
 216
 217   * ./dj_make
 218
 219   * cd xpdf
 220
 221   * strip pdftops.exe
 222
 223   * exe2coff pdftops.exe
 224
 225   * copy /B c:\djgpp\bin\cwsdstub.exe+pdftops pdftops.exe
 226
 227   * upx pdftops.exe
 228     - if you want compressed executables
 229
 230   * and similarly for the other executables
 231
 232   * cwsdstub.exe comes from djgpp/v2misc/csdpmi5b.zip on any of the
 233     djgpp ftp mirrors; exe2coff is part of the standard djgpp install
 234
 235   * upx comes from http://upx.sourceforge.net/
 236
 237 With the Microsoft tools:
 238
 239   * Open a DOS window.
 240
 241   * Type "cl".  If you get the message "Bad command or file name", you
 242     must run VCVARS32.BAT. (The location of this BAT file can be
 243     determined with Explorer.)
 244
 245   * Type "ms_make"
 246
 247 The dj_make and ms_make scripts don't build pdftoppm -- you'll need to
 248 install t1lib and FreeType 2 before you can compile pdftoppm.