Merge http://www.kernel.org/pub/scm/gitk/gitk
[git.git] / Documentation / git-checkout.txt
1 git-checkout(1)
2 ===============
3
4 NAME
5 ----
6 git-checkout - Checkout and switch to a branch.
7
8 SYNOPSIS
9 --------
10 'git-checkout' [-f] [-b <new_branch>] [<branch>] [<paths>...]
11
12 DESCRIPTION
13 -----------
14
15 When <paths> are not given, this command switches branches, by
16 updating the index and working tree to reflect the specified
17 branch, <branch>, and updating HEAD to be <branch> or, if
18 specified, <new_branch>.
19
20 When <paths> are given, this command does *not* switch
21 branches.  It updates the named paths in the working tree from
22 the index file (i.e. it runs `git-checkout-index -f -u`).  In
23 this case, `-f` and `-b` options are meaningless and giving
24 either of them results in an error.  <branch> argument can be
25 used to specify a specific tree-ish to update the index for the
26 given paths before updating the working tree.
27
28
29 OPTIONS
30 -------
31 -f::
32         Force an re-read of everything.
33
34 -b::
35         Create a new branch and start it at <branch>.
36
37 <new_branch>::
38         Name for the new branch.
39
40 <branch>::
41         Branch to checkout; may be any object ID that resolves to a
42         commit. Defaults to HEAD.
43
44
45 EXAMPLE
46 -------
47
48 The following sequence checks out the `master` branch, reverts
49 the `Makefile` to two revisions back, deletes hello.c by
50 mistake, and gets it back from the index.
51
52 ------------
53 $ git checkout master
54 $ git checkout master~2 Makefile
55 $ rm -f hello.c
56 $ git checkout hello.c
57 ------------
58
59 If you have an unfortunate branch that is named `hello.c`, the
60 last step above would be confused as an instruction to switch to
61 that branch.  You should instead write:
62
63 ------------
64 $ git checkout -- hello.c
65 ------------
66
67
68 Author
69 ------
70 Written by Linus Torvalds <torvalds@osdl.org>
71
72 Documentation
73 --------------
74 Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.
75
76 GIT
77 ---
78 Part of the gitlink:git[7] suite
79