Fix rev-list documentation again (--sparse and pathspec)
[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 Author
41 ------
42 Written by Linus Torvalds <torvalds@osdl.org> and
43 Junio C Hamano <junkio@cox.net>
44
45 Documentation
46 -------------
47 Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.
48
49 GIT
50 ---
51 Part of the gitlink:git[7] suite