/*
**
**  $VER: Reboot.doc 1.1 (17.9.95)
**  Reboot 1.0
**
**  documentation
**
**  (C) Copyright 1994/1995 by Roland 'Gizzy' Mainz
**          All Rights Reserved
**
*/

=====================   Reboot 1.1 documentation   ========================
===========================================================================
A   simple   tool   to  be  used   with  Kickstart 2.x/3.x,  written  by
 Roland 'Gizzy' Mainz,  freeware, all rights reserved.
No guarantee of any kind is made that  the programm described below in this
 document is 100% reliable. You use this material on your own risk.


=========================== Misc ==========================================
===========================================================================
While playing with ENVOY 1.6, I need a program which allows to reboot
another AMIGA through the network (by my own "RemoteNetShell") or
after a given time.
First I wrote a little script (using WAIT) and a C program calling
exec.library/ColdReboot() to solve this problem.
Switching to IAM's ENVOY 2.0 I replaced this script by this tool,
adding some features (WB (including multiselect), SHELL ReadArgs(),
locale support and test mode).


=========================== Installation ==================================
===========================================================================
After unpacking this archieve:

Workbench:
  - Drop the 'Reboot' icon in your favorite drawer (like
     "SYS:Utilities/").
    See SHELL for copying the catalog files.

Shell:
  - Unpack this archieve at "SYS:Utilities/"
    and add the following statements at your "S:user-startup" startup file:

    Assign Reboot: SYS:Utilities/Reboot
    path Reboot: ADD
  OR
  - Drop/Copy the 'Reboot' file in your favorite directory
    (like "Sys:Utilities").
    To copy the (german) catalog files, type
    Copy Catalogs/#? TO="LOCALE:Catalogs/" ALL QUIET CLONE

=============================== Usage =====================================
===========================================================================

    NAME
        Reboot -- rebooting utility

    FORMAT
        Reboot [REBOOTDELAY <seconds>] [QUIET|NOREQ]

    TEMPLATE
        REBOOTDELAY/K/N,QUIET=NOREQ/S

    TOOLTYPES
        REBOOTDELAY/N
        QUIET/S
        NOREQ/S

    PURPOSE
        To reboot the computer.

    SPECIFICATION
        Reboot is used to reboot the whole computer like a "cold"
        system start.

        Unless you specify otherwise (through REBOOTDELAY option), reboot
        waits 2 seconds before rebooting the system.
        This is used to let the system (and it's disk drives) settle.
        This delay time can't be less than 1 second, a REBOOTDELAY=0
        will also wait this time.

        Whenever the QUIET (or NOREQ) option is set, the verify requesters
        ("Are you sure#?" etc.) will be suppressed.

        Test mode / Variable support:
        "Setenv Reboot OFF" or "Set Reboot OFF" will stop Reboot from
        rebooting the system. Instead it will work like when a CTRL_C
        signal or an aborted verify requester occurs.
        This is very useful when testing scripts etc.
        See also in the BUGS section.

        Reboot supports workbench multiselect (e.g. project icons) !

    BUGS/NOTES
        Setenv Reboot " OFF" (space before OFF switch) currently won't 
        stop rebooting the system.
        Be sure you don't set some rubbish in this variable. If future 
        parsing through dos.libary/ReadArgs() fails, later versions of
        Reboot won't reboot the system.
        Local variables longer than 255 are currently not supported.

        "Set Reboot OFF" is only valid if you start Reboot from this
        shell.


=============================== TODO ======================================
===========================================================================
  - ReadArgs() parsing of REBOOT variable
  - AmigaGuide document "Reboot.guide"


============================== SOURCE =====================================
===========================================================================
Reboot source and catalogs may be recompiled/reprocessed
(using DICE-C or SAS-C) by executing Reboot.c.

I've you like to include a new language (like Français or Nederlands etc.),
send me a filled "Reboot_blank.ct" file named "Reboot_#?.ct" (#? for your
language). As an example, see "Reboot_deutsch.ct".
Note that I can currently only process "Reboot_#?.ct" files whose language
is supported by AmigaOS 3.1 (e.g. a CBM language driver exists).


=========================== Author's Request ==============================
===========================================================================
By  releasing  this program I do  not  place any obligations on you,
feel free to share this program with your  friends (and enemies).

If you want to blame me, report any bugs, or wants a new version
send your letter to:
                Roland Mainz
                Hohenstaufenstraße 8
                D-52388 Nörvenich
                GERMANY

EMAIL is also available:
If you don't find a file "email.changed" in this archieve,
my email address is:
                mainz@mats.gmd.de


The  entire  "Reboot"  package  may  be  noncommercially  redistributed,
provided  that  the package  is always  distributed in it's complete  form
(including it's documentation).  A small copy fee  for media costs is okay
but any kind of commercial distribution is strictly forbidden!
Comments  and  suggestions  how  to  improve  this  program  are generally
appreciated!

Thanks to Matt Dillon for his DICE, and Olaf 'Olsen' Barthel for his
help, ideas and some text clips from his documentations.