summaryrefslogtreecommitdiffstats
path: root/Documentation
diff options
context:
space:
mode:
authorRonald Bhuleskar <funronald@google.com>2023-03-22 15:07:19 -0700
committerRonald Bhuleskar <funronald@google.com>2023-03-28 14:29:54 -0700
commit738dacb7fbdd1bfec0bd4d387b37ac5e89d36c07 (patch)
treed9be06b60cf34c89b86cf69aaf37526d823fc478 /Documentation
parent5166ded0986df7a99bbc9ae6bc057a27a1e7d974 (diff)
downloadjgit-738dacb7fbdd1bfec0bd4d387b37ac5e89d36c07.tar.gz
jgit-738dacb7fbdd1bfec0bd4d387b37ac5e89d36c07.zip
BasePackFetchConnection: support negotiationTip feature
By default, Git will report, to the server, commits reachable from all local refs to find common commits in an attempt to reduce the size of the to-be-received packfile. If specified with negotiation tip, Git will only report commits reachable from the given tips. This is useful to speed up fetches when the user knows which local ref is likely to have commits in common with the upstream ref being fetched. When negotation-tip is on, use the wanted refs instead of all refs as source of the "have" list to send. This is controlled by the `fetch.usenegotationtip` flag, false by default. This works only for programmatic fetches and there is no support for it yet in the CLI. Change-Id: I19f8fe48889bfe0ece7cdf78019b678ede5c6a32
Diffstat (limited to 'Documentation')
-rw-r--r--Documentation/config-options.md6
1 files changed, 6 insertions, 0 deletions
diff --git a/Documentation/config-options.md b/Documentation/config-options.md
index cbcb36a250..3495813e76 100644
--- a/Documentation/config-options.md
+++ b/Documentation/config-options.md
@@ -50,6 +50,12 @@ For details on native git options see also the official [git config documentatio
| `core.trustPackedRefsStat` | `unset` | &#x20DE; | Whether to trust the file attributes (Java equivalent of stat command on *nix) of the packed-refs file. If `never` JGit will ignore the file attributes of the packed-refs file and always read it. If `always` JGit will trust the file attributes of the packed-refs file and will only read it if a file attribute has changed. `after_open` behaves the same as `always`, except that the packed-refs file is opened and closed before its file attributes are considered. An open/close of the packed-refs file is known to refresh its file attributes, at least on some NFS clients. If `unset`, JGit will use the behavior described in `trustFolderStat`. |
| `core.worktree` | Root directory of the working tree if it is not the parent directory of the `.git` directory | &#x2705; | The path to the root of the working tree. |
+## __fetch__ options
+
+| option | default | git option | description |
+|---------|---------|------------|-------------|
+| `fetch.useNegotiationTip` | `false` | &#x2705; | When enabled it restricts the client negotiation on unrelated branches i.e. only send haves for the refs that the client is interested in fetching. |
+
## __gc__ options
| option | default | git option | description |