Installation instructions for gFTP 1.0
--------------------------------------

[Requirements]

* gtk+ 1.1.x or higher. You can download the newest gtk+ from 
  ftp://ftp.gtk.org/pub/gtk/v1.1. You can download the latest version of gtk 
  and you will also need to download the latest glib from that same directory.
* X11R6 or later.
* pthread libraries. If you have a libc6 based machine (Debian 2.x, RedHat 
  5.x), you should already have the pthread libraries installed. If you have 
  a libc5 based machine (Slackware), you will need to install LinuxThreads. 
  You can download it from my website at http://www.newwave.net/~masneyb. Also,
  if you don't have LinuxThreads installed, you most likely don't have thread 
  safe X libraries. You must have thread safe X libraries or gFTP will 
  constantly crash. You can download some thread safe X libraries off my 
  website also.

[Installation Instructions]

* If you do not want to compile this program yourself, you can check my
  webpage at http://www.newwave.net/~masneyb. I have some static binaries
  available and have debs for Debian and rpms for RedHat.
* If you are compiling gFTP yourself, extract the files from the distribution 
  with tar -zxvf gftp-1.0.tar.gz
* Go to the gftp-1.0 directory and type make to make a binary for your machine
* If the compile suceeds without any errors, you can type make install to 
  install the binary in /usr/local/bin. This will also copy some necessary
  files to /usr/local/share/gftp. If you do not have root on your machine to
  install these files, please see the section Manually setting up the config
  file below. Otherwise, you should be able to type gftp to run it.

[Frequently Asked Questions]

Here is a list of frequently asked questions about gFTP. You can always find
the latest version of this FAQ off my website at
http://www.newwave.net/~masneyb

*******************************************************************************

Q: I am having a hard time using the drag and drop in gFTP. How do I use it?

A: To drag from the file listboxes in gFTP, you have to drag with button #3.
   On a two button mouse, you have to hold down both buttons. For this to work
   tho, you have to edit your XF86Config file, and go to the Pointer section.
   You have to make sure Emulate3Buttons is in there. Here's the section out of
   my config file:

   Section "Pointer"
      Protocol        "PS/2"             # This will depend on your mouse
      Device          "/dev/mouse"       # This will also depend on your mouse
      Emulate3Buttons                    # You need this for a 2 button mouse
   EndSection

*******************************************************************************

Q: I have a libc 5 based machine and everytime I run gFTP it instantly crashes. 
   I get an error something like: Gdk-ERROR **: an x io error occurred 
   What's wrong?

A: Your X libraries are not thread safe. They must be compiled with 
   -D_REENTRANT. You can either recompile your X libraries, or you can
   download some from my webpage at
   http://www.newwave.net/~masneyb/XFree86-libs-3.3-2_threading.i386.tgz

*******************************************************************************

Q: I upgraded my gtk+ to 1.1.11 or greater. Now when I try to run your
   program I get an error like: error in loading shared libraries, and there is
   some undefined symbols. What's wrong?

A: Starting with gtk+ 1.1.11, this broke binary compatibility with older
   versions of gtk. So, you have to recompile gftp (along with any other gtk
   1.1.x apps you may be using).

*******************************************************************************

[Manually setting up the config file]

If you did a make install on your machine, you should not have to do this.
When gftp doesn't see it's config not installed, it will automatically
install it for you. However, if you don't have root on your machine and you
can't do a make install, you have to manually setup the config file.

* You will need to make a directory in your home directory called .gftp. Once 
  you do this, copy the contents of the sample.gftp directory to your ~/.gftp 
  directory. You only have to make one change to the gftprc file. The first 
  line has an email= line. Please set this to your email address. For example:
  email=foo@bar.org. You will not have to make any other changes to the config 
  file unless you want to add anything else yourself.
* You can register specific file extensions to a XPM file. If you want to 
  register a file extension with a particular XPM file, the config file line 
  has the following format:  ext=file extension:xpm file
  The XPM files must be placed in the /usr/local/share/gftp or the ~/.gftprc 
  directory. For example, I included a file tar.xpm with this distribution, and 
  if I would want to associate all .tar files with this icon, I would add this 
  to the config file: ext=.tar:tar.xpm
* You can also add hosts for the connection manager to the config file. You can 
  add/remove these from within the ftp program itself, so you can skip this 
  section if you want to. But if you want to add them manually yourself, the 
  line has the following format: 
     host=category:host descr:[host]:[port]:[dir]:[user]:[passwd]
  Inside the connection manager, you can have multiple categories, that each 
  have multiple hosts associated with them. If you want multiple hosts to be 
  contained in the same category, set their category name to be EXACTLY the 
  same. The host description will show up inside the connection manager, and 
  when you select it, it will fill in the host, port, directory, username and 
  password fields. If you want your password field to contain your email 
  address (i.e. when you're logging in as anonymous), just set your passwd 
  file to @EMAIL@. This allows for users to easily share their config files.
       
Brian Masney <masneyb@newwave.net>
gFTP Official Homepage - http://www.newwave.net/~masneyb

