'\" t
.\"     Title: timew-track
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.20
.\"      Date: 2025-08-22
.\"    Manual: User Manuals
.\"    Source: timew 1.9.1
.\"  Language: English
.\"
.TH "TIMEW\-TRACK" "1" "2025-08-22" "timew 1.9.1" "User Manuals"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "NAME"
timew-track \- add intervals to the database
.SH "SYNOPSIS"
.sp
.nf
\fBtimew track\fP \fI<range>\fP [\fI<tag>\fP\fB...\fP]
.fi
.br
.SH "DESCRIPTION"
.sp
The track command is used to add tracked time in the past.
Perhaps you forgot to record time, or are just filling in old entries.
.SH "HINTS"
.sp
Apart from range hints (see \fBtimew\-hints\fP(7)), the track command accepts the following hints:
.sp
\fB:fill\fP
.RS 4
The \*(Aq:fill\*(Aq hint can be used to create a new interval that fills the gap between two adjacent intervals.
.RE
.SH "EXAMPLES"
.sp
\fBRecording a closed interval\fP
.RS 4
For example:
.sp
.if n .RS 4
.nf
.fam C
$ timew track :yesterday \*(AqTraining Course\*(Aq
$ timew track 9am \- 11am \*(AqStaff Meeting\*(Aq
.fam
.fi
.if n .RE
.sp
Note that the track command expects a closed interval (start and end time), when recording.
If a closed interval is not provided, the \*(Aqtrack\*(Aq command behaves the same as the \*(Aqstart\*(Aq command.
.RE
.sp
\fBFilling the gap between two intervals\fP
.RS 4
To fill the gap between two intervals, without having to specify the exact times, one can use the :fill hint.
When e.g. the first interval ends some time before 10:00 and the second interval starts some time after 11:00, calling
.sp
.if n .RS 4
.nf
.fam C
$ timew track 10:00 \- 11:00 :fill \*(AqCoffee Break\*(Aq
.fam
.fi
.if n .RE
.sp
will instruct Timewarrior to expand the interval such that it starts right after the first interval and ends right before the second interval.
.RE
.SH "SEE ALSO"
.sp
\fBtimew\-cancel\fP(1),
\fBtimew\-continue\fP(1),
\fBtimew\-start\fP(1),
\fBtimew\-stop\fP(1)