summaryrefslogtreecommitdiffstats
path: root/README
diff options
context:
space:
mode:
authorJay Berkenbilt <ejb@ql.org>2009-10-11 02:44:23 +0200
committerJay Berkenbilt <ejb@ql.org>2009-10-11 02:44:23 +0200
commit444fab8f879f3c012668fadce3f27baf0c9d8942 (patch)
tree25347d6193ba64c0269ea5955879872c029801cf /README
parent2b5ac676ed1cbde1092d41acf0775b1c8d9a2baf (diff)
downloadqpdf-444fab8f879f3c012668fadce3f27baf0c9d8942.tar.zst
more build fixes
git-svn-id: svn+q:///qpdf/trunk@777 71b93d88-0707-0410-a8cf-f5a4172ac649
Diffstat (limited to 'README')
-rw-r--r--README31
1 files changed, 29 insertions, 2 deletions
diff --git a/README b/README
index d4b9620b..40e0f33a 100644
--- a/README
+++ b/README
@@ -8,6 +8,9 @@ Artistic License which may be found in the source distribution as
"Artistic-2.0". It is provided "as is" without express or implied
warranty.
+Building on UNIX/Linux
+======================
+
For UNIX and UNIX-like systems, you can usually get by with just
./configure
@@ -17,8 +20,32 @@ make install
For more detailed general information, see the "INSTALL" file in this
directory.
-For specific information about building qpdf on Windows, see
-"README.windows".
+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.
The QPDF package provides some executables and a software library. A
user's manual can be found in the "doc" directory. The docbook