notes, version

git-svn-id: svn+q:///qpdf/trunk@893 71b93d88-0707-0410-a8cf-f5a4172ac649

1 files changed, 31 insertions, 3 deletions

diff --git a/README.windows b/README.windows
index 8ef78c81..ac02c95e 100644
--- a/README.windows
+++ b/README.windows
@@ -12,14 +12,42 @@ want to run them, you need ghostscript and tiff utils as well.  Then
 omit --disable-test-compare-images from the configure statements given
 below.  The image comparison tests have not been tried under MSYS.
 
+
+External Libraries
+==================
+
+In order to build qpdf, you must have copies of zlib and pcre.  The
+easy way to get them is to download them from the qpdf download area.
+There are packages called external-libs-bin.zip and
+external-libs-src.zip.  If you are building with MSVC 9 (.NET 2008) or
+MINGW 4.4, you can just extract the external-libs-bin.zip zip file
+into the top-level qpdf source tree.  It will create a directory
+called external-libs which contains header files and precompiled
+libraries.  Passing --enable-external-libs to ./configure (which is
+done automatically if you follow the instructions below) is sufficient
+to find them.
+
+You can also obtain pcre and zlib directly on your own and install
+them.  If you are using mingw, you can just set CPPFLAGS, LDFLAGS, and
+LIBS when you run ./configure so that it can find the header files and
+libraries.  If you are building with msvc and you want to do this, it
+probably won't work because ./configure doesn't know how to interpret
+LDFLAGS and LIBS properly for MSVC (though qpdf's own build system
+does).  In this case, you can probably get away with cheating by
+passing --enable-external-libs to ./configure and then just editing
+CPPFLAGS, LDFLAGS, LIBS in the generated autoconf.mk file.  Note that
+you should use UNIX-like syntax (-I, -L, -l) even though this is not
+what cl takes on the command line.  qpdf's build rules will fix it.
+
+
 Building with MinGW
 ===================
 
 QPDF is known to build and pass its test suite with MSYS-1.0.11 and
 gcc 4.4.0 with C++ support.  If you also have ActiveState Perl in your
-path, you can fully configure, build, and test qpdf in this
-environment.  You will most likely not be able to build qpdf with
-mingw using cygwin.
+path and the external-libs distribution described above, you can fully
+configure, build, and test qpdf in this environment.  You will most
+likely not be able to build qpdf with mingw using cygwin.
 
 From your MSYS prompt, run