How do I check out version version/tag 1.1.4 of the rspec bundle?
cd ~/Library/Application\ Support/TextMate/Bundles/
git clone git://github.com/rspec/rspec-tmbundle.git RSpec.tmbundle
osascript -e 'tell app "TextMate" to reload bundles'
How do I check out version version/tag 1.1.4 of the rspec bundle?
cd ~/Library/Application\ Support/TextMate/Bundles/
git clone git://github.com/rspec/rspec-tmbundle.git RSpec.tmbundle
osascript -e 'tell app "TextMate" to reload bundles'
Clone the repository as normal:
git clone git://github.com/rspec/rspec-tmbundle.git RSpec.tmbundle
Then checkout the tag you want like so:
git checkout tags/1.1.4
This will checkout out the tag in a 'detached HEAD' state. In this state, "you can look around, make experimental changes and commit them, and [discard those commits] without impacting any branches by performing another checkout".
To retain any changes made, move them to a new branch:
git checkout -b 1.1.4-jspooner
You can get back to the master branch by using:
git checkout master
Note, as was mentioned in the first revision of this answer, there is another way to checkout a tag:
git checkout 1.1.4
But as was mentioned in a comment, if you have a branch by that same name, this will result in git warning you that the refname is ambiguous and checking out the branch by default:
warning: refname 'test' is ambiguous.
Switched to branch '1.1.4'
The shorthand can be safely used if the repository does not share names between branches and tags.
1.1.4
. Git will checkout the branch, not the tag. To explicitly checkout the tag do: git checkout tags/1.1.4
As of Git v2.23.0 (August 2019), git switch
is preferred over git checkout
when you’re simply switching branches/tags. I’m guessing they did this since git checkout
had two functions: for switching branches and for restoring files. So in v2.23.0, they added two new commands, git switch
, and git restore
, to separate those concerns. I would predict at some point in the future, git checkout
will be deprecated.
To switch to a normal branch, use git switch <branch-name>
. To switch to a commit-like object, including single commits and tags, use git switch --detach <commitish>
, where <commitish>
is the tag name or commit number.
The --detach
option forces you to recognize that you’re in a mode of “inspection and discardable experiments”. To create a new branch from the commitish you’re switching to, use git switch -c <new-branch> <start-point>
.
git switch --detach <tag>
such as git switch --detach v1.10
works quite well
Jul 29, 2021 at 18:56
To switch to a commit-like object, including single commits and tags, use
git switch --detach <commitish>
, where<commitish>
is the tag name or commit number.
Actually, Git 2.36 (Q2 2022) is clearer: the error message given by "git switch HEAD~4
"(man)" has been clarified to suggest the "--detach
" option that is required.
See commit 808213b (25 Feb 2022) by Alex Henrie (alexhenrie
).
(Merged by Junio C Hamano -- gitster
-- in commit 061fd57, 06 Mar 2022)
switch
: mention the--detach
option when dying due to lack of a branchSigned-off-by: Alex Henrie
Users who are accustomed to doing
git checkout <tag>
(man) assume thatgit switch <tag>
(man) will do the same thing.
Inform them of the--detach
option so they aren't left wondering whygit switch
doesn't work butgit checkout
does.
git config
now includes in its man page:
suggestDetachingHead
Advice shown when
git switch
refuses to detach HEAD without the explicit--detach
option.
The error message will show:
a branch is expected, got tag 'xxx' If you want to detach HEAD at the commit, try again with the --detach option