=======
 ALARM 
=======
| 

about
-----
| 

:author:  Bart Thate <bart@gozerbot.org>
:contact: IRCNET/#dunkbots
:website: http://plugins.gozerbot.org
:license: Public Domain
 
| 

description
-----------
| 

the alarm plugin allows for alarms which /msg the user giving the command at a certain time or at number of seconds from now

| 

commands
--------
| 


1) alarm

    say txt at a specific time or time diff

    ::

        <user> !alarm 12:00 lunchtime
        <output> alarm 42 set at Tue Jun 26 12:00:00 2007

    ::

        <user> !alarm 3-11-2007 0:01 birthday !
        <output> alarm 43 set at Sat Nov  3 00:01:00 2007

    ::

        <user> !alarm +180 egg ready
        <output> alarm 44 set at Tue Jun 26 03:56:11 2007

2) alarm-del

    delete alarm with id <nr>

    ::

        <user> !alarm-del 1
        <output> failed to delete alarm with id 1

3) alarm-list

    list current alarms

    ::

        <user> !alarm-list
        <output> 15) test: Sat Nov  3 00:01:00 2007 - birthday !  .. 18) test: Sat Nov  3 00:01:00 2007 - birthday ! 
        <output>  .. 21) test: Sat Nov  3 00:01:00 2007 - birthday !  .. 26) test: Sat Nov  3 00:01:00 2007 - birthday
        <output>  !  .. 33) test: Sat Nov  3 00:01:00 2007 - birthday !  .. 36) test: Sat Nov  3 00:01:00 2007 - birthday
        <output>  !  .. 39) test: Sat Nov  3 00:01:00 2007 - birthday !  .. 42) test: Tue Jun 26 12:00:00 2007 - lunchtime
        <output>   .. 43) test: Sat Nov  3 00:01:00 2007 - birthday !  .. 44) test: Tue Jun 26 03:56:11 2007 - egg ready
        <output>  

4) alarm-mylist (myalarms)

    list alarms of user giving the commands

    ::

        <user> !alarm-mylist
        <output> 15) Sat Nov  3 00:01:00 2007 - birthday !  .. 18) Sat Nov  3 00:01:00 2007 - birthday !  .. 21) Sat Nov
        <output>   3 00:01:00 2007 - birthday !  .. 26) Sat Nov  3 00:01:00 2007 - birthday !  .. 33) Sat Nov  3 00:01:00
        <output>  2007 - birthday !  .. 36) Sat Nov  3 00:01:00 2007 - birthday !  .. 39) Sat Nov  3 00:01:00 2007 - birthday
        <output>  !  .. 42) Tue Jun 26 12:00:00 2007 - lunchtime  .. 43) Sat Nov  3 00:01:00 2007 - birthday !  .. 44)
        <output>  Tue Jun 26 03:56:11 2007 - egg ready 
