← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/en/user-guide/svn_plugin.txt

  • Committer: Canonical.com Patch Queue Manager
  • Date: 2009-08-27 02:27:19 UTC
  • mfrom: (4634.3.19 gc-batching)
  • Revision ID: pqm@pqm.ubuntu.com-20090827022719-bl2yoqhpj3fcfczu
(andrew) Fix #402657: 2a fetch over dumb transport reads one group at
        a time.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/en/user-guide/svn_plugin.txt
30
30
GNOME project like **beagle**. Firstly, setup a local shared repository
31
31
for storing your branches in and checkout the trunk::
32
32
 
33
 
  bzr init-repo --rich-root-pack beagle-repo
 
33
  bzr init-repo --default-rich-root beagle-repo
34
34
  cd beagle-repo
35
35
  bzr checkout svn+ssh://svn.gnome.org/svn/beagle/trunk beagle-trunk
36
36
 
37
 
Note that using the ``rich-root-pack`` option to ``init-repo`` is
 
37
Note that using the ``default-rich-root`` option to ``init-repo`` is
38
38
important as bzr-svn requires some extra metadata not yet supported in Bazaar's
39
39
default repository format. Next, create a feature branch and hack away::
40
40
 
41
41
  bzr branch beagle-trunk beagle-feature1
42
42
  cd beagle-feature1
43
 
  *changes*
 
43
  (hack, hack, hack)
44
44
  bzr commit -m "blah blah blah"
45
 
  *changes*
 
45
  (hack, hack, hack)
46
46
  bzr commit -m "blah blah blah"
47
47
 
48
48
When the feature is cooked, refresh your trunk mirror and merge
67
67
instead. bzr-svn provides the ``svn-import`` command for doing this
68
68
repository-to-repository conversion. Here's an example of how to use it::
69
69
 
70
 
  bzr init-repo --rich-root-pack beagle.bzr
71
 
  cd beagle.bzr
72
70
  bzr svn-import svn+ssh://svn.gnome.org/svn/beagle
73
71
 
74
72
Here's the recipe from above updated to use a central Bazaar mirror::
75
73
 
76
 
  bzr init-repo --rich-root-pack beagle-repo
 
74
  bzr init-repo --default-rich-root beagle-repo
77
75
  cd beagle-repo
78
76
  bzr branch bzr+ssh://bzr.gnome.org/beagle.bzr/trunk beagle-trunk
79
77
  bzr branch beagle-trunk beagle-feature1
80
78
  cd beagle-feature1
81
 
  *changes*
 
79
  (hack, hack, hack)
82
80
  bzr commit -m "blah blah blah"
83
 
  *changes*
 
81
  (hack, hack, hack)
84
82
  bzr commit -m "blah blah blah"
85
83
  cd ../beagle-trunk
86
84
  bzr pull
107
105
 
108
106
Bazaar and Subversion are different tools with different capabilities
109
107
so there will always be some limited interoperability issues.
110
 
Here are some examples current as of bzr-svn 0.4.10:
 
108
Here are some examples current as of bzr-svn 0.5.4:
111
109
 
112
110
 * Bazaar doesn't support versioned properties
113
111
 
114
112
 * Bazaar doesn't support tracking of file copies.
115
113
 
116
 
 * ``bzr push`` to an existing Subversion branch works but 
117
 
   ``bzr push`` to a new Subversion branch doesn't. Until
118
 
   the relevant bug is fixed (#121875), you need to use
119
 
   ``bzr svn-push`` in the latter case.
120
 
 
121
114
See the bzr-svn web page,
122
115
http://bazaar-vcs.org/BzrForeignBranches/Subversion,
123
116
for the current list of constraints.