home *** CD-ROM | disk | FTP | other *** search
/ The Best Internet Programs / BESTINTERNET.bin / internet / winwais / readme.txt < prev    next >
Encoding:
Text File  |  1994-03-15  |  12.6 KB  |  312 lines
  1. U.S. Geological Survey
  2. WAIS for Windows (WinWAIS) Version 2.4 
  3.  
  4. This floppy or .zip file contains USGS WinWAIS Version 2.4.  WinWAIS 2.4 
  5. includes bug fixes for problems discovered with the WinWAIS 2.3 release.  
  6. Considerable new functionality is also included in this release.
  7.  
  8. New for Version 2.4 
  9.    
  10. 1. The SLIP dialer has been removed from WinWAIS and established as a    
  11.    separate windows applicaion.  WAISDIAL is still called from WinWAIS, 
  12.    but may also br run independently.
  13.      
  14.    Several new statements have been added to the SLIP dial scripting
  15.    language:
  16.      
  17.      file ini-filename   <-- names a xxx.ini file to be updated during
  18.                              script processing
  19.      section sectionname <-- names a section within a .ini file that will
  20.                              be updated during script processing  
  21.      set ini-value=capture | speed | port | other-value                       
  22.                         
  23.    See the script provided in wais.slp for a Trumpet TCP example. 
  24.      
  25. 2. Problems fetching non-text documents from some servers have been fixed.
  26.  
  27. 3. Problems fetching WAIS source descriptions from some servers have been
  28.    fixed.
  29.  
  30. 4. Horizontal scroll bars have been added to the viewing window.
  31.  
  32. 5. All local server code has been removed from WAIS.DLL.  This decreases
  33.    the size of the DLL.
  34.  
  35. 6. WinSock TCP/IP calls have been rewritten to avoid problems with the
  36.    "linger" option that seem to plague some winsock implementations.
  37.      
  38. New for Version 2.3.
  39.  
  40.      Waterloo TCP has been replaced with Trumpet TCP. There is no longer 
  41.      a separate TCP setup for WinWAIS.
  42.  
  43.      SLIP dialing has been rewritten to use Trumpet TCP.  The X00 FOSSIL
  44.      driver is no longer used.
  45.  
  46.      The VT100 telnet that was included in prior releases has been moved to
  47.      a separate application (VTTelnet).  VTTelnet is automatically installed
  48.      during WinWAIS installation.
  49.  
  50.    Version 2.3A Bug Fixes:
  51.  
  52.      Non text files were truncated when associated with text files of a
  53.      smaller length when received from some multitype servers.
  54.  
  55. Version 2.2B Bug Fixes: 
  56.    
  57.      In 2.2A, retrieval for a non text document from a file of less than
  58.      29K bytes sometimes caused a null file to be returned.
  59.  
  60.      The change button in the source edit window would never allow a change.
  61.      It required that the old source be deleted, and the new source added.
  62.  
  63.      The temp file name passed to filter programs did not include path
  64.      information from the TMP or TEMP environment variable that is used
  65.      to place the temporary file on disk.  This resulted in the filter 
  66.      program failing to locate the input file.
  67.  
  68. New for Version 2.2A:
  69.  
  70.      The WAIS Source window now displays the entire source description,  
  71.      including the technical contact portion of the .src.
  72.  
  73.      Up to 500 sources may be displayed per source group (was 100) 
  74.      
  75.      A list of all WAIS sources cataloged on the Directory of Servers as
  76.      of 9/15/94 is included in the distribution.  This file is named 
  77.      ALLSRC.SRC, and must be manually copied to the target directory.    
  78.      
  79.        Example:  expand b:allsrc.sr_ c:\wais\allsrc.src
  80.      
  81.      Bug Fixes:  
  82.        
  83.        The WAIS, WATSTUB and WINSTUB DLL's have been compiled to access the
  84.        appropriate DGROUP for each DLL.
  85.  
  86.        An updated version of VER.DLL is included in the distribution.  This
  87.        should fix problems encountered by some when installing THREED.VBX
  88.  
  89. New for Version 2.2:
  90.  
  91.      Visual Basic Version 3.0 was used to compile WAIS.EXE and WSSETUP.EXE. 
  92.      Earlier versions of some system .VBX and .DLL files must be replaced
  93.      with versions from this installation.  If you get incompatability 
  94.      errors check to make sure you don't have an earlier version of the
  95.      offending file in a directory included in your PATH statement.
  96.      
  97.      Source Groups 
  98.       
  99.        Information source "groups" have been added.  An information source 
  100.        assigned to a particular group is only shown as an available source 
  101.        when the group is selected.  This allows you to reduce the length of
  102.        each set of source listings by assigning only thoses sources related
  103.        to a particular interest area to each group.  For example, a group
  104.        named SERVERS may be defined to hold only entries for directories
  105.        of servers.  The default group name when WinWAIS is installed is
  106.        WAIS.  Other may be defined by changing the Source Group name in
  107.        either the Sources Editor or when a new source is displayed after 
  108.        an inquiry.
  109.      
  110.      Wais Source Display 
  111.       
  112.        When a WAIS source is presented in response to searching a directory
  113.        of servers, a unique viewing window is opened to display the source
  114.        description.
  115.      
  116.      Math Coprocessor Test for the Map Window
  117.       
  118.        A warning is issued if an attempt is made to display the spatial 
  119.        searching map on a machine without a hardware math coprocessor.  The 
  120.        map takes several minutes to draw when no coprocessor is present.
  121.  
  122.      Tempory File Assignments
  123.  
  124.        WinWAIS temporary files are now assigned to the directory named in 
  125.        the TEMP or TMP environment variables.
  126.  
  127.      Internal Enhancements
  128.  
  129.        Memory management now uses Windows subsegment allocation techniques.  
  130.        This reduces the overhead for memory allocation by around a factor
  131.        of four.
  132.  
  133.        Yield functions have been improved in both client and server 
  134.        components. 
  135.    
  136.        Get next and get previous functions have been completely rewritten
  137.        to improve memory efficiency.
  138.  
  139.        Relevance feedback functions have been completely rewritten to 
  140.        improve memory efficiency.
  141.  
  142.        All DLL's have been relinked to use paragraph segment boundaries.  
  143.  
  144.      Bug Fixes
  145.  
  146.        Blank source lines may no longer be added to information source 
  147.        definition files.
  148.  
  149.        A HUGE memory leak has been plugged.
  150.  
  151.        Phantom button click events when using the tool bars have been 
  152.        fixed.
  153.  
  154.        A winsock error code 10042 during close has been fixed.
  155.  
  156.      Unresolved Bugs:
  157.  
  158.        The setup program still gets confused when installing to network
  159.        drives.  This is the way Microsoft put setup together, and there's
  160.        really nothing I can do to fix it.
  161.  
  162.    Still available from Version 2.1:
  163.    
  164.      Support for either an embedded TCP/IP stack or Windows Sockets is
  165.      included.  Setup will ask you to specify the combination of TCPs
  166.      to be supported.  Note that dummy DLLs are placed in your target
  167.      installation directory for the options that are NOT selected, i.e.,
  168.      a dummy WINSOCK.DLL if Windows Sockets is NOT selected, and a dummy
  169.      WATTCP.DLL if Waterloo TCP/IP is NOT selected.  These must be deleted
  170.      if you choose to change TCP/IP options by reinstalling WinWAIS.
  171.  
  172.      Multiple document types is supported.
  173.  
  174.      Online help is available at any time by either selecting help from 
  175.      the menu line or by pressing F1.
  176.    
  177.    Still available from Version 2.0:
  178.    
  179.      Novell ODI support via the ODIPKT driver developed by Daniel 
  180.      Lanciani.
  181.    
  182.      SLIP serial communications support, including an embedded scripting 
  183.      language for dialing and logging onto a SLIP server.  (SLIP acccess
  184.      uses the X00 FOSSIL driver developed by Raymond L. Gwinn.  Please be
  185.      sure to read the LICENSE.TXT file if you use this driver). 
  186.    
  187.      Direct access to the full set of Clarkson packet drivers.  These may
  188.      be loaded prior to invoking Windows, or may be loaded and accessed
  189.      dynamically by WinWAIS.
  190.  
  191.      Multiple retrieved files management, to allow non-text files to be 
  192.      passed to processing filters.  Paint Shop Professional (PSP) is  
  193.      included with this distribution for viewing GIF, TIFF, and a variety
  194.      of other image formats.  Please read the PSP license notice if you
  195.      choose to use PSP as your imaging filter.
  196.  
  197.      USGS spatial searching and an embedded telnet emulator are included
  198.      within USGS WinWAIS.
  199.  
  200.      The various windows and panels have been buffed up quite a bit, and
  201.      ribbon bars have been added for most commonly used functions.
  202.  
  203. Installation:
  204.  
  205.    IF YOU HAVE PROBLEMS RUNNING THE SETUP PROGRAM, A BATCH FILE NAMED
  206.    UNPACK.BAT IS INCLUDED WITH THE WINWAIS DISTRIBUTION.  RUN THIS
  207.    BATCH FILE TO MANUALLY DECOMPRESS THE INSTALLATION FILES.  OTHERWISE: 
  208.    
  209.    Unzip the distribution file into a convenient directory, or, if you
  210.    received this distribution on a floppy disk, place the disk in your a:
  211.    or b: drive.
  212.  
  213.    Start Windows
  214.  
  215.    From the Program Manager select file/run and enter drive:\path\setup
  216.    
  217.    Floppy disk example:
  218.     
  219.        a:setup
  220.  
  221.    Hard disk example:
  222.  
  223.        c:\waisdist\setup
  224.  
  225.    Setup will display "c:\wais" as the default installation drive and 
  226.    directory.  You may accept this default or change it to something 
  227.    else.
  228.  
  229.    Setup will ask you to select TCP/IP installation options.  These
  230.    include whether to support Windows Sockets, the embedded TCP/IP
  231.    that comes with WinWAIS, and to select packet drivers for inclusion 
  232.    in your destination WAIS directory.  You may select drivers at this
  233.    time, may choose to use other drivers by loading them prior to
  234.    invoking Windows, or may move drivers to the destination WAIS
  235.    directory at a later time.  The WAIS TCP/IP Setup will only allow
  236.    you to select drivers that are included in the destination WAIS
  237.    directory and are defined in the file named WAIS.DRV.  (The WAIS.DRV
  238.    file includes the name of the driver, it's title, and information
  239.    for formatting parameters that are passed to the driver when it is
  240.    loaded by WinWAIS.)
  241.  
  242.    Setup will decompress the distribution files, place them in your 
  243.    destination directory, and will create a program group and WinWAIS 
  244.    icon.
  245.  
  246. Source code:
  247.  
  248.    US Geological Survey wants others to benefit from and further this 
  249.    work.  Source code will be provided upon request, subject only to 
  250.    the condition that the USGS must be acknowledged in a Help/About 
  251.    WinWAIS message box that will be displayed by all versions of 
  252.    this program.  Also, no copyright or other restriction may be placed 
  253.    on this work.  Of course, portions of derived works that originate 
  254.    with others may be copyrighted.  Source may be downloaded as follows:
  255.  
  256.      >ftp ridgisd.er.usgs.gov (130.11.48.107)
  257.      >user anonymous
  258.      >pswd anything
  259.      >cd software/wais
  260.      >type binary
  261.      >get wnwsrc23.zip
  262.  
  263.    Unzip as follows:
  264.    
  265.      pkunzip -d wnwsrc23 (the -d option is needed to create the 
  266.                          various subdirectories)
  267.  
  268.    The following files are created in the target directory:
  269.  
  270.      readme.txt  - this file 
  271.      floppy.bat  - makes each subdirectory and compresses executables
  272.                    into the ..\floppy subdirectory
  273.      cleanup.bat - runs "make clean" in various subdirectories to 
  274.                    remove intermediate and executable files 
  275.    
  276.    The following directories are created subordinate to the directory 
  277.    containing the .zip file:
  278.  
  279.      ir      - WAIS C code and a makefile that creates WAIS.DLL 
  280.      packet  - Clarkson driver source and a makefile that
  281.                creates the XXX.COM packet drivers used by WinWAIS
  282.      setup   - VB source code for the WSSETUP.EXE module
  283.      vb      - VB source code for the WAIS.EXE module
  284.      help    - rtf format source and bmp files used to create the 
  285.                WAIS.HLP file (compile by running the help compiler: 
  286.                hc31 wais)
  287.      telnet  - VB source code for a telnet emulator that's accessed 
  288.                by WinWAIS.  This module may be separately compiled and  
  289.                executed as a stand alone application.
  290.      lib     - a collection of object libraries used during C 
  291.                compilations.  These modules are placed here purely as
  292.                a convenience.
  293.      util    - odds and ends utilities--usually written in qbasic
  294.      floppy  - the place where all the executable and reference files
  295.                are collected for the distribution version of WinWAIS
  296.  
  297.    There are no longer any dependencies on the order in which the 
  298.    various EXEs and DLLs are built.  Each makefile may be run as
  299.    needed to recreate its DLLs or EXEs.  They are created in their
  300.    home directories, and may be moved to \floppy either by hand or
  301.    by running FLOPPY.BAT.  COMPRESS is used to establish the files 
  302.    in \floppy.  Here's an example: 
  303.    
  304.     compress -r wais.dll ..\floppy
  305.  
  306.    
  307. Please send all comments and suggestions to:
  308.  
  309.   tgauslin@isdres.er.usgs.gov
  310.  
  311. Enjoy!!!
  312.