glossary: Add definitions for dangling and unreachable objects
[git/mingw/4msysgit/kblees.git] / Documentation / git-fetch.txt
blob5fbeab76b7214f871865eaefd5dbe744036676b0
1 git-fetch(1)
2 ============
4 NAME
5 ----
6 git-fetch - Download objects and refs from another repository
9 SYNOPSIS
10 --------
11 'git-fetch' <options> <repository> <refspec>...
14 DESCRIPTION
15 -----------
16 Fetches named heads or tags from another repository, along with
17 the objects necessary to complete them.
19 The ref names and their object names of fetched refs are stored
20 in `.git/FETCH_HEAD`.  This information is left for a later merge
21 operation done by "git merge".
23 When <refspec> stores the fetched result in tracking branches,
24 the tags that point at these branches are automatically
25 followed.  This is done by first fetching from the remote using
26 the given <refspec>s, and if the repository has objects that are
27 pointed by remote tags that it does not yet have, then fetch
28 those missing tags.  If the other end has tags that point at
29 branches you are not interested in, you will not get them.
32 OPTIONS
33 -------
34 include::fetch-options.txt[]
36 include::pull-fetch-param.txt[]
38 include::urls.txt[]
40 SEE ALSO
41 --------
42 gitlink:git-pull[1]
45 Author
46 ------
47 Written by Linus Torvalds <torvalds@osdl.org> and
48 Junio C Hamano <junkio@cox.net>
50 Documentation
51 -------------
52 Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.
54 GIT
55 ---
56 Part of the gitlink:git[7] suite