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

about
-----
| 

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

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

remind the user with given txt at a certain time

| 

  the alarm plugin allows for alarms that message the user giving the
  command at a certain time or number of seconds from now
 

| 

commands
--------
| 


1) alarm

    say txt at a specific time or time diff

    ::

        <user> !alarm 12:00 lunchtime
        <output> alarm 7 set at Thu May 22 12:00:00 2008

    ::

        <user> !alarm 3-11-2008 0:01 birthday !
        <output> alarm 8 set at Mon Nov  3 00:01:00 2008

    ::

        <user> !alarm +180 egg ready
        <output> alarm 9 set at Thu May 22 11:33:46 2008

2) alarm-del

    delete alarm with id <nr>

    ::

        <user> !alarm-del 7
        <output> alarm with id 7 deleted

3) alarm-list

    list current alarms

    ::

        <user> !alarm-list
        <output> 6) test: Thu May 22 12:00:00 2008 - lunchtime  .. 8)
        <output>  test: Mon Nov  3 00:01:00 2008 - birthday !  .. 9)
        <output>  test: Thu May 22 11:33:46 2008 - egg ready 

4) alarm-mylist (myalarms)

    list alarms of user giving the commands

    ::

        <user> !alarm-mylist
        <output> 6) Thu May 22 12:00:00 2008 - lunchtime  .. 8) Mon
        <output>  Nov  3 00:01:00 2008 - birthday !  .. 9) Thu May 22
        <output>  11:33:46 2008 - egg ready 
