gc-import.1

   1 .TH "GC-IMPORT" "1" "March 30, 2008" "version $VERSION$" "USER COMMANDS"
   2 .SH "NAME"
   3 gc\-import \- Structured import of a CVS repository into GIT
   4 .SH "SYNOPSIS"
   5 .B gc\-import
   6 [\-h] [\-V] [\-v] [\-d <dir>] [\-r <remote>] [\-u] [\-gu] [\-gn] <cvsroot> <module>
   7 .SH "DESCRIPTION"
   8 Imports a CVS repository into a new GIT repository using git\-cvsimport
   9 and then checks out the CVS working copy into a subdirectory.
  10 .P
  11 You can use gc\-commit or gc\-multi\-commit to easily commit your changes from
  12 the GIT repository back into CVS without having to pass a GIT_DIR or a CVSROOT
  13 environment variable
  14 .SH "OPTIONS"
  15 .TP
  16 \-h
  17 Display a short help text
  18 .TP
  19 \-V
  20 Echos version information
  21 .TP
  22 \-v
  23 Turn on verbose output
  24 .TP
  25 \-d <dir>
  26 Directory of the newly created GIT repository
  27 .TP
  28 \-r <remote>
  29 The remote branch to import the CVS branches into (refs/remotes/<remote>/*).
  30 Default is \fIcvs\fR
  31 .TP
  32 \-u
  33 Usually git\-import adds the ".cvs" directory, into which
  34 the CVS checkout is created, to a .gitignore file.
  35 If you pass this option, the .gitignore won't be created.
  36 .TP
  37 \-gu
  38 convert underscores to dots during git\-cvsimport
  39 .TP
  40 \-gu
  41 pass --no-cvs-direct to cvsps if 'cvsps --cvs-direct' does not work
  42 such as the error "cvs_direct: protocol error reading version".
  43 .SH "EXAMPLES"
  44 .TP
  45 import a repository into the given directory
  46 .PP
  47 .RS 4
  48 .nf
  49 .B gc\-import \-d myproj.git \-m \-u :ext:foo@example.com:/csvroot myproject
  50 .B cd myproj.git
  51 //edit foo.c
  52 .B git commit
  53 Version feac8a commited
  54 .B gc\-commit \-c feac8a
  55 Import into cvs and commit if successfull
  56 .fi
  57 .PP
  58 .SH "EXIT STATUS"
  59 gc\-import returns zero on success. A non zero is returned in case of failure.
  60 .SH "AUTHOR"
  61 David Soria Parra (dsp (at) php.net)
  62 .SH "SEE ALSO"
  63 git\-cvsimport(1), gc\-commit(1), gc\-update(1)