Bazaar

bzr-svn explanation in users guide should say how to convert using bind and unbind

Bug #330372 reported by baxissimo
2
Affects Status Importance Assigned to Milestone
Bazaar
Confirmed
Medium
Unassigned
Breezy
Triaged
Low
Unassigned

Bug Description

The explanation here:
http://doc.bazaar-vcs.org/latest/en/user-guide/index.html#bzr-svn

made me nervous because it sounded to me like I would have to choose between two different styles of workflow up front and never be able to change that decision.

But thanks to some folks on #bzr I learned that there is no "lock-in". After you create bzr-svn repo of one type or the other, you can switch it to the other type quite easily using bzr bind and unbind. (And you can see which it currently is using bzr info).

After explaining the two different ways to use bzr-svn, I think it would be useful for the guide to explain that if you change your mind you can always switch later, and then explain how to do that.

Tags: bind doc
Revision history for this message
Jelmer Vernooij (jelmer) wrote :

This behaviour is in no way specific to bzr-svn, so I don't think this is something that should be mentioned in the bzr-svn part of the user-guide specifically. If it's unclear, this should rather be fixed in the general documentation of branches/checkouts.

Revision history for this message
baxissimo (wbaxter) wrote :

The bzr-svn section is one people are likely to jump straight to before they know all the ins and outs of bzr. I know because I'm a newbie who did just that. I read that section and then ended up going to irc because I wasn't sure how to find the answer to the question "can I change from one svn style of checkout to another?" Reading that section gave me no keywords I could use to find the answer.

I think it's fine to put the detailed explanations in the branches/checkouts section if you like, but then you need to include a link to the branches/checkouts section in the bzr-svn section. Right now there are precious few clues in the bzr-svn section about how to understand more about what the two commands mentioned actually do.

This is my advice as a newbie who knows SVN and Hg trying to understand how Bzr works. If you don't want to take this advice, that's your choice.

(I think you were one of the ones who answered my question on IRC... so thanks for that.)

Martin Pool (mbp)
tags: added: doc
Changed in bzr:
status: New → Confirmed
importance: Undecided → Medium
Jelmer Vernooij (jelmer)
tags: added: bind
Jelmer Vernooij (jelmer)
tags: added: check-for-breezy
Jelmer Vernooij (jelmer)
tags: removed: check-for-breezy
Changed in brz:
status: New → Triaged
importance: Undecided → Wishlist
importance: Wishlist → Low
To post a comment you must log in.
This report contains Public information  
Everyone can see this information.
Subscribing...

Other bug subscribers

Remote bug watches

Bug watches keep track of this bug in other bug trackers.