Autogenerated HTML docs for v1.3.3-g63df

[git.git] / git-cvsimport.html
diff --git a/git-cvsimport.html b/git-cvsimport.html

index 20f90f0..dcae53b 100644 (file)
--- a/git-cvsimport.html
+++ b/git-cvsimport.html
@@ -3,7 +3,7 @@
  <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">\r
  <head>\r
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />\r
-<meta name="generator" content="AsciiDoc 7.0.1" />\r
+<meta name="generator" content="AsciiDoc 7.0.2" />\r
  <style type="text/css">\r
  /* Debug borders */\r
  p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {\r
@@ -283,6 +283,11 @@ git-cvsimport(1) Manual Page
  repository, or incrementally import into an existing one.</p>\r
  <p>Splitting the CVS log into patch sets is done by <em>cvsps</em>.\r
  At least version 2.1 is required.</p>\r
+<p>You should <strong>never</strong> do any work of your own on the branches that are\r
+created by git-cvsimport. The initial import will create and populate a\r
+"master" branch from the CVS repository's main branch which you're free\r
+to work with; after that, you need to <em>git merge</em> incremental imports, or\r
+any CVS branches, yourself.</p>\r
  </div>\r
  <h2>OPTIONS</h2>\r
  <div class="sectionbody">\r
@@ -425,6 +430,31 @@ the old cvs2git tool.</p>
          Substitute the character "/" in branch names with &lt;subst&gt;\r
  </p>\r
  </dd>\r
+<dt>\r
+-A &lt;author-conv-file&gt;\r
+</dt>\r
+<dd>\r
+<p>\r
+        CVS by default uses the unix username when writing its\r
+        commit logs. Using this option and an author-conv-file\r
+        in this format\r
+</p>\r
+<div class="listingblock">\r
+<div class="content">\r
+<pre><tt>        exon=Andreas Ericsson &lt;ae@op5.se&gt;\r
+        spawn=Simon Pawn &lt;spawn@frog-pond.org&gt;\r
+</tt></pre>\r
+</div></div>\r
+<p>git-cvsimport will make it appear as those authors had\r
+their GIT_AUTHOR_NAME and GIT_AUTHOR_EMAIL set properly\r
+all along.</p>\r
+<p>For convenience, this data is saved to $GIT_DIR/cvs-authors\r
+each time the -A option is provided and read from that same\r
+file each time git-cvsimport is run.</p>\r
+<p>It is not recommended to use this feature if you intend to\r
+export changes back to CVS again later with\r
+git-link[1]::git-cvsexportcommit.</p>\r
+</dd>\r
  </dl>\r
  </div>\r
  <h2>OUTPUT</h2>\r
@@ -448,7 +478,7 @@ various participants of the git-list &lt;git@vger.kernel.org&gt;.</p>
  </div>\r
  <div id="footer">\r
  <div id="footer-text">\r
-Last updated 06-Jan-2006 17:12:15 PDT\r
+Last updated 21-Mar-2006 08:33:42 UTC\r
  </div>\r
  </div>\r
  </body>\r