Installation instructions for gFTP 1.1
--------------------------------------

[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.1.tar.gz
* Go to the gftp-1.1 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, copy the contents of the sample.gftp directory to
  ~/.gftp. Then open the gftprc file, and change it accordingly.

[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: Where does gFTP store it's options?

A: gFTP will automatically create a ~/.gftp directory when it is first run.
   Your config file is ~/.gftp/gftprc, and this is where all of gFTP's
   settings are stored. The config file is well commented, so take a glance
   at it and see if there is anything you want to change.

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

Q: I see that gFTP has proxy server support. I cannot get it to work on
   mine. What's wrong?

A: gFTP does have support for ftp proxy servers. It does NOT have support
   for http proxies however. If you are behind a firewall, and need to use
   ftp, you should install a ftp proxy. There will probably never be http 
   proxy server support in gFTP. I want to keep this program as small and 
   powerful as possible, and I feel that starting to parse html will start
   to stray away from gFTP being just a ftp client. If this really bothers
   you, use a web browser instead.

   If you are trying to connect to a ftp proxy, and are having problems,
   first see the config file. There is support for several types of proxies.
   If your type of ftp proxy isn't listed, then please email me about it,
   and I will see about getting support for it added. It would also be nice if 
   you could send me a sample session of a connection to your proxy server.

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

Q: I am trying to connect to a site that only allows me to log in once.
   Well, I connect to it fine, and then when I go to download a file, it logs
   in again, and the ftp server kills my connection. What can I do about this?

A: gFTP has to open another connection to the server when it is going to
   transfer a file. If a ftp site won't let you log in 2 times, then go to
   the FTP menu, and turn off Start Transfers. Then tell gFTP to do your
   file transfer. It will queue it in the transfer window, but it will not
   start it. When you are done, disconnect from the ftp server, and then go
   back to the FTP menu, and turn on Start Transfers. It will then start
   those transfers for you.

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

Q: I am trying to compile your program and I get some parse errors before
   GdkDragContext. What's wrong?

A: You have an older version of gtk installed on your system. If you are
   using Red Hat or Debian Linux, simply remove the gtk and glib devel
   packages. You can still leave the gtk 1.0 libraries installed.

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

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).

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

If you are still having problems with gFTP, please feel free to email me
about it.

Brian Masney <masneyb@newwave.net>
gFTP Official Homepage - http://www.newwave.net/~masneyb
