Note: This code was built on WIndows XP using libdap 3.7.10 in Feb 2008 with only minor modifications to the VCPP/Makefile. James Gallagher 22 Feb 2008 -------------------------- These are the instructions that accompany each Windows release of the OPeNDAP Core Library known as "libdap". Introduction ------------ This is the 3.7.3 release of libdap for MS Windows XP (or later) on 32-bit machines. It was built using Visual C++ 8.x. Both static and dynamic versions of the Core libraries are provided. You must have the prerequisites for this distribution installed before installing this distribution. The prerequisites are contained in the libdap-prerequisites3.7.3.zip file available from http://opendap.org. Purposes of this Distribution ----------------------------- This distribution serves three purposes: 1) The Dynamic-link libraries necessary for running executables based upon this version of libdap are provided. 2) The export libraries and the associated headers that are required to OPeNDAP enable 3rd-party applications that are to be based upon this specific version of libdap are provided. Dynamic-link libraries necessary to run such applications are also provided. These are the tools that experienced developers require to OPeNDAP-enable their applications. The documentation that specifies the interface to the OPeNDAP Core Library is not provided with this release. With this distriubution, an experienced developer should be able to link their software with libdap to OPeNDAP-enable it. See the 'sample' subdirectory for a makefile that details how to compile and link. Sample code is also provided. 3) Provides instructions for rebuilding this version of libdap from source code. Contents -------- bin/ - Contains a basic OPeNDAP client "getdap" dll/ - Provides the run-time dynamic link libraries etc/ - Contains the 'deflate' program include/ - Contains the headers necessary to compile lib/ - Contains the libraries needed to link. Both a static and dynamic version of the OPeNDAP Core library (libdapMT.lib and libdapMD.lib respectively) are provided. sample/ - Contains sample code and a sample makefile readme.txt - This readme file Installation Instruction ------------------------ 1) Install the prerequisites outlined above 2) Drag-n-drop the 'bin', 'dll', 'include', 'lib', 'etc' and 'sample' directories found in this distriubution to C:\opendap. If prompted to over write the existing directory structure, choose 'Yes to all'. 3) Place C:\opendap\bin and C:\opendap\dll on your execution path. Test the Install: 1) Open a DOS window 2) Issue the following command C:\> getdap --help If the install is successful, you should see the usage message for the getdap utility. Rebuilding from source code --------------------------- To Rebuild libdap 3.7.3 from source code using MS Visual C++ 8.x, the subversion command-line utility and the installed prerequisite package outlined above: 1) Add BISON_HAIRY environment var and set to C:\opendap\include\bison.hairy 2) Add BISON_SIMPLE and set to C:\opendap\include\bison.simple 3) Add INCLUDE environment variable if necessary and add following to it: C:\opendap\include C:\opendap\include\pthreads C:\opendap\include\libxml C:\opendap\include\curl 4) Add LIB environment variable if necessary and add the following to it: C:\opendap\lib Note: Microsoft provides a means of opening a command prompt where compiler command-line tools can be conveniently executed. Under Visual Studio, this is available via the "Visual Studio 2005 Command Prompt" located underneath the start->programs menu. In Visual C++ 8.x an identical mechanism is provided. When we refer to a "command-line" window in the below instructions, we are referring to this Microsoft-provided compiler command prompt. We are not referring to a simple DOS Command Prompt. Open a command-line window and: C:\> cd C:\opendap C:\> svn co http://scm.opendap.org:8090/svn/tags/libdap/3.7.3 libdap3.7.3 C:\> cd libdap3.7.3\VCPP C:\> nmake grammarclean C:\> nmake all December 10, 2006 Robert O. Morris