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