                                    MBWatch
                                    =======

About this program
==================

This is the 3rd release of my timer program. I've written this program in  order
to  have a small, handy timer to control the time I spend e.g on IRC and to help
me, reduce my phonebills. I've been searching for such a  program  for  quite  a
long  time  and didn't find any comparable tool. And this stuff like e.g MagicCX
is IMHO quite too buggy and eats too much of my valuable memory.  In  the  first
place  my  intention  was,  to  leave  this  program  as  small as possible, but
meanwhile I've added some quite useful features and it got slightly  bigger  and
it'll  grow  a  bit  in  the future. So, if you'd like to have some more special
features in this program, please be so kind and let me know  your  very  special
needs.  I  won't implement everything, but as you might notice, I've implemented
some wishes by some users of my first version.

Usage
=====

Start MBWatch by starting it from a shell or from a script.

    MBWatch X=XPOS/N,Y=YPOS/N,SCR=SCREEN/K,S=START/S,LOGTIME/N,SEC/N,MIN/N,HOUR/N,
            ALARM/N,SAMPLE/K

    XPOS        Left Edge of the Window
                                        !!! Currently, I don't check your values
    YPOS        Top Edge of the Window

    SCREEN      You may enter the name of your favorite PubScreen

    START       The timer is resetted and starts automatically

    LOGFILE     Enable the Log Function.

    LOGTIME     Time distance in seconds. MBWatch will update the s:.mbwatch
                file after n seconds. If you start MBWatch a second time after
                e.g a crash, it'll continue with the last logtime. This file
                will be deleted, everytime you leave MBWatch the "normal" way.

    SEC         This will give you a certain time offset. E.g the timer starts
    MIN         to count about half a minute after the handshake has started,
    HOUR        so you'll be able to give a preset.

    ALARM       You may set an alarm time in seconds. When the given time is
                over, there'll be either a DisplayBeep or an 8svx sample will
                be played.

    SAMPLE      If you place the path to an 8svx sample here, it'll be played
                when the alarmtime has passed.

ARexx
=====

MBTimer installs an ARexx port for each Window you open. They'll be named
'MBWATCH.00' through 'MBWATCH.99'.

    Commands:

        START       Start the timer

        STOP        Stop the timer

        RESET       Reset the timer

        QUIT        Quit this program

        GETTIME     Return the time string

    Invocation via e.g your shell:

        rx "ADDRESS MBWATCH.01; START"

OnlineWatch-2
=============

This script is (c) by Dirk M. Oppelt. (Dimik@#amigager)

OnlineWatch-2 is a Shell script that stops the timer, reads  the  actual  online
time,  gives  you  some  information  and writes a logfile. There'll be a single
logfile for every month. This logfile is only for the german telekom phonebills,
but  I  guess  it could be adapted to your country without problems. To use this
script you simply have to execute it when you stop using your  phone,  the  rest
will be done automagically.

Currently OnlineWatch-2 doesn't support holidays.

The logfiles will be placed in s:gebuehren/

A better doc for this function will follow soon ;-)

How I use this program
======================

I use Jochen Wiedmann's IPDial to startup my slip  line  via  AmiTCP.  When  the
connection  is established, I use the script (and my enhanced version of IPStart
- I'll give it to Jochen soon ;c) ) to start MBWatch and to start the timer.  In
my Stopnet script I stop this timer again.

Legal Stuff
===========

This program is Giftware. If you like this program, I'd be glad if you'd send me
something.  A  huge  bag  full  of  money, a cd, a new car, hmmm, what about ...
*grin*. No, give me some response, send me your suggestions, tell  me  what  you
like about this program, or tell me what you'd like to see in future versions.

I've decided to publish this program as GWAR-Ware. Perhaps you'd like to know one
important thing: 'What the fuck is GWAR ?'. GWAR is one of the best bands in the
entire universe. If you like this program, you'll have to buy either a GWAR CD or
go to a GWAR concert !!!

Future Plans
============

    o   Including more shell arguments
    o   Fixing some stupid things
    o   Perhaps your idea ...
    o   A better documentation
    o   Perhaps a log function for e.g PhoneBill or similar programs

History
=======

    1.0b    First official release

    1.0a    Added Ctrl-C handling
            Added the GetTime ARexx command

    1.0     Added a logfile option
            Removed autoactivation of the window.
            Added Alarm function
            Added Preset capability
            Now you can add several windows
            Window will open on the DefaultPubScreen if the given screen is not
                available.

    1.1     The logfile option must be switched on with the LOGFILE keyword
            Added Dirk's Logscript
            Fixed some minor bugs

Thank you
=========

    Dirk M. Oppelt (Dimik) for the wonderful Script.

    Jochen Wiedmann for his incredible IPDial.

    To GWAR, Colloseum, Emerson Lake & Palmer, Faith no more, Rainbow

        Their music inspired me while working on this program.

    3 or 4 guys who gave me some inspirations about this program.

        Sorry, I don't know, where the piece of paper with your names has
        gone. The only one I can remember right now is 'obw' at #amigager.

    All the people at #amigager

Author
======

    Michael Bauer
    Hegelstr. 27
    72072 Tuebingen
    07071/72293

    EMail: michael.bauer@zdv.uni-tuebingen.de (this one is preferred)
    or     u195305@pluto.rz.fh-reutlingen.de
    IRC:   Gutgolf@#amigager
    WWW:   http://pluto.rz.fh-reutlingen.de/~u195305/index.html

