File: ardt.c
Title: ardt.c V000
Short: Acornet-Download-Tool 002 as source
Type: misc/unix
Author: <@>
Uploader: <@>
Version: 0.0.2
Release:
Keyword:
Status: Free
Size (unarchived):      KB
Archiver: Plain Text
------------------------
Description:

This file enables you to use AcorNet via an textual interface
called ArchiDownloadTool (ardt).

-------------------- Description-Format
IMPORTANT: If things are marked with 'XXX' or '(?)' i need your
response to give more precise information.
Tell me if it works or tell me the right information.
mailto:pgpeter@informatik.uni-siegen.de
'>>' stands for the shell-prompt and means that you should enter
     the things after '>>' into your unix-shell.
'>'  stands for output of the previousliy entered shell-commands

-------------------- Requirements
It should work on Unix-Workstations.
You need:
sh	A unix-shell. bash/ksh should work too
cc	A C-Compiler (or gcc if you have it)

-------------------- Getting all files
You have to get ardt.c first!
You can get it from:
ftp://ftp.uni-kl.de/pub/acorn/acornet/misc/unix/ardt.c

------------------ compiling the program
Now do:
>> sh.ardt.c
which outputs (or something similar):
> cc -g -DDEBUG -o ardt  ardt.c -lcurses -ltermcap
>> ls -F
should output:
> ardt*        ardt.c
  ^^^^ This is the executable :)
(or something similar)

If your compiler gives you warnings or errors, please contact me.
Experienced Unix-Users: You can look at the begin of ardt.c and
try to change the source until it works. Please send me your patches.

Working configurations (only tested the compiling):
ardtpatch.002:
OS-Version	Hardware	compiler Tester
--------------------------------------------------------------
sunos4.1.1	sparc ipx	cc	pgpeter@informatik.uni-siegen.de
Ultrix4.4	Dec Mips	cc	pgpeter@informatik.uni-siegen.de
OSF1 V3.2	Dec-alpha	cc	pgpeter@informatik.uni-siegen.de
HPUX 0.9	HP9000/345	cc
HPUX 0.9	HP9000/720	cc
(XXX) please send me more!!!

------------------ Using ardt
At the first time, ardt will create a file .ardtrc in your
$HOME-Directory.
Move with CursorUp/Down and select with Return.
Select: "Internal FTP" and then the next site.
(DON'T USE the "Siegerland-Entries" they won't work!!!)
Then it will tell you that it's your first time
and connect to the site.
Use '?' to get a help.
Tag the files with 'Return', get the Readme with 'r'
and 'd'ownload 'b'egin to download all tagges Archives.

The next time you connect, you will see only the files,
which are new since your last connect!
To view all select 'v'iew 'a'll.

If it works for you on an Architecture for which we have
no precompiled binary, PLEASE load it up to
ftp://ftp.uni-kl.de/ with a changed .txt-File
(use ardt_alpha.txt as template and insert the result 
 of 'uname -a' into it)
Other people would be happy about it.
Thank you in advance

KNOWN BUGS:
- When getting a .txt-File you get Error-Messages about
  wrong .txt-Filesizes. This is normal.
  And will be fixed somedays.
- find doesn't work. This is no ardt-Problem.
  The find-Tables are not made automatically
  until now.

PLANS:
- fix bugs
- none

Note: The standard-config-file is "$HOME/.ardtrc"
HISTORY:
002/21-Jul-95	Little Bugfix :(
	Ardt didn't work well without config-file
	(perhaps after quitting and starting it
	 worked well. Dont know)
001/20-Jul-95
Additions:
- different table-format
- privftpsites-Option in config-File
  this sites are added to the actual-sites-list
  (only if new sites are read in. To force this,
   set "sites=0" into the config-files.
- option -c for different config-files.
000/07-Jul-95	First version.

Known Bugs:
- none :-)

Untested:
- master/find-Server
  [when AcorNet has more than one site]

Todo:
- replace aminet everywhere
  [sometime]
- generic-version which is usable for aminet/acornet 
  by adding new fields into the config-file.
  [sometime]
- clean up config-file (remove fsp/....)
  [sometime]

------------------ Last Words
Please support AcorNet. Please upload any interesting Software
and make a .txt-File.
------------------ The End