summaryrefslogtreecommitdiff
path: root/plugins/reminder.py
diff options
context:
space:
mode:
Diffstat (limited to 'plugins/reminder.py')
-rw-r--r--plugins/reminder.py57
1 files changed, 57 insertions, 0 deletions
diff --git a/plugins/reminder.py b/plugins/reminder.py
index 16a3f710..eb2f9801 100644
--- a/plugins/reminder.py
+++ b/plugins/reminder.py
@@ -1,3 +1,60 @@
+"""
+Installation
+------------
+You only have to load the plugin:
+
+.. code-block:: none
+
+ /load reminder
+
+Usage
+-----
+
+This plugin defines three new global commands: :term:`/remind`,
+:term:`/done`, and :term:`/tasks`.
+
+.. glossary::
+
+ /remind
+ **Usage:** ``/remind <time> <todo>``
+
+ This command will remind you to do ``todo`` every ``time``.
+
+ /done
+ **Usage:** ``/done <id>``
+ Remove a reminder.
+
+ The ``id`` is found using :term:`/tasks`.
+
+
+ /tasks
+
+ Print a list of the tasks, their ids, and their frequency, into the
+ information buffer.
+
+Time format
+-----------
+
+In seconds:
+
+.. code-block:: none
+
+ /remind 600 Work!
+
+Will remind you to work every 10 minutes.
+
+Defining the time in seconds is not really practical, so you can describe it
+with days, hours, and minutes, in a time-string, e.g:
+
+.. code-block:: python
+
+ /remind 1h23m "Get up"
+
+Will remind you to get up every 1 hour 23 minutes.
+
+
+"""
+
from plugin import BasePlugin
import curses
import common