X-Git-Url: https://arthur.barton.de/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=Documentation%2Fbup-tag.md;h=49416a4502ed1484f81c0383fd37f362f8ee041b;hb=HEAD;hp=77b04ff0ec61a0f07709845796d57b80e482db1a;hpb=9665d202d372b499802e759f29c97f3861eb247c;p=bup.git diff --git a/Documentation/bup-tag.md b/Documentation/bup-tag.md index 77b04ff..49416a4 100644 --- a/Documentation/bup-tag.md +++ b/Documentation/bup-tag.md @@ -10,15 +10,15 @@ bup-tag - tag a commit in the bup repository bup tag -bup tag \ \ +bup tag [-f] \ \ -bup tag -d \ +bup tag -d [-f] \ # DESCRIPTION `bup tag` lists, creates or deletes a tag in the bup repository. -A tag is an easy way to retreive a specific commit. It can be used to mark a +A tag is an easy way to retrieve a specific commit. It can be used to mark a specific backup for easier retrieval later. When called without any arguments, the command lists all tags that can @@ -31,20 +31,17 @@ bup exposes the contents of backups with current tags, via any command that lists or shows backups. They can be found under the /.tag directory. For example, the 'ftp' command will show the tag named 'tag1' under /.tag/tag1. -Tags are also exposed under the branches from which they can be reached. For -example, if you create a tag named 'important' under branch 'computerX', you -will also be able to retrieve the contents of the backup that was tagged under -/computerX/important. This is done as a convenience, and should the branch -'computerX' be deleted, the contents of the tagged backup will be available -through /.tag/important as long as the tag is not deleted. - # OPTIONS --d, --delete +-d, \--delete : delete a tag -# EXAMPLE - +-f, \--force +: Overwrite the named tag even if it already exists. With -f, don't + report a missing tag as an error. + +# EXAMPLES + $ bup tag new-puppet-version hostx-backup $ bup tag