GIT 0.99.9d
[git.git] / Documentation / git-fetch.txt
1 git-fetch(1)
2 ============
3
4 NAME
5 ----
6 git-fetch - Download objects and a head from another repository.
7
8
9 SYNOPSIS
10 --------
11 'git-fetch' <repository> <refspec>...
12
13
14 DESCRIPTION
15 -----------
16 Fetches named heads or tags from another repository, along with
17 the objects necessary to complete them.
18
19 The ref names and their object names of fetched refs are stored
20 in $GIT_DIR/FETCH_HEAD.  This information is left for a later merge
21 operation done by "git resolve" or "git octopus".
22
23
24 OPTIONS
25 -------
26 include::pull-fetch-param.txt[]
27
28 -a, \--append::
29         Append ref names and object names of fetched refs to the
30         existing contents of $GIT_DIR/FETCH_HEAD.  Without this
31         option old data in $GIT_DIR/FETCH_HEAD will be overwritten.
32
33 -u, \--update-head-ok::
34         By default 'git-fetch' refuses to update the head which
35         corresponds to the current branch.  This flag disables the
36         check.  Note that fetching into the current branch will not
37         update the index and working directory, so use it with care.
38
39
40 SEE ALSO
41 --------
42 gitlink:git-pull[1]
43
44
45 Author
46 ------
47 Written by Linus Torvalds <torvalds@osdl.org> and
48 Junio C Hamano <junkio@cox.net>
49
50 Documentation
51 -------------
52 Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.
53
54 GIT
55 ---
56 Part of the gitlink:git[7] suite