1Building neon on Windows uses a single Nmake neon.mak file.  By
2placing various parameters on nmake's command line, you can specify
3exactly the features and behavior of the Neon libraries.  The
4parameters are additive, so to add more features, add the command line
5options specified in the particular section below.
6
7All the builds described below should work with Microsoft VC++ 5 and
86.
9
10Build neon
11__________
12
13This is the most basic version of the Neon library you can build.  It
14does not require any third party libraries, but you do not get the
15full capabilities of Neon.
16
17Compile Neon with no parameters
18
19  nmake /f neon.mak
20
21After compiling the library, the directory contains libneon.lib,
22against which you can link your program.
23
24
25Build neon with WebDAV support
26______________________________
27
28To compile Neon with WebDAV support, Neon must compile and link
29against a third-party XML parser, either expat, expat-lite, libxml or
30libxml2.  This Windows neon.mak file is designed to compile and link
31against the pre-built Expat Windows libraries version 1.95.X or newer.
32This library is available for download from
33
34  http://sourceforge.net/projects/expat/
35
36Download the latest expat_win32bin package named
37
38  expat_win32bin_X_YY_Z.exe
39
40and install it on your system.  It wants to install itself into
41Q:\some\dir\Expat-X.Y.ZZ.  Choose your installation location for expat
42and then compile Neon with
43
44  nmake /f neon.mak EXPAT_SRC=\path\to\Expat-X.YY.Z
45
46NOTE: When you run your program make sure the LIBEXPAT.DLL from expat
47is accessible, i.e. is in your PATH.
48
49This should work with Microsoft VC++ 5 and 6.
50
51
52Build neon with dynamically linked SSL support
53______________________________________________
54
55To build neon on Windows with SSL support you need OpenSSL already
56installed on your system (I used OpenSSL 0.9.7g).  It can be
57downloaded from
58
59  http://www.openssl.org/source/openssl-0.9.7g.tar.gz
60
61After compiling OpenSSL, now simply point make to the OpenSSL sources:
62
63  nmake /f neon.mak OPENSSL_SRC=\path\to\openssl
64
65NOTE: The include files for OpenSSL reside in inc32/ directory
66("../openssl-0.9.7g/inc32").
67
68NOTE: Make sure that your program is linked against libeay32.lib and
69ssleay32.lib (normally in "../openssl-0.9.7g/out32dll") and that
70libeay32.dll and ssleay32.dll is accessible, i.e. is in your PATH.
71
72
73Build neon with statically linked OpenSSL support
74_________________________________________________
75
76If you want to statically link against OpenSSL, then add the
77OPENSSL_STATIC parameter.
78
79  nmake /f neon.mak OPENSSL_SRC=\path\to\openssl OPENSSL_STATIC=yes
80
81
82Build neon with statically linked Zlib support
83______________________________________________
84
85If you want to build Neon with the capability to decompress compressed
86content, then you need to compile against the Zlib library.
87
88Neon's neon.mak file will compile and link the Zlib sources. You need
89Zlib 1.2.1 or later, as previous versions do not include build scripts
90for Win32.
91
92Here's how to compile in Zlib support.
93
94  1) Get one of the Zlib source file packages in Zip format from
95     http://www.gzip.org/zlib/; for example,
96     http://www.gzip.org/zlib/zlib121.zip
97  2) Unzip it.
98
99Now add the ZLIB_SRC parameter to Neon's neon.mak pointing to your
100newly compiled zlib.
101
102  nmake /f neon.mak ZLIB_SRC=\path\to\zlib
103
104
105Build neon with dynamically linked Zlib support
106_______________________________________________
107
108To build Neon with dynamically linked Zlib support, use the
109instructions for the statically linked Zlib support above and add the
110ZLIB_DLL parameter
111
112  nmake /f neon.mak ZLIB_SRC=\path\to\zlib ZLIB_DLL=yes
113
114
115Build neon with IPv6 support
116____________________________
117
118To build neon with support for IPv6, use parameter ENABLE_IPV6.
119
120  nmake /f neon.mak ENABLE_IPV6=yes
121
122This requires a copy of the Platform SDK which contains the IPv6
123headers and libraries.
124
125Build neon with debugging support
126_________________________________
127
128Set the DEBUG_BUILD parameter
129
130  nmake /f neon.mak DEBUG_BUILD=yes
131
132It does not matter what value DEBUG_BUILD is set to, as long as it is
133not set to "".
134
135After compiling the library, the directory contains libneonD.lib,
136against which you can link your program.
137