@DATABASE Irritator.guide
@AUTHOR "Gareth Griffiths"
@VERSION 1.00
@NODE MAIN "Irritator - Contents"

                        Gareth Griffiths presents..

  ______  _____   _____   ______  ______   ____   ______   ____   _____
  ######  #####   #####   ######  ######   ####   ######   ####   #####
    ##    ##  ##  ##  ##    ##      ##    ##  ##    ##    ##  ##  ##  ##
    ##    ##  ##  ##  ##    ##      ##    ##  ##    ##    ##  ##  ##  ##
    ##    ##__##  ##__##    ##      ##    ##__##    ##    ##  ##  ##__##
    ##    #####   #####     ##      ##    ######    ##    ##  ##  #####
    ##    ##  ##  ##  ##    ##      ##    ##  ##    ##    ##  ##  ##  ##
    ##    ##  ##  ##  ##    ##      ##    ##  ##    ##    ##  ##  ##  ##
  __##__  ##  ##  ##  ##  __##__    ##    ##  ##    ##    ##__##  ##  ##
  ######  ##  ##  ##  ##  ######    ##    ##  ##    ##     ####   ##  ##
 
                          @{"  " LINK INTRO} Introduction
                          @{"  " LINK REQ} System Requirements
                          @{"  " LINK INSTALL} Installation

                          @{"  " LINK USAGE} Usage
                          @{"  " LINK TEXTS} Editing the texts.

                          @{"  " LINK FUTURE} The Future
                          @{"  " LINK BUGS} Known Bugs
                          @{"  " LINK HIST} History

                          @{"  " LINK CREDS} Credits
                          @{"  " LINK AUTH} The Author

        Irritator is ©1999 Joker Developments. All Rights Reserved.
@ENDNODE
@NODE INTRO "Irritator - Introduction"
@{FG HIGHLIGHT}
                               @{U}Introduction@{UU}@{FG TEXT}

Welcome to the Irritator. This program is designed to irritate. Irritate
the computer user. It does this by performing various actions at random
intervals while the program is active. The program can belch at you (!) and
click mouse buttons, it can even draw lines on your screens.

If you have someone in your house who ALWAYS uses your computer without
your permission, one solution would be a password protection program.
Another solution would be the Irritator. Scare them off completely. They
will be confused and dumbfounded when icons start dragging themselves, the
screen flashes, belches are heard, and even User Error requesters pop up.

If you find the Irritator useful, tell me, please!

                           @{"  " LINK MAIN} Back to Contents.
@ENDNODE
@NODE REQ "Irritator - System Requirements"

                            @{FG HIGHLIGHT}@{U}System Requirements@{UU}@{FG TEXT}

To use Irritator, you need AT LEAST the following system setup:

        · An Amiga (well, duh ;)
        · Workbench 2.04 or above.
        · 1Mb Chip RAM or more.
        · A hard drive is not required, but recommended.

To get the full benefit from its features, you will also need a mouse. But
since most Amiga's are shipped with those anyway, you probably have one ;)

                           @{"  " LINK MAIN} Back to Contents.
@ENDNODE
@NODE INSTALL "Irritator - Installation"

                               @{FG HIGHLIGHT}@{U}Installation@{FG TEXT}@{UU}

Installing Irritator is devastatingly simple. There are two ways, auto and
manual. To install Irritator automatically, just double click on the
@{I}Install@{UI} on your Workbench screen. To install it manually, simply
follow these steps:

        @{B}1.@{UB} Copy Irritator and Irritator.info to anywhere you like.
 
        @{B}2.@{UB} Copy the documentation over to whereever you like.

        @{B}3.@{UB} Copy Irritator.txts to ENVARC:

        @{B}4.@{UB} Reboot your machine, and then run Irritator in the 
          normal way.

If you want to avoid rebooting your machine, copy Irritator.txts to ENV: as
well before starting Irritator.

                           @{"  " LINK MAIN} Back to Contents.
@ENDNODE
@NODE USAGE "Irritator - Usage"

                                   @{FG HIGHLIGHT}@{U}Usage@{UU}@{FG TEXT}

Again, this is devastatingly simple. Just double-click on it's icon!
Alternatively you can run it from the CLI, but it has no benefit. The
program will then create itself as a commodity. To check this, load up
Exchange (normally held in @{I}SYS:Tools/Commodities@{UI} and check the list)

If Irritator cannot create a commodity for some reason, you will be
informed and the program will close itself.

After you get Irritator running successfully, just leave it and sit back to
watch the poor computer user suffer at the hands of the Amiga ;)

If for some reason you want to stop the program or quit, just load up
Exchange again and select Irritator from the list. Now click on Remove to
kill the program completely, or toggle it on/off by clicking
Active/Inactive in the Exchange window.

                           @{"  " LINK MAIN} Back to Contents.
@ENDNODE
@NODE TEXTS "Irritator - Editing the texts."

                             @{FG HIGHLIGHT}@{U}Editing the Texts@{UU}@{FG TEXT}

To alter the @{B}actions@{UB} which are displayed in the System Error!
requesters, simply load @{I}ENVARC:Irritator.txts@{UI} into a text editor.
Now just edit or append to this file. The only limit on the number of
actions is the amount of memory you have to store the array in!

Seperate each entry with a carriage return (just press RETURN at the end of
each entry ;) and you won't have any problems.

                           @{"  " LINK MAIN} Back to Contents.
@ENDNODE
@NODE FUTURE "Irritator - The Future"

                                @{FG HIGHLIGHT}@{U}The Future@{UU}@{FG TEXT}

The future of Irritator hangs in the balance. It all depends on whether I
(or you, the users) can think of anything else irritating enough to be put
in ;)

Definitely in for a future release is a GUI which allows you to control
which actions are turned on and which are off. Updates will be available
via my site and Aminet.

                           @{"  " LINK MAIN} Back to Contents.
@ENDNODE
@NODE BUGS "Irritator - Known Bugs"

                                @{FG HIGHLIGHT}@{U}Known Bugs@{FG TEXT}@{UU}

There are no KNOWN bugs as yet. But a product can never be 100% bug free,
just ask Micro$oft ;)

If you discover a bug in Irritator, then PLEASE report it. Send an e-mail
detailing your system setup, which version of Irritator you are using, and
as detailed a description of the bug as you can manage, i.e. what it's
effect is on the program, how you found the bug, what you have to do to
discover the bug etc. Send bug-reports to:

                       @{I}bugs@jokerd.freeserve.co.uk@{UI}

Put the program name in the Subject header, i.e. Irritator for this
program. I will then endeavour to stamp out the bug.

                           @{"  " LINK MAIN} Back to Contents.
@ENDNODE
@NODE HIST "Irritator - History"

                                  @{FG HIGHLIGHT}@{U}History@{UU}@{FG TEXT}

V1.0 - 23/08/99

   · First Aminet release.
   · Actions added: @{B}All of 'em ;)@{UB}

                           @{"  " LINK MAIN} Back to Contents.
@ENDNODE
@NODE CREDS "Irritator - Credits"

                                  @{FG HIGHLIGHT}@{U}Credits@{FG TEXT}@{UU}

Irritator was programmed in Blitz Basic 2 by @{"Gareth Griffiths" LINK AUTH}. It took
about a day to write ;) and suffered no real setbacks.

Thanks to Toby Zuijdveld and Rob Hutchinson for ideas on what to implement.

Irritator is ©1999 Joker Developments.
Blitz Basic 2 is ©1995 ACID Software.

                           @{"  " LINK MAIN} Back to Contents.
@ENDNODE
@NODE AUTH "Irritator - The Author"

                                @{FG HIGHLIGHT}@{U}The Author@{UU}@{FG TEXT}

Gareth Griffiths is a 15 year old lad from Shrewsbury, in the UK. He
programs his Amiga for most of his spare time, in between playing on his
PSX and doing chores ;)

He founded Joker Developments, a small group of people who program for the
Amiga as well. He can be contacted via e-mail at this address:

                        @{I}gaz@jokerd.freeserve.co.uk@{UI}

To find information on forthcoming products, and to download existing ones,
visit the Joker Developments website, at @{I}http://www.jokerd.freeserve.co.uk@{UI}
And don't forget to sign the guestbook!

He is also a member of Satanic Dreams Software, a larger group of people
who program for the Amiga (and PC). Visit their website at
@{I}http://www.satanicdreams.freeserve.co.uk@{UI}

                           @{"  " LINK MAIN} Back to Contents.
@ENDNODE
@NODE NUTHIN "Irritator - Blank Page"
@ENDNODE