
-+ ** KillJoy 2.0 by Anthony Brice and Paul Juhasz (c) December 1995 ** +-

                       (C) Binary Systems 1995

 Waiting mail remover for Zeus,XenoLink,DLG or Excelsior Bulletin boards.


What is it?
-----------

KillJoy is a little tool I wrote to clear waiting mail files for points or
other sysops on my BBS who don't want to be prompted when they logon about
mail here that would have already be seen by them on their own systems.

My own points love it as it lets them logon quicker :-)

KillJoy is fool-proof - even Kevin Gearing could use it :-) It won't bomb
out if it can't find a users data listed in the config, it won't bomb out if
there is no waiting mail for a user listed in the config, so it's perfectly
safe to use it as many times as you wish. Personally I run it on a Cybercron
event but you can use it anywhere.

KillJoy was compiled in Blitz2 as was the funky KillJoy-Prefs gui which you
can use to configure KillJoy to fit your own system and preferences.

Example config file is enclosed but all that is is an ascii list of names so
you could run an arexx script on the bbs for users to add their own names to
the list as a logon configuration option, should you so wish.


Usage:
------

KillJoy ?       will put up some help text.

KillJoy USE     will scan KillJoy.cfg and delete all waiting mail for all the
                names it will find.

KillJoy LIST    will output the list of names in the Config file.

KillJoy Anthony_Brice  - will kill all waiting mail for Anthony Brice.

Note: The _ must be used in place of blank characters as multiple names can
      be given as arguments to KillJoy when needed.

When used without parameters, KillJoy will open its prefs window. This will 
also happen when the env-variable KillJoy that points to the users' waiting
mail cannot be found...


KillJoy's Prefs-Window
----------------------

Built into the KillJoy executable is a fully-featured Gui configuration editor
that you may want to use instead of a text editor to compile the list of names
that KillJoy acts on when a valid argument is found.

The prefs editor should be self explanatory in usage apart from this, but just
to be thorough, here's a breakdown on what it all does.

The UserNames Gadget just shows the number of users in the currently active
list of names. At the bottom of the gui is a status display which normally
just displays author info but will show errors should there be any problems
while running such as file errors etc. You have your normal Add and Delete
buttons which I'll leave to your active imagination as to what they both do :)

Save Config and Read Config do exactlly what they say and work on the currently
configured file path from the tooltype line which is detailed below.

The UserDirectory GetFile gadget is used to select the path where the user
directories for your BBS software are. Inside these directories are the
waitingmail.dat files which killjoy will be removing for you, so make sure
you pick the correct one. Note that KillJoy will not kill anything else if you
do mess up this selection, but all of you should be able to find it with no
problem anyway. For Zeus you'll find it in Zeus:System/Users/ wheras Xenolink
is XUSER: if you've installed it correctly.

Users of DLG and Excelsior will have to wing it as I've never ran either of
those BBS programs myself :-)


ToolTypes currently supported in KillJoy's icon
-----------------------------------------------

WINDOWX=blah             <-- Window top left X position
WINDOWY=blah             <-- Window top left Y position
ICONX=blah               <-- Iconified Icon X position
ICONY=blah               <-- Iconified Icon Y position

When any of the specified coordinates are out of bounds, both the full and
the iconized windows will be auto-adjusted to fit on your screen.

PUBSCREEN=blah           <-- Your preferred public screen to bump the Gui
                             onto, but watch it - it's case sensitive!!!
                             Without any entry after the "=" it will put
                             KillJoy_Prefs onto the topmost screen.

Default screen is naturally Workbench if you choose not to use this option. If 
a named screen is not available, the program will not run.

FONT=blah                <-- Name of font, with or without the .font.

The font must be an 8 point font or else it will default to Topaz. I recomend
Pearl.font which is classy.

CFGPATH=<path>           <-- You need only specify this one for your bbs.
                             Full path, trailing slash is optional...

As a default the following directories will be searched: S:, Env:, EnvArc:
and RAM:.  If you want to change it then use the tooltype to specify a path.

I am reliably informed that the structure of waiting mail is the same for
all of the listed BBS programs, so KillJoy just needs the UserDirectory to
be selected from the KillJoy-Prefs gui and it will look in the correct places
and not delete anything it shouldn't when attempting to remove waiting mail
pointers. The User directory Gadget on KillJoy-Prefs will save the path as an
Enviroment label in EnvArc: which should be present on every Amiga by default :)


About the Authors (Shameless plug time)
---------------------------------------

Anthony Brice is a hard working Bulletin board sysop who just recently went
over to working with Blitz and, hence, hardly knows what the hell he's doing
at the best of times, but hasn't messed this program up, honestly :-) My main
claim to fame on this wonderfull little tool is the hard working routine to
actually kill the mail, and design of the program. Of course my hours in
GadToolsBox designing that nice gui shouldn't go unmentioned although Paul
takes near-on all of the credit for getting the beast actually working.
Particuarly with those nasty little listviews which you mustn't remind him
about as he doesn't have much hair left these days :-)

Paul Juhasz is running a point off the above mentioned hard-working sysop.
Being a relic from the mainframe era, he is the chief trouble-shooter and
bug-fixer and is responsible for the inner workings of this program. Most
of the time he is high on Intuition, Exec and a few other things, so he
can be graciously absolved of any blame for whatever the program decides
to do in his absence... #%)=

If you use this program then you're obligated to at least send us an email
message, or fidonet, with a thank you, or report some bugs, offer suggestions,
and let us know if it works well on your system etc. We have some other funky
little programs in the pipeline now that KillJoy is finished as our first real
step into gadtools programming so be sure to watch the Aminet for future works
of art we come up with. Bug reports are most strongly requested as we'd like
to see how badly we screwed up so we can ignore all the hate mail and convince
ourselves that we never need to see that bloody source code ever again :)

It's not shareware or anything like that, so the message means what it says -
send us a card or mail - we need lots of feedback as it's our first joint
project and we need to know what people want.


Contact
-------

You can contact either of us at the BackYard BBS or via Fido, Barnet etc.

Anthony Brice - fido: 2:254/255.1 - Barnet: 959:102/0.1
                    email: anthony@backyard.demon.co.uk

Paul Juhasz   - fido: 2:254/255.37 - AmigaNet: 39:139/13.37
                    email: phineas@darkside.demon.co.uk

                 We welcome your suggestions :-)

