Short:        Dopus5 Appicons for Amisat and Charon
Author:       Steve@hargreavess.freeserve.co.uk (Steve Hargreaves)
Uploader:     Steve hargreavess freeserve co uk (Steve Hargreaves)
Type:         util/wb
Version:      1.0
Requires:     rexxsupport.library, rexxmast, Dopus5, Charon and/or Amisat
Architecture: m68k-amigaos

What is this? Quite simply, it's a pair of scripts that will
place appicons on your dopus desktop for Amisat and Charon. Each
icon can be used to launch/quit the respective programs, and the
icon imagery will change according to the status of the
application (running/not running). In the case of Charon, if
Charon is running, the icon can also be used to open the GUI.

Why? Well, Amisat on teh Amiga has no GUI at all, so I thought it
would be useful to have some way of telling if the program was
running, and to control it. For Charon, I load this on an "On
Demand" basis, and wanted to be able to tell if it's currently
downloading, and to start/stop it at will without having to use
the full GUI. The Charon script will respect resumed downloads.

Installation:- AmisatAppIcon.dopus5

This is the easiest of the two. Simply copy the script to
Dopus5:arexx and the icons (saton.info and satoff.info) to
Dopus5:Images. In your online script, include a line "Run RX
Dopus5:arexx/AmisatAppIcon.dopus5" (without the double quotes)
will do it. If you don't use run, then your online script will
halt, since the Amisat script doesn't return until you quit it.

CharonAppIcon:-

Start installation as for AmisatAppIcon. Additionally, copy the
script charonchange.rexx to Rexx: You will need to edit
charonpath in the CharonAppIcon.dopus5 script to suit your set up
(use a standard text editor).

Now configure Charon as follows:-

Global1:-

On start execute Run >NIL:RX rexx:charonchange.rexx on
On exit execute rx rexx:charonchange.rexx off

Global2:-

Check Auto exit

That's it - installation is complete, and whenever you go online,
Charon and Amisat will be started automatically and the appicons
displayed.

Usage.

Double click to toggle the status of the respective programs (If
it's running, it will quit and vice versa).

Icon popup menus:-

"Information" will open a window showing the
current status. In the case of Charon, if it's running, this
option will open the GUI.

"Close" will quit the associated program and close the appicon.

Quitting the scripts:-

OK - DON'T send a break to either - the script will not cleanup
after itself if you do, and you'll be left with a stray appicon
on your desktop. Either use close from the popup menu, or, as I
do, use the enclosed ofl.rexx script. Simply copy the script to
Rexx: and include in your offline script "RX ofl.rexx" (Without
the double quotes)

Note:- the ofl.rexx script will also quit RC-FTPD if you use it.
I left it in because some may find it useful. If you don't use
RC-FTPD, then don't worry, it won't hurt anything.

Known bugs:-

Well, just the one, actually. If you use AmDynDns these scripts
will probably fail. This is because AmDynDns is actually a
compiled Arexx script, which disposes of rexxsupport.library on
exit. Since these two scripts make a lot of use of
rexxsupport.library, then they would fail with an error (leaving
the icon on your desktop) at some point.

Use the alternative AmiDynDns which doesn't suffer from this
problem.

Other Info:-

For both scripts, the supplied icons are examples. You can use
your own by overwriting Dopus5:images/saton.info satoff.info
charon.info and charoff.info with your own icons.

Author:-

Bug reports, compliments, gratuities etc. can all be sent to me
at Steve@hargreavess.freeserve.co.uk