builtin-mailinfo.c: check error status from rewind and ftruncate
[git/spearce.git] / Documentation / fetch-options.txt
blob5eb2b0ee07b2f4e81e909a103f486c1a6d2dc6cb
1 ifndef::git-pull[]
2 -q::
3 --quiet::
4         Pass --quiet to git-fetch-pack and silence any other internally
5         used git commands.
7 -v::
8 --verbose::
9         Be verbose.
10 endif::git-pull[]
12 -a::
13 --append::
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.
18 --upload-pack <upload-pack>::
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.
24 -f::
25 --force::
26         When 'git-fetch' is used with `<rbranch>:<lbranch>`
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.
32 ifdef::git-pull[]
33 --no-tags::
34 endif::git-pull[]
35 ifndef::git-pull[]
36 -n::
37 --no-tags::
38 endif::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.
43 -t::
44 --tags::
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.
52 -k::
53 --keep::
54         Keep downloaded pack.
56 -u::
57 --update-head-ok::
58         By default 'git-fetch' refuses to update the head which
59         corresponds to the current branch.  This flag disables the
60         check.  This is purely for the internal use for 'git-pull'
61         to communicate with 'git-fetch', and unless you are
62         implementing your own Porcelain you are not supposed to
63         use it.
65 --depth=<depth>::
66         Deepen the history of a 'shallow' repository created by
67         `git clone` with `--depth=<depth>` option (see linkgit:git-clone[1])
68         by the specified number of commits.