← 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: Lukáš Lalinský
  • Date: 2008-08-23 13:06:24 UTC
  • mto: (3650.1.1 bzr.ab.integration)
  • mto: This revision was merged to the branch mainline in revision 3651.
  • Revision ID: lalinsky@gmail.com-20080823130624-rvbasutb8urxkamy
Add a test

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/en/user-guide/svn_plugin.txt
20
20
who are unable to do so yet for timing or non-technical reasons.
21
21
 
22
22
For installation instructions, see the bzr-svn home page:
23
 
http://wiki.bazaar.canonical.com/BzrForeignBranches/Subversion.
 
23
http://bazaar-vcs.org/BzrForeignBranches/Subversion.
24
24
 
25
25
 
26
26
A simple example
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 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
 
Next, create a feature branch and hack away::
 
37
Note that using the ``rich-root-pack`` option to ``init-repo`` is
 
38
important as bzr-svn requires some extra metadata not yet supported in Bazaar's
 
39
default repository format. Next, create a feature branch and hack away::
38
40
 
39
41
  bzr branch beagle-trunk beagle-feature1
40
42
  cd beagle-feature1
41
 
  (hack, hack, hack)
 
43
  *changes*
42
44
  bzr commit -m "blah blah blah"
43
 
  (hack, hack, hack)
 
45
  *changes*
44
46
  bzr commit -m "blah blah blah"
45
47
 
46
48
When the feature is cooked, refresh your trunk mirror and merge
65
67
instead. bzr-svn provides the ``svn-import`` command for doing this
66
68
repository-to-repository conversion. Here's an example of how to use it::
67
69
 
 
70
  bzr init-repo --rich-root-pack beagle.bzr
 
71
  cd beagle.bzr
68
72
  bzr svn-import svn+ssh://svn.gnome.org/svn/beagle
69
73
 
70
74
Here's the recipe from above updated to use a central Bazaar mirror::
71
75
 
72
 
  bzr init-repo beagle-repo
 
76
  bzr init-repo --rich-root-pack beagle-repo
73
77
  cd beagle-repo
74
78
  bzr branch bzr+ssh://bzr.gnome.org/beagle.bzr/trunk beagle-trunk
75
79
  bzr branch beagle-trunk beagle-feature1
76
80
  cd beagle-feature1
77
 
  (hack, hack, hack)
 
81
  *changes*
78
82
  bzr commit -m "blah blah blah"
79
 
  (hack, hack, hack)
 
83
  *changes*
80
84
  bzr commit -m "blah blah blah"
81
85
  cd ../beagle-trunk
82
86
  bzr pull
103
107
 
104
108
Bazaar and Subversion are different tools with different capabilities
105
109
so there will always be some limited interoperability issues.
106
 
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:
107
111
 
108
112
 * Bazaar doesn't support versioned properties
109
113
 
110
114
 * Bazaar doesn't support tracking of file copies.
111
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
 
112
121
See the bzr-svn web page,
113
 
http://wiki.bazaar.canonical.com/BzrForeignBranches/Subversion,
 
122
http://bazaar-vcs.org/BzrForeignBranches/Subversion,
114
123
for the current list of constraints.