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

FreeBSD Manual Pages

  
 
  

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

NAME
       timew-continue -	resume tracking	of existing interval

SYNOPSIS
       timew continue [<id>|<tag>...] [<datetime>|<range>]

DESCRIPTION
       The 'continue' command is used to resume	tracking specified by a	closed
       interval. This command is a convenient way to resume work without
       re-entering the tags.

       The interval to be resumed can be specified either by its id or by a
       set of tags. Specifying multiple	ids or both ids	and tags will result
       in an error.

       When given a set	of tags, the first interval matching it	will be	taken
       as a blueprint for the new interval. When given neither id nor tags,
       the first interval in the database is taken.

       When no datetime	or range given,	the new	interval is started at the
       current time.

EXAMPLES
       Using the 'summary' command and specifying the ':ids' hint shows
       interval	IDs. Consider the following intervals:

	   $ src/timew summary :ids

	   Wk  Date	  Day ID Tags		  Start	     End    Time   Total
	   W23 2020-06-04 Thu @4 BAR	       13:00:00	14:00:00 1:00:00
			      @3 BAR, FOO      14:00:00	15:00:00 1:00:00
			      @2 BAR, BAZ, FOO 15:00:00	16:00:00 1:00:00
			      @1 FOO	       16:00:00	17:00:00 1:00:00 4:00:00

	   4:00:00

       Simple continue

	       $ timew continue

       The 'continue' command creates a	new open interval, starting now, with
       tag 'FOO'

       Continue	an interval via	id

	       $ timew continue	@3

       The 'continue' command creates a	new open interval, starting now, with
       tags 'BAR' and 'FOO'.

       Continue	an interval via	tag set

	       $ timew continue	FOO BAR

       The 'continue' command creates a	new open interval, starting now, with
       tags 'FOO', 'BAR', and 'BAZ'.

       Note that the first matching interval (here '@2') is taken as a
       blueprint for the new interval, although	'@3' would have	been a perfect
       match for the given tag set. The	command	'timew continue	BAR' would
       have the	same effect. This means	that there is no way to	continue '@4'
       via a tag set.

       Continue	an interval at a specific date & time

	       $ timew continue	@4 19:00  (1)
	       $ timew continue	FOO 19:00 (2)

       The 'continue' command creates a	new open interval

	1. with	tag 'BAR' (as specified	by '@4') and start time	'19:00'.

	2. with	tag 'FOO' (as specified	by '@1') and start time	'19:00'.

	   Continue an interval	with a specific	range

		   $ timew continue @4 19:00 - 20:00  (1)
		   $ timew continue FOO	19:00 -	20:00 (2)

       The 'continue' command creates a	new closed interval

	1. with	tag 'BAR' (as specified	by '@4'), start	time '19:00', and end
	   time	'20:00'.

	2. with	tag 'FOO' (as specified	by '@1') and start time	'19:00', and
	   end time '20:00'.

SEE ALSO
       timew-cancel(1),	timew-start(1),	timew-stop(1), timew-track(1)

timew 1.7.1			  2024-01-16		     TIMEW-CONTINUE(1)

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

home | help