This text is a work in progress—highly subject to change—and may not accurately describe any released version of the Apache™ Subversion® software. Bookmarking or otherwise referring others to this page is probably not such a smart idea. Please visit http://www.svnbook.com/ for stable versions of this book.
We covered a lot of ground in this chapter. We discussed the concepts of tags and branches and demonstrated how Subversion implements these concepts by copying directories with the svn copy command. We showed how to use svn merge to copy changes from one branch to another or roll back bad changes. We went over the use of svn switch to create mixed-location working copies. And we talked about how one might manage the organization and lifetimes of branches in a repository.
Remember the Subversion mantra: branches and tags are cheap. So don't be afraid to use them when needed!
As a helpful reminder of all the operations we discussed, here is handy reference table you can consult as you begin to make use of branches.
Table 4.1. Branching and merging commands
Action | Command |
---|---|
Create a branch or tag |
svn copy
|
Switch a working copy to a branch or tag |
svn switch
|
Synchronize a branch with trunk |
svn merge
|
See merge history or eligible changesets |
svn mergeinfo
|
Merge a branch back into trunk |
svn merge
|
Merge one specific change |
svn merge -c
|
Merge a range of changes |
svn merge -r
|
Block a change from automatic merging |
svn merge -c
|
Preview a merge |
svn merge
|
Abandon merge results |
svn revert -R .
|
Resurrect something from history |
svn copy
|
Undo a committed change |
svn merge -c -
|
Examine merge-sensitive history |
svn log -g; svn blame -g
|
Create a tag from a working copy |
svn copy .
|
Rearrange a branch or tag |
svn move
|
Remove a branch or tag |
svn delete
|