'\" t
.\"     Title: timew-hints
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.20
.\"      Date: 2023-12-30
.\"    Manual: User Manuals
.\"    Source: timew 1.7.0-dev
.\"  Language: English
.\"
.TH "TIMEW\-HINTS" "7" "2023-12-30" "timew 1.7.0\-dev" "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 pass:[blue\ R\ <\ >]
.\}
.SH "NAME"
timew-hints \- Timewarrior hints
.SH "SYNOPSIS"

.SH "DESCRIPTION"
.sp
Timewarrior supports hints, which are single\-word command line features that start with a colon like this:
.sp
.if n .RS 4
.nf
.fam C
:week
.fam
.fi
.if n .RE
.sp
Hints serve several purposes.
This example is a shortcut for the date range that defines the current week.
.sp
Other hints, such as:
.sp
.if n .RS 4
.nf
.fam C
:quiet
.fam
.fi
.if n .RE
.sp
are ways to control the behavior of Timewarrior, in this case eliminating all forms of feedback, for purposes of automation.
.sp
The supported hints are:
.sp
.if n .RS 4
.nf
.fam C
:quiet         Turns off all feedback. For automation
:debug         Runs in debug mode, shows many runtime details
:yes           Overrides confirmation by answering \*(Aqyes\*(Aq to the questions
.fam
.fi
.if n .RE
.sp
.if n .RS 4
.nf
.fam C
:color         Force color on, even if not connected to a TTY
:nocolor       Force color off, even if connected to a TTY
:blank         Leaves tracked time out of a report
:fill          Expand time to fill surrounding available gap
:adjust        Automatically correct overlaps
:ids           Displays interval ID numbers in the summary report
.fam
.fi
.if n .RE
.sp
Range hints provide convenient shortcuts to date ranges:
.sp
.if n .RS 4
.nf
.fam C
:all           All tracked time
:yesterday     The 24 hours of the previous day
:day / :today  The 24 hours of the current day
:week          This week
:fortnight     This week and the one before
:month         This month
:quarter       This quarter
:year          This year
:lastweek      Last week
:lastmonth     Last month
:lastquarter   Last quarter
:lastyear      Last year
:monday        Previous monday
:tuesday       Previous tuesday
:wednesday     Previous wednesday
:thursday      Previous thursday
:friday        Previous friday
:saturday      Previous saturday
:sunday        Previous sunday
.fam
.fi
.if n .RE