aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJunio C Hamano <junkio@cox.net>2005-12-08 16:30:24 -0800
committerJunio C Hamano <junkio@cox.net>2005-12-08 16:30:24 -0800
commitc82365dc6f211722cbbed96f41a61f477914c91a (patch)
tree86a8dc2afea62f4ba5b207671652bb03391fe5b5
parent8c667f4bb878a7bcb45eb6dbd920b8aba9718d7e (diff)
downloadgit-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.txt30
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
------