X-Git-Url: https://git.carlh.net/gitweb/?a=blobdiff_plain;f=win32%2FREADME.txt;h=850624c8e273e731c0f0f33d3f721690a46099a5;hb=4ca942b397d1e6ff69b28aa01a5e5a250103463f;hp=01644c30679adc624c2f81d49e6b4fc2caf50465;hpb=ac3911d072bbc882abcdf8dba81e6862c759d400;p=asdcplib.git

diff --git a/win32/README.txt b/win32/README.txt
index 01644c3..850624c 100755
--- a/win32/README.txt
+++ b/win32/README.txt
@@ -1,2 +1,53 @@
+I. INTRODUCTION
+===============
+
 Hello, and welcome to the Windows build instructions for asdcplib.
 
+
+II. DEPENDENCIES
+================
+
+First, you'll need Microsoft's Visual Studio 2005 or later. A heavyweight edition isn't needed;
+the freely downloadable Express edition works fine.
+
+Next, you'll need an OpenSSL distribution. The absolute, bare minimum needed is 0.9.7. However,
+if this will be used in conjunction with CineCert's other software, the later 0.9.8b
+is needed. That said, the latest revision of OpenSSL as of this writing (0.9.8j) works great.
+Extract and build in the directory of your choice.
+
+For optional XML parsing support, you'll need to use Xerces-C++ 2.7 or 2.8 (3.0 isn't yet
+supported) or Expat 2.0.1 (supported in previous versions of asdcplib). If you'll be using this
+software in conjuction with CineCert's other software, the use of Xerces-C++ is required. As
+with OpenSSL above, if you need/desire XML parsing, extract the source package and build in a
+directory of your choice.
+
+
+III. BUILDING
+=============
+
+There's a build option that changes the behavior of UUID generation. If ENABLE_RANDOM_UUID is
+set at build, then mixed-case UUID generation will be enabled if (and only if) the environment
+variable KM_USE_RANDOM_UUID is set during runtime.
+
+Open a command prompt in which the VS build tools are available on the command line (e.g., the
+"Visual Studio command prompt"). The nmake invocation follows this form:
+C:\>nmake WITH_OPENSSL=<OpenSSL directory> [WITH_XERCES=<Xerces directory>|
+	WITH_XML_PARSER=<Expat directory>] [ENABLE_RANDOM_UUID=1] /f Makefile.mak
+
+On our Windows development machine, the invocation with XML parsing by Xerces-C++ is as such:
+C:\Program Files\asdcplib\win32>nmake WITH_OPENSSL="c:\Program Files\openssl-0.9.8j"
+	WITH_XERCES="C:\Program Files\xerces-c_2_8_0-x86-windows-vc_8_0" /f Makefile.mak
+
+With XML parsing by Expat and random UUID generation enabled:
+C:\Program Files\asdcplib\win32>nmake WITH_OPENSSL="c:\Program Files\openssl-0.9.8j"
+	WITH_XML_PARSER="C:\Program Files\Expat 2.0.1" ENABLE_RANDOM_UUID=1 /f Makefile.mak
+
+Without XML parsing:
+C:\Program Files\asdcplib\win32>nmake WITH_OPENSSL="c:\Program Files\openssl-0.9.8j"
+	/f Makefile.mak
+
+
+IV. CONCLUSION
+==============
+
+For answers to questions, please send a message to <asdcplib@cinecert.com>.