blob: 49a9a6c26466ca29f2b90bd6bcae0b0c6606d65a (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
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](/)
|