| `--all`:: | |
| The command by default packs all tags and refs that are already | |
| packed, and leaves other refs | |
| alone. This is because branches are expected to be actively | |
| developed and packing their tips does not help performance. | |
| This option causes all refs to be packed as well, with the exception | |
| of hidden refs, broken refs, and symbolic refs. Useful for a repository | |
| with many branches of historical interests. | |
| `--no-prune`:: | |
| The command usually removes loose refs under `$GIT_DIR/refs` | |
| hierarchy after packing them. This option tells it not to. | |
| `--auto`:: | |
| 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": 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 | |
| maintains the property that N is at least twice as big as N+1. Only | |
| tables that violate this property are compacted. | |
| `--include <pattern>`:: | |
| Pack refs based on a `glob(7)` pattern. Repetitions of this option | |
| accumulate inclusion patterns. If a ref is both included in `--include` and | |
| `--exclude`, `--exclude` takes precedence. Using `--include` will preclude all | |
| tags from being included by default. Symbolic refs and broken refs will never | |
| be packed. When used with `--all`, it will be a noop. Use `--no-include` to clear | |
| and reset the list of patterns. | |
| `--exclude <pattern>`:: | |
| Do not pack refs matching the given `glob(7)` pattern. Repetitions of this option | |
| accumulate exclusion patterns. Use `--no-exclude` to clear and reset the list of | |
| patterns. If a ref is already packed, including it with `--exclude` will not | |
| unpack it. | |
| + | |
| When used with `--all`, pack only loose refs which do not match any of | |
| the provided `--exclude` patterns. | |
| + | |
| When used with `--include`, refs provided to `--include`, minus refs that are | |
| provided to `--exclude` will be packed. |