Version control with Subversion : "Next generation open source version control"--Cover

One of the greatest frustrations in most software projects is version control: the art of managing changes to information. Today's increasingly fast pace of software development--as programmers make small changes to software one day only to undo them the next--has only heightened the problem; consecutive work on code or single-programmer software is a rare sight these days. Without careful attention to version control, concurrent and collaborative work can create more headaches than it solves. This is where Subversion comes into play. Written by members of the Subversion open source development team, Version Control with Subversion introduces the powerful new versioning tool designed to be the successor to the Concurrent Version System or CVS. CVS users will find the "look and feel" Subversion comfortably familiar, but under the surface it's far more flexible, robust, and usable, and more importantly, it improves on CVS's more notable flaws. The book begins with a general introduction to Subversion, the basic concepts behind version control, and a guided tour of Subversion's capabilities and structure. With thorough attention to detail, the authors cover every aspect of installing and configuring Subversion for managing a programming project, documentation, or any other team-based endeavor. Later chapters cover the more complex topics of branching, repository administration, and other advanced features such as properties, externals, and access control. The book ends with reference material and appendices covering a number of useful topics such as a Subversion complete reference and troubleshooting guide. Version Control with Subversion aims to be useful to readers of widely different backgrounds, from those with no previous experience in version control to experienced sysadmins. If you've never used version control, you'll find everything you need to get started in this book. And if you're a seasoned CVS pro, this book will help you make a painless leap into Subversion. Version Control with Subversion......Page 3 Table of Contents......Page 4 Foreword......Page 11 How to Read this Book......Page 13 Icons......Page 14 Organization of This Book......Page 15 Acknowledgments......Page 16 From C. Michael Pilato......Page 17 Subversion's History......Page 18 Subversion's Features......Page 19 Subversion's Architecture......Page 20 Installing Subversion......Page 21 A Quick Start......Page 22 Versioning Models......Page 25 The Lock-Modify-Unlock Solution......Page 26 The Copy-Modify-Merge Solution......Page 28 Working Copies......Page 30 Revisions......Page 33 How Working Copies Track the Repository......Page 34 Mixed revisions are normal......Page 35 Summary......Page 36 Revision Numbers......Page 37 Revision Keywords......Page 38 Revision Dates......Page 39 Initial Checkout......Page 40 Update Your Working Copy......Page 42 Make Changes to Your Working Copy......Page 43 Examine Your Changes......Page 44 svn status......Page 45 svn diff......Page 47 svn revert......Page 49 Resolve Conflicts (Merging Others' Changes)......Page 50 Merging Conflicts by Hand......Page 51 Commit Your Changes......Page 53 Examining History......Page 54 svn log......Page 55 Examining Local Changes......Page 56 Comparing Repository to Repository......Page 57 svn list......Page 58 svn cleanup......Page 59 Summary......Page 60 Using Branches......Page 61 Creating a Branch......Page 63 Working with Your Branch......Page 65 Copying Changes Between Branches......Page 67 Copying Specific Changes......Page 68 The Key Concept Behind Merging......Page 70 Previewing Merges......Page 71 Merge Conflicts......Page 72 Noticing or Ignoring Ancestry......Page 73 Merging a Whole Branch to Another......Page 74 Undoing Changes......Page 76 Resurrecting Deleted Items......Page 77 Release Branches......Page 78 Feature Branches......Page 79 Switching a Working Copy......Page 80 Tags......Page 81 Creating a Complex Tag......Page 82 Repository Layout......Page 83 Data Lifetimes......Page 84 Summary......Page 85 Understanding Transactions and Revisions......Page 86 Repository Data Stores......Page 87 Berkeley DB......Page 88 Repository Creation and Configuration......Page 89 Hook Scripts......Page 91 svnlook......Page 94 svnadmin......Page 97 svndumpfilter......Page 98 Berkeley DB Utilities......Page 101 Repository Cleanup......Page 102 Managing Disk Space......Page 104 Repository Recovery......Page 105 Migrating a Repository......Page 106 Repository Backup......Page 110 Adding Projects......Page 111 Choosing a Repository Layout......Page 112 Creating the Layout, and Importing Initial Data......Page 113 Summary......Page 114 Overview......Page 115 Client Credentials Caching......Page 116 Invoking the Server......Page 118 Built-in authentication and authorization......Page 120 Set access controls......Page 121 SSH authentication and authorization......Page 122 Initial setup......Page 123 Controlling the invoked command......Page 124 Prerequisites......Page 125 Basic Apache Configuration......Page 126 Authentication Options......Page 127 Basic HTTP Authentication......Page 128 SSL Certificate Management......Page 129 Blanket Access Control......Page 131 Per-Directory Access Control......Page 132 Disabling Path-based Checks......Page 135 Repository Browsing......Page 136 Other Features......Page 137 Supporting Multiple Repository Access Methods......Page 138 Configuration Area Layout......Page 140 Configuration and the Windows Registry......Page 141 Servers......Page 142 Config......Page 144 Why Properties?......Page 146 Manipulating Properties......Page 147 Special Properties......Page 150 svn:ignore......Page 151 svn:keywords......Page 153 svn:eol-style......Page 156 svn:externals......Page 157 Locking......Page 158 Creating locks......Page 159 Breaking and stealing locks......Page 162 Lock Communication......Page 165 Peg and Operative Revisions......Page 166 Externals Definitions......Page 169 Vendor branches......Page 170 General Vendor Branch Management Procedure......Page 171 svn_load_dirs.pl......Page 173 Understanding locales......Page 174 Subversion's use of locales......Page 175 Using External Differencing Tools......Page 176 External diff......Page 177 External diff3......Page 178 Subversion Repository URLs......Page 179 Layered Library Design......Page 181 Repository Layer......Page 182 Repository Access Layer......Page 186 RA-DAV (Repository Access Using HTTP/DAV)......Page 187 RA-Local (Direct Repository Access)......Page 188 Client Layer......Page 189 URL and Path Requirements......Page 190 Using Languages Other than C and C++......Page 191 Inside the Working Copy Administration Area......Page 194 The Entries File......Page 195 WebDAV......Page 196 Programming with Memory Pools......Page 197 Join the Community......Page 199 Become Familiar with Community Policies......Page 200 Donate Your Changes......Page 201 svn Switches......Page 202 svn Subcommands......Page 205 svn add......Page 206 svn blame......Page 208 svn cat......Page 209 svn checkout......Page 211 svn cleanup......Page 213 svn commit......Page 214 svn copy......Page 216 svn delete......Page 219 svn diff......Page 221 svn export......Page 224 svn help......Page 226 svn import......Page 227 svn info......Page 229 svn list......Page 232 svn lock......Page 234 svn log......Page 236 svn merge......Page 240 svn mkdir......Page 242 svn move......Page 244 svn propdel......Page 246 svn propedit......Page 247 svn propget......Page 248 svn proplist......Page 250 svn propset......Page 252 svn resolved......Page 254 svn revert......Page 256 svn status......Page 258 svn switch......Page 262 svn unlock......Page 264 svn update......Page 266 svnadmin Switches......Page 267 svnadmin Subcommands......Page 268 svnadmin create......Page 269 svnadmin deltify......Page 270 svnadmin dump......Page 271 svnadmin help......Page 273 svnadmin hotcopy......Page 274 svnadmin list-dblogs......Page 275 svnadmin list-unused-dblogs......Page 276 svnadmin load......Page 277 svnadmin lslocks......Page 278 svnadmin lstxns......Page 279 svnadmin recover......Page 280 svnadmin rmlocks......Page 282 svnadmin rmtxns......Page 283 svnadmin setlog......Page 284 svnlook Switches......Page 285 svnlook......Page 286 svnlook author......Page 287 svnlook cat......Page 288 svnlook changed......Page 289 svnlook date......Page 290 svnlook diff......Page 291 svnlook dirs-changed......Page 292 svnlook help......Page 293 svnlook history......Page 294 svnlook info......Page 295 svnlook lock......Page 296 svnlook log......Page 297 svnlook propget......Page 298 svnlook proplist......Page 299 svnlook tree......Page 300 svnlook uuid......Page 301 svnserve Switches......Page 302 svnversion......Page 303 svnversion......Page 304 mod_dav_svn......Page 305 Subversion properties......Page 306 Subversion-defined properties......Page 307 Directory Versions......Page 309 Status......Page 310 Update......Page 311 Binary Files and Translation......Page 312 Converting a Repository from CVS to Subversion......Page 313 Original WebDAV......Page 315 Subversion and DeltaV......Page 316 Autoversioning......Page 317 Client Interoperability......Page 318 Microsoft Office, Dreamweaver, Photoshop......Page 319 Microsoft Web Folders......Page 320 WebDAV filesystem implementation......Page 321 Linux davfs2......Page 322 Appendix C. Third Party Tools......Page 323 Appendix D. Copyright......Page 324