bk fast-export(7.3ce-rc1)   BitKeeper User's Manual  bk fast-export(7.3ce-rc1)

NAME
       bk fast-export - export the repository in a format compatible with git

SYNOPSIS
       bk fast-export <options>

DESCRIPTION
       bk  fast-export  exports the entire repository in a format suitable for
       input to git's fast-import command. The output is sent to standard out-
       put.

       By  default  the  BitKeeper  MD5KEY of the equivalent changeset will be
       added to every commit in git.

OPTIONS
       -A<filename>
       --authors=<filename> Use the given file as a map for authors. The  syn-
                            tax is compatible with git cvsimport:

                                USER = Name <email@domain.com>

                            With one user per line.
       --branch=<branch>    By  default  the export will be done for the "mas-
                            ter" git branch.  This  option  lets  you  do  the
                            export  for a different branch. This is useful for
                            exporting two different BitKeeper  branches  (e.g.
                            "dev"  and "stable") into the same git repository.
                            See SUGGESTED USE below.
       --incremental=<repo> Do an incremental export starting  from  the  last
                            exported  cset found in the Git repository <repo>.
                            This will not work if  the  previous  export  used
                            --no-bk-keys.
       --no-bk-keys         Don't  add  the  "bk: <mk5key>" line at the end of
                            the comments (incompatible with --incremental).
       -q
       --quiet              Don't print warnings or other information.
       -S
       --standalone         When used in a nested collection, export only  the
                            product  or  the  component implied by the current
                            working directory.

EXAMPLES
       The commands to export a BitKeeper repository named "bk-repo" to a  git
       repository named "git-repo" would be:

           $ git init git-repo
           $ (cd bk-repo; bk fast-export) | (cd git-repo ; git fast-import)

       And to do an incremental export later:

           $ (cd bk-repo; bk fast-export --incremental=../git-repo) | \
             (cd git-repo ; git fast-import)

SUGGESTED USE
       It  is  suggested that you create a pristine import branch where no git
       commits are created. By default, fast-export warns if the latest commit
       in  the  import  branch  is not marked with a BitKeper key (This can be
       disabled with the --quiet option).

       For example, if you have two separate BitKeeper  branches:  'dev',  and
       'stable',  you  can import each of them into corresponding git branches
       and pass the appropriate --branch option to fast-export each  time.  If
       the git repository is also being developed, this can be done in a sepa-
       rate git branch (e.g. 'master').

EXIT STATUS
       bk fast-export returns exit status 0 if the export  completed  success-
       fuly. Non-zero if there was an error.

SEE ALSO
       bk fast-import

CATEGORY
       Utility

BitKeeper Inc                         1E1            bk fast-export(7.3ce-rc1)