======
 TODO 
======
| 

about
-----
| 

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

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

todo lists

| 

  manage todo lists .. by user or by channel .. a time/data string can 
  be provided to set time on a todo item.
 

| 

commands
--------
| 


1) todo

    todo [<item>] .. show todo items or add a todo item

    ::

        <user> !todo
        <output> nothing todo ;]

    ::

        <user> !todo program the bot
        <output> todo item 1 added

    ::

        <user> !todo 22:00 sleep
        <output> time detected Sat May 24 22:00:00 2008 .. todo item
        <output>  2 added

4) todo-chan (chantodo)

    todo-chan [<item>] .. add channel todo

    ::

        <user> !todo-chan fix bla
        <output> todo item 1 added

3) todo-chandone (chandone)

    todo-chandone <listofnrs> .. remove item from channel todo list

    ::

        <user> !todo-chandone 2
        <output> no items deleted

3) todo-done (done)

    todo-done <listofnrs> .. remove items from todo list

    ::

        <user> !todo-done 1
        <output> 1 item deleted

    ::

        <user> !todo-done 3 5 8
        <output> no items deleted

3) todo-get

    todo-get <nick> .. get the todo list of <nick>

    ::

        <user> !todo-get dunker
        <output> can't find user for bart@gozerbot.org

3) todo-getprio (prio)

    todo-getprio [<channel|name>] <itemnr> .. get todo priority

    ::

        <user> !todo-getprio #dunkbots 5
        <output> priority is None

    ::

        <user> !todo-getprio 3
        <output> no todo item 3 known for test

3) todo-set

    todo-set <nick> <txt> .. set todo item of <nick>

    ::

        <user> !todo-set dunker bot proggen
        <output> can't find user for bart@gozerbot.org

3) todo-setprio (setprio)

    todo-setprio [<channel|name>] <itemnr> <prio> .. set todo priority

    ::

        <user> !todo-setprio #dunkbots 2 5
        <output> priority set

    ::

        <user> !todo-setprio owner 3 10
        <output> priority set

    ::

        <user> !todo-setprio 2 10
        <output> priority set

3) todo-settime

    todo-settime [<channel|name>] <itemnr> <timestring> .. set todo time

    ::

        <user> !todo-settime #dunkbots 2 13:00
        <output> odo-settime [<channe|namel>] <itemnr> <timestring>

    ::

        <user> !todo-settime owner 3 2-2-2010
        <output> odo-settime [<channe|namel>] <itemnr> <timestring>

    ::

        <user> !todo-settime 2 22:00
        <output> no todo 2 found for todo-settime

3) todo-time (tt)

    todo-time .. show todo items with time fields

    ::

        <user> !todo-time
        <output> 2) Sat May 24 22:00:00 2008 sleep [+10]

3) todo-today (today)

    todo-today .. todo items for today

    ::

        <user> !todo-today
        <output> 2) Sat May 24 22:00:00 2008 sleep [+10]

3) todo-tomorrow (tomorrow)

    todo-tomorrow .. todo items for tomorrow

    ::

        <user> !todo-tomorrow
        <output> nothing todo ;]

3) todo-week

    todo-week .. todo items for this week

    ::

        <user> !todo-week
        <output> 2) Sat May 24 22:00:00 2008 sleep [+10]
