gc-update.1

   1 .TH gc\-update 1 "March 30, 2008" "version $VERSION$" "USER COMMANDS"
   2 .sh NAME
   3 gc\-update \- Update a GIT repository that was imported with gc-import
   4 .SH SYNOPSIS
   5 .B gc\-update
   6 [\-h] [\-V] [\-v] [\-cn] [\-m]
   7 .SH DESCRIPTION
   8 Updates a GIT repository that was previously imported using gc\-import.
   9 .P
  10 By default gc\-update tries to rebase the branch that tracks the CVS onto the
  11 \fImaster\fR branch, but you can specify the -m option to use merge. Using merge
  12 might result in duplicated commits if you try to reimport commits that were
  13 previously exported from the same repository into CVS, because the timestamps
  14 and email addresses will differ and therefore a different commit is
  15 generated and merged.
  16 .P
  17 Before gc\-update merges or rebases, it stashes away the current changes.
  18 .SH OPTIONS
  19 .TP
  20 \-h
  21 Display a short help text
  22 .TP
  23 \-V
  24 Echos version information
  25 .TP
  26 \-v
  27 Turn on verbose output
  28 .TP
  29 \-cn
  30 Do not run \fIcvs update\fR in the CVS working copy (.cvs/)
  31 .TP
  32 \-m
  33 Merge the cvs branch and the master branch instead of rebase them
  34 .SH EXAMPLES
  35 .TP
  36 Update a given GIT repository from CVS:
  37 .PP
  38 .RS 4
  39 .nf
  40 .B gc\-import \-d myproj.git \-m \-u :ext:foo@example.com:/csvroot myproject
  41 // importing..
  42 .B cd myproj.git
  43 // somebody commited into the example.com CVS
  44 // fetch whats changed
  45 .B gc\-update
  46 // git repository is now up to date
  47 .fi
  48 .PP
  49 .SH EXIT STATUS
  50 gc\-update returns zero on success. A non zero value is returned in case of failure.
  51 .SH AUTHOR
  52 David Soria Parra (dsp (at) php.net)
  53 .SH SEE ALSO
  54 git\-cvsimport(1), git\-rebase(1)