8d308b3540
Most users should be using git-gc instead of directly calling prune. For those who really do want more information on pruning, let's point them at git-fsck, which goes into slightly more detail on reachability. And since we're pointing users there, let's make sure reflogs are mentioned in git-fsck(1). Signed-off-by: Jeff King <peff@peff.net> Signed-off-by: Junio C Hamano <gitster@pobox.com>
84 lines
1.8 KiB
Plaintext
84 lines
1.8 KiB
Plaintext
git-prune(1)
|
|
============
|
|
|
|
NAME
|
|
----
|
|
git-prune - Prune all unreachable objects from the object database
|
|
|
|
|
|
SYNOPSIS
|
|
--------
|
|
'git-prune' [-n] [--expire <expire>] [--] [<head>...]
|
|
|
|
DESCRIPTION
|
|
-----------
|
|
|
|
NOTE: In most cases, users should run linkgit:git-gc[1], which calls
|
|
git-prune. See the section "NOTES", below.
|
|
|
|
This runs `git-fsck --unreachable` using all the refs
|
|
available in `$GIT_DIR/refs`, optionally with additional set of
|
|
objects specified on the command line, and prunes all
|
|
objects unreachable from any of these head objects from the object database.
|
|
In addition, it
|
|
prunes the unpacked objects that are also found in packs by
|
|
running `git prune-packed`.
|
|
|
|
OPTIONS
|
|
-------
|
|
|
|
-n::
|
|
Do not remove anything; just report what it would
|
|
remove.
|
|
|
|
\--::
|
|
Do not interpret any more arguments as options.
|
|
|
|
\--expire <time>::
|
|
Only expire loose objects older than <time>.
|
|
|
|
<head>...::
|
|
In addition to objects
|
|
reachable from any of our references, keep objects
|
|
reachable from listed <head>s.
|
|
|
|
EXAMPLE
|
|
-------
|
|
|
|
To prune objects not used by your repository nor another that
|
|
borrows from your repository via its
|
|
`.git/objects/info/alternates`:
|
|
|
|
------------
|
|
$ git prune $(cd ../another && $(git-rev-parse --all))
|
|
------------
|
|
|
|
Notes
|
|
-----
|
|
|
|
In most cases, users will not need to call git-prune directly, but
|
|
should instead call linkgit:git-gc[1], which handles pruning along with
|
|
many other housekeeping tasks.
|
|
|
|
For a description of which objects are considered for pruning, see
|
|
git-fsck's --unreachable option.
|
|
|
|
See Also
|
|
--------
|
|
|
|
linkgit:git-fsck[1],
|
|
linkgit:git-gc[1],
|
|
linkgit:git-reflog[1]
|
|
|
|
Author
|
|
------
|
|
Written by Linus Torvalds <torvalds@osdl.org>
|
|
|
|
Documentation
|
|
--------------
|
|
Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.
|
|
|
|
GIT
|
|
---
|
|
Part of the linkgit:git[7] suite
|