ShutDown v1.0 - (C) 1994 Tom De Voeght.


                              {b}ShutDown v1.0
                          (C) 1994 Tom De Voeght.@{ub}


                  _/          _/  _/_/_/_/    _/_/_/    _/_/_/
                 _/          _/  _/        _/        _/
       A        _/    _/    _/  _/_/_/    _/        _/          Production
                 _/  _/  _/    _/        _/        _/
                  _/  _/      _/_/_/_/    _/_/_/    _/_/_/


This is the documentation of an advanced ShutDown command for the Amiga.

Introduction :
~~~~~~~~~~~~~~
I once came across a command named 'reset' ; it looked good, and it
was rather small, so I was really happy with it, but then ...

As we all know resetting your Amiga can be dangerous, especially when
there is/was any disk-activity at the time of your reset. I guess we 
all experienced that many times ; disk not validated anymore, and 
sometimes loss of data.

Well, here is ShutDown. This new command will prompt you with a
requester before it resets the computer, securing your data, because all 
tasks can and will be finished. A real ShutDown as on UN*X systems.

But there is more ... For those who have Static Memory (StatRAM device),
ShutDown will call the 'killsd0' command imbedded in the STATRAM-package
and enable you to perform a total ShutDown, including the recoverable 
RAM. There is an acknowledgement inside this procedure, so you cannot 
go wrong here. Each function of ShutDown is hereby protected ... :-)

In other words, it might be a bit large (1.5 Kb), but its features are 
worth it, and I'm sure you'll find this command rather useful ...

There's more to come :

No doubt these features will come soon, although I started coding this
Software just to try out some ReqTools-possibilities. It worked just
great, and therefor I decided to share the command with the rest of
the world ; who knows who my use it ? :-)

Execution :
~~~~~~~~~~~
For v1.0 execution is rather easy : just double click the icon or 
type 'ShutDown' in a shell-window. From there onwards you'll be guided
through the command thanks to the excellent.

As I already said, for the moment no tooltypes or command line options
present, but this will soon be changed, if I have enough time to add
the missing code

Installation
~~~~~~~~~~~~
This is the easy part ...
Installing ShutDown isn't very tough ; you just need to copy it somewhere
in your path, and that's all there is to be done. Simple, eh ?

e.g.

 copy ShutDown C:

Will copy the ShutDown program to your C: assign, which is always in the
path, and will always give you access to the ShutDown command.

Distribution :
~~~~~~~~~~~~~~
ShutDown is freely distributable software, but it's also
Copyright (C) Tom De Voeght. You can freely copy/spread it 
as long as you don't make any profit doing it and that 
the  original archive  remains intact. 

The above is also known as FreeWare.

IMPORTANT !!!!
~~~~~~~~~~~~~~
You will need a written  permission from the author if you  
want to include ShutDown in ANY software package, either 
commercial or freely distributable packages.

Disclaimer :
~~~~~~~~~~~~
The Author can't be held  responsible for any damage this
software may cause, directly or indirectly, on the system
it is run. You're using it at your own risk.

Acknowledgements :
~~~~~~~~~~~~~~~~~~

The author would like to thank the following people for their
support :  (alphabetical order)

  - Arun Kumar          (thanks for learning me my first steps in C)
  - Nico François       (Great REQTOOLS & other stuff)
  - Rafael D'Halleweyn  (Tips & Suggestions. Thanx, Raf !)

  - The Amiga for being such a great pal ... I love it ... :-)


ShutDown was developed on an antique A-500 with 1 Mb CHIP & 2 Mb FAST.
AmigaOS 2.05 & 1.2 were both used for testing this program.

Author :
~~~~~~~~
ShutDown v1.0 is © Copyright 1994 by Tom De Voeght.

The author can be reached for all bug-reports, suggestions, etc. :
(flames will be politely discarded)

 Snail-Mail :  Tom De Voeght
               Kempenlandstraat 23
               2660 HOBOKEN
               BELGIUM - Europe

 E-Mail : tdv@suntew.ruca.ua.ac.be
          tvoeght@nyx.cs.du.edu

If possible, send me a note if you decide to test this program ; I'd
like to hear from you guys !!!

History :
~~~~~~~~~
 v0.5 : No big deal ; it was just an ordinary 'reset'-command.
 v0.7 : ReqTools-interface written.
 v0.9 : STAT-RAM support included.

 v1.0 : [FIRST PUBLIC RELEASE] - Should work fine now.

TO DO :
~~~~~~~
For the moment, it's a rather small and simple command. It's easy coding,
and no fancy stuff imbedded. But of course I have some dreams :

 - Command line options.
 - Disable/Enable ReqTools Switch.
 - Direct rebooting (no acknowledgements)
 - Variable wait-periods before the actual ShutDown.

 - Anything else ? (tell me !)

 - Smaller code. (I still find 1.5 Kb rather large, but I'm a perfectionist)

ReqTools :
~~~~~~~~~~
This is the name of an excellent library, offering you the best looking
requesters under all OS's. If you've never heared of it, check it out
right NOW !!!

   -> ReqTools is Copyright (c) Nico François. <-

Thanks, Nico, for such a great library, and of course thanks for making
it available to the public !!!