"SfR Fresh" - the SfR Freeware/Shareware Archive

Member "libdap-3.8.2/VCPP/doc/readme.txt" of archive libdap-3.8.2.tar.gz:

    1 
    2 Note: This code was built on WIndows XP using libdap 3.7.10 in Feb 2008 with
    3 only minor modifications to the VCPP/Makefile. 
    4 
    5 James Gallagher
    6 22 Feb 2008
    7 --------------------------
    8 
    9 These are the instructions that accompany each Windows release of the OPeNDAP
   10 Core Library known as "libdap".
   11 
   12 Introduction
   13 ------------
   14 
   15 This is the 3.7.3 release of libdap for MS Windows XP (or later) on 32-bit
   16 machines.  It was built using Visual C++ 8.x.  Both static and dynamic
   17 versions of the Core libraries are provided.
   18 
   19 You must have the prerequisites for this distribution installed before
   20 installing this distribution.  The prerequisites are contained in the
   21 libdap-prerequisites3.7.3.zip file available from http://opendap.org.
   22 
   23 
   24 Purposes of this Distribution
   25 -----------------------------
   26 
   27 This distribution serves three purposes:
   28 
   29 1)  The Dynamic-link libraries necessary for running executables based
   30     upon this version of libdap are provided.
   31 
   32 2)  The export libraries and the associated headers that are required
   33     to OPeNDAP enable 3rd-party applications that are to be based upon this
   34     specific version of libdap are provided.  Dynamic-link libraries necessary
   35     to run such applications are also provided.  These are the tools that
   36     experienced developers require to OPeNDAP-enable their applications.
   37 
   38     The documentation that specifies the interface to the OPeNDAP Core Library
   39     is not provided with this release.  With this distriubution, an experienced
   40     developer should be able to link their software with libdap to OPeNDAP-enable
   41     it.
   42 
   43     See the 'sample' subdirectory for a makefile that details how to compile and
   44     link.  Sample code is also provided.
   45 
   46 3)  Provides instructions for rebuilding this version of libdap from source
   47     code.
   48 
   49 Contents
   50 --------
   51 
   52   bin/       - Contains a basic OPeNDAP client "getdap"
   53   dll/       - Provides the run-time dynamic link libraries
   54   etc/       - Contains the 'deflate' program
   55   include/   - Contains the headers necessary to compile
   56   lib/       - Contains the libraries needed to link.  Both a static and
   57                dynamic version of the OPeNDAP Core library (libdapMT.lib
   58                and libdapMD.lib respectively) are provided.
   59   sample/    - Contains sample code and a sample makefile
   60   readme.txt - This readme file
   61 
   62 
   63 
   64 Installation Instruction
   65 ------------------------
   66 
   67    1)  Install the prerequisites outlined above
   68 
   69    2)  Drag-n-drop the 'bin', 'dll', 'include', 'lib', 'etc' and 'sample' directories
   70        found in this distriubution to C:\opendap.  If prompted to over write the
   71        existing directory structure, choose 'Yes to all'.
   72 
   73    3)  Place C:\opendap\bin and C:\opendap\dll on your execution path.
   74 
   75    Test the Install:
   76 
   77    1)  Open a DOS window
   78 
   79    2)  Issue the following command
   80 
   81        C:\> getdap --help
   82 
   83        If the install is successful, you should see the usage message for the getdap
   84        utility.
   85 
   86 
   87 
   88 Rebuilding from source code
   89 ---------------------------
   90 
   91 
   92   To Rebuild libdap 3.7.3 from source code using MS Visual C++ 8.x,
   93   the subversion command-line utility and the installed prerequisite package
   94   outlined above:
   95   
   96   1)  Add BISON_HAIRY environment var and set to C:\opendap\include\bison.hairy
   97   2)  Add BISON_SIMPLE and set to C:\opendap\include\bison.simple
   98   3)  Add INCLUDE environment variable if necessary and add following to it:
   99 
  100          C:\opendap\include
  101          C:\opendap\include\pthreads
  102          C:\opendap\include\libxml
  103          C:\opendap\include\curl
  104 
  105   4)  Add LIB environment variable if necessary and add the following to it:
  106 
  107          C:\opendap\lib
  108 
  109   
  110   Note: Microsoft provides a means of opening a command prompt where compiler
  111   command-line tools can be conveniently executed.  Under Visual Studio,
  112   this is available via the "Visual Studio 2005 Command Prompt" located
  113   underneath the start->programs menu.  In Visual C++ 8.x an identical
  114   mechanism is provided.  When we refer to a "command-line" window in the below
  115   instructions, we are referring to this Microsoft-provided compiler command
  116   prompt.  We are not referring to a simple DOS Command Prompt.
  117 
  118   Open a command-line window and:
  119 
  120   C:\> cd C:\opendap
  121   C:\> svn co http://scm.opendap.org:8090/svn/tags/libdap/3.7.3 libdap3.7.3
  122   C:\> cd libdap3.7.3\VCPP
  123   C:\> nmake grammarclean
  124   C:\> nmake all
  125 
  126 
  127 December 10, 2006
  128 Robert O. Morris
  129 
  130 
  131