
These are the instructions that accompany each Windows release of the OPeNDAP
Client-Side Library known as "libnc-dap".

Introduction
------------

This is the 3.7.0 release of libnc-dap 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 netcdf libraries are provided.

An installed version of libdap version 3.7.3 is a prerequisite for this
distribution.  See http://opendap.org and the 'libdap3.7.3.zip' provided
there for further information.

Purposes of this Distribution
-----------------------------

This distribution serves three purposes:

1)  The Dynamic-link libraries necessary for running executables based
    upon this version of libnc-dap are provided.

2)  The export libraries and the associated headers that are required
    to compile and link applications that are to be based upon this
    specific version of libnc-dap are provided.  Dynamic-link libraries necessary
    to run such applications are also provided.

    The documentation that specifies the interface to the libnc-dap Library
    is not provided with this release.  With this distriubution, an experienced
    developer should be able to compile and link their software with libnc-dap.

3)  Provides instructions for rebuilding this version of libnc-dap from source
    code.

Contents
--------

  bin/       - Contains the dncdump utility
  dll/       - Provides the run-time dynamic link library for libnc-dap
  include/   - Contains the headers necessary to compile a libnc-dap based application
  lib/       - Contains the libraries needed to link a libnc-dap based application.  Both
               a static and dynamic version of the libnc-dap library (libnc-dapMT.lib
               and libdnc-dapMD.lib respectively) are provided.
  readme.txt - This readme file


Installation Instruction
------------------------

   1)  Install the prerequisites outlined above

   2)  Drag-n-drop the 'bin', 'dll', 'include', and 'lib' directories
       found in this distriubution to C:\opendap.  If prompted to over write the
       existing directory structure, choose 'Yes to all'.

   Test the Install:

   1)  Open a DOS window

   2)  Issue the following command

       C:\> dncdump

       If the install is successful, you should see the usage message for the dncdump
       utility.



Rebuilding from source code
---------------------------

  To Rebuild libnc-dap 3.7.0 from source code using MS Visual C++ 8.x,
  the subversion command-line utility and the installed prerequisite package
  outlined above:


  1)  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

  2)  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.

  To Rebuild libnc-dap 3.7.0 from source code using MS Visual C++ 8.x,
  the subversion command-line utility and the installed prerequisite package
  outlined above:
  
  Open a command-line window and:

      C:\> cd C:\opendap
      C:\> svn co http://scm.opendap.org:8090/svn/tags/libnc-dap/3.7.0 libnc-dap3.7.0
      C:\> cd libnc-dap3.7.0\VCPP
      C:\> nmake all


December 10, 2006
Robert O. Morris



