2005-09-08 00:26:23 +00:00
|
|
|
git-prune(1)
|
|
|
|
============
|
2005-05-10 21:32:30 +00:00
|
|
|
|
|
|
|
NAME
|
|
|
|
----
|
2007-06-09 15:44:12 +00:00
|
|
|
git-prune - Prune all unreachable objects from the object database
|
2005-05-10 21:32:30 +00:00
|
|
|
|
|
|
|
|
|
|
|
SYNOPSIS
|
|
|
|
--------
|
2011-07-02 02:38:26 +00:00
|
|
|
[verse]
|
2010-01-09 23:33:00 +00:00
|
|
|
'git prune' [-n] [-v] [--expire <expire>] [--] [<head>...]
|
2005-05-10 21:32:30 +00:00
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
-----------
|
2005-08-30 00:21:06 +00:00
|
|
|
|
2010-01-09 23:33:00 +00:00
|
|
|
NOTE: In most cases, users should run 'git gc', which calls
|
|
|
|
'git prune'. See the section "NOTES", below.
|
2008-04-29 20:45:14 +00:00
|
|
|
|
2010-01-09 23:33:00 +00:00
|
|
|
This runs 'git fsck --unreachable' using all the refs
|
docs: don't talk about $GIT_DIR/refs/ everywhere
It is misleading to say that we pull refs from $GIT_DIR/refs/*, because we
may also consult the packed refs mechanism. These days we tend to treat
the "refs hierarchy" as more of an abstract namespace that happens to be
represented as $GIT_DIR/refs. At best, this is a minor inaccuracy, but at
worst it can confuse users who then look in $GIT_DIR/refs and find that it
is missing some of the refs they expected to see.
This patch drops most uses of "$GIT_DIR/refs/*", changing them into just
"refs/*", under the assumption that users can handle the concept of an
abstract refs namespace. There are a few things to note:
- most cases just dropped the $GIT_DIR/ portion. But for cases where
that left _just_ the word "refs", I changed it to "refs/" to help
indicate that it was a hierarchy. I didn't do the same for longer
paths (e.g., "refs/heads" remained, instead of becoming
"refs/heads/").
- in some cases, no change was made, as the text was explicitly about
unpacked refs (e.g., the discussion in git-pack-refs).
- In some cases it made sense instead to note the existence of packed
refs (e.g., in check-ref-format and rev-parse).
Signed-off-by: Jeff King <peff@peff.net>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
2010-02-18 01:16:20 +00:00
|
|
|
available in `refs/`, optionally with additional set of
|
2008-05-14 23:22:18 +00:00
|
|
|
objects specified on the command line, and prunes all unpacked
|
2005-12-09 07:18:41 +00:00
|
|
|
objects unreachable from any of these head objects from the object database.
|
|
|
|
In addition, it
|
2005-08-30 00:21:06 +00:00
|
|
|
prunes the unpacked objects that are also found in packs by
|
2010-01-09 23:33:00 +00:00
|
|
|
running 'git prune-packed'.
|
2005-08-30 00:21:06 +00:00
|
|
|
|
2008-05-14 23:22:18 +00:00
|
|
|
Note that unreachable, packed objects will remain. If this is
|
|
|
|
not desired, see linkgit:git-repack[1].
|
|
|
|
|
2005-08-30 00:21:06 +00:00
|
|
|
OPTIONS
|
|
|
|
-------
|
|
|
|
|
|
|
|
-n::
|
2010-08-06 20:28:05 +00:00
|
|
|
--dry-run::
|
2005-08-30 00:21:06 +00:00
|
|
|
Do not remove anything; just report what it would
|
|
|
|
remove.
|
2005-05-10 21:32:30 +00:00
|
|
|
|
2008-09-29 16:49:52 +00:00
|
|
|
-v::
|
2010-08-06 20:28:05 +00:00
|
|
|
--verbose::
|
2008-09-29 16:49:52 +00:00
|
|
|
Report all removed objects.
|
|
|
|
|
2006-05-05 19:05:24 +00:00
|
|
|
\--::
|
2005-12-09 00:30:24 +00:00
|
|
|
Do not interpret any more arguments as options.
|
|
|
|
|
2008-06-08 01:36:09 +00:00
|
|
|
--expire <time>::
|
2007-11-29 20:59:55 +00:00
|
|
|
Only expire loose objects older than <time>.
|
|
|
|
|
2005-12-09 00:30:24 +00:00
|
|
|
<head>...::
|
2005-12-09 07:18:41 +00:00
|
|
|
In addition to objects
|
2005-12-09 00:30:24 +00:00
|
|
|
reachable from any of our references, keep objects
|
2005-12-09 07:18:41 +00:00
|
|
|
reachable from listed <head>s.
|
2005-12-09 00:30:24 +00:00
|
|
|
|
|
|
|
EXAMPLE
|
|
|
|
-------
|
|
|
|
|
2005-12-09 07:18:41 +00:00
|
|
|
To prune objects not used by your repository nor another that
|
2005-12-09 00:30:24 +00:00
|
|
|
borrows from your repository via its
|
|
|
|
`.git/objects/info/alternates`:
|
|
|
|
|
|
|
|
------------
|
2008-06-30 06:09:04 +00:00
|
|
|
$ git prune $(cd ../another && $(git rev-parse --all))
|
2005-12-09 00:30:24 +00:00
|
|
|
------------
|
2005-05-10 21:32:30 +00:00
|
|
|
|
2008-04-29 20:45:14 +00:00
|
|
|
Notes
|
|
|
|
-----
|
|
|
|
|
2010-01-09 23:33:00 +00:00
|
|
|
In most cases, users will not need to call 'git prune' directly, but
|
|
|
|
should instead call 'git gc', which handles pruning along with
|
2008-04-29 20:45:14 +00:00
|
|
|
many other housekeeping tasks.
|
|
|
|
|
|
|
|
For a description of which objects are considered for pruning, see
|
2010-01-09 23:33:00 +00:00
|
|
|
'git fsck''s --unreachable option.
|
2008-04-29 20:45:14 +00:00
|
|
|
|
2008-05-28 23:55:27 +00:00
|
|
|
SEE ALSO
|
2008-04-29 20:45:14 +00:00
|
|
|
--------
|
|
|
|
|
|
|
|
linkgit:git-fsck[1],
|
|
|
|
linkgit:git-gc[1],
|
|
|
|
linkgit:git-reflog[1]
|
|
|
|
|
2005-05-10 21:32:30 +00:00
|
|
|
GIT
|
|
|
|
---
|
2008-06-06 07:07:32 +00:00
|
|
|
Part of the linkgit:git[1] suite
|