1.  LICENSE

    This program (called cmdftp) is copyright (C) 2003-2007 Claudio Fontana,
    and is free software under the GPL (GNU General Public License).
    You may read all the details about the license in the COPYING file
    included in this release.

2.  GETTING THE CODE TO RUN

    Use the sequence

    ./configure
    make
    make install

    A man page will be installed in section 1 of your manual.

2.5 CONFIGURATION TIPS - Skip if you are fine with defaults
    
    Use ./configure --help to get all possible options.
    
    Here's an example:
    ./configure --prefix=/usr/local --disable-largefile

    The cmdftp executable will be installed in /usr/local/bin, and large file
    support will be disabled (do not do it in real life).
    
    You can pass alternative compilation flags through CFLAGS.
    For example, to optimize cmdftp for size using gcc, do something like:

    ./configure CFLAGS='-Os'
    make
    make install

    If you want to further reduce size, and do not mind losing all symbols,

    ./configure CFLAGS='-Os'
    make
    make install-strip

    This produces a small executable (30K on my i386 linux system), without
    any loss in performance (since the bottleneck is the connection and time
    is never spent in tight code, -O2 and -O3 are just wasting executable
    space). I would suggest this for production, however you will not be able
    to report bugs without symbols.

    If you are using a size-optimized, stripped binary and experience runtime
    errors (a segmentation fault for example), please reinstall cmdftp without
    size-optimization and with full symbols before running gdb and backtracing
    (See below about bug reporting).
 
    Again, look at ./configure --help for all possible options available at
    the configuration phase.

3.  USAGE

    type 

    cmdftp -h

    to get all command line options.
    If your system supports long options, they are shown.

4.  COMMANDS

    At the cmdftp prompt, type

    h

    to display all available commands.
    See the man page for the details.
    
5.  ENVIRONMENT

    Environment variables recognized by cmdftp are:

    HOME, PAGER, EDITOR

    Also, cmdftp uses ~/.netrc for the autologin feature. See man netrc.
    To set environment variables refer to your shell documentation.

6.  "PROXY"

    cmdftp deals with FTP only and does not handle proxies in any special way.
    It has been tested working ok with ftp.proxy (http://www.ftpproxy.org).

    Here is what you do with ftp.proxy:

    Connect to the proxy, then specify login@host as username.

    You might need to disable autologin if the ftp proxy allows for a single
    login attempt.

    Your connection will be with the proxy for all means.
    For example, your ~/.netrc might not do what you expect it to do.
    This could change in the future (feedback welcome).

7.  COMMENTS/BUG REPORTS/HELP...

    The help forum is no more so please use savannah trackers at
    
    http://savannah.nongnu.org/projects/cmdftp

    Or send feedback directly to the AUTHOR: claudio@gnu.org
