Skip to content
This repository was archived by the owner on Nov 1, 2017. It is now read-only.

Clarify tag object creation and link with tag reference creation #233

Merged
jasonrudolph merged 2 commits into from
Mar 28, 2013
Merged

Clarify tag object creation and link with tag reference creation #233

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
db6cbcc
Add example input for creating tag objects
izuzak Mar 28, 2013
089197c
Link tag object creation with tag ref creation
izuzak Mar 28, 2013
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 15 additions & 4 deletions content/v3/git/tags.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,10 +23,11 @@ lightweight tags.

Note that creating a tag object does not create the reference that
makes a tag in Git. If you want to create an annotated tag in Git,
you have to do this call to create the tag object, and then create
the `refs/tags/[tag]` reference. If you want to create a lightweight
tag, you simply have to create the reference - this call would be
unnecessary.
you have to do this call to create the tag object, and then
[create](/v3/git/refs/#create-a-reference) the `refs/tags/[tag]` reference.
If you want to create a lightweight tag, you only have to
[create](/v3/git/refs/#create-a-reference) the tag reference - this call
would be unnecessary.

POST /repos/:owner/:repo/git/tags

Expand Down Expand Up @@ -54,6 +55,16 @@ tagger.email
tagger.date
: _Timestamp_ of when this object was tagged

### Example Input

<%= json "tag"=> "v0.0.1", \
"message" => "initial version\n", \
"object" => "c3d0be41ecbe669545ee3e94d31ed9a4bc91ee3c", \
"type" => "commit", \
"tagger"=> \
{"name" => "Scott Chacon", "email" => "[email protected]", \
"date" => "2011-06-17T14:53:35-07:00"} %>

### Response

<%= headers 201,
Expand Down