1TIMEW-CONTINUE(1) User Manuals TIMEW-CONTINUE(1)
2
3
4
6 timew-continue - resume tracking of existing interval
7
9 timew continue [<id>|<tag>...] [<datetime>|<range>]
10
12 The 'continue' command is used to resume tracking specified by a closed
13 interval. This command is a convenient way to resume work without
14 re-entering the tags.
15
16 The interval to be resumed can be specified either by its id or by a
17 set of tags. Specifying multiple ids or both ids and tags will result
18 in an error.
19
20 When given a set of tags, the first interval matching it will be taken
21 as a blueprint for the new interval. When given neither id nor tags,
22 the first interval in the database is taken.
23
24 When no datetime or range given, the new interval is started at the
25 current time.
26
28 Using the 'summary' command and specifying the ':ids' hint shows
29 interval IDs. Consider the following intervals:
30
31 $ src/timew summary :ids
32
33 Wk Date Day ID Tags Start End Time Total
34 W23 2020-06-04 Thu @4 BAR 13:00:00 14:00:00 1:00:00
35 @3 BAR, FOO 14:00:00 15:00:00 1:00:00
36 @2 BAR, BAZ, FOO 15:00:00 16:00:00 1:00:00
37 @1 FOO 16:00:00 17:00:00 1:00:00 4:00:00
38
39 4:00:00
40
41 Simple continue
42
43 $ timew continue
44
45 The 'continue' command creates a new open interval, starting now, with
46 tag 'FOO'
47
48 Continue an interval via id
49
50 $ timew continue @3
51
52 The 'continue' command creates a new open interval, starting now, with
53 tags 'BAR' and 'FOO'.
54
55 Continue an interval via tag set
56
57 $ timew continue FOO BAR
58
59 The 'continue' command creates a new open interval, starting now, with
60 tags 'FOO', 'BAR', and 'BAZ'.
61
62 Note that the first matching interval (here '@2') is taken as a
63 blueprint for the new interval, although '@3' would have been a perfect
64 match for the given tag set. The command 'timew continue BAR' would
65 have the same effect. This means that there is no way to continue '@4'
66 via a tag set.
67
68 Continue an interval at a specific date & time
69
70 $ timew continue @4 19:00 (1)
71 $ timew continue FOO 19:00 (2)
72
73 The 'continue' command creates a new open interval
74
75 1. with tag 'BAR' (as specified by '@4') and start time '19:00'.
76
77 2. with tag 'FOO' (as specified by '@1') and start time '19:00'.
78
79 Continue an interval with a specific range
80
81 $ timew continue @4 19:00 - 20:00 (1)
82 $ timew continue FOO 19:00 - 20:00 (2)
83
84 The 'continue' command creates a new closed interval
85
86 1. with tag 'BAR' (as specified by '@4'), start time '19:00', and end
87 time '20:00'.
88
89 2. with tag 'FOO' (as specified by '@1') and start time '19:00', and
90 end time '20:00'.
91
93 timew-cancel(1), timew-start(1), timew-stop(1), timew-track(1)
94
95
96
97timew 1.4.3 2021-05-16 TIMEW-CONTINUE(1)