Annotating

Adding notes

doing note lets you append a note to the last entry. You can specify a section to grab the last entry from with -s section_name. -e will open your $EDITOR for typing the note, but you can also just include it on the command line after any flags. You can also pipe a note in on STDIN (echo "fun stuff"|doing note). If you don't use the -r switch, new notes will be appended to the existing notes, and using the -e switch will let you edit and add to an existing note. The -r switch will remove/replace a note; if there's new note text passed when using the -r switch, it will replace any existing note. If the -r switch is used alone, any existing note will be removed.

The note command defaults to affecting the most recent entry across all sections. Narrow it down to a specific section with --section. It also has filtering options, so you can affect the most recent note matching a --tag or --search filter.

Inline notes

You can also add notes at the time of entry by using the -n or --note flag with doing now, doing later, or doing done. If you pass text to any of the creation commands which has multiple lines, everything after the first line break will become the note.

Parenthetical notes

If a string passed to now, later, or done has a parenthetical at the end, the parenthetical will be removed from the title and its contents added as a note. So doing now Working on @project1 (Adding some unit tests) would create an entry titled "Working on @project1" with a note "Adding some unit tests." This is the equivalent of doing now Working on @project1 -n "Adding some unit tests". A parenthetical connected to a tag or not at the end of the line will be left as is.

Tagging and flagging

See Tagging for details.