Darcs
Jump to navigation
Jump to search
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.
darcs is a peer-to-peer revision control system, written in Haskell.
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
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.
Operations
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.
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
Patches
- darcs changes: show patches
- darcs send: make an email bundle from patches, and optionally send it
- 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.
Repositories
- darcs initialize: create a new empty repository
- darcs get: create a new empty repository and add patches from another repository