git.oblomov.eu Git - git/blob - Documentation/git-remote-bzr.txt

   1 git-remote-bzr(1)
   2 ================
   3
   4 NAME
   5 ----
   6 git-remote-bzr - bidirectional bridge between Git and Bazaar
   7
   8
   9 SYNOPSIS
  10 --------
  11 [verse]
  12 'git clone' bzr::<bzr repository>
  13
  14
  15 DESCRIPTION
  16 -----------
  17
  18 This tool allows you to transparently clone, fetch and push to and from Bazaar
  19 repositories as if they were Git ones.
  20
  21 To use it you simply need to use the "'bzr::'" prefix when specifying a remote URL
  22 (e.g. when cloning).
  23
  24
  25 EXAMPLE
  26 -------
  27 --------------------------------------
  28 git clone bzr::lp:ubuntu/hello
  29 --------------------------------------
  30
  31
  32 NOTES
  33 -----
  34
  35 Remember to run `git gc --aggressive` after cloning a repository, specially if
  36 it's a big one. Otherwise lots of space will be wasted.
  37
  38 The oldest version of Bazaar supported is 2.0. Older versions are not tested.
  39
  40 Branches vs. repositories
  41 ~~~~~~~~~~~~~~~~~~~~~~~~~
  42
  43 Bazaar's UI can clone only branches, but a repository can contain multiple
  44 branches, and 'git-remote-bzr' can clone both.
  45
  46 For example, to clone a branch:
  47
  48 -------------------------------------
  49 git clone bzr::bzr://bzr.savannah.gnu.org/emacs/trunk emacs-trunk
  50 -------------------------------------
  51
  52 And to clone the whole repository:
  53
  54 -------------------------------------
  55 git clone bzr::bzr://bzr.savannah.gnu.org/emacs emacs
  56 -------------------------------------
  57
  58 The second command would clone all the branches contained in the emacs
  59 repository, however, it's possible to specify only certain branches:
  60
  61 -------------------------------------
  62 git config remote-bzr.branches 'trunk, xwindow'
  63 -------------------------------------
  64
  65 Some remotes don't support listing the branches contained in the repository, in
  66 which cases you need to manually specify the branches, and while you can
  67 specify the configuration in the clone command, you might find this easier:
  68
  69 -------------------------------------
  70 git init emacs
  71 git remote add origin bzr::bzr://bzr.savannah.gnu.org/emacs
  72 git config remote-bzr.branches 'trunk, xwindow'
  73 git fetch
  74 -------------------------------------