2008-04-29 12:55:25 +00:00
|
|
|
This is the QPDF package. Information about it can be found at
|
|
|
|
|
http://qpdf.qbilt.org.
|
|
|
|
|
|
2009-02-15 16:31:12 +00:00
|
|
|
QPDF is copyright (c) 2005-2009 Jay Berkenbilt
|
2008-04-29 12:55:25 +00:00
|
|
|
|
|
|
|
|
This software may be distributed under the terms of version 2 of the
|
|
|
|
|
Artistic License which may be found in the source distribution as
|
|
|
|
|
"Artistic-2.0". It is provided "as is" without express or implied
|
|
|
|
|
warranty.
|
|
|
|
|
|
2009-10-11 00:44:23 +00:00
|
|
|
Building on UNIX/Linux
|
|
|
|
|
======================
|
|
|
|
|
|
2009-10-10 18:06:26 +00:00
|
|
|
For UNIX and UNIX-like systems, you can usually get by with just
|
2008-04-29 12:55:25 +00:00
|
|
|
|
|
|
|
|
./configure
|
|
|
|
|
make
|
|
|
|
|
make install
|
|
|
|
|
|
2009-10-10 18:06:26 +00:00
|
|
|
For more detailed general information, see the "INSTALL" file in this
|
|
|
|
|
directory.
|
|
|
|
|
|
2009-10-11 00:44:23 +00:00
|
|
|
Building on Windows
|
|
|
|
|
===================
|
|
|
|
|
|
|
|
|
|
QPDF is known to build and pass its test suite with mingw (gcc 4.4.0)
|
|
|
|
|
and Microsoft Visual C++ .NET 2008 Express. In both cases, cygwin is
|
|
|
|
|
required to run the test suite. Either cygwin or MSYS is required to
|
|
|
|
|
build as well in order to get make and other related tools. The MSVC
|
|
|
|
|
build has only been tested under cygwin. The mingw build requires
|
|
|
|
|
MSYS and will probably not work with cygwin.
|
|
|
|
|
|
|
|
|
|
For details on how to build under Windows, see README.windows.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Additional Notes on Build
|
|
|
|
|
=========================
|
|
|
|
|
|
|
|
|
|
QPDF's build system, inspired by abuild (http://www.abuild.org), can
|
|
|
|
|
optionally use its own built-in rules rather than using libtool and
|
|
|
|
|
obeying the compiler specified with configure. This can be enabled by
|
|
|
|
|
passing --with-buildrules=buildrules where buildrules corresponds to
|
|
|
|
|
one of the .mk files (other than rules.mk) in the make directory.
|
|
|
|
|
This should never be necessary on a UNIX system, but may be necessary
|
|
|
|
|
on a Windows system. See README.windows for details. There is a
|
|
|
|
|
gcc-linux.mk file enable "gcc-linux" build rules, but it is intended
|
|
|
|
|
to help test the build system; Linux users should build with the
|
|
|
|
|
"libtools" rules, which are enabled by default.
|
2008-04-29 12:55:25 +00:00
|
|
|
|
|
|
|
|
The QPDF package provides some executables and a software library. A
|
|
|
|
|
user's manual can be found in the "doc" directory. The docbook
|
|
|
|
|
sources to the user's manual can be found in the "manual" directory.
|
|
|
|
|
|
|
|
|
|
The software library is just libqpdf, and all the header files are in
|
|
|
|
|
the qpdf subdirectory. If you link with -lqpdf and your system does
|
|
|
|
|
not know how to read libtool .la files, then you will also need to
|
|
|
|
|
link with -lpcre and -lz.
|
|
|
|
|
|
|
|
|
|
To learn about using the library, please read comments in the header
|
|
|
|
|
files in include/qpdf, especially QPDF.hh, QPDFObjectHandle.hh, and
|
|
|
|
|
QPDFWriter.hh. You can also study the code of qpdf/qpdf.cc, which
|
|
|
|
|
exercises most of the public interface. There are additional example
|
|
|
|
|
programs in the examples directory.
|
