path: root/Documentation/git-svn.txt
diff options
authorJay Soffian <>2010-01-23 08:30:01 (GMT)
committerEric Wong <>2010-01-23 11:23:04 (GMT)
commit075762085c6668f11c4ea165ecec17f69245ef09 (patch)
treec96d230f80c8d4322b43e899482e83e2fd784eca /Documentation/git-svn.txt
parent3e18ce1ac3034b1562ec748523aa7636e1b58b52 (diff)
git-svn: allow subset of branches/tags to be specified in glob spec
For very large projects it is useful to be able to clone a subset of the upstream SVN repo's branches. Allow for this by letting the left-side of the branches and tags glob specs contain a brace-delineated comma-separated list of names. e.g.: branches = branches/{red,green}/src:refs/remotes/branches/* Signed-off-by: Jay Soffian <> Acked-by: Eric Wong <>
Diffstat (limited to 'Documentation/git-svn.txt')
1 files changed, 16 insertions, 0 deletions
diff --git a/Documentation/git-svn.txt b/Documentation/git-svn.txt
index 5df3059..99f3c1e 100644
--- a/Documentation/git-svn.txt
+++ b/Documentation/git-svn.txt
@@ -838,6 +838,22 @@ independent path component (surrounded by '/' or EOL). This
type of configuration is not automatically created by 'init' and
should be manually entered with a text-editor or using 'git config'.
+It is also possible to fetch a subset of branches or tags by using a
+comma-separated list of names within braces. For example:
+[svn-remote "huge-project"]
+ url =
+ fetch = trunk/src:refs/remotes/trunk
+ branches = branches/{red,green}/src:refs/remotes/branches/*
+ tags = tags/{1.0,2.0}/src:refs/remotes/tags/*
+Note that git-svn keeps track of the highest revision in which a branch
+or tag has appeared. If the subset of branches or tags is changed after
+fetching, then .git/svn/.metadata must be manually edited to remove (or
+reset) branches-maxRev and/or tags-maxRev as appropriate.