
Version Control with Subversion For Subversion 1.5 (Compiled from r3305) Ben Collins-Sussman Brian W. Fitzpatrick C. Michael Pilato Version Control with Subversion: For Subversion 1.5: (Compiled from r3305) by Ben Collins-Sussman, Brian W. Fitzpatrick, and C. Michael Pilato Published (TBA) Copyright © 2002, 2003, 2004, 2005, 2006, 2007, 2008 Ben Collins-SussmanBrian W. FitzpatrickC. Michael Pilato This work is licensed under the Creative Commons Attribution License. To view a copy of this license, visit ht- tp://creativecommons.org/licenses/by/2.0/ or send a letter to Creative Commons, 559 Nathan Abbott Way, Stan- ford, California 94305, USA. Table of Contents Foreword ..........................................................................................................xii Preface ............................................................................................................xiv Audience ..................................................................................................xiv How to Read This Book ..............................................................................xv Conventions Used in This Book ..................................................................xv Organization of This Book ......................................................................... xvi This Book Is Free .................................................................................... xvii Acknowledgments .................................................................................... xvii From Ben Collins-Sussman ............................................................. xviii From Brian W. Fitzpatrick .................................................................. xix From C. Michael Pilato ...................................................................... xix What Is Subversion? ................................................................................. xix Is Subversion the Right Tool? .............................................................xx Subversion's History ..........................................................................xx Subversion's Architecture .................................................................. xxi Subversion's Components ................................................................ xxii What's New in Subversion ............................................................... xxiii 1. Fundamental Concepts ................................................................................... 1 The Repository ........................................................................................... 1 Versioning Models ...................................................................................... 1 The Problem of File Sharing ................................................................ 2 The Lock-Modify-Unlock Solution ......................................................... 2 The Copy-Modify-Merge Solution ......................................................... 4 Subversion in Action ................................................................................... 7 Subversion Repository URLs ............................................................... 7 Working Copies .................................................................................. 8 Revisions ......................................................................................... 10 How Working Copies Track the Repository ......................................... 12 Mixed Revision Working Copies ......................................................... 13 Summary ................................................................................................. 14 2. Basic Usage ................................................................................................. 15 Help! ........................................................................................................ 15 Getting Data into Your Repository .............................................................. 15 svn import ........................................................................................ 16 Recommended Repository Layout ..................................................... 16 Initial Checkout ......................................................................................... 16 Disabling Password Caching ............................................................. 18 Authenticating As a Different User ..................................................... 19 Basic Work Cycle ..................................................................................... 19 Update Your Working Copy ............................................................... 19 Make Changes to Your Working Copy ................................................ 20 Examine Your Changes .................................................................... 21 Undoing Working Changes ................................................................ 24 Resolve Conflicts (Merging Others' Changes) ..................................... 25 Commit Your Changes ...................................................................... 31 Examining History ..................................................................................... 32 Generating a List of Historical Changes .............................................. 32 Examining the Details of Historical Changes ....................................... 34 Browsing the Repository ................................................................... 35 Fetching Older Repository Snapshots ................................................ 36 Sometimes You Just Need to Clean Up ...................................................... 37 Disposing of a Working Copy ............................................................. 37 Recovering from an Interruption ......................................................... 37 Summary ................................................................................................. 38 3. Advanced Topics .......................................................................................... 39 Revision Specifiers ................................................................................... 39 iv Version Control with Subversion Revision Keywords ........................................................................... 39 Revision Dates ................................................................................. 40 Properties ................................................................................................ 41 Why Properties? ............................................................................... 42 Manipulating Properties ..................................................................... 43 Properties and the Subversion Workflow ............................................ 46 Automatic Property Setting ................................................................ 47 File Portability ........................................................................................... 48 File Content Type ............................................................................. 48 File Executability ............................................................................... 50 End-of-Line Character Sequences ..................................................... 50 Ignoring Unversioned Items ....................................................................... 51 Keyword Substitution ................................................................................ 55 Sparse Directories .................................................................................... 58 Locking .................................................................................................... 61 Creating Locks ................................................................................. 63 Discovering Locks ............................................................................. 65 Breaking and Stealing Locks ............................................................. 66 Lock Communication ........................................................................ 68 Externals Definitions ................................................................................. 69 Peg and Operative Revisions .................................................................... 72 Changelists .............................................................................................. 76 Creating and Modifying Changelists ................................................... 77 Changelists As Operation Filters ........................................................ 78 Changelist Limitations ....................................................................... 80 Network Model ......................................................................................... 80 Requests and Responses ................................................................. 80 Client Credentials Caching ................................................................ 81 Summary ................................................................................................. 83 4. Branching and Merging ................................................................................. 84 What's a Branch? ..................................................................................... 84 Using Branches ........................................................................................ 85 Creating a Branch ............................................................................. 86 Working
Details
-
File Typepdf
-
Upload Time-
-
Content LanguagesEnglish
-
Upload UserAnonymous/Not logged-in
-
File Pages407 Page
-
File Size-