gnut -- Un*x/Win32 Gnutella Client
==================================
 http://www.mrob.com/gnut (which currently points to:
 http://www.gnutelliums.com/linux_unix/gnut/ )

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:

    ./configure
    make

  If you're root:

    make install

  There is a lot more about installing in the file "INSTALL"

If gnut does not connect to any hosts when you first start it
up, even after a few minutes, try the following:

   Read the FAQ question 5.12 (in the manual chapter 5, file
   doc/gnut-5.html or on the Web, 

      http://www.gnutelliums.com/linux_unix/gnut/doc/gnut-5.html)

   Get 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) and rebuilding:

   If the steps listed above didn't work, you might have one of the less
   recent or less common versions of UNIX. Read the INSTALL file
   for a more complete description of installation with instructions
   on how to deal with lots of different situations.

   Rebuilding after making changes is described in the HACKING file,
   found in the same directory as this file. Beware that some files
   cannot be changed directly; read HACKING for details.

   Programmers wishing to talk with other programmers can join
   the mailing list described in the HACKING file.

Usage:

   Type 'gnut --help' to see command-line options. They are explained
   fully in the manual chapter 4. 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 on the
   Internet. The permanent location is:

      http://www.mrob.com/gnut

   And it is currently being hosted by gnutelliums.com at:

      http://www.gnutelliums.com/linux_unix/gnut/doc/gnut.html

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 Aug 2001
