git/list[1] front-page[2] threads[3] people[4] search[5] about
 

[PATCH] Documentation: partial clone-related arguments

From
JTJonathan Tan <jonathantanmy@google.com>
Date
Aug 13, 2018, 21:30 UTC
Message-ID
<20180813213048.45555-1-jonathantanmy@google.com>

Commit 88e2f9ed8e ("introduce fetch-object: fetch one promisor object", 2017-12-05) introduced new command-line arguments without documenting them. Add documentation for these arguments.

Signed-off-by: Jonathan Tan <jonathantanmy@google.com>
---
This is a follow-up to [1] in which Junio noticed some arguments lacking
documentation, and I said that I would make a patch documenting these.
[1] https://public-inbox.org/git/CAGf8dg+5ywyQVfuPfbRrKFdAatst25307ctQvkWqCDKHka7z4g@mail.gmail.com/
---
 Documentation/git-fetch-pack.txt |  8 ++++++++
 Documentation/git-index-pack.txt | 11 +++++++++++
 2 files changed, 19 insertions(+)
diff --git a/Documentation/git-fetch-pack.txt b/Documentation/git-fetch-pack.txt
index c97588479..a9dce8fee 100644
--- a/Documentation/git-fetch-pack.txt
+++ b/Documentation/git-fetch-pack.txt
@@ -108,6 +108,14 @@ be in a separate packet, and the list must end with a flush packet.
 	Output "connectivity-ok" if the received pack is
 	self-contained and connected.
 
+--from-promisor::
+	For internal use only. Ensure that any packs generated have
+	associated .promisor files.
+
+--no-dependents::
+	For internal use only. Indicate that any objects referenced by
+	the objects given as arguments do not need to be fetched.
+
 -v::
 	Run verbosely.
 
diff --git a/Documentation/git-index-pack.txt b/Documentation/git-index-pack.txt
index d5b7560bf..a20eeff8e 100644
--- a/Documentation/git-index-pack.txt
+++ b/Documentation/git-index-pack.txt
@@ -66,6 +66,17 @@ OPTIONS
 	message can later be searched for within all .keep files to
 	locate any which have outlived their usefulness.
 
+--promisor::
+	For internal use only. Create an empty .promisor file for the
+	associated pack file. In Git repositories that are partial
+	clones, the presence of this file indicates that this pack comes
+	from the promisor remote of the repository.
+
+--promisor=<msg>::
+	For internal use only. Create a .promisor file containing the
+	given message. Note that this message may not be preserved when
+	the associated pack is repacked.
+
 --index-version=<version>[,<offset>]::
 	This is intended to be used by the test suite only. It allows
 	to force the version for the generated pack index, and to force
-- 
2.18.0.597.ga71716f1ad-goog
Message 1 of 1 in “Documentation: partial clone-related arguments”
  1. Documentation: partial clone-related argumentsJonathan Tan, Aug 13, 2018

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.