gnut -- Un*x/Win32 Gnutella Client
==================================
http://www.mrob.com/gnut  (and old site: http://www.umr.edu/~jjp )

If you're new to gnut and/or gnutella in general:

   I highly recommend you read the file TUTORIAL, an excellent
   introduction to gnut written by Elijah <eli@panix.com> 

To build (and install) gnut:

   Read and follow the directions in the first few paragraphs of
   the file "DEPEND" (in the same directory as this file). More
   about building (compiling) below.

To run gnut for the first time (if you have not run a version of gnut
before on your current machine or user-account):

   Before you can run gnut you need a hosts list file. Try going to
   gnutella.wego.com, gnutella.co.uk/servers, or gnutelliums.com and
   look in the "downloads" or "files" area for a GNUTELLA.txt or
   GNUTELLA.net file. Save this file as ~/.gnut_hosts

   If you can't find the file, you can also connect to one of the
   "host cache" or "hosts server" addresses like
   gnutellahosts.com:6346, router.limewire.com:6346 or
   gnet1.ath.cx:6346 by typing a command like
   "open gnet1.ath.cx:6346", then after the connection is open
   (use "info" to find out), type "update" to send a request (called
   a "ping") for host addresses. After you do this, use "info" again
   to make sure the "HOST STATS" have a number bigger than 0. As
   soon as you quit gnut, it will save the host list as
   ~/.gnut_hosts and you're all set.


Building (Compiling):

   Building and installing is described in the first few paragraphs of
   the file DEPEND, in the same directory as this file.

   If you are running any fairly recent and popular version of Unix
   or Linux, you'll have no trouble. Otherwise, read the INSTALL
   document for more about installation.

Usage:

   If you don't already have a .gnut_hosts file, get one as described above.

   Type 'gnut --help' to see command-line options. Type 'gnut' with
   no arguments to run the program. At the gnut command prompt, type
   'help' for a list of commands. Type 'help commandname' (example
   'help find' or 'help load' for a more complete description of
   one command.

Bugs:

   Report bugs to "mrob at mrob dot com"

Documentation:

   All documentation can now be perused at your leisure in the Gnut
   Manual at:

      http://www.mrob.com/gnut

   or at gnut's old home:

      http://www.umr.edu/~jjp

Copying:

   This file, and everything contained in this package is distributed
   under the terms of the GNU General Public License, the terms of
   which can be found in the file COPYING.



Wow! You made it through reading all of that crap up above. If you
have any questions/comments/suggestions/patches/ideas, please send
them to Robert "mrob at mrob dot com", or contact Josh at "josh at
nemonet dot com" (but he has effectively discontinued maintaining
gnut)

Thanks!

- Robert Munafo, 10 Nov 2000