timew-annotate - add an annotation to intervals
Contents
Bugs & Limitations
The summary command truncates annotations longer than 15 characters. To display longer annotations, one
can use the 'export' command, or a custom report.
Currently, the annotation command picks the last token from the command line and uses it as annotation.
I.e. using no quotes in an annotation command like
$ timew annotate @1 lorem ipsum
will result in interval @1 having only 'ipsum' as its annotation. Use quotes to avoid this.
Description
The 'annotate' command is used to add an annotation to an interval.
See the 'summary' command on how to display the <id> and <annotation> of an interval.
Examples
Annotateasingleinterval
Call the command with an id and the annotation:
$ timew annotate @2 'Lorem ipsum'
Annotated @2 with "Lorem ipsum"
Removeanannotation
Annotating an interval with an empty string removes the annotation:
$ timew annotate @1 ''
Removed annotation from @1
Annotatemultipleintervals
You can annotate multiple intervals with the same annotation at once, by specifying their ids:
$ timew annotate @2 @10 @23 'Lorem ipsum'
Annotated @1 with "Lorem ipsum"
Annotated @10 with "Lorem ipsum"
Annotated @23 with "Lorem ipsum"
Annotatethecurrentopeninterval
If there is active time tracking, you can omit the ID when you want to add an annotation to the
current open interval:
$ timew start foo
...
$ timew annotate bar
Annotated @1 with "bar"
This results in the current interval having tag 'foo' and annotation 'bar'.
Name
timew-annotate - add an annotation to intervals
See Also
timew-export(1), timew-summary(1), timew-tag(1) timew 1.7.1 2024-02-25 TIMEW-ANNOTATE(1)
Synopsis
timewannotate [<id>...] <annotation>
