Commits

Anonymous committed 3221924

added instructions on building under Win32 (C.J. Madsen)

Comments (0)

Files changed (2)

    - added XML::LibXML::XPathExpression module that can pre-compile an XPath expreession
    - memory leak fixes
    - documentation fixes
+   - README - notes for building on Win32 (C.J. Madsen)
 
 1.66
    - Perl-thread support contributed by Tim Brody [rt.cpan.org #31945]
 the header file for libxml2, which in binary (.rpm,.deb) etc. distributions
 usually dwell in a package named libxml2-devel or similar.
 
-
-INSTALLATION
-============
-
-To install XML::LibXML just follow the standard installation routine for Perl
-modules:
-
-   1 perl Makefile.PL
-   2 make
-   3 make test
-   4 make install # as superuser
-
-Note that XML::LibXML is an XS based Perl extension and you need a C compiler
-to build it.
-
-Note also that you should rebuild XML::LibXML if you upgrade libxml2 in order
-to avoid problems with possible binary incompatibilities between releases of
-the library.
-
-
 Notes on libxml2 versions
 =========================
 
 problems. If Makefile.PL marks a version of libxml2 as incompatible or broken
 it is done for a good reason.
 
+INSTALLATION
+============
+
+(These instructions are for UNIX and GNU/Linux systems. For MSWin32,
+See Notes for Microsoft Windows below.)
+
+To install XML::LibXML just follow the standard installation routine for Perl
+modules:
+
+   1 perl Makefile.PL
+   2 make
+   3 make test
+   4 make install # as superuser
+
+Note that XML::LibXML is an XS based Perl extension and you need a C compiler
+to build it.
+
+Note also that you should rebuild XML::LibXML if you upgrade libxml2 in order
+to avoid problems with possible binary incompatibilities between releases of
+the library.
 
 Notes for Microsoft Windows
 ===========================
 
 Usually it takes a little time to build the package for the latest release.
 
+If you want to build XML::LibXML on Windows from source, you can use
+the following instructions contributed by Christopher J. Madsen:
+ 
+These instructions assume that you already have your system set up to
+compile modules that use C components.
+
+First, get the libxml2 binaries from http://xmlsoft.org/sources/win32/
+(currently also available at http://www.zlatkovic.com/pub/libxml/).
+
+You need:
+
+  iconv-VERSION.win32.zip
+  libxml2-VERSION.win32.zip
+  zlib-VERSION.win32.zip
+
+Download the latest version of each. (Each package will probably have
+a different version.) When you extract them, you'll get directories
+named iconv-VERSION.win32, libxml2-VERSION.win32, and
+zlib-VERSION.win32, each containing bin, lib, and include directories.
+
+Combine all the bin, include, & lib directories under c:\Prog\LibXML.
+(You can use any directory you prefer; just adjust the instructions
+accordingly.)
+
+Get the latest version of XML-LibXML-Common and XML-LibXML from CPAN.
+Extract them.
+
+Issue these commands in the XML-LibXML-Common-VERSION directory:
+
+  perl Makefile.PL INC=-Ic:\Prog\LibXML\include LIBS=-Lc:\Prog\LibXML\lib
+  nmake
+  copy c:\Prog\LibXML\bin\*.dll blib\arch\auto\XML\LibXML\Common
+  nmake test
+  nmake install
+
+(Note: Some systems use dmake instead of nmake.)
+
+By copying the libxml2 DLLs to the arch directory, you help avoid
+conflicts with other programs you may have installed that use other
+(possibly incompatible) versions of those DLLs.
+
+Issue these commands in the XML-LibXML-VERSION directory:
+
+  perl Makefile.PL INC=-Ic:\Prog\LibXML\include LIBS=-Lc:\Prog\LibXML\lib
+  nmake
+  nmake test
+  nmake install
 
 Notes for Mac OS X
 ==================