mirror of
https://github.com/git/git
synced 2024-08-27 03:29:21 +00:00
![Stephan Beyer](/assets/img/avatar_default.png)
The OPTIONS section of a documentation file contains a list of the options a git command accepts. Currently there are several variants to describe the case that different options (almost) do the same in the OPTIONS section. Some are: -f, --foo:: -f|--foo:: -f | --foo:: But AsciiDoc has the special form: -f:: --foo:: This patch applies this form to the documentation of the whole git suite, and removes useless em-dash prevention, so \--foo becomes --foo. Signed-off-by: Stephan Beyer <s-beyer@gmx.net> Signed-off-by: Junio C Hamano <gitster@pobox.com>
67 lines
1.9 KiB
Plaintext
67 lines
1.9 KiB
Plaintext
-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.
|
|
|
|
--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.
|
|
|
|
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.
|
|
|
|
-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. 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.
|