Merge branch 'jc/maint-reset'
[gitweb.git] / Documentation / fetch-options.txt
index a25d04a4fa2e6449d4e5ec1beddf305385ae8571..85c87180db59906f5401eafbe6460f49a60ee9dc 100644 (file)
@@ -1,19 +1,66 @@
--a, \--append::
+-q::
+--quiet::
+       Pass --quiet to git-fetch-pack and silence any other internally
+       used programs.
+
+-v::
+--verbose::
+       Be verbose.
+
+-a::
+--append::
        Append ref names and object names of fetched refs to the
        existing contents of `.git/FETCH_HEAD`.  Without this
        option old data in `.git/FETCH_HEAD` will be overwritten.
 
--f, \--force::
+--upload-pack <upload-pack>::
+       When given, and the repository to fetch from is handled
+       by 'git-fetch-pack', '--exec=<upload-pack>' is passed to
+       the command to specify non-default path for the command
+       run on the other end.
+
+-f::
+--force::
+       When `git-fetch` is used with `<rbranch>:<lbranch>`
+       refspec, it refuses to update the local branch
+       `<lbranch>` unless the remote branch `<rbranch>` it
+       fetches is a descendant of `<lbranch>`.  This option
+       overrides that check.
 
--t, \--tags::
-       By default, the git core utilities will not fetch and store
-       tags under the same name as the remote repository;  ask it
-       to do so using `--tags`.  Using this option will bound the
-       list of objects pulled to the remote tags.  Commits in branches
-       beyond the tags will be ignored.
+ifdef::git-pull[]
+--no-tags::
+endif::git-pull[]
+ifndef::git-pull[]
+-n::
+--no-tags::
+endif::git-pull[]
+       By default, tags that point at objects that are downloaded
+       from the remote repository are fetched and stored locally.
+       This option disables this automatic tag following.
 
--u, \--update-head-ok::
+-t::
+--tags::
+       Most of the tags are fetched automatically as branch
+       heads are downloaded, but tags that do not point at
+       objects reachable from the branch heads that are being
+       tracked will not be fetched by this mechanism.  This
+       flag lets all tags and their associated objects be
+       downloaded.
+
+-k::
+--keep::
+       Keep downloaded pack.
+
+-u::
+--update-head-ok::
        By default `git-fetch` refuses to update the head which
        corresponds to the current branch.  This flag disables the
-       check.  Note that fetching into the current branch will not
-       update the index and working directory, so use it with care.
+       check.  This is purely for the internal use for `git-pull`
+       to communicate with `git-fetch`, and unless you are
+       implementing your own Porcelain you are not supposed to
+       use it.
+
+--depth=<depth>::
+       Deepen the history of a 'shallow' repository created by
+       `git clone` with `--depth=<depth>` option (see linkgit:git-clone[1])
+       by the specified number of commits.