about summary refs log tree commit diff stats
diff options
context:
space:
mode:
authorgbmor <ben@gbmor.dev>2020-07-16 01:33:33 -0400
committergbmor <ben@gbmor.dev>2020-07-16 01:33:33 -0400
commitf0bb09f4e48c290d11cdcf6f85a3a606c16bf97b (patch)
tree309129df57ee2579152b4fcc41221402a3eb3336
parentb68274905feb35aaefc5aa5c1bda6b7e872ea248 (diff)
downloadwiki-f0bb09f4e48c290d11cdcf6f85a3a606c16bf97b.tar.gz
added todo.md, submitted by ~ensa
-rw-r--r--pages/todo.md66
1 files changed, 66 insertions, 0 deletions
diff --git a/pages/todo.md b/pages/todo.md
new file mode 100644
index 0000000..49a9a6c
--- /dev/null
+++ b/pages/todo.md
@@ -0,0 +1,66 @@
+<!--
+title: todo, a todo list manager
+description: todo usage guide
+author: ensa
+-->
+
+# todo, a todo list manager
+
+`todo` is a todo list manager.
+
+`todo` manages the todo list stored in the path referred to by `$TODO`, or
+`$HOME/todo` if TODO isn't set.
+
+## basic usage
+
+`todo` without arguments will print the file's
+contents, with line numbers added.
+example output:
+```
+     1  write todo documentation
+     2  water the cat
+     3  do nothing
+```
+
+`todo -a "MSG"`
+will append another line, containing MSG.
+```
+     1  write todo documentation
+     2  water the cat
+     3  do nothing
+     4  MSG
+```
+
+`todo -e` edits the todo file in `$EDITOR`.
+
+`todo -d 2` removes item 2 from the list, and archives it in `${TODO}.complete`
+with a timestamp.
+`todo` output after `todo -d 2`:
+```
+     1  write todo documentation
+     2  do nothing
+     3  MSG
+```
+
+`todo -x` views the list archive.
+example output:
+```
+2020-07-16 13:37:53 - water the cat
+```
+
+## advanced use
+
+the `-n` flag specifies the line number where the line is added, pushing all
+lower lines down by one.
+for example, `todo` after `todo -n 3 -a 'bake pie'` will result in this.
+```
+     1  write todo documentation
+     2  do nothing
+     3  bake pie
+     4  MSG
+```
+
+## source repository
+todo's source can be found [here](https://git.tilde.institute/ensa/todo).
+
+[back](/)