← 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: John Arbash Meinel
  • Date: 2008-09-05 02:29:34 UTC
  • mto: (3697.7.4 1.7)
  • mto: This revision was merged to the branch mainline in revision 3748.
  • Revision ID: john@arbash-meinel.com-20080905022934-s8692mbwpkdwi106
Cleanups to the algorithm documentation.

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 --default-rich-root beagle-repo
 
33
  bzr init-repo --rich-root-pack 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 ``default-rich-root`` option to ``init-repo`` is
 
37
Note that using the ``rich-root-pack`` 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
 
  (hack, hack, hack)
 
43
  *changes*
44
44
  bzr commit -m "blah blah blah"
45
 
  (hack, hack, hack)
 
45
  *changes*
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
70
72
  bzr svn-import svn+ssh://svn.gnome.org/svn/beagle
71
73
 
72
74
Here's the recipe from above updated to use a central Bazaar mirror::
73
75
 
74
 
  bzr init-repo --default-rich-root beagle-repo
 
76
  bzr init-repo --rich-root-pack beagle-repo
75
77
  cd beagle-repo
76
78
  bzr branch bzr+ssh://bzr.gnome.org/beagle.bzr/trunk beagle-trunk
77
79
  bzr branch beagle-trunk beagle-feature1
78
80
  cd beagle-feature1
79
 
  (hack, hack, hack)
 
81
  *changes*
80
82
  bzr commit -m "blah blah blah"
81
 
  (hack, hack, hack)
 
83
  *changes*
82
84
  bzr commit -m "blah blah blah"
83
85
  cd ../beagle-trunk
84
86
  bzr pull
105
107
 
106
108
Bazaar and Subversion are different tools with different capabilities
107
109
so there will always be some limited interoperability issues.
108
 
Here are some examples current as of bzr-svn 0.5.4:
 
110
Here are some examples current as of bzr-svn 0.4.10:
109
111
 
110
112
 * Bazaar doesn't support versioned properties
111
113
 
112
114
 * Bazaar doesn't support tracking of file copies.
113
115
 
 
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
 
114
121
See the bzr-svn web page,
115
122
http://bazaar-vcs.org/BzrForeignBranches/Subversion,
116
123
for the current list of constraints.