Version: vns2.1.x
Updated: 05/13/91
Copyright (c) 1991, Baylor College of Medicine.

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

   This file contains the information on building the Virtual Notebook
   System (VNS). Before attempting to build this software, you should
   read the INSTALL file first to make sure that you have setup and 
   install this software into a secure account under the user "vns".
   The INSTALL file also contains information about setting up the 
   flat-file version of the VNS server and general hints for getting
   started.

Source Tree Description
-----------------------

 appl       - VNS applications.
 bitmaps    - bitmaps used in VNS.
 docs       - documentation on VNS.
 include    - include files for the source tree.
 lib        - source for various link libraries.
 server     - The VNS server (dbsrv) and various database drivers.
 util       - system administration utilities and scripts.

Build Requirements
------------------

   To build this release of the Virtual Notebook System, the following
   external libraries are required:

     Release 4 of the X windows libraries:
      - libXmu.a
      - libXext.a
      - libX11.a
      - libXt.a

     Release 1.1 of Motif:
      - libXm.a

     Either Sybase database system and client libraries:
      - libsybdb.a

     OR the ndbm database libraries.

   The program "imake" (used to build X) must also be available on the
   build platform. The following build steps assumme that the script "xmkmf"
   also exists on your platform which configures the Makefiles for your
   site.

Building the Virtual Notebook System
------------------------------------

 1. First, look at the file "VNSImake.defs" in the top level directory.
    This file is included by all of the other Imake files in the source
    tree and contains several important defines. You should set the
    VNSTOP path for the full path to the top of the source tree. Also,
    the defines for the Motif library and include files should also 
    be set. THe install information may also need to be modified so that
    the executables are correctly installed for your site.

 2. Run "xmkmf" in the top directory to build the initial Makefile for
    the source tree and configure everything for your site.

 3. Now you are ready to build the entire release by typing:

       % make World >& make.world

    This will build everything in the entire source tree, saving a log
    of the build into the file make.world.

 4. If the build was successful, you are now prepared to install the
    binaries by typing:

       % make install

    Currently, only the srvlib and vns_comm libraries are installed.


Questions and Comments
----------------------

   If you have any questions or comments about the software, feel
   free to send them to:

       Barry Meyer
       Member of Technical Staff
       IAIMS Development
       V.P. Ofiice for Information Technology
       One Baylor Plaze
       Houston, Texas 77030
       internet: bmeyer@bcm.tmc.edu