Autogenerated HTML docs for v1.5.0-rc0-g244a7
authorJunio C Hamano <junio@hera.kernel.org>
Fri, 5 Jan 2007 07:46:25 +0000 (07:46 +0000)
committerJunio C Hamano <junio@hera.kernel.org>
Fri, 5 Jan 2007 07:46:25 +0000 (07:46 +0000)
git-svn.html
git-svn.txt

index ea7c74d89aa58c42c9905019897137d059a6901b..72cc62c3699454599cda5f1630aa0d81329bc341 100644 (file)
@@ -266,7 +266,7 @@ git-svn(1) Manual Page
 <h2>NAME</h2>\r
 <div class="sectionbody">\r
 <p>git-svn -\r
-   bidirectional operation between a single Subversion branch and git\r
+   bidirectional operation between Subversion and git\r
 </p>\r
 </div>\r
 </div>\r
@@ -276,21 +276,18 @@ git-svn(1) Manual Page
 </div>\r
 <h2>DESCRIPTION</h2>\r
 <div class="sectionbody">\r
-<p>git-svn is a simple conduit for changesets between a single Subversion\r
-branch and git. It is not to be confused with <a href="git-svnimport.html">git-svnimport(1)</a>.\r
-They were designed with very different goals in mind.</p>\r
-<p>git-svn is designed for an individual developer who wants a\r
+<p>git-svn is a simple conduit for changesets between Subversion and git.\r
+It is not to be confused with <a href="git-svnimport.html">git-svnimport(1)</a>, which is\r
+read-only and geared towards tracking multiple branches.</p>\r
+<p>git-svn was originally designed for an individual developer who wants a\r
 bidirectional flow of changesets between a single branch in Subversion\r
-and an arbitrary number of branches in git.  git-svnimport is designed\r
-for read-only operation on repositories that match a particular layout\r
-(albeit the recommended one by SVN developers).</p>\r
-<p>For importing svn, git-svnimport is potentially more powerful when\r
-operating on repositories organized under the recommended\r
-trunk/branch/tags structure, and should be faster, too.</p>\r
-<p>git-svn mostly ignores the very limited view of branching that\r
-Subversion has.  This allows git-svn to be much easier to use,\r
-especially on repositories that are not organized in a manner that\r
-git-svnimport is designed for.</p>\r
+and an arbitrary number of branches in git.  Since its inception,\r
+git-svn has gained the ability to track multiple branches in a manner\r
+similar to git-svnimport; but it cannot (yet) automatically detect new\r
+branches and tags like git-svnimport does.</p>\r
+<p>git-svn is especially useful when it comes to tracking repositories\r
+not organized in the way Subversion developers recommend (trunk,\r
+branches, tags directories).</p>\r
 </div>\r
 <h2>COMMANDS</h2>\r
 <div class="sectionbody">\r
@@ -776,7 +773,7 @@ SVN was very wrong.</p>
 </dd>\r
 </dl>\r
 <h3>Basic Examples</h3>\r
-<p>Tracking and contributing to a Subversion-managed project:</p>\r
+<p>Tracking and contributing to a the trunk of a Subversion-managed project:</p>\r
 <div class="listingblock">\r
 <div class="content">\r
 <pre><tt># Initialize a repo (like git init-db):\r
@@ -793,6 +790,29 @@ SVN was very wrong.</p>
 # Append svn:ignore settings to the default git exclude file:\r
         git-svn show-ignore &gt;&gt; .git/info/exclude</tt></pre>\r
 </div></div>\r
+<p>Tracking and contributing to an entire Subversion-managed project\r
+(complete with a trunk, tags and branches):\r
+See also:\r
+<em><a href="#tracking-multiple-repos">Tracking Multiple Repositories or Branches</a></em></p>\r
+<div class="listingblock">\r
+<div class="content">\r
+<pre><tt># Initialize a repo (like git init-db):\r
+        git-svn multi-init http://svn.foo.org/project \\r
+                -T trunk -b branches -t tags\r
+# Fetch remote revisions:\r
+        git-svn multi-fetch\r
+# Create your own branch of trunk to hack on:\r
+        git checkout -b my-trunk remotes/trunk\r
+# Do some work, and then commit your new changes to SVN, as well as\r
+# automatically updating your working HEAD:\r
+        git-svn dcommit -i trunk\r
+# Something has been committed to trunk, rebase the latest into your branch:\r
+        git-svn multi-fetch &amp;&amp; git rebase remotes/trunk\r
+# Append svn:ignore settings of trunk to the default git exclude file:\r
+        git-svn show-ignore -i trunk &gt;&gt; .git/info/exclude\r
+# Check for new branches and tags (no arguments are needed):\r
+        git-svn multi-init</tt></pre>\r
+</div></div>\r
 </div>\r
 <h2>REBASE VS. PULL</h2>\r
 <div class="sectionbody">\r
@@ -907,7 +927,7 @@ detect them.</p>
 </div>\r
 <div id="footer">\r
 <div id="footer-text">\r
-Last updated 21-Dec-2006 02:25:50 UTC\r
+Last updated 05-Jan-2007 07:46:19 UTC\r
 </div>\r
 </div>\r
 </body>\r
index f5f57e8f87d4271a634f13f33d6b33af43909473..f754d2f679b0f77c85767de8b45f089d441e4c4d 100644 (file)
@@ -3,7 +3,7 @@ git-svn(1)
 
 NAME
 ----
-git-svn - bidirectional operation between a single Subversion branch and git
+git-svn - bidirectional operation between Subversion and git
 
 SYNOPSIS
 --------
@@ -11,24 +11,20 @@ SYNOPSIS
 
 DESCRIPTION
 -----------
-git-svn is a simple conduit for changesets between a single Subversion
-branch and git. It is not to be confused with gitlink:git-svnimport[1].
-They were designed with very different goals in mind.
+git-svn is a simple conduit for changesets between Subversion and git.
+It is not to be confused with gitlink:git-svnimport[1], which is
+read-only and geared towards tracking multiple branches.
 
-git-svn is designed for an individual developer who wants a
+git-svn was originally designed for an individual developer who wants a
 bidirectional flow of changesets between a single branch in Subversion
-and an arbitrary number of branches in git.  git-svnimport is designed
-for read-only operation on repositories that match a particular layout
-(albeit the recommended one by SVN developers).
+and an arbitrary number of branches in git.  Since its inception,
+git-svn has gained the ability to track multiple branches in a manner
+similar to git-svnimport; but it cannot (yet) automatically detect new
+branches and tags like git-svnimport does.
 
-For importing svn, git-svnimport is potentially more powerful when
-operating on repositories organized under the recommended
-trunk/branch/tags structure, and should be faster, too.
-
-git-svn mostly ignores the very limited view of branching that
-Subversion has.  This allows git-svn to be much easier to use,
-especially on repositories that are not organized in a manner that
-git-svnimport is designed for.
+git-svn is especially useful when it comes to tracking repositories
+not organized in the way Subversion developers recommend (trunk,
+branches, tags directories).
 
 COMMANDS
 --------
@@ -370,7 +366,7 @@ SVN was very wrong.
 Basic Examples
 ~~~~~~~~~~~~~~
 
-Tracking and contributing to a Subversion-managed project:
+Tracking and contributing to a the trunk of a Subversion-managed project:
 
 ------------------------------------------------------------------------
 # Initialize a repo (like git init-db):
@@ -388,6 +384,30 @@ Tracking and contributing to a Subversion-managed project:
        git-svn show-ignore >> .git/info/exclude
 ------------------------------------------------------------------------
 
+Tracking and contributing to an entire Subversion-managed project
+(complete with a trunk, tags and branches):
+See also:
+'<<tracking-multiple-repos,Tracking Multiple Repositories or Branches>>'
+
+------------------------------------------------------------------------
+# Initialize a repo (like git init-db):
+       git-svn multi-init http://svn.foo.org/project \
+               -T trunk -b branches -t tags
+# Fetch remote revisions:
+       git-svn multi-fetch
+# Create your own branch of trunk to hack on:
+       git checkout -b my-trunk remotes/trunk
+# Do some work, and then commit your new changes to SVN, as well as
+# automatically updating your working HEAD:
+       git-svn dcommit -i trunk
+# Something has been committed to trunk, rebase the latest into your branch:
+       git-svn multi-fetch && git rebase remotes/trunk
+# Append svn:ignore settings of trunk to the default git exclude file:
+       git-svn show-ignore -i trunk >> .git/info/exclude
+# Check for new branches and tags (no arguments are needed):
+       git-svn multi-init
+------------------------------------------------------------------------
+
 REBASE VS. PULL
 ---------------