git-cvsimport.html - external/gitster/git-htmldocs - Git at Google

 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
  "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
 <meta name="generator" content="AsciiDoc 8.2.5" />
 <style type="text/css">
 /* Debug borders */
 p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
 /*
  border: 1px solid red;
 */
 }

 body {
  margin: 1em 5% 1em 5%;
 }

 a {
  color: blue;
  text-decoration: underline;
 }
 a:visited {
  color: fuchsia;
 }

 em {
  font-style: italic;
 }

 strong {
  font-weight: bold;
 }

 tt {
  color: navy;
 }

 h1, h2, h3, h4, h5, h6 {
  color: #527bbd;
  font-family: sans-serif;
  margin-top: 1.2em;
  margin-bottom: 0.5em;
  line-height: 1.3;
 }

 h1, h2, h3 {
  border-bottom: 2px solid silver;
 }
 h2 {
  padding-top: 0.5em;
 }
 h3 {
  float: left;
 }
 h3 + * {
  clear: left;
 }

 div.sectionbody {
  font-family: serif;
  margin-left: 0;
 }

 hr {
  border: 1px solid silver;
 }

 p {
  margin-top: 0.5em;
  margin-bottom: 0.5em;
 }

 pre {
  padding: 0;
  margin: 0;
 }

 span#author {
  color: #527bbd;
  font-family: sans-serif;
  font-weight: bold;
  font-size: 1.1em;
 }
 span#email {
 }
 span#revision {
  font-family: sans-serif;
 }

 div#footer {
  font-family: sans-serif;
  font-size: small;
  border-top: 2px solid silver;
  padding-top: 0.5em;
  margin-top: 4.0em;
 }
 div#footer-text {
  float: left;
  padding-bottom: 0.5em;
 }
 div#footer-badges {
  float: right;
  padding-bottom: 0.5em;
 }

 div#preamble,
 div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
 div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
 div.admonitionblock {
  margin-right: 10%;
  margin-top: 1.5em;
  margin-bottom: 1.5em;
 }
 div.admonitionblock {
  margin-top: 2.5em;
  margin-bottom: 2.5em;
 }

 div.content { /* Block element content. */
  padding: 0;
 }

 /* Block element titles. */
 div.title, caption.title {
  font-family: sans-serif;
  font-weight: bold;
  text-align: left;
  margin-top: 1.0em;
  margin-bottom: 0.5em;
 }
 div.title + * {
  margin-top: 0;
 }

 td div.title:first-child {
  margin-top: 0.0em;
 }
 div.content div.title:first-child {
  margin-top: 0.0em;
 }
 div.content + div.title {
  margin-top: 0.0em;
 }

 div.sidebarblock > div.content {
  background: #ffffee;
  border: 1px solid silver;
  padding: 0.5em;
 }

 div.listingblock {
  margin-right: 0%;
 }
 div.listingblock > div.content {
  border: 1px solid silver;
  background: #f4f4f4;
  padding: 0.5em;
 }

 div.quoteblock > div.content {
  padding-left: 2.0em;
 }

 div.attribution {
  text-align: right;
 }
 div.verseblock + div.attribution {
  text-align: left;
 }

 div.admonitionblock .icon {
  vertical-align: top;
  font-size: 1.1em;
  font-weight: bold;
  text-decoration: underline;
  color: #527bbd;
  padding-right: 0.5em;
 }
 div.admonitionblock td.content {
  padding-left: 0.5em;
  border-left: 2px solid silver;
 }

 div.exampleblock > div.content {
  border-left: 2px solid silver;
  padding: 0.5em;
 }

 div.verseblock div.content {
  white-space: pre;
 }

 div.imageblock div.content { padding-left: 0; }
 div.imageblock img { border: 1px solid silver; }
 span.image img { border-style: none; }

 dl {
  margin-top: 0.8em;
  margin-bottom: 0.8em;
 }
 dt {
  margin-top: 0.5em;
  margin-bottom: 0;
  font-style: italic;
 }
 dd > *:first-child {
  margin-top: 0;
 }

 ul, ol {
  list-style-position: outside;
 }
 div.olist2 ol {
  list-style-type: lower-alpha;
 }

 div.tableblock > table {
  border: 3px solid #527bbd;
 }
 thead {
  font-family: sans-serif;
  font-weight: bold;
 }
 tfoot {
  font-weight: bold;
 }

 div.hlist {
  margin-top: 0.8em;
  margin-bottom: 0.8em;
 }
 div.hlist td {
  padding-bottom: 5px;
 }
 td.hlist1 {
  vertical-align: top;
  font-style: italic;
  padding-right: 0.8em;
 }
 td.hlist2 {
  vertical-align: top;
 }

 @media print {
  div#footer-badges { display: none; }
 }

 div#toctitle {
  color: #527bbd;
  font-family: sans-serif;
  font-size: 1.1em;
  font-weight: bold;
  margin-top: 1.0em;
  margin-bottom: 0.1em;
 }

 div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
  margin-top: 0;
  margin-bottom: 0;
 }
 div.toclevel2 {
  margin-left: 2em;
  font-size: 0.9em;
 }
 div.toclevel3 {
  margin-left: 4em;
  font-size: 0.9em;
 }
 div.toclevel4 {
  margin-left: 6em;
  font-size: 0.9em;
 }
 include1::./stylesheets/xhtml11-manpage.css[]
 /* Workarounds for IE6's broken and incomplete CSS2. */

 div.sidebar-content {
  background: #ffffee;
  border: 1px solid silver;
  padding: 0.5em;
 }
 div.sidebar-title, div.image-title {
  font-family: sans-serif;
  font-weight: bold;
  margin-top: 0.0em;
  margin-bottom: 0.5em;
 }

 div.listingblock div.content {
  border: 1px solid silver;
  background: #f4f4f4;
  padding: 0.5em;
 }

 div.quoteblock-content {
  padding-left: 2.0em;
 }

 div.exampleblock-content {
  border-left: 2px solid silver;
  padding-left: 0.5em;
 }

 /* IE6 sets dynamically generated links as visited. */
 div#toc a:visited { color: blue; }
 </style>
 <title>git-cvsimport(1)</title>
 </head>
 <body>
 <div id="header">
 <h1>
 git-cvsimport(1) Manual Page
 </h1>
 <h2>NAME</h2>
 <div class="sectionbody">
 <p>git-cvsimport -
  Salvage your data out of another SCM people love to hate
 </p>
 </div>
 </div>
 <h2>SYNOPSIS</h2>
 <div class="sectionbody">
 <div class="verseblock">
 <div class="content"><em>git cvsimport</em> [-o &lt;branch-for-HEAD&gt;] [-h] [-v] [-d &lt;CVSROOT&gt;]
  [-A &lt;author-conv-file&gt;] [-p &lt;options-for-cvsps&gt;] [-P &lt;file&gt;]
  [-C &lt;git_repository&gt;] [-z &lt;fuzz&gt;] [-i] [-k] [-u] [-s &lt;subst&gt;]
  [-a] [-m] [-M &lt;regex&gt;] [-S &lt;regex&gt;] [-L &lt;commitlimit&gt;]
  [-r &lt;remote&gt;] [&lt;CVS_module&gt;]</div></div>
 </div>
 <h2 id="_description">DESCRIPTION</h2>
 <div class="sectionbody">
 <div class="para"><p>Imports a CVS repository into git. It will either create a new
 repository, or incrementally import into an existing one.</p></div>
 <div class="para"><p>Splitting the CVS log into patch sets is done by <em>cvsps</em>.
 At least version 2.1 is required.</p></div>
 <div class="para"><p>You should <strong>never</strong> do any work of your own on the branches that are
 created by <em>git-cvsimport</em>. By default initial import will create and populate a
 "master" branch from the CVS repository's main branch which you're free
 to work with; after that, you need to <em>git-merge</em> incremental imports, or
 any CVS branches, yourself. It is advisable to specify a named remote via
 -r to separate and protect the incoming branches.</p></div>
 <div class="para"><p>If you intend to set up a shared public repository that all developers can
 read/write, or if you want to use <a href="git-cvsserver.html">git-cvsserver(1)</a>, then you
 probably want to make a bare clone of the imported repository,
 and use the clone as the shared repository.
 See <a href="gitcvs-migration.html">gitcvs-migration(7)</a>.</p></div>
 </div>
 <h2 id="_options">OPTIONS</h2>
 <div class="sectionbody">
 <div class="vlist"><dl>
 <dt>
 -v
 </dt>
 <dd>
 <p>
  Verbosity: let <em>cvsimport</em> report what it is doing.
 </p>
 </dd>
 <dt>
 -d &lt;CVSROOT&gt;
 </dt>
 <dd>
 <p>
  The root of the CVS archive. May be local (a simple path) or remote;
  currently, only the :local:, :ext: and :pserver: access methods
  are supported. If not given, <em>git-cvsimport</em> will try to read it
  from <tt>CVS/Root</tt>. If no such file exists, it checks for the
  <tt>CVSROOT</tt> environment variable.
 </p>
 </dd>
 <dt>
 &lt;CVS_module&gt;
 </dt>
 <dd>
 <p>
  The CVS module you want to import. Relative to &lt;CVSROOT&gt;.
  If not given, <em>git-cvsimport</em> tries to read it from
  <tt>CVS/Repository</tt>.
 </p>
 </dd>
 <dt>
 -C &lt;target-dir&gt;
 </dt>
 <dd>
 <p>
  The git repository to import to. If the directory doesn't
  exist, it will be created. Default is the current directory.
 </p>
 </dd>
 <dt>
 -r &lt;remote&gt;
 </dt>
 <dd>
 <p>
  The git remote to import this CVS repository into.
  Moves all CVS branches into remotes/&lt;remote&gt;/&lt;branch&gt;
  akin to the <em>git-clone</em> "--use-separate-remote" option.
 </p>
 </dd>
 <dt>
 -o &lt;branch-for-HEAD&gt;
 </dt>
 <dd>
 <p>
  When no remote is specified (via -r) the <em>HEAD</em> branch
  from CVS is imported to the <em>origin</em> branch within the git
  repository, as <em>HEAD</em> already has a special meaning for git.
  When a remote is specified the <em>HEAD</em> branch is named
  remotes/&lt;remote&gt;/master mirroring <em>git-clone</em> behaviour.
  Use this option if you want to import into a different
  branch.
 </p>
 <div class="para"><p>Use <em>-o master</em> for continuing an import that was initially done by
 the old cvs2git tool.</p></div>
 </dd>
 <dt>
 -i
 </dt>
 <dd>
 <p>
  Import-only: don't perform a checkout after importing. This option
  ensures the working directory and index remain untouched and will
  not create them if they do not exist.
 </p>
 </dd>
 <dt>
 -k
 </dt>
 <dd>
 <p>
  Kill keywords: will extract files with <em>-kk</em> from the CVS archive
  to avoid noisy changesets. Highly recommended, but off by default
  to preserve compatibility with early imported trees.
 </p>
 </dd>
 <dt>
 -u
 </dt>
 <dd>
 <p>
  Convert underscores in tag and branch names to dots.
 </p>
 </dd>
 <dt>
 -s &lt;subst&gt;
 </dt>
 <dd>
 <p>
  Substitute the character "/" in branch names with &lt;subst&gt;
 </p>
 </dd>
 <dt>
 -p &lt;options-for-cvsps&gt;
 </dt>
 <dd>
 <p>
  Additional options for cvsps.
  The options <em>-u</em> and <em>-A</em> are implicit and should not be used here.
 </p>
 <div class="para"><p>If you need to pass multiple options, separate them with a comma.</p></div>
 </dd>
 <dt>
 -z &lt;fuzz&gt;
 </dt>
 <dd>
 <p>
  Pass the timestamp fuzz factor to cvsps, in seconds. If unset,
  cvsps defaults to 300s.
 </p>
 </dd>
 <dt>
 -P &lt;cvsps-output-file&gt;
 </dt>
 <dd>
 <p>
  Instead of calling cvsps, read the provided cvsps output file. Useful
  for debugging or when cvsps is being handled outside cvsimport.
 </p>
 </dd>
 <dt>
 -m
 </dt>
 <dd>
 <p>
  Attempt to detect merges based on the commit message. This option
  will enable default regexes that try to capture the source
  branch name from the commit message.
 </p>
 </dd>
 <dt>
 -M &lt;regex&gt;
 </dt>
 <dd>
 <p>
  Attempt to detect merges based on the commit message with a custom
  regex. It can be used with <em>-m</em> to enable the default regexes
  as well. You must escape forward slashes.
 </p>
 <div class="para"><p>The regex must capture the source branch name in $1.</p></div>
 <div class="para"><p>This option can be used several times to provide several detection regexes.</p></div>
 </dd>
 <dt>
 -S &lt;regex&gt;
 </dt>
 <dd>
 <p>
  Skip paths matching the regex.
 </p>
 </dd>
 <dt>
 -a
 </dt>
 <dd>
 <p>
  Import all commits, including recent ones. cvsimport by default
  skips commits that have a timestamp less than 10 minutes ago.
 </p>
 </dd>
 <dt>
 -L &lt;limit&gt;
 </dt>
 <dd>
 <p>
  Limit the number of commits imported. Workaround for cases where
  cvsimport leaks memory.
 </p>
 </dd>
 <dt>
 -A &lt;author-conv-file&gt;
 </dt>
 <dd>
 <p>
  CVS by default uses the Unix username when writing its
  commit logs. Using this option and an author-conv-file
  in this format
 </p>
 <div class="listingblock">
 <div class="content">
 <pre><tt> exon=Andreas Ericsson &lt;ae@op5.se&gt;
  spawn=Simon Pawn &lt;spawn@frog-pond.org&gt;
 </tt></pre>
 </div></div>
 <div class="para"><p><em>git-cvsimport</em> will make it appear as those authors had
 their GIT_AUTHOR_NAME and GIT_AUTHOR_EMAIL set properly
 all along.</p></div>
 <div class="para"><p>For convenience, this data is saved to <tt>$GIT_DIR/cvs-authors</tt>
 each time the <em>-A</em> option is provided and read from that same
 file each time <em>git-cvsimport</em> is run.</p></div>
 <div class="para"><p>It is not recommended to use this feature if you intend to
 export changes back to CVS again later with
 <em>git-cvsexportcommit</em>.</p></div>
 </dd>
 <dt>
 -h
 </dt>
 <dd>
 <p>
  Print a short usage message and exit.
 </p>
 </dd>
 </dl></div>
 </div>
 <h2 id="_output">OUTPUT</h2>
 <div class="sectionbody">
 <div class="para"><p>If <em>-v</em> is specified, the script reports what it is doing.</p></div>
 <div class="para"><p>Otherwise, success is indicated the Unix way, i.e. by simply exiting with
 a zero exit status.</p></div>
 </div>
 <h2 id="_author">Author</h2>
 <div class="sectionbody">
 <div class="para"><p>Written by Matthias Urlichs &lt;smurf@smurf.noris.de&gt;, with help from
 various participants of the git-list &lt;git@vger.kernel.org&gt;.</p></div>
 </div>
 <h2 id="_documentation">Documentation</h2>
 <div class="sectionbody">
 <div class="para"><p>Documentation by Matthias Urlichs &lt;smurf@smurf.noris.de&gt;.</p></div>
 </div>
 <h2 id="_git">GIT</h2>
 <div class="sectionbody">
 <div class="para"><p>Part of the <a href="git.html">git(1)</a> suite</p></div>
 </div>
 <div id="footer">
 <div id="footer-text">
 Last updated 2008-07-06 05:16:40 UTC
 </div>
 </div>
 </body>
 </html>
	<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
	"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
	<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
	<head>
	<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
	<meta name="generator" content="AsciiDoc 8.2.5" />
	<style type="text/css">
	/* Debug borders */
	p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
	/*
	border: 1px solid red;
	*/
	}

	body {
	margin: 1em 5% 1em 5%;
	}

	a {
	color: blue;
	text-decoration: underline;
	}
	a:visited {
	color: fuchsia;
	}

	em {
	font-style: italic;
	}

	strong {
	font-weight: bold;
	}

	tt {
	color: navy;
	}

	h1, h2, h3, h4, h5, h6 {
	color: #527bbd;
	font-family: sans-serif;
	margin-top: 1.2em;
	margin-bottom: 0.5em;
	line-height: 1.3;
	}

	h1, h2, h3 {
	border-bottom: 2px solid silver;
	}
	h2 {
	padding-top: 0.5em;
	}
	h3 {
	float: left;
	}
	h3 + * {
	clear: left;
	}

	div.sectionbody {
	font-family: serif;
	margin-left: 0;
	}

	hr {
	border: 1px solid silver;
	}

	p {
	margin-top: 0.5em;
	margin-bottom: 0.5em;
	}

	pre {
	padding: 0;
	margin: 0;
	}

	span#author {
	color: #527bbd;
	font-family: sans-serif;
	font-weight: bold;
	font-size: 1.1em;
	}
	span#email {
	}
	span#revision {
	font-family: sans-serif;
	}

	div#footer {
	font-family: sans-serif;
	font-size: small;
	border-top: 2px solid silver;
	padding-top: 0.5em;
	margin-top: 4.0em;
	}
	div#footer-text {
	float: left;
	padding-bottom: 0.5em;
	}
	div#footer-badges {
	float: right;
	padding-bottom: 0.5em;
	}

	div#preamble,
	div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
	div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
	div.admonitionblock {
	margin-right: 10%;
	margin-top: 1.5em;
	margin-bottom: 1.5em;
	}
	div.admonitionblock {
	margin-top: 2.5em;
	margin-bottom: 2.5em;
	}

	div.content { /* Block element content. */
	padding: 0;
	}

	/* Block element titles. */
	div.title, caption.title {
	font-family: sans-serif;
	font-weight: bold;
	text-align: left;
	margin-top: 1.0em;
	margin-bottom: 0.5em;
	}
	div.title + * {
	margin-top: 0;
	}

	td div.title:first-child {
	margin-top: 0.0em;
	}
	div.content div.title:first-child {
	margin-top: 0.0em;
	}
	div.content + div.title {
	margin-top: 0.0em;
	}

	div.sidebarblock > div.content {
	background: #ffffee;
	border: 1px solid silver;
	padding: 0.5em;
	}

	div.listingblock {
	margin-right: 0%;
	}
	div.listingblock > div.content {
	border: 1px solid silver;
	background: #f4f4f4;
	padding: 0.5em;
	}

	div.quoteblock > div.content {
	padding-left: 2.0em;
	}

	div.attribution {
	text-align: right;
	}
	div.verseblock + div.attribution {
	text-align: left;
	}

	div.admonitionblock .icon {
	vertical-align: top;
	font-size: 1.1em;
	font-weight: bold;
	text-decoration: underline;
	color: #527bbd;
	padding-right: 0.5em;
	}
	div.admonitionblock td.content {
	padding-left: 0.5em;
	border-left: 2px solid silver;
	}

	div.exampleblock > div.content {
	border-left: 2px solid silver;
	padding: 0.5em;
	}

	div.verseblock div.content {
	white-space: pre;
	}

	div.imageblock div.content { padding-left: 0; }
	div.imageblock img { border: 1px solid silver; }
	span.image img { border-style: none; }

	dl {
	margin-top: 0.8em;
	margin-bottom: 0.8em;
	}
	dt {
	margin-top: 0.5em;
	margin-bottom: 0;
	font-style: italic;
	}
	dd > *:first-child {
	margin-top: 0;
	}

	ul, ol {
	list-style-position: outside;
	}
	div.olist2 ol {
	list-style-type: lower-alpha;
	}

	div.tableblock > table {
	border: 3px solid #527bbd;
	}
	thead {
	font-family: sans-serif;
	font-weight: bold;
	}
	tfoot {
	font-weight: bold;
	}

	div.hlist {
	margin-top: 0.8em;
	margin-bottom: 0.8em;
	}
	div.hlist td {
	padding-bottom: 5px;
	}
	td.hlist1 {
	vertical-align: top;
	font-style: italic;
	padding-right: 0.8em;
	}
	td.hlist2 {
	vertical-align: top;
	}

	@media print {
	div#footer-badges { display: none; }
	}

	div#toctitle {
	color: #527bbd;
	font-family: sans-serif;
	font-size: 1.1em;
	font-weight: bold;
	margin-top: 1.0em;
	margin-bottom: 0.1em;
	}

	div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
	margin-top: 0;
	margin-bottom: 0;
	}
	div.toclevel2 {
	margin-left: 2em;
	font-size: 0.9em;
	}
	div.toclevel3 {
	margin-left: 4em;
	font-size: 0.9em;
	}
	div.toclevel4 {
	margin-left: 6em;
	font-size: 0.9em;
	}
	include1::./stylesheets/xhtml11-manpage.css[]
	/* Workarounds for IE6's broken and incomplete CSS2. */

	div.sidebar-content {
	background: #ffffee;
	border: 1px solid silver;
	padding: 0.5em;
	}
	div.sidebar-title, div.image-title {
	font-family: sans-serif;
	font-weight: bold;
	margin-top: 0.0em;
	margin-bottom: 0.5em;
	}

	div.listingblock div.content {
	border: 1px solid silver;
	background: #f4f4f4;
	padding: 0.5em;
	}

	div.quoteblock-content {
	padding-left: 2.0em;
	}

	div.exampleblock-content {
	border-left: 2px solid silver;
	padding-left: 0.5em;
	}

	/* IE6 sets dynamically generated links as visited. */
	div#toc a:visited { color: blue; }
	</style>
	<title>git-cvsimport(1)</title>
	</head>
	<body>
	<div id="header">
	<h1>
	git-cvsimport(1) Manual Page
	</h1>
	<h2>NAME</h2>
	<div class="sectionbody">
	<p>git-cvsimport -
	Salvage your data out of another SCM people love to hate
	</p>
	</div>
	</div>
	<h2>SYNOPSIS</h2>
	<div class="sectionbody">
	<div class="verseblock">
	<div class="content"><em>git cvsimport</em> [-o <branch-for-HEAD>] [-h] [-v] [-d <CVSROOT>]
	[-A <author-conv-file>] [-p <options-for-cvsps>] [-P <file>]
	[-C <git_repository>] [-z <fuzz>] [-i] [-k] [-u] [-s <subst>]
	[-a] [-m] [-M <regex>] [-S <regex>] [-L <commitlimit>]
	[-r <remote>] [<CVS_module>]</div></div>
	</div>
	<h2 id="_description">DESCRIPTION</h2>
	<div class="sectionbody">
	<div class="para"><p>Imports a CVS repository into git. It will either create a new
	repository, or incrementally import into an existing one.</p></div>
	<div class="para"><p>Splitting the CVS log into patch sets is done by <em>cvsps</em>.
	At least version 2.1 is required.</p></div>
	<div class="para"><p>You should <strong>never</strong> do any work of your own on the branches that are
	created by <em>git-cvsimport</em>. By default initial import will create and populate a
	"master" branch from the CVS repository's main branch which you're free
	to work with; after that, you need to <em>git-merge</em> incremental imports, or
	any CVS branches, yourself. It is advisable to specify a named remote via
	-r to separate and protect the incoming branches.</p></div>
	<div class="para"><p>If you intend to set up a shared public repository that all developers can
	read/write, or if you want to use <a href="git-cvsserver.html">git-cvsserver(1)</a>, then you
	probably want to make a bare clone of the imported repository,
	and use the clone as the shared repository.
	See <a href="gitcvs-migration.html">gitcvs-migration(7)</a>.</p></div>
	</div>
	<h2 id="_options">OPTIONS</h2>
	<div class="sectionbody">
	<div class="vlist"><dl>
	<dt>
	-v
	</dt>
	<dd>
	<p>
	Verbosity: let <em>cvsimport</em> report what it is doing.
	</p>
	</dd>
	<dt>
	-d <CVSROOT>
	</dt>
	<dd>
	<p>
	The root of the CVS archive. May be local (a simple path) or remote;
	currently, only the :local:, :ext: and :pserver: access methods
	are supported. If not given, <em>git-cvsimport</em> will try to read it
	from <tt>CVS/Root</tt>. If no such file exists, it checks for the
	<tt>CVSROOT</tt> environment variable.
	</p>
	</dd>
	<dt>
	<CVS_module>
	</dt>
	<dd>
	<p>
	The CVS module you want to import. Relative to <CVSROOT>.
	If not given, <em>git-cvsimport</em> tries to read it from
	<tt>CVS/Repository</tt>.
	</p>
	</dd>
	<dt>
	-C <target-dir>
	</dt>
	<dd>
	<p>
	The git repository to import to. If the directory doesn't
	exist, it will be created. Default is the current directory.
	</p>
	</dd>
	<dt>
	-r <remote>
	</dt>
	<dd>
	<p>
	The git remote to import this CVS repository into.
	Moves all CVS branches into remotes/<remote>/<branch>
	akin to the <em>git-clone</em> "--use-separate-remote" option.
	</p>
	</dd>
	<dt>
	-o <branch-for-HEAD>
	</dt>
	<dd>
	<p>
	When no remote is specified (via -r) the <em>HEAD</em> branch
	from CVS is imported to the <em>origin</em> branch within the git
	repository, as <em>HEAD</em> already has a special meaning for git.
	When a remote is specified the <em>HEAD</em> branch is named
	remotes/<remote>/master mirroring <em>git-clone</em> behaviour.
	Use this option if you want to import into a different
	branch.
	</p>
	<div class="para"><p>Use <em>-o master</em> for continuing an import that was initially done by
	the old cvs2git tool.</p></div>
	</dd>
	<dt>
	-i
	</dt>
	<dd>
	<p>
	Import-only: don't perform a checkout after importing. This option
	ensures the working directory and index remain untouched and will
	not create them if they do not exist.
	</p>
	</dd>
	<dt>
	-k
	</dt>
	<dd>
	<p>
	Kill keywords: will extract files with <em>-kk</em> from the CVS archive
	to avoid noisy changesets. Highly recommended, but off by default
	to preserve compatibility with early imported trees.
	</p>
	</dd>
	<dt>
	-u
	</dt>
	<dd>
	<p>
	Convert underscores in tag and branch names to dots.
	</p>
	</dd>
	<dt>
	-s <subst>
	</dt>
	<dd>
	<p>
	Substitute the character "/" in branch names with <subst>
	</p>
	</dd>
	<dt>
	-p <options-for-cvsps>
	</dt>
	<dd>
	<p>
	Additional options for cvsps.
	The options <em>-u</em> and <em>-A</em> are implicit and should not be used here.
	</p>
	<div class="para"><p>If you need to pass multiple options, separate them with a comma.</p></div>
	</dd>
	<dt>
	-z <fuzz>
	</dt>
	<dd>
	<p>
	Pass the timestamp fuzz factor to cvsps, in seconds. If unset,
	cvsps defaults to 300s.
	</p>
	</dd>
	<dt>
	-P <cvsps-output-file>
	</dt>
	<dd>
	<p>
	Instead of calling cvsps, read the provided cvsps output file. Useful
	for debugging or when cvsps is being handled outside cvsimport.
	</p>
	</dd>
	<dt>
	-m
	</dt>
	<dd>
	<p>
	Attempt to detect merges based on the commit message. This option
	will enable default regexes that try to capture the source
	branch name from the commit message.
	</p>
	</dd>
	<dt>
	-M <regex>
	</dt>
	<dd>
	<p>
	Attempt to detect merges based on the commit message with a custom
	regex. It can be used with <em>-m</em> to enable the default regexes
	as well. You must escape forward slashes.
	</p>
	<div class="para"><p>The regex must capture the source branch name in $1.</p></div>
	<div class="para"><p>This option can be used several times to provide several detection regexes.</p></div>
	</dd>
	<dt>
	-S <regex>
	</dt>
	<dd>
	<p>
	Skip paths matching the regex.
	</p>
	</dd>
	<dt>
	-a
	</dt>
	<dd>
	<p>
	Import all commits, including recent ones. cvsimport by default
	skips commits that have a timestamp less than 10 minutes ago.
	</p>
	</dd>
	<dt>
	-L <limit>
	</dt>
	<dd>
	<p>
	Limit the number of commits imported. Workaround for cases where
	cvsimport leaks memory.
	</p>
	</dd>
	<dt>
	-A <author-conv-file>
	</dt>
	<dd>
	<p>
	CVS by default uses the Unix username when writing its
	commit logs. Using this option and an author-conv-file
	in this format
	</p>
	<div class="listingblock">
	<div class="content">
	<pre><tt> exon=Andreas Ericsson <ae@op5.se>
	spawn=Simon Pawn <spawn@frog-pond.org>
	</tt></pre>
	</div></div>
	<div class="para"><p><em>git-cvsimport</em> will make it appear as those authors had
	their GIT_AUTHOR_NAME and GIT_AUTHOR_EMAIL set properly
	all along.</p></div>
	<div class="para"><p>For convenience, this data is saved to <tt>$GIT_DIR/cvs-authors</tt>
	each time the <em>-A</em> option is provided and read from that same
	file each time <em>git-cvsimport</em> is run.</p></div>
	<div class="para"><p>It is not recommended to use this feature if you intend to
	export changes back to CVS again later with
	<em>git-cvsexportcommit</em>.</p></div>
	</dd>
	<dt>
	-h
	</dt>
	<dd>
	<p>
	Print a short usage message and exit.
	</p>
	</dd>
	</dl></div>
	</div>
	<h2 id="_output">OUTPUT</h2>
	<div class="sectionbody">
	<div class="para"><p>If <em>-v</em> is specified, the script reports what it is doing.</p></div>
	<div class="para"><p>Otherwise, success is indicated the Unix way, i.e. by simply exiting with
	a zero exit status.</p></div>
	</div>
	<h2 id="_author">Author</h2>
	<div class="sectionbody">
	<div class="para"><p>Written by Matthias Urlichs <smurf@smurf.noris.de>, with help from
	various participants of the git-list <git@vger.kernel.org>.</p></div>
	</div>
	<h2 id="_documentation">Documentation</h2>
	<div class="sectionbody">
	<div class="para"><p>Documentation by Matthias Urlichs <smurf@smurf.noris.de>.</p></div>
	</div>
	<h2 id="_git">GIT</h2>
	<div class="sectionbody">
	<div class="para"><p>Part of the <a href="git.html">git(1)</a> suite</p></div>
	</div>
	<div id="footer">
	<div id="footer-text">
	Last updated 2008-07-06 05:16:40 UTC
	</div>
	</div>
	</body>
	</html>