Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
TIMEW-ANNOTATE(1)		  User Manuals		       TIMEW-ANNOTATE(1)

NAME
     timew-annotate - add an annotation to intervals

SYNOPSIS
     timew annotate [<id>...] <annotation>

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
     Annotate a single interval

	 Call the command with an id and the annotation:

	     $ timew annotate @2 'Lorem ipsum'
	     Annotated @2 with "Lorem ipsum"

     Remove an annotation

	 Annotating an interval with an empty string removes the annotation:

	     $ timew annotate @1 ''
	     Removed annotation from @1

     Annotate multiple intervals

	 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"

     Annotate the current open interval

	 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'.

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 com-
     mand like

	 $ timew annotate @1 lorem ipsum

     will result in interval @1 having	only  'ipsum'  as  its	annotation.  Use
     quotes to avoid this.

SEE ALSO
     timew-export(1), timew-summary(1), timew-tag(1)

timew 1.9.1			   2025-08-27		       TIMEW-ANNOTATE(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=timew-annotate&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help