Documentation/git-gc: improve description of --auto
This patch tries to make the description of --auto a little more clear for new users, especially those referred by the "git-gc --auto" notification message. It also cleans up some grammatical errors and typos in the original description, as well as rewording for clarity. Signed-off-by: Jeff King <peff@peff.net> Signed-off-by: Shawn O. Pearce <spearce@spearce.org>
This commit is contained in:
parent
08fbb136f7
commit
d7e56dbc4f
@ -45,18 +45,23 @@ OPTIONS
|
|||||||
few hundred changesets or so.
|
few hundred changesets or so.
|
||||||
|
|
||||||
--auto::
|
--auto::
|
||||||
With this option, `git gc` checks if there are too many
|
With this option, `git gc` checks whether any housekeeping is
|
||||||
loose objects in the repository and runs
|
required; if not, it exits without performing any work.
|
||||||
gitlink:git-repack[1] with `-d -l` option to pack them.
|
Some git commands run `git gc --auto` after performing
|
||||||
The threshold for loose objects is set with `gc.auto` configuration
|
operations that could create many loose objects.
|
||||||
variable, and can be disabled by setting it to 0. Some
|
+
|
||||||
Porcelain commands use this after they perform operation
|
Housekeeping is required if there are too many loose objects or
|
||||||
that could create many loose objects automatically.
|
too many packs in the repository. If the number of loose objects
|
||||||
Additionally, when there are too many packs are present,
|
exceeds the value of the `gc.auto` configuration variable, then
|
||||||
they are consolidated into one larger pack by running
|
all loose objects are combined into a single pack using
|
||||||
the `git-repack` command with `-A` option. The
|
`git-repack -d -l`. Setting the value of `gc.auto` to 0
|
||||||
threshold for number of packs is set with
|
disables automatic packing of loose objects.
|
||||||
`gc.autopacklimit` configuration variable.
|
+
|
||||||
|
If the number of packs exceeds the value of `gc.autopacklimit`,
|
||||||
|
then existing packs (except those marked with a `.keep` file)
|
||||||
|
are consolidated into a single pack by using the `-A` option of
|
||||||
|
`git-repack`. Setting `gc.autopacklimit` to 0 disables
|
||||||
|
automatic consolidation of packs.
|
||||||
|
|
||||||
Configuration
|
Configuration
|
||||||
-------------
|
-------------
|
||||||
|
Loading…
Reference in New Issue
Block a user