help

todo.py help

What you see in the terminal

Use ./todo.py -h for option help

Usage: ./todo.py command [arg(s)]
   add | a "Item to do +project @context #{yyyy-mm-dd}"
      Adds 'Item to do +project @context #{yyyy-mm-dd}' to your todo.txt
      file.
      +project, @context, #{yyyy-mm-dd} are optional

   addm "First item to do +project @context #{yyyy-mm-dd}
      Second item to do +project @context #{yyyy-mm-dd}
      ...
      Last item to do +project @context #{yyyy-mm-dd}"
      Adds each line as a separate item to your todo.txt file.

   append | app NUMBER "text to append"
      Append "text to append" to item NUMBER.

   del | rm NUMBER
      Deletes the item on line NUMBER in todo.txt

   depri | dp NUMBER
      Remove the priority of the item on line NUMBER.

   do NUMBER
      Marks item with corresponding number as done and moves it to
      your done.txt file.

   help | h
      Display this message and exit.

   listall | lsa
      Lists all items in your todo.txt file sorted by priority followed
      by the items in your done.txt file.

   listcon | lsc
      Lists all items in your todo.txt file sorted by context.

   listdate | lsd
      Lists all items in your todo.txt file sorted by date.

   list | ls
      Lists all items in your todo.txt file sorted by priority.

   listproj | lsp
      Lists all items in your todo.txt file sorted by project title.

   pri | p NUMBER [A-X]
      Add priority specified (A, B, C, etc.) to item NUMBER.

   prepend | pre NUMBER "text to prepend"
      Add "text to prepend" to the beginning of the item.

Examples

todo.py add | a "string"

$ todo.py add "(A) Make a list of examples for wiki"
TODO: '(A) Make a list of examples for wiki' added on line 5.
TODO: /home/sigma/.todo/todo.txt archived.

todo.py addm "string"

$ todo.py addm "(A) Make a better list of examples for wiki
(B) Then do it again.
(C) And once more for maximum verbosity.
(D) Check to see if 'verbosity' is a word."
TODO: '(A) Make a better list of examples for wiki' added on line 1.
TODO: '(B) Then do it again.' added on line 2.
TODO: '(C) And once more for maximum verbosity.' added on line 3.
TODO: '(D) Check to see if 'verbosity' is a word.' added on line 4.

todo.py app NUMBER "string"

$ todo.py app 2 "Then make more examples."
TODO: Item 2 changed from '(B) Then do it again.' to '(B) Then do it again. Then
make more examples.'.

todo.py del NUMBER

$ todo.py del 1
'(A) Make a better list of examples for wiki' deleted.
TODO: Item 1 deleted.

todo.py dp NUMBER

$ todo.py dp 1
TODO: Item 1 changed from '(B) Then do it again.' to 'Then do it again.'.

todo.py do NUMBER

$ todo.py do 1
x 2012-05-18 Then do it again.
TODO: Item 1 marked as done.

todo.py lsa

$ todo.py lsa
1 (C) And once more for maximum verbosity.
2 (D) Check to see if 'verbosity' is a word.
x 2012-05-018 Then do it again.

todo.py lsc

$ todo.py add '(A) Need a @context example.'
TODO: '(A) Need a @context example.' added on line 3.
$ todo.py lsc
context:
    3 (A) Need a @context example.
1 (C) And once more for maximum verbosity.
2 (D) Check to see if 'verbosity' is a word.

todo.py lsd

$ todo.py add '(A) Need a #{2012-05-18} date example.'
TODO: '(A) Need a #{2012-05-18} date example.' added on line 4.
$ todo.py lsd
2012-05-18:
    4 (A) Need a #{2012-05-18} date example.
3 (A) Need a @context example.
1 (C) And once more for maximum verbosity.
2 (D) Check to see if 'verbosity' is a word.

todo.py ls

$ todo.py ls
3 (A) Need a @context example.
4 (A) Need a #{2012-05-18} date example.
1 (C) And once more for maximum verbosity.
2 (D) Check to see if 'verbosity' is a word.

todo.py lsp

$ todo.py add '(B) Add a +project example.'
TODO: '(B) Add a +project example.' added on line 5.
$ todo.py lsp
project:
    5 (B) Add a +project example.
3 (A) Need a @context example.
4 (A) Need a #{2012-05-18} date example.
1 (C) And once more for maximum verbosity.
2 (D) Check to see if 'verbosity' is a word.

todo.py pri NUMBER PRIORITY

$ todo.py pri 2 B
TODO: Item 2 changed from '(D) Check to see if 'verbosity' is a word.' to '(B)
Check to see if 'verbosity' is a word.'.

todo.py pre NUMBER "text to prepend"

$ todo.py pre 3 "This is no longer needed."
TODO: Item 3 changed from '(A) Need a @context example.' to '(A) This is no
longer needed. Need a @context example.'.