| fetch.recurseSubmodules:: |
| This option controls whether `git fetch` (and the underlying fetch |
| in `git pull`) will recursively fetch into populated submodules. |
| This option can be set either to a boolean value or to 'on-demand'. |
| Setting it to a boolean changes the behavior of fetch and pull to |
| recurse unconditionally into submodules when set to true or to not |
| recurse at all when set to false. When set to 'on-demand', fetch and |
| pull will only recurse into a populated submodule when its |
| superproject retrieves a commit that updates the submodule's |
| reference. |
| Defaults to 'on-demand', or to the value of 'submodule.recurse' if set. |
| |
| fetch.fsckObjects:: |
| If it is set to true, git-fetch-pack will check all fetched |
| objects. See `transfer.fsckObjects` for what's |
| checked. Defaults to false. If not set, the value of |
| `transfer.fsckObjects` is used instead. |
| |
| fetch.fsck.<msg-id>:: |
| Acts like `fsck.<msg-id>`, but is used by |
| linkgit:git-fetch-pack[1] instead of linkgit:git-fsck[1]. See |
| the `fsck.<msg-id>` documentation for details. |
| |
| fetch.fsck.skipList:: |
| Acts like `fsck.skipList`, but is used by |
| linkgit:git-fetch-pack[1] instead of linkgit:git-fsck[1]. See |
| the `fsck.skipList` documentation for details. |
| |
| fetch.unpackLimit:: |
| If the number of objects fetched over the Git native |
| transfer is below this |
| limit, then the objects will be unpacked into loose object |
| files. However if the number of received objects equals or |
| exceeds this limit then the received pack will be stored as |
| a pack, after adding any missing delta bases. Storing the |
| pack from a push can make the push operation complete faster, |
| especially on slow filesystems. If not set, the value of |
| `transfer.unpackLimit` is used instead. |
| |
| fetch.prune:: |
| If true, fetch will automatically behave as if the `--prune` |
| option was given on the command line. See also `remote.<name>.prune` |
| and the PRUNING section of linkgit:git-fetch[1]. |
| |
| fetch.pruneTags:: |
| If true, fetch will automatically behave as if the |
| `refs/tags/*:refs/tags/*` refspec was provided when pruning, |
| if not set already. This allows for setting both this option |
| and `fetch.prune` to maintain a 1=1 mapping to upstream |
| refs. See also `remote.<name>.pruneTags` and the PRUNING |
| section of linkgit:git-fetch[1]. |
| |
| fetch.all:: |
| If true, fetch will attempt to update all available remotes. |
| This behavior can be overridden by passing `--no-all` or by |
| explicitly specifying one or more remote(s) to fetch from. |
| Defaults to false. |
| |
| fetch.output:: |
| Control how ref update status is printed. Valid values are |
| `full` and `compact`. Default value is `full`. See the |
| OUTPUT section in linkgit:git-fetch[1] for details. |
| |
| fetch.negotiationAlgorithm:: |
| Control how information about the commits in the local repository |
| is sent when negotiating the contents of the packfile to be sent by |
| the server. Set to "consecutive" to use an algorithm that walks |
| over consecutive commits checking each one. Set to "skipping" to |
| use an algorithm that skips commits in an effort to converge |
| faster, but may result in a larger-than-necessary packfile; or set |
| to "noop" to not send any information at all, which will almost |
| certainly result in a larger-than-necessary packfile, but will skip |
| the negotiation step. Set to "default" to override settings made |
| previously and use the default behaviour. The default is normally |
| "consecutive", but if `feature.experimental` is true, then the |
| default is "skipping". Unknown values will cause 'git fetch' to |
| error out. |
| + |
| See also the `--negotiate-only` and `--negotiation-tip` options to |
| linkgit:git-fetch[1]. |
| |
| fetch.showForcedUpdates:: |
| Set to false to enable `--no-show-forced-updates` in |
| linkgit:git-fetch[1] and linkgit:git-pull[1] commands. |
| Defaults to true. |
| |
| fetch.parallel:: |
| Specifies the maximal number of fetch operations to be run in parallel |
| at a time (submodules, or remotes when the `--multiple` option of |
| linkgit:git-fetch[1] is in effect). |
| + |
| A value of 0 will give some reasonable default. If unset, it defaults to 1. |
| + |
| For submodules, this setting can be overridden using the `submodule.fetchJobs` |
| config setting. |
| |
| fetch.writeCommitGraph:: |
| Set to true to write a commit-graph after every `git fetch` command |
| that downloads a pack-file from a remote. Using the `--split` option, |
| most executions will create a very small commit-graph file on top of |
| the existing commit-graph file(s). Occasionally, these files will |
| merge and the write may take longer. Having an updated commit-graph |
| file helps performance of many Git commands, including `git merge-base`, |
| `git push -f`, and `git log --graph`. Defaults to false. |
| |
| fetch.bundleURI:: |
| This value stores a URI for downloading Git object data from a bundle |
| URI before performing an incremental fetch from the origin Git server. |
| This is similar to how the `--bundle-uri` option behaves in |
| linkgit:git-clone[1]. `git clone --bundle-uri` will set the |
| `fetch.bundleURI` value if the supplied bundle URI contains a bundle |
| list that is organized for incremental fetches. |
| + |
| If you modify this value and your repository has a `fetch.bundleCreationToken` |
| value, then remove that `fetch.bundleCreationToken` value before fetching from |
| the new bundle URI. |
| |
| fetch.bundleCreationToken:: |
| When using `fetch.bundleURI` to fetch incrementally from a bundle |
| list that uses the "creationToken" heuristic, this config value |
| stores the maximum `creationToken` value of the downloaded bundles. |
| This value is used to prevent downloading bundles in the future |
| if the advertised `creationToken` is not strictly larger than this |
| value. |
| + |
| The creation token values are chosen by the provider serving the specific |
| bundle URI. If you modify the URI at `fetch.bundleURI`, then be sure to |
| remove the value for the `fetch.bundleCreationToken` value before fetching. |