Merge branch 'ps/doc-pack-refs-auto-with-files-backend-fix'

gitster · gitster · commit edb4fd966974 · 2025-07-16T09:42:28.000-07:00
Doc update.

* ps/doc-pack-refs-auto-with-files-backend-fix:
  docs/git-pack-refs: document heuristic used for packing loose refs
diff --git 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

Original file line number	Diff line number	Diff line change
`@@ -66,7 +66,10 @@ Pack refs as needed depending on the current state of the ref database. The`
`66`	`66`	`behavior depends on the ref format used by the repository and may change in the`
`67`	`67`	`future.`
`68`	`68`	`+`
`69`		- - "files": No special handling for `--auto` has been implemented.
	`69`	+ - "files": Loose references are packed into the `packed-refs` file
	`70`	`+ based on the ratio of loose references to the size of the`
	`71`	+ `packed-refs` file. The bigger the `packed-refs` file, the more loose
	`72`	`+ references need to exist before we repack.`
`70`	`73`	`+`
`71`	`74`	`- "reftable": Tables are compacted such that they form a geometric`
`72`	`75`	`sequence. For two tables N and N+1, where N+1 is newer, this`