112 lines
3.5 KiB
Plaintext
112 lines
3.5 KiB
Plaintext
Usage: todo.sh [-fhpantvV] [-d todo_config] action [task_number] [task_description]
|
|
|
|
Actions:
|
|
add "THING I NEED TO DO +project @context"
|
|
a "THING I NEED TO DO +project @context"
|
|
Adds THING I NEED TO DO to your todo.txt file on its own line.
|
|
Project and context notation optional.
|
|
Quotes optional.
|
|
|
|
addto DEST "TEXT TO ADD"
|
|
Adds a line of text to any file located in the todo.txt directory.
|
|
For example, addto inbox.txt "decide about vacation"
|
|
|
|
append NUMBER "TEXT TO APPEND"
|
|
app NUMBER "TEXT TO APPEND"
|
|
Adds TEXT TO APPEND to the end of the todo on line NUMBER.
|
|
Quotes optional.
|
|
|
|
archive
|
|
Moves done items from todo.txt to done.txt and removes blank lines.
|
|
|
|
del NUMBER [TERM]
|
|
rm NUMBER [TERM]
|
|
Deletes the item on line NUMBER in todo.txt.
|
|
If term specified, deletes only the term from the line.
|
|
|
|
depri NUMBER
|
|
dp NUMBER
|
|
Deprioritizes (removes the priority) from the item
|
|
on line NUMBER in todo.txt.
|
|
|
|
do NUMBER
|
|
Marks item on line NUMBER as done in todo.txt.
|
|
|
|
list [TERM...]
|
|
ls [TERM...]
|
|
Displays all todo's that contain TERM(s) sorted by priority with line
|
|
numbers. If no TERM specified, lists entire todo.txt.
|
|
|
|
listall [TERM...]
|
|
lsa [TERM...]
|
|
Displays all the lines in todo.txt AND done.txt that contain TERM(s)
|
|
sorted by priority with line numbers. If no TERM specified, lists
|
|
entire todo.txt AND done.txt concatenated and sorted.
|
|
|
|
listcon
|
|
lsc
|
|
Lists all the task contexts that start with the @ sign in todo.txt.
|
|
|
|
listfile SRC [TERM...]
|
|
lf SRC [TERM...]
|
|
Displays all the lines in SRC file located in the todo.txt directory,
|
|
sorted by priority with line numbers. If TERM specified, lists
|
|
all lines that contain TERM in SRC file.
|
|
|
|
listpri [PRIORITY]
|
|
lsp [PRIORITY]
|
|
Displays all items prioritized PRIORITY.
|
|
If no PRIORITY specified, lists all prioritized items.
|
|
|
|
listproj
|
|
lsprj
|
|
Lists all the projects that start with the + sign in todo.txt.
|
|
|
|
move NUMBER DEST [SRC]
|
|
mv NUMBER DEST [SRC]
|
|
Moves a line from source text file (SRC) to destination text file (DEST).
|
|
Both source and destination file must be located in the directory defined
|
|
in the configuration directory. When SRC is not defined
|
|
it's by default todo.txt.
|
|
|
|
prepend NUMBER "TEXT TO PREPEND"
|
|
prep NUMBER "TEXT TO PREPEND"
|
|
Adds TEXT TO PREPEND to the beginning of the todo on line NUMBER.
|
|
Quotes optional.
|
|
|
|
pri NUMBER PRIORITY
|
|
p NUMBER PRIORITY
|
|
Adds PRIORITY to todo on line NUMBER. If the item is already
|
|
prioritized, replaces current priority with new PRIORITY.
|
|
PRIORITY must be an uppercase letter between A and Z.
|
|
|
|
replace NUMBER "UPDATED TODO"
|
|
Replaces todo on line NUMBER with UPDATED TODO.
|
|
|
|
report
|
|
Adds the number of open todo's and closed done's to report.txt.
|
|
|
|
|
|
|
|
Options:
|
|
-d CONFIG_FILE
|
|
Use a configuration file other than the default ~/todo.cfg
|
|
-f
|
|
Forces actions without confirmation or interactive input
|
|
-h
|
|
Display this help message
|
|
-p
|
|
Plain mode turns off colors
|
|
-a
|
|
Don't auto-archive tasks automatically on completion
|
|
-n
|
|
Don't preserve line numbers; automatically remove blank lines
|
|
on task deletion
|
|
-t
|
|
Prepend the current date to a task automatically
|
|
when it's added.
|
|
-v
|
|
Verbose mode turns on confirmation messages
|
|
-V
|
|
Displays version, license and credits
|