2005-09-08 00:26:23 +00:00
|
|
|
git-fetch(1)
|
|
|
|
============
|
2005-07-16 07:17:42 +00:00
|
|
|
|
|
|
|
NAME
|
|
|
|
----
|
2007-01-18 23:53:37 +00:00
|
|
|
git-fetch - Download objects and refs from another repository
|
2005-07-16 07:17:42 +00:00
|
|
|
|
|
|
|
|
|
|
|
SYNOPSIS
|
|
|
|
--------
|
2011-07-02 02:38:26 +00:00
|
|
|
[verse]
|
2010-04-10 02:50:19 +00:00
|
|
|
'git fetch' [<options>] [<repository> [<refspec>...]]
|
|
|
|
'git fetch' [<options>] <group>
|
2010-10-08 17:31:17 +00:00
|
|
|
'git fetch' --multiple [<options>] [(<repository> | <group>)...]
|
2010-04-10 02:50:19 +00:00
|
|
|
'git fetch' --all [<options>]
|
2009-11-09 20:09:56 +00:00
|
|
|
|
2005-07-16 07:17:42 +00:00
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
-----------
|
2009-11-09 20:09:56 +00:00
|
|
|
Fetches named heads or tags from one or more other repositories,
|
|
|
|
along with the objects necessary to complete them.
|
2005-08-24 23:23:08 +00:00
|
|
|
|
|
|
|
The ref names and their object names of fetched refs are stored
|
2005-11-07 05:30:56 +00:00
|
|
|
in `.git/FETCH_HEAD`. This information is left for a later merge
|
2010-01-09 23:33:00 +00:00
|
|
|
operation done by 'git merge'.
|
2005-07-16 07:17:42 +00:00
|
|
|
|
2010-11-02 15:31:23 +00:00
|
|
|
When <refspec> stores the fetched result in remote-tracking branches,
|
2007-02-09 23:41:35 +00:00
|
|
|
the tags that point at these branches are automatically
|
|
|
|
followed. This is done by first fetching from the remote using
|
|
|
|
the given <refspec>s, and if the repository has objects that are
|
|
|
|
pointed by remote tags that it does not yet have, then fetch
|
|
|
|
those missing tags. If the other end has tags that point at
|
|
|
|
branches you are not interested in, you will not get them.
|
|
|
|
|
2011-04-13 15:39:40 +00:00
|
|
|
'git fetch' can fetch from either a single named repository,
|
2009-11-09 20:09:56 +00:00
|
|
|
or from several repositories at once if <group> is given and
|
|
|
|
there is a remotes.<group> entry in the configuration file.
|
|
|
|
(See linkgit:git-config[1]).
|
2005-07-16 07:17:42 +00:00
|
|
|
|
|
|
|
OPTIONS
|
|
|
|
-------
|
2005-11-07 05:30:56 +00:00
|
|
|
include::fetch-options.txt[]
|
2005-07-16 07:17:42 +00:00
|
|
|
|
2005-11-07 05:30:56 +00:00
|
|
|
include::pull-fetch-param.txt[]
|
2005-10-20 04:25:39 +00:00
|
|
|
|
2007-07-04 22:21:36 +00:00
|
|
|
include::urls-remotes.txt[]
|
2005-07-16 07:17:42 +00:00
|
|
|
|
2009-10-21 17:21:23 +00:00
|
|
|
|
|
|
|
EXAMPLES
|
|
|
|
--------
|
|
|
|
|
|
|
|
* Update the remote-tracking branches:
|
|
|
|
+
|
|
|
|
------------------------------------------------
|
|
|
|
$ git fetch origin
|
|
|
|
------------------------------------------------
|
|
|
|
+
|
|
|
|
The above command copies all branches from the remote refs/heads/
|
|
|
|
namespace and stores them to the local refs/remotes/origin/ namespace,
|
|
|
|
unless the branch.<name>.fetch option is used to specify a non-default
|
|
|
|
refspec.
|
|
|
|
|
|
|
|
* Using refspecs explicitly:
|
|
|
|
+
|
|
|
|
------------------------------------------------
|
|
|
|
$ git fetch origin +pu:pu maint:tmp
|
|
|
|
------------------------------------------------
|
|
|
|
+
|
|
|
|
This updates (or creates, as necessary) branches `pu` and `tmp` in
|
|
|
|
the local repository by fetching from the branches (respectively)
|
|
|
|
`pu` and `maint` from the remote repository.
|
|
|
|
+
|
|
|
|
The `pu` branch will be updated even if it is does not fast-forward,
|
|
|
|
because it is prefixed with a plus sign; `tmp` will not be.
|
|
|
|
|
|
|
|
|
2011-03-06 22:14:15 +00:00
|
|
|
BUGS
|
|
|
|
----
|
|
|
|
Using --recurse-submodules can only fetch new commits in already checked
|
|
|
|
out submodules right now. When e.g. upstream added a new submodule in the
|
|
|
|
just fetched commits of the superproject the submodule itself can not be
|
|
|
|
fetched, making it impossible to check out that submodule later without
|
|
|
|
having to do a fetch again. This is expected to be fixed in a future git
|
|
|
|
version.
|
|
|
|
|
2005-11-05 09:37:00 +00:00
|
|
|
SEE ALSO
|
|
|
|
--------
|
2007-12-29 06:20:38 +00:00
|
|
|
linkgit:git-pull[1]
|
2005-11-05 09:37:00 +00:00
|
|
|
|
2005-07-16 07:17:42 +00:00
|
|
|
GIT
|
|
|
|
---
|
2008-06-06 07:07:32 +00:00
|
|
|
Part of the linkgit:git[1] suite
|