Pragmatic Version Control with CVS

I've been grappling with the Concurrent Versioning System (CVS) for years. Moreover, I've been misusing it. Baffled and intimidated by its cryptic syntax and concepts, I've missed out on the power of branching and tagging, and the way these tools can be used to clearly demarcate project releases and versions. Using CVS as little more than a safer place to keep code than a local hard drive and an easier way to pass code around than FTP, I and my teams have failed to benefit from version control's true purpose. Checking code into the mainline only, we've found ourselves holding off on writing or checking in new code while a release is underway, and being forced to add new, untested code to a stable past release in order to fix a bug. CVS's documentation has never helped matters. The free online manuals (aka "The Fish Book", "The Cederqvist", etc.) are classics and miss no detail documenting CVS's complex and option-laden commands, but say little about what exactly to do with the commands in order to run a successful software project. Other commercial CVS books essentially have been longer-form rewrites of the original manuals. And through it all, CVS's syntax has remained complex and intimidating. Along comes Pragmatic Version Control Using CVS. With clarity, brevity, and humor, its authors show that version control can and must be the centerpiece of any development process, and they show how to make the humble, aging CVS work as that centerpiece. Taking the successful 80/20 approach, they cover only the features necessary to support the important things in software project execution: maintaining separate versions, marking releases and bug fixes, merging fixes to an old release into the latest version, and even bonus topics like managing third-party code. They take an Occam's Razor to CVS's syntax, leaving you with a small, essential slice that's easy to remember and use. Alongside this syntax, the authors suggest idioms, naming conventions, and techniques. What you end up with is the bare bones of how to run a software project. You start to feel like you're not even using CVS - that you could be using any version control system. The syntax becomes secondary and the process takes center stage. Here is a summary of their approach: (1) Develop on the mainline; (2) Branch only from the mainline, and only when you're ready to put out a release (or experiment with some great departure from the current codebase); (3) Tag the branch when the release is done; (4) Return to the branch to fix a post-release bug; (5) Tag the branch before and after the bug fix; (6) Merge the bug fix back into the mainline; (7) Get back to work on the mainline; (8) Go home at a reasonable hour. In between all these steps, part of your team can work on the latest version while others launch or patch a release. Old work will not impede new work; new work will not pollute old work. The authors put the "concurrent" back into "CVS." That's the undergirding of a solid de

I had already started trying to use CVS (on OpenBSD) and had run into problems. Reading this book flattened out the CVS learning curve. It showed me how to perform CVS-related tasks that come up frequently, and helped me comprehend why I had previously been having trouble. I read most of the book in one day. Definitely a keeper!

I read this book cover-to-cover in two days. Don't mistake this as the book being lightweight. This book captures the essentials for using CVS in small, medium, and large projects. I've used CVS since 1997 in various aspects. In my experience, the authors present material that I've learned over the last eight years in an easy-to-read and easy-to-digest format. They touch on the basics, but the basics are really all many organizations need. I have been involved with projects where complex branching and tagging schemes were devised, which makes it hard to focus on actually writing code; you spend too much time dealing with bookkeeping, etc. The authors provide a no-nonsense way of using branches and tags that makes sense and is easy to grasp. This book is no replacement for some of the other CVS books out there that tend to focus on all aspects of CVS (administartion, coding, etc.) but if all you want is a great introduction to 97% of what you need to know as a developer, then get this book!

(The following is an excerpt of a review of "The Pragmatic Starter Kit" I posted at JavaRanch.) Authors, David Thomas and Andrew Hunt, smashed a home run with their book, "Pragmatic Version Control Using CVS" - the first volume in the three part "The Pragmatic Starter Kit" series. Using easy to read explanations, examples and stories, this book clearly explains what version control is, how it works, why folks are using it, how CVS works, and what commands developers are using during the life of their projects. "Pragmatic Version Control Using CVS" provides the semantics and idioms behind the syntax found in the CVS Manual. Before reading this book, I was a timid CVS user, willing to do little more than check code out. Now, after reading the book, I check code out and in, branch, merge and resolve conflicts with confidence. I'd recommend this book to any developer using a version control system that wouldn't already describe themselves as Zen masters in the craft, and to any developer not already using a version control system.

Hunt and Thomas, "The Pragmatic Programmers", provide a delightfully brief user's guide for the Concurrent Version System (CVS). They focus on idiomatic usage patterns, leading the way from installing CVS and creating a first project to branching for releases and developer sandboxes. They provide practical advice on when to branch, how to comment, what constitutes a project, and even what to check into CVS in the first place. I've been using CVS for years, and learned a lot here; especially about the various kinds of diff reporting and configuration options.Almost everyone is confused by CVS first. Almost everyone who gets over the learning curve swears by it (or some variant). The main adoption hurdle is the unix-style documentation that provides telegraphic explanations of commands in insider jargon. Hunt and Thomas explain what it all means, and more importantly, how to use it, and why to use it. Complex relationships like merge conflicts are illustrated with clear diagrams and sensible easy-to-follow examples. Even though I see myself using this book quite a bit, I could've used it even more when I was getting started, before CVS became second nature.