X-Git-Url: https://git.tokkee.org/?a=blobdiff_plain;f=Documentation%2Fgit-tag.txt;h=299b04f726b2e7662fb7db64169726eec82a5c14;hb=8b3dce565084c89ceb19f7ccf0fe22ffd365f7fd;hp=1118ce22dcfcbaf190bd7abc60c2b33c213acd06;hpb=6eedee514eb39f2b097cd572b47946cef6ea88e6;p=git.git diff --git a/Documentation/git-tag.txt b/Documentation/git-tag.txt index 1118ce22d..299b04f72 100644 --- a/Documentation/git-tag.txt +++ b/Documentation/git-tag.txt @@ -10,17 +10,15 @@ SYNOPSIS -------- [verse] 'git tag' [-a | -s | -u ] [-f] [-m | -F ] - [ | ] -'git tag' -d ... + [ | ] +'git tag' -d ... 'git tag' [-n[]] -l [--contains ] [] -'git tag' -v ... +'git tag' -v ... DESCRIPTION ----------- -Adds a 'tag' reference in `.git/refs/tags/`. The tag must pass -linkgit:git-check-ref-format[1] which basicly means that control characters, -space, ~, ^, :, ?, *, [ and \ are prohibited. +Adds a tag reference in `.git/refs/tags/`. Unless `-f` is given, the tag must not yet exist in `.git/refs/tags/` directory. @@ -53,6 +51,7 @@ OPTIONS Make a GPG-signed tag, using the given key -f:: +--force:: Replace an existing tag with the given name (instead of failing) -d:: @@ -88,6 +87,12 @@ OPTIONS Implies `-a` if none of `-a`, `-s`, or `-u ` is given. +:: + The name of the tag to create, delete, or describe. + The new tag name must pass all checks defined by + linkgit:git-check-ref-format[1]. Some of these checks + may restrict the characters allowed in a tag name. + CONFIGURATION ------------- By default, 'git-tag' in sign-with-default mode (-s) will use your @@ -252,6 +257,10 @@ $ GIT_COMMITTER_DATE="2006-10-02 10:31" git tag -s v1.0.1 ------------ +SEE ALSO +-------- +linkgit:git-check-ref-format[1]. + Author ------ Written by Linus Torvalds ,