GIT 1.6.5
[git/git.git] / Documentation / fetch-options.txt
CommitLineData
90e43115 1ifndef::git-pull[]
3240240f
SB
2-q::
3--quiet::
42905294 4 Pass --quiet to git-fetch-pack and silence any other internally
57f6ec02 5 used git commands.
42905294 6
3240240f
SB
7-v::
8--verbose::
42905294 9 Be verbose.
90e43115 10endif::git-pull[]
42905294 11
3240240f
SB
12-a::
13--append::
93d69d86
JL
14 Append ref names and object names of fetched refs to the
15 existing contents of `.git/FETCH_HEAD`. Without this
16 option old data in `.git/FETCH_HEAD` will be overwritten.
17
3240240f 18--upload-pack <upload-pack>::
42905294
AR
19 When given, and the repository to fetch from is handled
20 by 'git-fetch-pack', '--exec=<upload-pack>' is passed to
21 the command to specify non-default path for the command
22 run on the other end.
2c620a1a 23
3240240f
SB
24-f::
25--force::
ba020ef5 26 When 'git-fetch' is used with `<rbranch>:<lbranch>`
a3e3dc46
JH
27 refspec, it refuses to update the local branch
28 `<lbranch>` unless the remote branch `<rbranch>` it
29 fetches is a descendant of `<lbranch>`. This option
30 overrides that check.
93d69d86 31
10eb64f5 32ifdef::git-pull[]
3240240f 33--no-tags::
10eb64f5
MV
34endif::git-pull[]
35ifndef::git-pull[]
3240240f
SB
36-n::
37--no-tags::
10eb64f5
MV
38endif::git-pull[]
39 By default, tags that point at objects that are downloaded
40 from the remote repository are fetched and stored locally.
41 This option disables this automatic tag following.
03febf99 42
3240240f
SB
43-t::
44--tags::
03febf99
JH
45 Most of the tags are fetched automatically as branch
46 heads are downloaded, but tags that do not point at
47 objects reachable from the branch heads that are being
48 tracked will not be fetched by this mechanism. This
49 flag lets all tags and their associated objects be
50 downloaded.
93d69d86 51
3240240f
SB
52-k::
53--keep::
0f76f526
TP
54 Keep downloaded pack.
55
3240240f
SB
56-u::
57--update-head-ok::
ba020ef5 58 By default 'git-fetch' refuses to update the head which
93d69d86 59 corresponds to the current branch. This flag disables the
ba020ef5
JN
60 check. This is purely for the internal use for 'git-pull'
61 to communicate with 'git-fetch', and unless you are
a597fb0e
JH
62 implementing your own Porcelain you are not supposed to
63 use it.
03febf99 64
3240240f 65--depth=<depth>::
f4bf2184 66 Deepen the history of a 'shallow' repository created by
5162e697 67 `git clone` with `--depth=<depth>` option (see linkgit:git-clone[1])
f4bf2184 68 by the specified number of commits.