home *** CD-ROM | disk | FTP | other *** search
/ The Best Internet Programs / BESTINTERNET.bin / internet / hgopher / readme.txt < prev   
Encoding:
Text File  |  1994-01-10  |  10.9 KB  |  293 lines
  1.           README for HGOPHER  (Hampson's Gopher) 
  2.  
  3.     A Gopher Client For Windows 3.1  Version 2.4
  4.  
  5.  
  6. Welcome
  7.  
  8. This is a Gopher+ Client for windows 3.1.
  9.  
  10. Send comments or problems on this product to m.hampson@ic.ac.uk
  11.  
  12. For information on winsock consult alt.winsock
  13. For information on gopher  consult comp.infosystems.gopher
  14. For information on PC NFS  consult com.protocols.nfs
  15.  
  16. HGopher now has online help. Please read the on line help section 
  17. called  "read this first" at least.
  18.  
  19. If you are a 2.3 user read the section "What's new in Version 2.4" to
  20. discover the bug fixes and enhencements.
  21.  
  22.  
  23. Requirements
  24.     
  25.     WINSOCK VERSION
  26.  
  27.     * MS Windows 3.1  (not tested with Windows 3.0)
  28.       Or Windows NT.
  29.     * Winsock DLL and TCP/IP+Packet support layer.
  30.     * See later for a list of Winsock tested versions.
  31.  
  32.     PC NFS VERSION
  33.     
  34.     * MS Windows 3.1 (not tested with Windows 3.0)
  35.     * PC NFS Version 4 or version 5 (may work with other versions)
  36.           NOTE: you can also use the Winsock version with PC NFS 5.0
  37.                 and I suggest you do, as support for the native PC NFS
  38.                 version may be withdrawn at some point.
  39.  
  40.  
  41. Installation
  42.  
  43.     Available for ANON FTP from lister.cc.ic.ac.uk
  44.         
  45.     Change to directory pub/wingopher and collect one of the files
  46.  
  47.     hgopher2.4.zip   [Winsock Version]      (Binary mode required)
  48.     hngopher2.4.zip  [Sun PC NFS Version]   (Binary mode required)
  49.  
  50.  
  51.         Unzip the package you have chosen to get 
  52.         hgopher.exe / hngopher.exe        Gopher program
  53.         hgopher.hlp                Online help
  54.         hgcso.exe / hngcso.exe            CSO Viewer
  55.         hgopher.ini                All the defaults
  56.         default.gbm                Some book marks
  57.         readme.txt                This file
  58.  
  59.  
  60.         Install these files in a directory of you choice. You should
  61.         make this the working directory when you run HGopher from
  62.         program manager.
  63.  
  64.         If you have an existing 2.2/2.3 hgopher.ini in your windows directory
  65.         HGopher 2.4 will use that. Else it will use the one in the working
  66.         directory. Old Version 1.0 and 1.1 ini files will cause HGopher 2.4
  67.         a major stress attack - get rid of them.
  68.  
  69.     You should also be able to get this product
  70.         from the following archives
  71.  
  72.     sunsite.unc.edu:<somewhere>        (Probably a day or two delay)
  73.         microdyne.com:/pub/winsock/apps                   ( or look in incoming)
  74.         boombox.micro.umn.edu:/pub/gopher/Windows       (or via their Gopher)
  75.         ftp.york.ac.uk:<somewhere>
  76.  
  77.         But make sure that you are getting the new 2.4 version (ie hgopher2.4.zip)
  78.  
  79.         You can also get HGopher from the "HGopher Information Centre", here's the
  80.         bookmark
  81.  
  82.     #
  83.         Type=1
  84.         Host=gopher.ic.ac.uk
  85.         Port=71
  86.         Path=1/HGopher Information
  87.         #
  88.         # Note the port - 71 NOT 70.
  89.  
  90.  
  91. Troubleshooting
  92.     
  93.     WINSOCK VERSION
  94.  
  95.     The first time you start it hgopher may not be able to 
  96.     connect to a server or will probably connect to the wrong
  97.     server
  98.     Use the Options  menu to config it as follows
  99.  
  100.     Gopher Options
  101.     
  102.     Set the name and path of your favorite gopher server
  103.  
  104.     Select a directory for temp files that already exists
  105.  
  106.     Hit the save button to save these setting between sessions
  107.     Hit the OK button to use these setting now
  108.  
  109.     use "go home" from the command menu to get the main menu 
  110.     from your default gopher.
  111.  
  112.     Network setup
  113.     
  114.     Set whether you are using DNS or the Vendor look up
  115.     service - If your vendor supports DNS lookup themselves
  116.     I suggest you use their service as the inbuilt DNS has
  117.     been shown not to work on some (most) Winsock versions. 
  118.  
  119.     If you are using the Winsock version with PC NFS you must
  120.         use the inbuilt DNS as Sun have not only not bothered to
  121.     implement DNS support but their own NIS does not function
  122.     with their Winsock either (at least at the release level
  123.     I have).
  124.     
  125.     If using the inbuilt DNS remember to use IP addresses and
  126.     not host names.
  127.  
  128.         WINSOCK USERS PLEASE NOTE - The file WINSOCK.DLL is required by this
  129.         program - if you don't have that file you are not running winsock.
  130.         WINSOCK.DLL does not come with HGopher, it is part of the network
  131.         package you are using. WINSOCK.DLL are NOT interchangable you must
  132.         use the correct one for your network stack. Public domain/ Shareware
  133.         WINSOCK stacks are beginning to appear - tune to alt.winsock to stay
  134.         in touch with what is going on in this field.
  135.  
  136.  
  137.     PC NFS VERSION
  138.  
  139.     Make sure at least RTM is loaded before you start Windows
  140.  
  141.     The first time you start it hngopher may not be able to 
  142.     connect to a server or will probably connect to the wrong
  143.     server
  144.     Use the Options menu to config it as follows
  145.  
  146.     Gopher Options
  147.     
  148.     Set the name and path of your favorite gopher server
  149.  
  150.     Select a directory for temp files that already exists
  151.  
  152.     Hit the save button to save these setting between sessions
  153.     Hit the OK button to use these setting now
  154.  
  155.     use "go home" from the command menu to get the main menu 
  156.     from your default gopher.
  157.  
  158.     Network setup
  159.     
  160.     Set whether you are using DNS or the Vendor name lookup
  161.     - with Sun this is NIS  - DNS is better.
  162.     Add up to 3 local DNS servers and your local domain
  163.     Hit OK. Remember to use IP addresses not hostnames.
  164.  
  165.  
  166. Usage
  167.  
  168.         For further usage information please read the online manual.
  169.         If you have any problems read the "read this first" section
  170.         of the manual.
  171.  
  172.     
  173. Winsock implementations tested against
  174.  
  175.   HGopher should work with any winsock complaint software. Previous versions
  176.   are known to work with the following.
  177.  
  178.  
  179.     Lanera        - Verified to work
  180.     Distinct    - Verified to work
  181.     Netmange    - Believed to work
  182.     PC NFS 5.0      - Verified to work
  183.     PCTCP 2.11    - Verified to work
  184.     PCTCP 2.2    - Verified to work - However if you get a message
  185.               like PCTCPAPI052: get_kernel_info: Bad net_dope
  186.                           structure 0x1ae01197, try getting a newer version
  187.                   of their winsoc dll via ANON ftp
  188.               vax.ftp.com:/pub/winsockapi/FTPSoftware/winsock.dll.
  189.     SuperTcp 3.56   - Verified to work
  190.     Windows NT      - Verified to work under Beta version
  191.         Wintrumpet Socket version 1.00 alpha #12  Verified to work
  192.     Wollongong Pathway for DOS Runtime Release 1.2.0.1 with fix c42992a.exe
  193.  
  194.         Novell  Lan WorkPlace for DOS Ver 4.1 (Patch level N)
  195.         ( Special thanks to Brian Meek of Novell for making this software
  196.           available to me).
  197.  
  198.     Persoft's SMARTTERM 420 for Windows
  199.         ( Special thanks to Scott Meeker of Persoft for making this software
  200.           available to me).
  201.  
  202.  
  203.  
  204. ----------------------------------------------------------------------------
  205.     CopyRight notices 
  206.  
  207.     This version of gopher is not available in source code
  208.     form, however future versions maybe.
  209. ----------------------------------------------------------------------------
  210.  
  211.  * Copyright (c) 1993  Martyn Hampson
  212.  * All rights reserved.
  213.  *
  214.  * Redistribution and use in source and binary forms, with or without
  215.  * modification, are permitted provided that the following conditions
  216.  * are met:
  217.  * 1. Redistributions of source code must retain the above copyright
  218.  *    notice, this list of conditions and the following disclaimer.
  219.  * 2. Redistributions in binary form must reproduce the above copyright
  220.  *    notice, this list of conditions and the following disclaimer in the
  221.  *    documentation and/or other materials provided with the distribution.
  222.  * 3. All advertising materials mentioning features or use of this software
  223.  *    must display the following acknowledgement:
  224.  *    This product includes software developed by Martyn Hampson
  225.  * 4. The name Martyn Hampson
  226.  *    may NOT be used to endorse or promote products derived from this software
  227.  *    without specific prior written permission.
  228.  *
  229.  * THIS SOFTWARE IS PROVIDED ``AS IS'' AND
  230.  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  231.  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  232.  * ARE DISCLAIMED.  IN NO EVENT SHALL Martyn Hampson  BE LIABLE
  233.  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  234.  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  235.  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  236.  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  237.  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  238.  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  239.  * SUCH DAMAGE.
  240.  */
  241.  
  242. Some sections of the gopher code are modified versions of existing
  243. software. I include the copyright notices attached to that software below.
  244.  
  245. * The Resolver routines *
  246.  
  247. /*
  248.  * Copyright (c) 1985, 1988 Regents of the University of California.
  249.  * All rights reserved.
  250.  *
  251.  * Redistribution and use in source and binary forms, with or without
  252.  * modification, are permitted provided that the following conditions
  253.  * are met:
  254.  * 1. Redistributions of source code must retain the above copyright
  255.  *    notice, this list of conditions and the following disclaimer.
  256.  * 2. Redistributions in binary form must reproduce the above copyright
  257.  *    notice, this list of conditions and the following disclaimer in the
  258.  *    documentation and/or other materials provided with the distribution.
  259.  * 3. All advertising materials mentioning features or use of this software
  260.  *    must display the following acknowledgement:
  261.  *    This product includes software developed by the University of
  262.  *    California, Berkeley and its contributors.
  263.  * 4. Neither the name of the University nor the names of its contributors
  264.  *    may be used to endorse or promote products derived from this software
  265.  *    without specific prior written permission.
  266.  *
  267.  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  268.  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  269.  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  270.  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  271.  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  272.  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  273.  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  274.  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  275.  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  276.  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  277.  * SUCH DAMAGE.
  278.  */
  279.  
  280. * Misc utility routines (from Xgopher) *
  281.  
  282. * Allan Tuchman, University of Illinois at Urbana-Champaign     
  283. *                Computing and Communications Services Office   
  284. * Copyright 1992 by                                             
  285. *           the Board of Trustees of the University of Illinois 
  286. * Permission is granted to freely copy and redistribute this    
  287. * software with the copyright notice intact.                    
  288.  
  289.  
  290.  
  291.  
  292.  
  293.