Add retag command (#551)

Closes #515 

---------

Signed-off-by: cyberme0w <iuri_archer@hotmail.com>
This commit is contained in:
Iúri Archer 2023-07-31 22:45:08 +02:00 committed by GitHub
parent a2374fb67b
commit 4469e9056a
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
9 changed files with 519 additions and 0 deletions

View file

@ -0,0 +1,40 @@
= timew-retag(1)
== NAME
timew-retag - replace all tags in intervals
== SYNOPSIS
[verse]
*timew retag* [_<id>_**...**] _<tag>_**...**
== DESCRIPTION
The 'retag' command is used to replace all tags in an interval with the newly provided tags.
Using the 'summary' command, and specifying the ':ids' hint shows interval IDs.
Using the right ID, you can identify an interval to retag.
== EXAMPLES
For example, show the IDs:
$ timew summary :week :ids
Then having selected '@2' as the interval you wish to retag:
$ timew retag @2 'New Tag'
Note that you can retag multiple intervals, with multiple tags:
$ timew retag @2 @10 @23 'Tag One' tag2 tag3
If there is active time tracking, you can omit the ID when you want to retag the current open interval:
$ timew start foo
$ timew retag bar
This results in the current interval having only the 'bar' tag.
== SEE ALSO
**timew-lengthen**(1),
**timew-shorten**(1),
**timew-summary**(1),
**timew-tag**(1)
**timew-untag**(1)

View file

@ -88,6 +88,9 @@ Alphabetically:
*timew-resize*(1)::
Set interval duration
*timew-retag*(1)::
Replace tags in intervals
*timew-shorten*(1)::
Shorten intervals