U.S. Geological Survey
WAIS for Windows (WinWAIS) Version 2.4 

This floppy or .zip file contains USGS WinWAIS Version 2.4.  WinWAIS 2.4 
includes bug fixes for problems discovered with the WinWAIS 2.3 release.  
Considerable new functionality is also included in this release.

New for Version 2.4 
   
1. The SLIP dialer has been removed from WinWAIS and established as a    
   separate windows applicaion.  WAISDIAL is still called from WinWAIS, 
   but may also br run independently.
     
   Several new statements have been added to the SLIP dial scripting
   language:
     
     file ini-filename   <-- names a xxx.ini file to be updated during
                             script processing
     section sectionname <-- names a section within a .ini file that will
                             be updated during script processing  
     set ini-value=capture | speed | port | other-value                       
                        
   See the script provided in wais.slp for a Trumpet TCP example. 
     
2. Problems fetching non-text documents from some servers have been fixed.

3. Problems fetching WAIS source descriptions from some servers have been
   fixed.

4. Horizontal scroll bars have been added to the viewing window.

5. All local server code has been removed from WAIS.DLL.  This decreases
   the size of the DLL.

6. WinSock TCP/IP calls have been rewritten to avoid problems with the
   "linger" option that seem to plague some winsock implementations.
     
New for Version 2.3.

     Waterloo TCP has been replaced with Trumpet TCP. There is no longer 
     a separate TCP setup for WinWAIS.

     SLIP dialing has been rewritten to use Trumpet TCP.  The X00 FOSSIL
     driver is no longer used.

     The VT100 telnet that was included in prior releases has been moved to
     a separate application (VTTelnet).  VTTelnet is automatically installed
     during WinWAIS installation.

   Version 2.3A Bug Fixes:

     Non text files were truncated when associated with text files of a
     smaller length when received from some multitype servers.

Version 2.2B Bug Fixes: 
   
     In 2.2A, retrieval for a non text document from a file of less than
     29K bytes sometimes caused a null file to be returned.

     The change button in the source edit window would never allow a change.
     It required that the old source be deleted, and the new source added.

     The temp file name passed to filter programs did not include path
     information from the TMP or TEMP environment variable that is used
     to place the temporary file on disk.  This resulted in the filter 
     program failing to locate the input file.

New for Version 2.2A:

     The WAIS Source window now displays the entire source description,  
     including the technical contact portion of the .src.

     Up to 500 sources may be displayed per source group (was 100) 
     
     A list of all WAIS sources cataloged on the Directory of Servers as
     of 9/15/94 is included in the distribution.  This file is named 
     ALLSRC.SRC, and must be manually copied to the target directory.    
     
       Example:  expand b:allsrc.sr_ c:\wais\allsrc.src
     
     Bug Fixes:  
       
       The WAIS, WATSTUB and WINSTUB DLL's have been compiled to access the
       appropriate DGROUP for each DLL.

       An updated version of VER.DLL is included in the distribution.  This
       should fix problems encountered by some when installing THREED.VBX

New for Version 2.2:

     Visual Basic Version 3.0 was used to compile WAIS.EXE and WSSETUP.EXE. 
     Earlier versions of some system .VBX and .DLL files must be replaced
     with versions from this installation.  If you get incompatability 
     errors check to make sure you don't have an earlier version of the
     offending file in a directory included in your PATH statement.
     
     Source Groups 
      
       Information source "groups" have been added.  An information source 
       assigned to a particular group is only shown as an available source 
       when the group is selected.  This allows you to reduce the length of
       each set of source listings by assigning only thoses sources related
       to a particular interest area to each group.  For example, a group
       named SERVERS may be defined to hold only entries for directories
       of servers.  The default group name when WinWAIS is installed is
       WAIS.  Other may be defined by changing the Source Group name in
       either the Sources Editor or when a new source is displayed after 
       an inquiry.
     
     Wais Source Display 
      
       When a WAIS source is presented in response to searching a directory
       of servers, a unique viewing window is opened to display the source
       description.
     
     Math Coprocessor Test for the Map Window
      
       A warning is issued if an attempt is made to display the spatial 
       searching map on a machine without a hardware math coprocessor.  The 
       map takes several minutes to draw when no coprocessor is present.

     Tempory File Assignments

       WinWAIS temporary files are now assigned to the directory named in 
       the TEMP or TMP environment variables.

     Internal Enhancements

       Memory management now uses Windows subsegment allocation techniques.  
       This reduces the overhead for memory allocation by around a factor
       of four.

       Yield functions have been improved in both client and server 
       components. 
   
       Get next and get previous functions have been completely rewritten
       to improve memory efficiency.

       Relevance feedback functions have been completely rewritten to 
       improve memory efficiency.

       All DLL's have been relinked to use paragraph segment boundaries.  

     Bug Fixes

       Blank source lines may no longer be added to information source 
       definition files.

       A HUGE memory leak has been plugged.

       Phantom button click events when using the tool bars have been 
       fixed.

       A winsock error code 10042 during close has been fixed.

     Unresolved Bugs:

       The setup program still gets confused when installing to network
       drives.  This is the way Microsoft put setup together, and there's
       really nothing I can do to fix it.

   Still available from Version 2.1:
   
     Support for either an embedded TCP/IP stack or Windows Sockets is
     included.  Setup will ask you to specify the combination of TCPs
     to be supported.  Note that dummy DLLs are placed in your target
     installation directory for the options that are NOT selected, i.e.,
     a dummy WINSOCK.DLL if Windows Sockets is NOT selected, and a dummy
     WATTCP.DLL if Waterloo TCP/IP is NOT selected.  These must be deleted
     if you choose to change TCP/IP options by reinstalling WinWAIS.

     Multiple document types is supported.

     Online help is available at any time by either selecting help from 
     the menu line or by pressing F1.
   
   Still available from Version 2.0:
   
     Novell ODI support via the ODIPKT driver developed by Daniel 
     Lanciani.
   
     SLIP serial communications support, including an embedded scripting 
     language for dialing and logging onto a SLIP server.  (SLIP acccess
     uses the X00 FOSSIL driver developed by Raymond L. Gwinn.  Please be
     sure to read the LICENSE.TXT file if you use this driver). 
   
     Direct access to the full set of Clarkson packet drivers.  These may
     be loaded prior to invoking Windows, or may be loaded and accessed
     dynamically by WinWAIS.

     Multiple retrieved files management, to allow non-text files to be 
     passed to processing filters.  Paint Shop Professional (PSP) is  
     included with this distribution for viewing GIF, TIFF, and a variety
     of other image formats.  Please read the PSP license notice if you
     choose to use PSP as your imaging filter.

     USGS spatial searching and an embedded telnet emulator are included
     within USGS WinWAIS.

     The various windows and panels have been buffed up quite a bit, and
     ribbon bars have been added for most commonly used functions.

Installation:

   IF YOU HAVE PROBLEMS RUNNING THE SETUP PROGRAM, A BATCH FILE NAMED
   UNPACK.BAT IS INCLUDED WITH THE WINWAIS DISTRIBUTION.  RUN THIS
   BATCH FILE TO MANUALLY DECOMPRESS THE INSTALLATION FILES.  OTHERWISE: 
   
   Unzip the distribution file into a convenient directory, or, if you
   received this distribution on a floppy disk, place the disk in your a:
   or b: drive.

   Start Windows

   From the Program Manager select file/run and enter drive:\path\setup
   
   Floppy disk example:
    
       a:setup

   Hard disk example:

       c:\waisdist\setup

   Setup will display "c:\wais" as the default installation drive and 
   directory.  You may accept this default or change it to something 
   else.

   Setup will ask you to select TCP/IP installation options.  These
   include whether to support Windows Sockets, the embedded TCP/IP
   that comes with WinWAIS, and to select packet drivers for inclusion 
   in your destination WAIS directory.  You may select drivers at this
   time, may choose to use other drivers by loading them prior to
   invoking Windows, or may move drivers to the destination WAIS
   directory at a later time.  The WAIS TCP/IP Setup will only allow
   you to select drivers that are included in the destination WAIS
   directory and are defined in the file named WAIS.DRV.  (The WAIS.DRV
   file includes the name of the driver, it's title, and information
   for formatting parameters that are passed to the driver when it is
   loaded by WinWAIS.)

   Setup will decompress the distribution files, place them in your 
   destination directory, and will create a program group and WinWAIS 
   icon.

Source code:

   US Geological Survey wants others to benefit from and further this 
   work.  Source code will be provided upon request, subject only to 
   the condition that the USGS must be acknowledged in a Help/About 
   WinWAIS message box that will be displayed by all versions of 
   this program.  Also, no copyright or other restriction may be placed 
   on this work.  Of course, portions of derived works that originate 
   with others may be copyrighted.  Source may be downloaded as follows:

     >ftp ridgisd.er.usgs.gov (130.11.48.107)
     >user anonymous
     >pswd anything
     >cd software/wais
     >type binary
     >get wnwsrc23.zip

   Unzip as follows:
   
     pkunzip -d wnwsrc23 (the -d option is needed to create the 
                         various subdirectories)

   The following files are created in the target directory:

     readme.txt  - this file 
     floppy.bat  - makes each subdirectory and compresses executables
                   into the ..\floppy subdirectory
     cleanup.bat - runs "make clean" in various subdirectories to 
                   remove intermediate and executable files 
   
   The following directories are created subordinate to the directory 
   containing the .zip file:

     ir      - WAIS C code and a makefile that creates WAIS.DLL 
     packet  - Clarkson driver source and a makefile that
               creates the XXX.COM packet drivers used by WinWAIS
     setup   - VB source code for the WSSETUP.EXE module
     vb      - VB source code for the WAIS.EXE module
     help    - rtf format source and bmp files used to create the 
               WAIS.HLP file (compile by running the help compiler: 
               hc31 wais)
     telnet  - VB source code for a telnet emulator that's accessed 
               by WinWAIS.  This module may be separately compiled and  
               executed as a stand alone application.
     lib     - a collection of object libraries used during C 
               compilations.  These modules are placed here purely as
               a convenience.
     util    - odds and ends utilities--usually written in qbasic
     floppy  - the place where all the executable and reference files
               are collected for the distribution version of WinWAIS

   There are no longer any dependencies on the order in which the 
   various EXEs and DLLs are built.  Each makefile may be run as
   needed to recreate its DLLs or EXEs.  They are created in their
   home directories, and may be moved to \floppy either by hand or
   by running FLOPPY.BAT.  COMPRESS is used to establish the files 
   in \floppy.  Here's an example: 
   
    compress -r wais.dll ..\floppy

   
Please send all comments and suggestions to:

  tgauslin@isdres.er.usgs.gov

Enjoy!!!
