Autogenerated manpages for v1.5.3-rc4-24-g5b56a
authorJunio C Hamano <junio@hera.kernel.org>
Tue, 7 Aug 2007 06:06:13 +0000 (06:06 +0000)
committerJunio C Hamano <junio@hera.kernel.org>
Tue, 7 Aug 2007 06:06:13 +0000 (06:06 +0000)
man1/git-svn.1

index 28349b6b5c79a63c30d12e55471d470d12b177c5..7e35ff84fad703dccf04cd0e5b4870d7091b7868 100644 (file)
@@ -2,7 +2,7 @@
 .\" It was generated using the DocBook XSL Stylesheets (version 1.69.1).
 .\" Instead of manually editing it, you probably should edit the DocBook XML
 .\" source for it and then use the DocBook XSL Stylesheets to regenerate it.
-.TH "GIT\-SVN" "1" "07/19/2007" "Git 1.5.3.rc2.19.gc4fba" "Git Manual"
+.TH "GIT\-SVN" "1" "08/07/2007" "Git 1.5.3.rc4.24.g5b56a" "Git Manual"
 .\" disable hyphenation
 .nh
 .\" disable justification (adjust text to left margin only)
@@ -267,6 +267,23 @@ Tracking and contributing to an entire Subversion\-managed project (complete wit
 # of dcommit/rebase/show\-ignore should be the same as above.
 .ft
 
+.fi
+The initial \fIgit\-svn clone\fR can be quite time\-consuming (especially for large Subversion repositories). If multiple people (or one person with multiple machines) want to use git\-svn to interact with the same Subversion repository, you can do the initial \fIgit\-svn clone\fR to a repository on a server and have each person clone that repository with \fIgit clone\fR:
+.sp
+.nf
+.ft C
+# Do the initial import on a server
+        ssh server "cd /pub && git\-svn clone http://svn.foo.org/project
+# Clone locally
+        git clone server:/pub/project
+# Tell git\-svn which branch contains the Subversion commits
+        git update\-ref refs/remotes/git\-svn origin/master
+# Initialize git\-svn locally (be sure to use the same URL and \-T/\-b/\-t options as were used on server)
+        git\-svn init http://svn.foo.org/project
+# Pull the latest changes from Subversion
+        git\-svn rebase
+.ft
+
 .fi
 .SH "REBASE VS. PULL/MERGE"
 Originally, git\-svn recommended that the remotes/git\-svn branch be pulled or merged from. This is because the author favored \fIgit\-svn set\-tree B\fR to commit a single head rather than the \fIgit\-svn set\-tree A..B\fR notation to commit multiple commits.