Personal tools

Darcs

From HaskellWiki

Revision as of 07:24, 23 August 2006 by Ashley Y (Talk | contribs)

Jump to: navigation, search

darcs is a peer-to-peer revision control system, written in Haskell.

Contents

1 Understanding darcs

You can think of a darcs repository as containing these things:

  • Patches: a patch is a collection of changes that forms the unit of synchronisation with other repositories
  • Unrecorded changes to known files and directories
  • Unknown items (files and directories)
  • Boring items: anything with a name matched in _darcs/prefs/boring
  • The unrevert cache of changes

Note that some projects are keen on making sure all derivative items are "boring" rather than merely unknown items that will show up with darcs wh -l. Other projects less so.

2 Operations

2.1 Unknown items

  • darcs whatsnew -l: show changes and unknown items
  • creating a item: add item to the unknown items.
  • darcs add: convert the unknown item into a change to create the item and its contents
  • darcs remove: add a change to empty the item and delete it but keep it as an unknown item.

2.2 Changes

  • darcs whatsnew: show unrecorded changes
  • removing an item: add a change to remove the item
  • editing a file: add a change for the edit
  • darcs mv: add a change to move an item
  • darcs replace: add a change to replace text in a file
  • darcs record: record changes to add a patch
  • darcs unrecord: remove a patch by turning back it into unrecorded changes
  • darcs amend-record: replace a patch with one with added changes
  • darcs revert: remove changes

2.3 Patches

  • darcs changes: show patches
  • darcs send --output=FILE: make an email bundle from patches
  • darcs send --to=ADDRESS: send an email bundle from patches
  • darcs pull: add patches from another repository
  • darcs push: add patches from this repository to another repository
  • darcs apply: add patches from an email bundle
  • darcs rollback: add a patch that is the inverse of an existing patch
  • darcs obliterate: remove a patch. Warning: if the patch doesn't exist elsewhere, you will lose that work.
  • darcs tag: add a tag for the current set of patches

2.4 Repositories

  • darcs initialize: create a new empty repository
  • darcs get: create a new empty repository and add patches from another repository

3 External link