Professional Documents
Culture Documents
Readme
Readme
============
This directory contains the files required to build this software on the
native Windows platform. This is not a place to look for help if you are
using a POSIX emulator, such as Cygwin. Check the Unix instructions for
that.
CONTENTS
========
1. General
1.1 Building From the Command-Line
1.2 Configuring The Source
1.3 Compiling
1.4 Installing
2. Compiler Specifics
2.1 Microsoft Visual C/C++
2.1 GNU C/C++, Mingw Edition
2.2 Borland C++ Builder
2.2.1 Building with iconv support
2.2.2 Compatability problems with MSVC (and probably CYGWIN)
2.2.3 Other caveats
1. General
==========
1.1 Building From The Command-Line
---------------------------------This is the easiest, preferred and currently supported method. It can
be that a subdirectory of the directory where this file resides
contains project files for some IDE. If you want to use that, please
refer to the readme file within that subdirectory.
In order to build from the command-line you need to make sure that
your compiler works from the command line. This is not always the
case, often the required environment variables are missing. If you are
not sure, test if this works first. If it doesn't, you will first have
to configure your compiler suite to run from the command-line - please
refer to your compiler's documentation regarding that.
The first thing you want to do is configure the source. You can have
the configuration script do this automatically for you. The
configuration script is written in JScript, a Microsoft's
implementation of the ECMA scripting language. Almost every Windows
machine can execute this through the Windows Scripting Host. If your
system lacks the ability to execute JScript for some reason, you must
perform the configuration manually and you are on your own with that.
The second step is compiling the source and, optionally, installing it
to the location of your choosing.
2. Compiler Specifics
=====================
2.1 Microsoft Visual C/C++
-------------------------If you use the compiler which comes with Visual Studio .NET, note that
it will link to its own C-runtime named msvcr70.dll or msvcr71.dll. This
file is not available on any machine which doesn't have Visual Studio
.NET installed.
2.2 GNU C/C++, Mingw edition
---------------------------When specifying paths to configure.js, please use slashes instead of
backslashes for directory separation. Sometimes Mingw needs this. If
this is the case, and you specify backslashes, then the compiler will
complain about not finding necessary header files.
2.2 Borland C++ Builder
----------------------To compile libxml2 with the BCB6 compiler and associated tools, just follow
the basic instructions found in this file file. Be sure to specify
the "compiler=bcb" option when running the configure script. To compile the
library and test programs, just type
make -fMakefile.bcb
That should be all that's required. But there are a few other things to note:
2.2.1 Building with iconv support
If you configure libxml2 to include iconv support, you will obviously need to
obtain the iconv library and include files. To get them, just follow the links
at http://www.gnu.org/software/libiconv/ - there are pre-compiled Win32
versions available, but note that these where built with MSVC. Hence the
supplied import library is in COFF format rather than OMF format. You can
convert this library by using Borland's COFF2OMF utility, or use IMPLIB to