A sort of docs for
================================================================================
New File Transfer Protocol Client   Version 0.5 (preview)
================================================================================
I am sorry for the missing docs. I should write it, but not now. The
minimum you have to know is:

-1) 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 06;
please install this version as it fixes rather annoying bug resulting
in closing sockets under some circumstances. 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 are now in online help! Press Shift+F1 and F1.

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, 3.x, IBM TCP/IP 2.x, 3.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's 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.

17) nftp will try to use any text mode you have set before starting it.
Modes with 80 columns work rather good, but do not expect this from 132-col
or other modes. If you're using non-25-lines mode regularly and noticed
any oddity not occuring in 25-line mode, please tell me.

18) There seems to a bug in emx's malloc(). Sometimes I get segmentation fault
and core dump on the very straightforward code (including malloc). I am
considering replacing emx's malloc with DosAllocMem call.

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.

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

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