.TH timew-untag 1 "2021-01-10" "timew 1.4.2" "User Manuals"
.
.SH NAME
timew-untag \- remove tags from intervals
.
.SH SYNOPSIS
.B timew untag
[
.I <id>
.B ...
]
.I <tag>
.B ...
.
.SH DESCRIPTION
The 'untag' command is used to remove a tag from an interval.
Using the 'summary' command, and specifying the ':ids' hint shows interval IDs.
Using the right ID, you can identify an interval to untag.
.
.SH EXAMPLES
For example, show the IDs:
.RS
$ timew summary :week :ids
.RE
Then having selected '@2' as the interval you wish to untag:
.RS
$ timew untag @2 'Old Tag'
.RE
Note that you can untag multiple intervals, with multiple tags:
.RS
$ timew untag @2 @10 @23 'Old Tag' tag2 tag3
.RE
If there is active time tracking, you can omit the ID when you want to remove tags from the current open interval:
.RS
$ timew start foo bar
.br
$ timew untag bar
.RE
This results in the current interval having tag 'foo' but not 'bar'.
.
.SH "SEE ALSO"
.BR timew-lengthen (1),
.BR timew-shorten (1),
.BR timew-summary (1),
.BR timew-tag (1)