mirror of
https://github.com/git/git.git
synced 2024-09-28 11:11:18 +02:00
c82365dc6f
Not replacing but always including our own refs may be more desirable (and unarguably much safer), but at the same time I have a suspicion that that might be forbidding a useful usage I haven't thought of, so... Signed-off-by: Junio C Hamano <junkio@cox.net>
71 lines
1.7 KiB
Plaintext
71 lines
1.7 KiB
Plaintext
git-prune(1)
|
|
============
|
|
|
|
NAME
|
|
----
|
|
git-prune - Prunes all unreachable objects from the object database
|
|
|
|
|
|
SYNOPSIS
|
|
--------
|
|
'git-prune' [-n] [--] [<head>...]
|
|
|
|
DESCRIPTION
|
|
-----------
|
|
|
|
This runs `git-fsck-objects --unreachable` using the heads
|
|
specified on the command line (or `$GIT_DIR/refs/heads/\*` and
|
|
`$GIT_DIR/refs/tags/\*` if none is specified), and prunes all
|
|
unreachable 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.
|
|
|
|
<head>...::
|
|
Instead of keeping objects
|
|
reachable from any of our references, keep objects
|
|
reachable from only listed <head>s.
|
|
+
|
|
Note that the explicitly named <head>s are *not* appended to the
|
|
default set of references, but they replace them. In general you
|
|
would want to say `git prune $(git-rev-parse --all) extra1
|
|
extra2` to keep chains of commits leading to extra1, extra2,
|
|
... in addition to what are reachable from your own refs.
|
|
Saying `git prune extra1 extra2` would *lose* objects reachable
|
|
only from the usual refs, which is usually not what you want.
|
|
|
|
|
|
EXAMPLE
|
|
-------
|
|
|
|
To prune objects not used by your repository and another that
|
|
borrows from your repository via its
|
|
`.git/objects/info/alternates`:
|
|
|
|
------------
|
|
$ git prune $(git-rev-parse --all) \
|
|
$(cd ../another && $(git-rev-parse --all))
|
|
------------
|
|
|
|
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 gitlink:git[7] suite
|
|
|