Contents

• Introduction
  • Features
  • Switching from CVS
  • Switching from arch
  
  
• Building darcs
  • Prerequisites
  • Building on Mac OS X
  • Building on Microsoft Windows
  • Building from tarball
  • Building darcs from the repository
  • Submitting patches to darcs
  
  
• Getting started
  • Creating your repository
  • Making changes
  • Making your repository visible to others
  • Getting changes made to another repository
  • Moving patches from one repository to another
    • All pulls
    • Send and apply manually
    • Push
    • Push --apply-as
    • Sending signed patches by email
  • Reducing disk space usage
    • Linking between repositories
    • Alternate formats for the pristine tree
  
  
• Configuring darcs
  • prefs
  • Environment variables
  • General-purpose variables
  • Remote repositories
  • Highlighted output
  • Character escaping and non-ASCII character encodings
  
  
• Best practices
  • Introduction
  • Creating patches
    • Changes
    • Keeping or discarding changes
    • Unrecording changes
    • Special patches and pending
  • Using patches
    • Dependencies
    • Branches: just normal repositories
    • Moving patches around--no versions
    • Tags--versions
    • Conflicts
    • Resolving conflicts
  • Distributed development with one primary developer
  • Development by a small group of developers in one office
  • Personal development
    • Private patches
  
  
• Darcs commands
  • Common options to darcs commands
  • Options apart from darcs commands
  • Getting help
    • darcs help
  • Creating repositories
    • darcs initialize
    • darcs get
    • darcs put
  • Modifying the contents of a repository
    • darcs add
    • darcs remove
    • darcs mv
    • darcs replace
  • Working with changes
    • darcs record
    • darcs pull
    • darcs push
    • darcs send
    • darcs apply
  • Seeing what you've done
    • darcs whatsnew
    • darcs changes
    • darcs show
  • More advanced commands
    • darcs tag
    • darcs setpref
    • darcs check
    • darcs optimize
  • Undoing, redoing and running in circles
    • darcs amend-record
    • darcs rollback
    • darcs unrecord
    • darcs obliterate
    • darcs revert
    • darcs unrevert
  • Advanced examination of the repository
    • darcs diff
    • darcs annotate
    • darcs show
  • Rarely needed and obscure commands
    • darcs convert
    • darcs mark-conflicts
    • darcs dist
    • darcs trackdown
    • darcs repair
  
  
• Theory of patches
  • Background
  • Introduction
  • Applying patches
    • Hunk patches
    • Token replace patches
  • Patch relationships
  • Commuting patches
    • Composite patches
    • How merges are actually performed
  • Conflicts
  • Patch string formatting
  
  
• DarcsRepo format
• The GNU General Public License
  • Appendix: How to Apply These Terms to Your New Programs