Björn Gustavsson | 9c4a036 | 2009-11-09 21:09:56 +0100 | [diff] [blame] | 1 | --all:: |
| 2 | Fetch all remotes. |
| 3 | |
Stephan Beyer | 3240240 | 2008-06-08 03:36:09 +0200 | [diff] [blame] | 4 | -a:: |
| 5 | --append:: |
Jon Loeliger | 93d69d8 | 2005-11-06 23:30:56 -0600 | [diff] [blame] | 6 | Append ref names and object names of fetched refs to the |
| 7 | existing contents of `.git/FETCH_HEAD`. Without this |
| 8 | option old data in `.git/FETCH_HEAD` will be overwritten. |
| 9 | |
Jari Aalto | 6b276e1 | 2009-10-21 23:07:49 +0300 | [diff] [blame] | 10 | --depth=<depth>:: |
Nguyễn Thái Ngọc Duy | cfb70e1 | 2013-01-11 16:05:48 +0700 | [diff] [blame] | 11 | Deepen or shorten the history of a 'shallow' repository created by |
Jari Aalto | 6b276e1 | 2009-10-21 23:07:49 +0300 | [diff] [blame] | 12 | `git clone` with `--depth=<depth>` option (see linkgit:git-clone[1]) |
Philip Oakley | bc40dea | 2012-09-19 00:25:28 +0100 | [diff] [blame] | 13 | to the specified number of commits from the tip of each remote |
| 14 | branch history. Tags for the deepened commits are not fetched. |
Michal Ostrowski | 2c620a1 | 2006-01-20 13:05:24 -0500 | [diff] [blame] | 15 | |
Nguyễn Thái Ngọc Duy | 4dcb167 | 2013-01-11 16:05:46 +0700 | [diff] [blame] | 16 | --unshallow:: |
| 17 | Convert a shallow repository to a complete one, removing all |
| 18 | the limitations imposed by shallow repositories. |
| 19 | |
Jay Soffian | 28a1540 | 2009-11-10 09:19:43 +0100 | [diff] [blame] | 20 | ifndef::git-pull[] |
| 21 | --dry-run:: |
| 22 | Show what would be done, without making any changes. |
| 23 | endif::git-pull[] |
| 24 | |
Stephan Beyer | 3240240 | 2008-06-08 03:36:09 +0200 | [diff] [blame] | 25 | -f:: |
| 26 | --force:: |
Thomas Rast | 0b444cd | 2010-01-10 00:33:00 +0100 | [diff] [blame] | 27 | When 'git fetch' is used with `<rbranch>:<lbranch>` |
Junio C Hamano | a3e3dc4 | 2005-12-01 12:24:51 -0800 | [diff] [blame] | 28 | refspec, it refuses to update the local branch |
| 29 | `<lbranch>` unless the remote branch `<rbranch>` it |
| 30 | fetches is a descendant of `<lbranch>`. This option |
| 31 | overrides that check. |
Jon Loeliger | 93d69d8 | 2005-11-06 23:30:56 -0600 | [diff] [blame] | 32 | |
Jari Aalto | 6b276e1 | 2009-10-21 23:07:49 +0300 | [diff] [blame] | 33 | -k:: |
| 34 | --keep:: |
| 35 | Keep downloaded pack. |
| 36 | |
Björn Gustavsson | 16679e3 | 2009-11-09 21:10:32 +0100 | [diff] [blame] | 37 | ifndef::git-pull[] |
| 38 | --multiple:: |
| 39 | Allow several <repository> and <group> arguments to be |
| 40 | specified. No <refspec>s may be specified. |
Jay Soffian | f360d84 | 2009-11-10 09:15:47 +0100 | [diff] [blame] | 41 | |
Oren Held | 1b79d1c | 2010-07-13 15:01:40 +0300 | [diff] [blame] | 42 | -p:: |
Jay Soffian | f360d84 | 2009-11-10 09:15:47 +0100 | [diff] [blame] | 43 | --prune:: |
Matthieu Moy | 0e615b2 | 2010-11-02 16:31:20 +0100 | [diff] [blame] | 44 | After fetching, remove any remote-tracking branches which |
Jay Soffian | f360d84 | 2009-11-10 09:15:47 +0100 | [diff] [blame] | 45 | no longer exist on the remote. |
Björn Gustavsson | 16679e3 | 2009-11-09 21:10:32 +0100 | [diff] [blame] | 46 | endif::git-pull[] |
| 47 | |
Miklos Vajna | 10eb64f | 2008-01-25 10:17:38 +0000 | [diff] [blame] | 48 | ifdef::git-pull[] |
Stephan Beyer | 3240240 | 2008-06-08 03:36:09 +0200 | [diff] [blame] | 49 | --no-tags:: |
Miklos Vajna | 10eb64f | 2008-01-25 10:17:38 +0000 | [diff] [blame] | 50 | endif::git-pull[] |
| 51 | ifndef::git-pull[] |
Stephan Beyer | 3240240 | 2008-06-08 03:36:09 +0200 | [diff] [blame] | 52 | -n:: |
| 53 | --no-tags:: |
Miklos Vajna | 10eb64f | 2008-01-25 10:17:38 +0000 | [diff] [blame] | 54 | endif::git-pull[] |
| 55 | By default, tags that point at objects that are downloaded |
| 56 | from the remote repository are fetched and stored locally. |
Daniel Johnson | ed36854 | 2010-08-11 18:57:20 -0400 | [diff] [blame] | 57 | This option disables this automatic tag following. The default |
| 58 | behavior for a remote may be specified with the remote.<name>.tagopt |
| 59 | setting. See linkgit:git-config[1]. |
Junio C Hamano | 03febf9 | 2006-01-07 00:48:04 -0800 | [diff] [blame] | 60 | |
Jens Lehmann | 2e5955f | 2010-11-03 21:55:48 +0100 | [diff] [blame] | 61 | ifndef::git-pull[] |
Stephan Beyer | 3240240 | 2008-06-08 03:36:09 +0200 | [diff] [blame] | 62 | -t:: |
| 63 | --tags:: |
Junio C Hamano | 9eb4754 | 2013-06-07 08:09:51 -0700 | [diff] [blame] | 64 | This is a short-hand for giving `refs/tags/*:refs/tags/*` |
Junio C Hamano | f0cb2f1 | 2012-12-13 16:19:45 -0800 | [diff] [blame] | 65 | refspec from the command line, to ask all tags to be fetched |
| 66 | and stored locally. Because this acts as an explicit |
| 67 | refspec, the default refspecs (configured with the |
| 68 | remote.$name.fetch variable) are overridden and not used. |
Jon Loeliger | 93d69d8 | 2005-11-06 23:30:56 -0600 | [diff] [blame] | 69 | |
Jens Lehmann | 8f0700d | 2011-03-06 23:11:21 +0100 | [diff] [blame] | 70 | --recurse-submodules[=yes|on-demand|no]:: |
| 71 | This option controls if and under what conditions new commits of |
| 72 | populated submodules should be fetched too. It can be used as a |
| 73 | boolean option to completely disable recursion when set to 'no' or to |
| 74 | unconditionally recurse into all populated submodules when set to |
| 75 | 'yes', which is the default when this option is used without any |
| 76 | value. Use 'on-demand' to only recurse into a populated submodule |
| 77 | when the superproject retrieves a commit that updates the submodule's |
Jens Lehmann | c16c3e4 | 2011-03-06 23:12:58 +0100 | [diff] [blame] | 78 | reference to a commit that isn't already in the local submodule |
| 79 | clone. |
Jens Lehmann | 8f0700d | 2011-03-06 23:11:21 +0100 | [diff] [blame] | 80 | |
| 81 | --no-recurse-submodules:: |
| 82 | Disable recursive fetching of submodules (this has the same effect as |
| 83 | using the '--recurse-submodules=no' option). |
Jens Lehmann | 7dce19d | 2010-11-12 13:54:52 +0100 | [diff] [blame] | 84 | |
Jens Lehmann | 7dce19d | 2010-11-12 13:54:52 +0100 | [diff] [blame] | 85 | --submodule-prefix=<path>:: |
| 86 | Prepend <path> to paths printed in informative messages |
| 87 | such as "Fetching submodule foo". This option is used |
| 88 | internally when recursing over submodules. |
Jens Lehmann | 88a2197 | 2011-03-06 23:10:46 +0100 | [diff] [blame] | 89 | |
| 90 | --recurse-submodules-default=[yes|on-demand]:: |
| 91 | This option is used internally to temporarily provide a |
| 92 | non-negative default value for the --recurse-submodules |
| 93 | option. All other methods of configuring fetch's submodule |
| 94 | recursion (such as settings in linkgit:gitmodules[5] and |
| 95 | linkgit:git-config[1]) override this option, as does |
| 96 | specifying --[no-]recurse-submodules directly. |
Jens Lehmann | 7dce19d | 2010-11-12 13:54:52 +0100 | [diff] [blame] | 97 | endif::git-pull[] |
| 98 | |
Stephan Beyer | 3240240 | 2008-06-08 03:36:09 +0200 | [diff] [blame] | 99 | -u:: |
| 100 | --update-head-ok:: |
Thomas Rast | 0b444cd | 2010-01-10 00:33:00 +0100 | [diff] [blame] | 101 | By default 'git fetch' refuses to update the head which |
Jon Loeliger | 93d69d8 | 2005-11-06 23:30:56 -0600 | [diff] [blame] | 102 | corresponds to the current branch. This flag disables the |
Thomas Rast | 0b444cd | 2010-01-10 00:33:00 +0100 | [diff] [blame] | 103 | check. This is purely for the internal use for 'git pull' |
| 104 | to communicate with 'git fetch', and unless you are |
Junio C Hamano | a597fb0 | 2007-01-01 15:07:35 -0800 | [diff] [blame] | 105 | implementing your own Porcelain you are not supposed to |
| 106 | use it. |
Junio C Hamano | 03febf9 | 2006-01-07 00:48:04 -0800 | [diff] [blame] | 107 | |
Jari Aalto | 6b276e1 | 2009-10-21 23:07:49 +0300 | [diff] [blame] | 108 | --upload-pack <upload-pack>:: |
| 109 | When given, and the repository to fetch from is handled |
Thomas Rast | 0b444cd | 2010-01-10 00:33:00 +0100 | [diff] [blame] | 110 | by 'git fetch-pack', '--exec=<upload-pack>' is passed to |
Jari Aalto | 6b276e1 | 2009-10-21 23:07:49 +0300 | [diff] [blame] | 111 | the command to specify non-default path for the command |
| 112 | run on the other end. |
| 113 | |
| 114 | ifndef::git-pull[] |
| 115 | -q:: |
| 116 | --quiet:: |
| 117 | Pass --quiet to git-fetch-pack and silence any other internally |
Tay Ray Chuan | 9839018 | 2010-02-24 20:50:28 +0800 | [diff] [blame] | 118 | used git commands. Progress is not reported to the standard error |
| 119 | stream. |
Jari Aalto | 6b276e1 | 2009-10-21 23:07:49 +0300 | [diff] [blame] | 120 | |
| 121 | -v:: |
| 122 | --verbose:: |
| 123 | Be verbose. |
| 124 | endif::git-pull[] |
Tay Ray Chuan | 9839018 | 2010-02-24 20:50:28 +0800 | [diff] [blame] | 125 | |
| 126 | --progress:: |
| 127 | Progress status is reported on the standard error stream |
| 128 | by default when it is attached to a terminal, unless -q |
| 129 | is specified. This flag forces progress status even if the |
| 130 | standard error stream is not directed to a terminal. |