[PATCH] doc: pack-objects: clarify --missing option

From

Han Young <hanyang.tony@bytedance.com>

Date

Aug 8, 2024, 06:21 UTC

Message-ID

<20240808062120.34629-1-hanyang.tony@bytedance.com>

Signed-off-by: Han Young <hanyang.tony@bytedance.com>
---
objects read from stdin ignore --missing option, if the repo has
promisor remote, we will try to fetch missing objects. Even if
the missing objects is not "EXPECTED promisor missing objects".
"--missing=allow-promisor" will not raise an error on such cases.

 Documentation/git-pack-objects.txt | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/Documentation/git-pack-objects.txt b/Documentation/git-pack-objects.txt
index e32404c6aa..0c1f86dabe 100644
--- a/Documentation/git-pack-objects.txt
+++ b/Documentation/git-pack-objects.txt
@@ -313,13 +313,14 @@ attempt to fetch missing objects will be made before declaring them missing.
 This is the default action.
 +
 The form '--missing=allow-any' will allow object traversal to continue
-if a missing object is encountered.  No fetch of a missing object will occur.
-Missing objects will silently be omitted from the results.
+if a missing object is encountered.  No fetch of a missing object will occur
+during object traversal. Missing objects will silently be omitted from the
+results.
 +
 The form '--missing=allow-promisor' is like 'allow-any', but will only
 allow object traversal to continue for EXPECTED promisor missing objects.
-No fetch of a missing object will occur.  An unexpected missing object will
-raise an error.
+No fetch of a missing object will occur during object traversal.
+An unexpected missing object will raise an error.
 
 --exclude-promisor-objects::
 	Omit objects that are known to be in the promisor remote.  (This

-- 
2.45.2