bob/tagger
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Enhance explanation around existing tags

Browse Source 
Adding existing tags is a nop. Changing a tag into an existing tag is
effectively a deletion of the original tag.
This commit is contained in:
Bob Polis
2025-08-08 12:54:54 +02:00
parent d3bafe2885
commit 1e7e84a9a5
1 changed files with 7 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

7
man/man1/tagger.1
View File

@@ -62,6 +62,8 @@ option is implied, and can be omitted.
.It Fl a, \-add Ar tag
Add the specified tag.
This option can be used multiple times.
Adding a tag that is already present in a file will not add it a second time, so
tags always remain unique for any given file.
.It Fl c, \-change Ar tag
Change the given tag, into a new value supplied as an argument for the
.Fl i
@@ -75,6 +77,11 @@ These pairs of
and
.Fl i
options can be used multiple times.
.Pp
If a tag is changed into a tag that already exists for a file, it is not added a
second time, so tags will always remain unique for any given file.
This situation would be equivalent to simply delete the original tag which
should be changed.
.It Fl d, \-delete Ar tag
Delete the given tag, if it exists.
This option can be used multiple times.