Girish Mahajan (Editor)

Darcs

Updated on
Edit
Like
Comment
Share on FacebookTweet on TwitterShare on LinkedInShare on Reddit
Written in
  
Haskell

Type
  
Version control

Darcs

Developer(s)
  
Guillaume Hoffmann (and others)

Initial release
  
March 3, 2003; 13 years ago (2003-03-03)

Stable release
  
2.12.1 / September 5, 2016; 5 months ago (2016-09-05)

Operating system
  
Unix, Linux, BSD, Apple OS X, MS Windows

Darcs is a distributed version control system created by David Roundy. Key features include the ability to choose which changes to accept from other repositories, interaction with either other local (on-disk) repositories or remote repositories via SSH, HTTP, or email, and an unusually interactive interface. The developers also emphasize the use of advanced software tools for verifying correctness: the expressive type system of the functional programming language Haskell enforces some properties, and randomized testing via QuickCheck verifies many others. The name is a recursive acronym for Darcs Advanced Revision Control System.

Contents

Model

Darcs treats patches as first-class citizens. For the user, a repository can be seen as a set of patches, where each patch is not necessarily ordered with respect to other patches, i.e. the set of patches is only a partially ordered set. In many cases patches can be independently transmitted between various repositories.

Many branching, merging, and cherry-picking operations that would require additional commands with snapshot-based systems like Git or Mercurial can be directly done with Darcs with the usual "pull" and "push" commands. In terms of user interface, this means that Darcs has fewer commands. These commands are more interactive: one can choose more precisely which patches they want to exchange with remote repositories.

The patches of a repository are linearly ordered. Darcs automatically calculates whether patches can be reordered (an operation called commutation), and how to do it. These calculations implement a so-called "patch theory".

A Darcs patch can contain changes of the following kinds:

  • line changes,
  • file and directory creation and deletion,
  • file and directory moving,
  • word substitution (typically used in code refactoring, for instance rename all occurrences of "foo" to "bar" in a given file).
  • The notion of dependency between patches is defined syntactically. Intuitively, a patch B depends on another patch A if A provides the content that B modifies. This means that patches that modify different parts of the code are considered, by default, independent. To address cases when this is not desirable, Darcs enables the user to specify explicit dependencies between patches.

    Since version 2.10, Darcs uses patience diff by default.

    History

    Darcs evolved out of David Roundy's efforts to design a new patch format for GNU arch in June 2002. These discussions didn't lead to any code being committed to Arch, but did lead to the conception of the theory of patches. After writing an initial version of Darcs in C++, the Haskell version was written in Autumn 2002 and released to the public in April 2003. Darcs 2.0 was released in April 2008 and introduced a more robust repository format, as well as a new patch semantics called "darcs-2", aimed at minimizing exponential merge issues. The current development strategy focuses on implementing optimizations and adding new features, while maintaining the same repository format.

    Shortcomings

    Darcs has been criticized on the grounds of performance. One of the most notable issues was related to the merge algorithm in Darcs 1.x, which could do exponential work to merge some conflicts. Although the issue was not completely corrected in Darcs 2, the frequency of exponential merges has been reduced. Bugs still remain in which merging of recursive conflicts fails.

    References

    Darcs Wikipedia