<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
</div>\r
<h2>SYNOPSIS</h2>\r
<div class="sectionbody">\r
-<p><em>git-cvsimport</em> [ -o <branch-for-HEAD> ] [ -h ] [ -v ]\r
- [ -d <CVSROOT> ] [ -p <options-for-cvsps> ]\r
- [ -C <git_repository> ] [ -i ] [ -P <file> ] [ -k ]\r
- [ -s <subst> ] [ -m ] [ -M regex ] [ <CVS_module> ]</p>\r
+<div class="verseblock">\r
+<div class="content"><em>git-cvsimport</em> [-o <branch-for-HEAD>] [-h] [-v] [-d <CVSROOT>] [-s <subst>]\r
+ [-p <options-for-cvsps>] [-C <git_repository>] [-i] [-P <file>]\r
+ [-m] [-M regex] [<CVS_module>]</div></div>\r
</div>\r
<h2>DESCRIPTION</h2>\r
<div class="sectionbody">\r
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
Substitute the character "/" in branch names with <subst>\r
</p>\r
</dd>\r
+<dt>\r
+-A <author-conv-file>\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 <ae@op5.se>\r
+ spawn=Simon Pawn <spawn@frog-pond.org>\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
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 27-Dec-2005 00:15:58 PDT\r
+Last updated 21-Mar-2006 08:33:42 UTC\r
</div>\r
</div>\r
</body>\r