Build Instructions For XML-RPC For C/C++ On Windows
---------------------------------------------------

-------------------------------------------------------------------------
These instructions are for static link libraries, using Microsoft Visual
Studio 7 and later.  There are project files to create DLLs, using
Visual Studio 2008 or later, in the 'dll' subdirectory.  People maintain
those project files separately from the rest of the build system, so it's
not uncommon for something to work with one but not the other.
-------------------------------------------------------------------------


1. Run the batch file ConfigureWin32.bat, found in the Windows
directory. This will copy four(4) headers to the appropriate folders.

2. Load xmlrpc.dsw in MSVC[7,8] or later, and build the Release or Debug
configurations. DLL configurations are not included, and may not compile.

This build requires that you have a Microsoft SDK, or Plaform SDK
installed, since among other things, it uses <http.h>, and
HTTPAPI.LIB, from the SDK.

Once built, the rpctest.exe, in the bin folder, should run with no errors,
and the xmlrpc_sample_add_server.exe, using port 8080, and
xmlrpc_sample_add_sync_client.exe should communicate ... proving 7+5 = 12 ;=))

Have fun.

PS: Several other batch files are included in the Windows folder ...

delsln.bat - to delete all the MSVC7 and 8 solution file.

diffcfg.bat - compare the headers in windows with the version used in
the compile. Requires diff.exe to be in the path.

updcfg.bat - copy the 3 manually maintained configuration files back
to the Windows folder (for distribution).

cleawin32.bat - deletes the headers used in the compile. That is does the
opposite of ConfigureWin32.bat.

cleanall.bat - to remove ALL the binary files created. Requires an xdelete
program which will recursively delete an entire folder.


There is some historical information in ReadMeOld.txt, which used to be
the contents of this file.  Some of it is still valid.


Developing XML-RPC For C/C++ for Windows
----------------------------------------

If you fix or enhance something in the Windows build system, please send
your updates to the Xmlrpc-c maintainer to be included in future releases
so others don't have to repeat your work.

Output of a Subversion 'diff' is usually the best way to send updates,
but you can also send complete files or just a description of the
change if that is easier.

For the project files, we distribute only MSVC6-compatible DSP and DSW
files (which are, of course, usable as input to later versions of MSVC
as well).  That means if you need to modify something in the project
files and you are not using MSVC6, you must edit the project files
manually as text files.  Modifying them via the IDE would simply
generate new files in a format that cannot be used with older MSVC.