aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorJunio C Hamano <gitster@pobox.com>2025-07-16 09:42:28 -0700
committerJunio C Hamano <gitster@pobox.com>2025-07-16 09:42:28 -0700
commitedb4fd966974c8b64be527e321f2af70a7f89822 (patch)
tree6fab8c77dab33e5e76938a692eaab8f6a49c0398
parentac5fd295819b0c4b4e743f522de76c482e7e7e3c (diff)
parentad7780b38fae2fb915404a59b0c904da8ed154a6 (diff)
downloadgit-edb4fd966974c8b64be527e321f2af70a7f89822.tar.gz
Merge branch 'ps/doc-pack-refs-auto-with-files-backend-fix'
Doc update. * ps/doc-pack-refs-auto-with-files-backend-fix: docs/git-pack-refs: document heuristic used for packing loose refs
-rw-r--r--Documentation/git-pack-refs.adoc5
1 files changed, 4 insertions, 1 deletions
diff --git a/Documentation/git-pack-refs.adoc b/Documentation/git-pack-refs.adoc
index 652c549771..42b90051e6 100644
--- a/Documentation/git-pack-refs.adoc
+++ b/Documentation/git-pack-refs.adoc
@@ -66,7 +66,10 @@ Pack refs as needed depending on the current state of the ref database. The
behavior depends on the ref format used by the repository and may change in the
future.
+
- - "files": No special handling for `--auto` has been implemented.
+ - "files": Loose references are packed into the `packed-refs` file
+ based on the ratio of loose references to the size of the
+ `packed-refs` file. The bigger the `packed-refs` file, the more loose
+ references need to exist before we repack.
+
- "reftable": Tables are compacted such that they form a geometric
sequence. For two tables N and N+1, where N+1 is newer, this