diff options
Diffstat (limited to 'man1/git-fetch.1')
-rw-r--r-- | man1/git-fetch.1 | 147 |
1 files changed, 144 insertions, 3 deletions
diff --git a/man1/git-fetch.1 b/man1/git-fetch.1 index 1181c3db6..1ad7e3e89 100644 --- a/man1/git-fetch.1 +++ b/man1/git-fetch.1 @@ -2,12 +2,12 @@ .\" Title: git-fetch .\" Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author] .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/> -.\" Date: 09/13/2022 +.\" Date: 09/14/2022 .\" Manual: Git Manual -.\" Source: Git 2.37.3.611.ge188ec3a73 +.\" Source: Git 2.37.3.662.g36f8e7ed7d .\" Language: English .\" -.TH "GIT\-FETCH" "1" "09/13/2022" "Git 2\&.37\&.3\&.611\&.ge188ec" "Git Manual" +.TH "GIT\-FETCH" "1" "09/14/2022" "Git 2\&.37\&.3\&.662\&.g36f8e7" "Git Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -1191,6 +1191,147 @@ The victim sends "have" lines advertising the IDs of objects it has that are not .\} As in #1, the attacker chooses an object ID X to steal\&. The victim sends an object Y that the attacker already has, and the attacker falsely claims to have X and not Y, so the victim sends Y as a delta against X\&. The delta reveals regions of X that are similar to Y to the attacker\&. .RE +.SH "CONFIGURATION" +.sp +Everything below this line in this section is selectively included from the \fBgit-config\fR(1) documentation\&. The content is the same as what\(cqs found there: +.PP +fetch\&.recurseSubmodules +.RS 4 +This option controls whether +\fBgit fetch\fR +(and the underlying fetch in +\fBgit pull\fR) will recursively fetch into populated submodules\&. This option can be set either to a boolean value or to +\fIon\-demand\fR\&. 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 +\fIon\-demand\fR, fetch and pull will only recurse into a populated submodule when its superproject retrieves a commit that updates the submodule\(cqs reference\&. Defaults to +\fIon\-demand\fR, or to the value of +\fIsubmodule\&.recurse\fR +if set\&. +.RE +.PP +fetch\&.fsckObjects +.RS 4 +If it is set to true, git\-fetch\-pack will check all fetched objects\&. See +\fBtransfer\&.fsckObjects\fR +for what\(cqs checked\&. Defaults to false\&. If not set, the value of +\fBtransfer\&.fsckObjects\fR +is used instead\&. +.RE +.PP +fetch\&.fsck\&.<msg\-id> +.RS 4 +Acts like +\fBfsck\&.<msg\-id>\fR, but is used by +\fBgit-fetch-pack\fR(1) +instead of +\fBgit-fsck\fR(1)\&. See the +\fBfsck\&.<msg\-id>\fR +documentation for details\&. +.RE +.PP +fetch\&.fsck\&.skipList +.RS 4 +Acts like +\fBfsck\&.skipList\fR, but is used by +\fBgit-fetch-pack\fR(1) +instead of +\fBgit-fsck\fR(1)\&. See the +\fBfsck\&.skipList\fR +documentation for details\&. +.RE +.PP +fetch\&.unpackLimit +.RS 4 +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 +\fBtransfer\&.unpackLimit\fR +is used instead\&. +.RE +.PP +fetch\&.prune +.RS 4 +If true, fetch will automatically behave as if the +\fB\-\-prune\fR +option was given on the command line\&. See also +\fBremote\&.<name>\&.prune\fR +and the PRUNING section of +\fBgit-fetch\fR(1)\&. +.RE +.PP +fetch\&.pruneTags +.RS 4 +If true, fetch will automatically behave as if the +\fBrefs/tags/*:refs/tags/*\fR +refspec was provided when pruning, if not set already\&. This allows for setting both this option and +\fBfetch\&.prune\fR +to maintain a 1=1 mapping to upstream refs\&. See also +\fBremote\&.<name>\&.pruneTags\fR +and the PRUNING section of +\fBgit-fetch\fR(1)\&. +.RE +.PP +fetch\&.output +.RS 4 +Control how ref update status is printed\&. Valid values are +\fBfull\fR +and +\fBcompact\fR\&. Default value is +\fBfull\fR\&. See section OUTPUT in +\fBgit-fetch\fR(1) +for detail\&. +.RE +.PP +fetch\&.negotiationAlgorithm +.RS 4 +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 +\fBfeature\&.experimental\fR +is true, then the default is "skipping"\&. Unknown values will cause +\fIgit fetch\fR +to error out\&. +.sp +See also the +\fB\-\-negotiate\-only\fR +and +\fB\-\-negotiation\-tip\fR +options to +\fBgit-fetch\fR(1)\&. +.RE +.PP +fetch\&.showForcedUpdates +.RS 4 +Set to false to enable +\fB\-\-no\-show\-forced\-updates\fR +in +\fBgit-fetch\fR(1) +and +\fBgit-pull\fR(1) +commands\&. Defaults to true\&. +.RE +.PP +fetch\&.parallel +.RS 4 +Specifies the maximal number of fetch operations to be run in parallel at a time (submodules, or remotes when the +\fB\-\-multiple\fR +option of +\fBgit-fetch\fR(1) +is in effect)\&. +.sp +A value of 0 will give some reasonable default\&. If unset, it defaults to 1\&. +.sp +For submodules, this setting can be overridden using the +\fBsubmodule\&.fetchJobs\fR +config setting\&. +.RE +.PP +fetch\&.writeCommitGraph +.RS 4 +Set to true to write a commit\-graph after every +\fBgit fetch\fR +command that downloads a pack\-file from a remote\&. Using the +\fB\-\-split\fR +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 +\fBgit merge\-base\fR, +\fBgit push \-f\fR, and +\fBgit log \-\-graph\fR\&. Defaults to false\&. +.RE .SH "BUGS" .sp Using \-\-recurse\-submodules can only fetch new commits in submodules that are present locally e\&.g\&. in \fB$GIT_DIR/modules/\fR\&. If the upstream adds a new submodule, that submodule cannot be fetched until it is cloned e\&.g\&. by \fBgit submodule update\fR\&. This is expected to be fixed in a future Git version\&. |