Pragmatic Version Control Using Subversion

September 28, 2006 - 4 minute read -
subversion version-control

When I was in grade school I had to do a biographical book review every year. Probably 5 years, from 2nd grade to 7th grade we would be required to do book reviews and inevitably we'd have to do a biography. We'll, I hated biographies, so every year I would do the same person: Jacque Cousteau. So, I'm not going to do any biographies, but I will review some technical books that I read.

Pragmatic Version Control Using Subversion

Pragmatic Version Control Using Subversion by Mike Mason


  1. Introduction
  2. What is Version Control?
  3. Getting Started with Subversion
  4. How To...
  5. Common Subversion Commands
  6. File Locking and Binary Files
  7. Organizing Your Repository
  8. Using Tags and Branches
  9. Creating a Project
  10. Third-Party Code

This book is not written as an exhaustive reference of of all of the Subversion commands. For that you can use the Subversion Red Bean book. Instead, this book is written as a series of scripts and best practices that you can use on your project. It's more of a manual on how to use Subversion on an average project. I found this very helpful because it tackled the problems from a solution-oriented "why" approach, as opposed to merely a how approach.

Chapters 1 - 3

As would be expected, the early chapters offer a general introduction to the topic of the book. In the style of many of the Extreme Programming and Pragmatic Programmers books, these introduction include stories to illustrate the reasons and techniques that are outlined in more detail throughout the book. I find these stories to be very helpful because I think many people can identify with them.

Chapters 4 - 6

These chapters do a good job of covering the basics of source control. If you've been using source control such as Subversion or CVS, these chapters will likely not offer you a lot of new information. If you are new to using version control systems, then these chapters will give you a great overview of the basic day-to-day operations that you need to be an effective version control user.

Chapter 7

Chapter 7 is entirely devoted to file locking and binary files. While file locking is interesting in certain situations, I've never personally found the need for it. I guess this is a good chapter to skim just to know the possibilities in case you ever run across a situation where you need to lock binary files. If you're in a hurry, skip this one I guess.

Chapters 8 - 10

These chapters constituted some of the more interesting information in the book for me. They deal with the aspects of of source control that make it truly powerful. Branching, tagging and general project organization. Often people avoid using branching and tagging because it can be confusing. But this book lays out some really good strategies for leveraging these features.

I really liked the covering of using branching and tagging. In Subversion both of these operations are are performed using the same "svn copy" command. If both of these logical operations are performed using the same actual Subversion command, then why would you need to use both? Well these chapters answer this question well, for example, by laying out the use of tags to demarcate longer-running bug fix session for easy merging into the trunk or a release branch. I found these chapters to be the most interesting by far to someone who has used Subversion for a long time, but maybe hasn't utilized it to it's fullest extent (*ahem* that would be me probably).


Pragmatic Version Control does a great job of walking through the day-to-day tasks of using Subversion on a project. It covers the basics of updating, merging, committing, etc. It also offers some really good advice on branching and tagging (and the reasons to use both) for releases as well as for development reasons such as bug fixing. It also covers things such as dealing with vendor branches and dealing with shared projects by using svn:externals references to import other projects into your main subversion project.

There is also a version of this book written for CVS users. I'm a big fan of Subversion and so I would recommend any CVS users to seriously consider moving to Subversion. There is a great script cvs2svn that handles converting a CVS repository into a Subversion repository. It does a great job of collecting individual CVS file revisions into Subversion atomic commits. It also handles creating branches and tags for you so you won't lose any of your version history.

Pragmatic Version Control using Subversion - Mike Mason - ISBN: 0-9776166-5-7