.\" Process this file with .\" groff -man -Tascii cvs2svn.1 .TH CVS2SVN "1" "Oct 24, 2004" "Subversion" "User Commands" .SH NAME cvs2svn \- convert a cvs repository into a subversion repository .SH SYNOPSIS .B cvs2svn [\fIOPTION\fR]... \fI-s svn-repos-path cvs-repos-path\fR .br .B cvs2svn [\fIOPTION\fR]... \fI--dumpfile=path cvs-repos-path\fR .SH DESCRIPTION Create a new Subversion repository based on the version history stored in a CVS repository. Each CVS commit will be mirrored in the Subversion repository, including such information as date of commit and id of the committer. .TP \fB--help\fR, \fB-h\fR Print the usage message and exit with success. .TP \fB--help-passes\fR Print the numbers and names of the conversion passes and exit with success. .TP \fB--version\fR Print the version number. .TP \fB--verbose\fR, \fB-v\fR Print more information while running. .TP \fB--quiet\fR, \fB-q\fR Print less information while running. This option may be specified twice to suppress all non-error output. .TP \fB--options\fR=\fIpath\fR Read the conversion options from \fIpath\fR instead of from the command line. See the documentation for more information. Only the following options are allowed in combination with \fB--options\fR: \fB-h\fR/\fB--help\fR, \fB--help-passes\fR, \fB--version\fR, \fB-v\fR/\fB--verbose\fR, \fB-q\fR/\fB--quiet\fR, \fB-p\fR, \fB--dry-run\fR, and \fB--profile\fR. .TP \fB-s\fR \fIpath\fR Load CVS repository into the Subversion repository located at PATH. If there is no Subversion repository at \fIpath\fR, create a new one. .TP \fB-p\fR \fIpass\fR Execute only pass \fIpass\fR of the conversion. \fIpass\fR can be specified by name or by number (see \fB--help-passes\fR). .TP \fB-p\fR [\fIstart\fR]:[\fIend\fR] Execute passes \fIstart\fR through \fIend\fR of the conversion (inclusive). \fIstart\fR and \fIend\fR can be specified by name or by number (see \fB--help-passes\fR). If \fIstart\fR or \fIend\fR is missing, it defaults to the first or last pass, respectively. For this to work the earlier passes must have been completed before on the same CVS repository, and the generated data files must be in the temporary directory (see \fB--tmpdir\fR). .TP \fB--existing-svnrepos\fR Load into existing SVN repository, instead of creating a new repository. Please note that you need write permission for the repository files. .TP \fB--dumpfile\fR=\fIpath\fR Just produce a dumpfile; don't commit to an SVN repository. Use \fIpath\fR as the name of the dumpfile. .TP \fB--dry-run\fR Do not create a repository or a dumpfile; just print the details of what cvs2svn would do if it were really converting your repository. .TP \fB--use-cvs\fR Use CVS instead of RCS 'co' to extract data (only use this if having problems with RCS, as CVS is much slower). .TP \fB--trunk-only\fR Convert only trunk commits, not tags nor branches. .TP \fB--trunk\fR=\fIpath\fR Set the top-level path to use for trunk in the Subversion repository. The default is \fItrunk\fR. .TP \fB--branches\fR=\fIpath\fR Set the top-level path to use for branches in the Subversion repository. The default is \fIbranches\fR. .TP \fB--tags\fR=\fIpath\fR Set the top-level path to use for tags in the Subversion repository. The default is \fItags\fR. .TP \fB--no-prune\fR When all files are deleted from a directory in the Subversion repository, don't delete the empty directory (the default is to delete any empty directories. .TP \fB--encoding\fR=\fIencoding\fR Use \fIencoding\fR as the encoding for filenames, log messages, and author names in the CVS repos. This option may be specified multiple times, in which case the encodings are tried in order until one succeeds. Default: ascii. .TP \fB--fallback-encoding\fR=\fIencoding\fR If all of the encodings specified with \fB--encoding\fR fail, then fall back to using \fIencoding\fR in lossy 'replace' mode. Use of this option may cause information to be lost, but at least it allows the conversion to run to completion. Default: disabled. .TP \fB--force-branch\fR=\fIregexp\fR Force symbols whose names match \fIregexp\fR to be branches. .TP \fB--force-tag\fR=\fIregexp\fR Force symbols whose names match \fIregexp\fR to be tags. .TP \fB--exclude\fR=\fIregexp\fR Exclude branches and tags whose names match \fIregexp\fR from the conversion. .TP \fB--symbol-default\fR=\fIopt\fR Specify how to convert ambiguous symbols (those that appear in the CVS archive as both branches and tags). \fIopt\fR must be `branch' (treat every ambiguous symbol as a branch), `tag' (treat every ambiguous symbol as a tag), `heuristic' (decide how to treat each ambiguous symbol based on whether it was used more often as a branch/tag in CVS), or `strict' (no default; every ambiguous symbol has to be resolved manually using \fB--force-branch\fR, \fB--force-tag\fR, or \fB--exclude\fR). .TP \fB--symbol-transform\fR=\fIpattern\fR:\fIreplacement\fR Transform RCS/CVS symbol names before entering them into Subversion. \fIpattern\fR is a Python regexp pattern and \fIreplacement\fR is a replacement using Python's regexp reference syntax. You may specify any number of these options; they will be applied in the order given on the command line. .br This option can be useful if you're converting a repository in which the developer used directory-wide symbol names like 1_0, 1_1 and 2_1 as a kludgy form of release tagging (the C-x v s command in Emacs VC mode encourages this practice). .TP \fB--username\fR=\fIname\fR Set the default username to \fIname\fR when cvs2svn doesn't have a username from the CVS repository to work with. This happens when a branch or tag is created. The default is to use no author at all for such commits. .TP \fB--fs-type\fR Pass \fI--fs-type\fR=\fItype\fR to "svnadmin create" when creating a new repository. .TP \fB--bdb-txn-nosync\fR Pass \fI--bdb-txn-nosync\fR to "svnadmin create" when creating a new repository. .TP \fB--cvs-revnums\fR Record CVS revision numbers as file properties in the Subversion repository. (Note that unless it is removed explicitly, the last CVS revision number will remain associated with the file even after the file is changed within Subversion.) .TP \fB--mime-types\fR=\fIfile\fR Specify an apache-style mime.types \fIfile\fR for setting svn:mime-type. .TP \fB--auto-props\fR=\fIfile\fR Specify a file in the format of Subversion's config file, whose [auto-props] section can be used to set arbitrary properties on files in the Subversion repository based on their filenames. (The [auto-props] section header must be present; other sections of the config file, including the enable-auto-props setting, are ignored.) Filenames are matched to the filename patterns case-sensitively unless the --auto-props-ignore-case option is specified. .TP \fB--auto-props-ignore-case\fR Ignore case when pattern-matching auto-props patterns. .TP \fB--eol-from-mime-type\fR For files that don't have the kb expansion mode but have a known mime type, set the eol-style based on the mime type. For such files, set svn:eol-style to "native" if the mime type begins with "text/", and leave it unset (i.e., no EOL translation) otherwise. Files with unknown mime types are not affected by this option. This option has no effect unless the \fB--mime-types\fR option is also specified. .TP \fB--no-default-eol\fR Files that don't have the kb expansion mode and (if \fB--eol-from-mime-type\fR is set) unknown mime type usually have their svn:eol-style property to "native". If this option is specified, such files are left with no eol-style (i.e., no EOL translation). .TP \fB--keywords-off\fR By default, cvs2svn sets svn:keywords on CVS files to "author id date" if the mode of the RCS file in question is either kv, kvl or not kb. If you use the --keywords-off switch, cvs2svn will not set svn:keywords for any file. While this will not touch the keywords in the contents of your files, Subversion will not expand them. .TP \fB--tmpdir\fR=\fIpath\fR Set the \fIpath\fR to use for temporary data. Default is the current directory. .TP \fB--skip-cleanup\fR Prevent the deletion of temporary files. .TP \fB--profile\fR Profile with 'hotshot' (into file \fIcvs2svn.hotshot\fR). .TP \fB--svnadmin\fR=\fIpath\fR Path to the \fIsvnadmin\fR program. .TP \fB--co\fR=\fIpath\fR Path to the \fIco\fR program. (\fIco\fR is needed if \fB--use-cvs\fR is not specified.) .TP \fB--cvs\fR=\fIpath\fR Path to the \fIcvs\fR program. (\fIcvs\fR is needed if \fB--use-cvs\fR is specified.) .TP \fB--sort\fR=\fIpath\fR Path to the GNU \fIsort\fR program. (cvs2svn requires GNU sort.) .SH FILES The current directory (or the directory specified by \fB--tmpdir\fR) is used as scratch space for data files of the form \fIcvs2svn-data.*\fR and a dumpfile named \fIcvs2svn-dump\fR. .SH AUTHORS Main authors are: .br C. Michael Pilato .br Greg Stein .br Branko Čibej .br Blair Zajac .br Max Bowsher .br Brian Fitzpatrick .br Tobias Ringström .br Karl Fogel .br Erik Hülsmann .br David Summers .br Michael Haggerty .PP Manpage was written for the Debian GNU/Linux system by Laszlo 'GCS' Boszormenyi (but may be used by others). .SH SEE ALSO cvs(1), svn(1), svnadmin(1)