undef/git-commit-vandalism
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Documentation/git-gc: improve description of --auto

Browse Source 
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:
Jeff King 2007-10-18 22:05:10 -04:00 committed by Shawn O. Pearce
parent 08fbb136f7
commit d7e56dbc4f
1 changed files with 17 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

29
Documentation/git-gc.txt
View File

@ -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
------------- -------------