diff options
| author | Junio C Hamano <junkio@cox.net> | 2005-12-08 16:30:24 -0800 |
|---|---|---|
| committer | Junio C Hamano <junkio@cox.net> | 2005-12-08 16:30:24 -0800 |
| commit | c82365dc6f211722cbbed96f41a61f477914c91a (patch) | |
| tree | 86a8dc2afea62f4ba5b207671652bb03391fe5b5 | |
| parent | 8c667f4bb878a7bcb45eb6dbd920b8aba9718d7e (diff) | |
| download | git-c82365dc6f211722cbbed96f41a61f477914c91a.tar.gz git-c82365dc6f211722cbbed96f41a61f477914c91a.tar.xz | |
Documentation: git-prune
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>
| -rw-r--r-- | Documentation/git-prune.txt | 30 |
1 files changed, 29 insertions, 1 deletions
diff --git a/Documentation/git-prune.txt b/Documentation/git-prune.txt index 3367c9b21..05c8d4928 100644 --- a/Documentation/git-prune.txt +++ b/Documentation/git-prune.txt @@ -8,7 +8,7 @@ git-prune - Prunes all unreachable objects from the object database SYNOPSIS -------- -'git-prune' [-n] +'git-prune' [-n] [--] [<head>...] DESCRIPTION ----------- @@ -27,6 +27,34 @@ OPTIONS 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 ------ |