A sort of docs for
================================================================================
New File Transfer Protocol Client   Version 0.4 (preview)
================================================================================

I am sorry for the missing docs. I should write it, but not now.
The minimum you have to know is:

-) INSTALLATION: nftp is now built with emx+gcc and requires emx 0.9a runtime
dlls. If you already have installed them, you may skip this paragraph.
If you don't have them get emxrt.zip from
    ftp.uni-stuttgart.de:/pub/systems/os2/emx-0.9a/
    ftp-os2.cdrom.com:/pub/os2/unix/emx09a/
    hobbes.nmsu.su:/pub/os2/unix/emx09a/
(emxrt.zip is the runtime emx package). This version uses fixlevel 04.
Refer to the instructions in emxrt.zip on how to install and use emx runtime
package.

0) This is a preview version, please do not expect much. However, I am
using it in everyday life and rather happy with it. Give it a try! May be
you will like it too...

1) Run it with a 'hostname' (not number!) as a single parameter
to login as anonymous.

2) Run it with 2 parameters ('hostname', 'userid') to login
as 'userid' (you'll be prompted for a password).

3) Keys:

   a) while viewing directory or control connection

   F10     - quit
   F12     - logoff
   Ctrl-K  - same as above
   F4      - save current dir/host as a bookmark
   Alt-F4  - open bookmarks
   Ctrl-B  - same as above
   Alt-F   - use/inhibit NLST with flags (default is on). Some servers
             do not like NLST -lLa. Try if you see strange messages from
             server when retrieving directory listing.
   Ctrl-V  - display version information
   Alt-C   - change directory on remote
   Ctrl-L  - login as anonymous into new site
   Ctrl-N  - login with userid/password into new site

   b) while viewing directory

   F3      - view a file under cursor.
   F5      - download marked (if anything marked) or file under cursor.
   Insert  - mark/unmark a file under cursor.
   Ctrl-D  - redraw screen.
   Ctrl-R  - re-read directory.   
   Ctrl-T  - change transfer type (ASCII/BINARY).
   Ctrl-NumPlus   - Mark all files.
   Ctrl-NumMinus  - Unmark all files.
   Ctrl-Backslash - goto root directory.
   Ctrl-PgUp      - goto ".."
   Ctrl-PgDn      - change into directory under the cursor.
   Enter          - the same as above.
   Up, Down, Home, End, PgUp, PgDn - move cursor.
   Space   - switch to control connection

   c) while viewing control connection

   Up, Down, PgUp, PgDn, Home, End - scrolling
   Esc     - return to end of log after scrolling (same as End key)
   Space   - switch to directory screen

   d) while viewing bookmarks

   Up, Down - move cursor
   Enter    - login into and change dir
   Del      - delete bookmark

   e) while editing entry field

   Esc      - abandon
   Enter    - confirm
   Left, Right, Home, End - move cursor around
   Tab, Shift-Tab - move to next/previous field (if any)
   Del, Backspace - delete characters
   Del just after appearing - clear field

4) Check out nftp.ini file and insert your e-mail address.
I hope that all parameters in nftp.ini should be self-explanatory.

5) You must run it on HPFS (or NFS :)) drive to be able to download files
which are not 8.3-compliant. All downloads go into the directory from
which nftp was run.

6) nftp.ini must have the same name (eg, nftp) and must reside in the
same directory as the executable or somewhere in the PATH.

7) Requirements: OS/2 2.x, IBM TCP/IP 2.x. I don't know about IAK: I can't
find PPP or SLIP providers!

8) You cannot upload files to server.

10) You can connect ONLY to servers running unix or servers with unix-like
output like Penguin FTPD.

11) I AM NOT GOING TO PORT THIS PROGRAM TO UNIX OR SOME OTHER OPERATING SYSTEM.

12) There is no any error recovery, only detection. So if you got "too many
users", "host unreachable" or something like the above nftp falls back to
command line forgetting to clear the screen and writing the error cause into
logfile (if the latter is switched on).

13) If you enable debugging ("debug=on" in nftp.ini) you'll get very detailed
information about how program is running. However, with large transfers you 
will get very large debug files (several megabytes) - beware!

14) Bookmark file (default name is nftp.mrk) is just a plain text file and
can be edited with any ASCII editor.

15) Performance with 10 Mb/sec Ethernet local transfers isn't spectacular.
The programs wasn't tuned for this. I usually get about 250 Kb/sec on
files large enough (say, 1-2 megs).

16) Q and S keys (interrupt transfer/skip file) do not work yet.

Please tell me ANY suggestions about the program: look, feel, features
to implement, etc., etc., etc. I would also be glad just to read that
this program is useful. In fact, please spend a couple of minutes to write
down a few lines if you like this program. I don't have much free time to
improve it, and your feedback will encourage me to work on the program.
I cannot promise to respond to all letters but I will surely read them all
thoroughly.

This preview version is FREE. It can be distributed freely.
However, I reserve all rights to this program.
I think that 1.00 will be shareware.

As usual, no warranties of any kind.

Where to find new versions/etc.:
0) ftp-os2.cdrom.com, hobbes.nmsu.edu, ftp.leo.org
1) http://crydee.sai.msu.su/         then look around
2) anonymous ftp:  crydee.sai.msu.su/h/pub/software/nftp/
3) E-mail: asv@sai.msu.su
4) Voice: +7 (095) 939-1626.

Sergey Ajukov (asv@sai.msu.su).

P.S. Sorry for my English, I am Russian.
