~bzr/bzr/bzr.1.5

« back to all changes in this revision

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

  • Committer: Canonical.com Patch Queue Manager
  • Date: 2008-05-16 18:09:11 UTC
  • mfrom: (3421.1.1 jam-integration)
  • Revision ID: pqm@pqm.ubuntu.com-20080516180911-jm273stya26f1rxj
(igc) Updates to the user guide

Show diffs side-by-side

added added

removed removed

Lines of Context:
19
19
this is a common interim step for teams looking to adopt Bazaar but
20
20
who are unable to do so yet for timing or non-technical reasons.
21
21
 
 
22
For installation instructions, see the bzr-svn home page:
 
23
http://bazaar-vcs.org/BzrForeignBranches/Subversion.
 
24
 
22
25
 
23
26
A simple example
24
27
----------------
62
65
to import the Subversion repository into a Bazaar one once and for all
63
66
for your project, and then branch from that native Bazaar repository
64
67
instead. bzr-svn provides the ``svn-import`` command for doing this
65
 
repository-to-repository conversion. See ``bzr help svn-import`` for details.
 
68
repository-to-repository conversion. Here's an example of how to use it::
 
69
 
 
70
  bzr init-repo --rich-root-pack beagle.bzr
 
71
  cd beagle.bzr
 
72
  bzr svn-import svn+ssh://svn.gnome.org/svn/beagle
66
73
 
67
74
Here's the recipe from above updated to use a central Bazaar mirror::
68
75
 
69
76
  bzr init-repo --rich-root-pack beagle-repo
70
77
  cd beagle-repo
71
 
  bzr branch bzr+ssh://bzr.gnome.org/bzr/beagle/trunk beagle-trunk
 
78
  bzr branch bzr+ssh://bzr.gnome.org/beagle.bzr/trunk beagle-trunk
72
79
  bzr branch beagle-trunk beagle-feature1
73
80
  cd beagle-feature1
74
81
  *changes*
79
86
  bzr pull
80
87
  bzr merge ../beagle-feature1
81
88
  bzr commit -m "Complete comment for SVN commit"
82
 
  bzr svn-push
 
89
  bzr push
83
90
 
84
91
In this case, committing to the trunk only commits the merge locally.
85
92
To commit back to the master Subversion trunk, an additional command
86
 
(``bzr svn-push``) is required.
 
93
(``bzr push``) is required.
87
94
 
88
 
Note: You'll need to give ``pull and ``svn-push`` the relevant URLs
 
95
Note: You'll need to give ``pull and ``push`` the relevant URLs
89
96
the first time you use those commands in the trunk branch. After that,
90
97
bzr remembers them.
91
98
 
100
107
 
101
108
Bazaar and Subversion are different tools with different capabilities
102
109
so there will always be some limited interoperability issues.
103
 
Here are some examples current as of bzr-svn 0.49:
 
110
Here are some examples current as of bzr-svn 0.4.10:
104
111
 
105
112
 * Bazaar doesn't support versioned properties
106
113
 
107
 
 * Renames are not correctly communicated.
 
114
 * Bazaar doesn't support tracking of file copies.
 
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.
108
120
 
109
121
See the bzr-svn web page,
110
122
http://bazaar-vcs.org/BzrForeignBranches/Subversion,