{"thread":{"id":"49119","subject":"[PATCH] Documentation: partial clone-related arguments","startedAt":"2018-08-13T21:30:55Z","lastAt":"2018-08-13T21:30:55Z","messageCount":1,"participants":["Jonathan Tan"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"355488","messageId":"20180813213048.45555-1-jonathantanmy@google.com","threadId":"49119","inReplyTo":null,"subject":"[PATCH] Documentation: partial clone-related arguments","fromName":"Jonathan Tan","fromEmail":"jonathantanmy@google.com","sentAt":"2018-08-13T21:30:48Z","receivedAt":"2018-08-13T21:30:55Z","isPatch":true,"sender":{"key":"jonathantanmy@fastmail.com","avatar":null},"body":"Commit 88e2f9ed8e (\"introduce fetch-object: fetch one promisor object\",\n2017-12-05) introduced new command-line arguments without documenting\nthem. Add documentation for these arguments.\n\nSigned-off-by: Jonathan Tan <jonathantanmy@google.com>\n---\nThis is a follow-up to [1] in which Junio noticed some arguments lacking\ndocumentation, and I said that I would make a patch documenting these.\n\n[1] https://public-inbox.org/git/CAGf8dg+5ywyQVfuPfbRrKFdAatst25307ctQvkWqCDKHka7z4g@mail.gmail.com/\n---\n Documentation/git-fetch-pack.txt |  8 ++++++++\n Documentation/git-index-pack.txt | 11 +++++++++++\n 2 files changed, 19 insertions(+)\n\ndiff --git a/Documentation/git-fetch-pack.txt b/Documentation/git-fetch-pack.txt\nindex c97588479..a9dce8fee 100644\n--- a/Documentation/git-fetch-pack.txt\n+++ b/Documentation/git-fetch-pack.txt\n@@ -108,6 +108,14 @@ be in a separate packet, and the list must end with a flush packet.\n \tOutput \"connectivity-ok\" if the received pack is\n \tself-contained and connected.\n \n+--from-promisor::\n+\tFor internal use only. Ensure that any packs generated have\n+\tassociated .promisor files.\n+\n+--no-dependents::\n+\tFor internal use only. Indicate that any objects referenced by\n+\tthe objects given as arguments do not need to be fetched.\n+\n -v::\n \tRun verbosely.\n \ndiff --git a/Documentation/git-index-pack.txt b/Documentation/git-index-pack.txt\nindex d5b7560bf..a20eeff8e 100644\n--- a/Documentation/git-index-pack.txt\n+++ b/Documentation/git-index-pack.txt\n@@ -66,6 +66,17 @@ OPTIONS\n \tmessage can later be searched for within all .keep files to\n \tlocate any which have outlived their usefulness.\n \n+--promisor::\n+\tFor internal use only. Create an empty .promisor file for the\n+\tassociated pack file. In Git repositories that are partial\n+\tclones, the presence of this file indicates that this pack comes\n+\tfrom the promisor remote of the repository.\n+\n+--promisor=<msg>::\n+\tFor internal use only. Create a .promisor file containing the\n+\tgiven message. Note that this message may not be preserved when\n+\tthe associated pack is repacked.\n+\n --index-version=<version>[,<offset>]::\n \tThis is intended to be used by the test suite only. It allows\n \tto force the version for the generated pack index, and to force\n-- \n2.18.0.597.ga71716f1ad-goog\n\n"}]}