# darcs-beta: a distributed, interactive, smart revision control system

[ deprecated, development ] [ Propose Tags ]
Deprecated. in favor of darcs
Versions 2.2.98.1, 2.2.98.2, 2.2.98.3, 2.2.98.4, 2.3.98.1, 2.3.98.2, 2.3.98.3, 2.3.99.2, 2.4.98.1, 2.4.98.2, 2.4.98.3, 2.4.98.4, 2.4.98.5, 2.4.99.1, 2.7.98.1, 2.7.98.2, 2.7.98.3, 2.7.99.1, 2.7.99.2 NEWS array (>=0.1 && <0.4), base (>=3 && <5), bytestring (>=0.9.0 && <0.10), containers (>=0.1 && <0.4), directory (==1.0.*), extensible‑exceptions (==0.1.*), filepath (==1.1.*), hashed‑storage (>=0.5.2 && <0.6), haskeline (>=0.6.2.2 && <0.7), html (==1.0.*), HTTP (>=3000.0 && <4000.1), HUnit (>=1.0), mmap (==0.5.*), mtl (>=1.0 && <1.2), network (==2.2.*), old‑time (==1.0.*), parsec (>=2.0 && <3.1), process (==1.0.*), QuickCheck (>=2.1.0.0), random (==1.0.*), regex‑compat (>=0.71 && <0.94), tar (==0.3.*), terminfo (==0.3.*), test‑framework (>=0.2.2), test‑framework‑hunit (>=0.2.2), test‑framework‑quickcheck2 (>=0.2.2), text (>=0.3), unix (>=1.0 && <2.5), unix‑compat (>=0.1.2), zlib (>=0.5.1.0 && <0.6.0.0) [details] LicenseRef-GPL David Roundy , Development http://darcs.net/ head: darcs get http://darcs.net/ by ReinierLamers at Sun Sep 5 18:18:02 UTC 2010 NixOS:2.7.99.2 unit, darcs, witnesses 6842 total (73 in the last 30 days) (no votes yet) [estimated by rule of succession] λ λ λ Docs uploaded by userBuild status unknown Hackage Matrix CI

Darcs is a free, open source revision control system. It is:

• Distributed: Every user has access to the full command set, removing boundaries between server and client or committer and non-committers.

• Interactive: Darcs is easy to learn and efficient to use because it asks you questions in response to simple commands, giving you choices in your work flow. You can choose to record one change in a file, while ignoring another. As you update from upstream, you can review each patch name, even the full "diff" for interesting patches.

• Smart: Originally developed by physicist David Roundy, darcs is based on a unique algebra of patches.

This smartness lets you respond to changing demands in ways that would otherwise not be possible. Learn more about spontaneous branches with darcs.

## Flags

NameDescriptionDefaultType
curl

Use libcurl for HTTP support.

EnabledAutomatic
http

Use the pure Haskell HTTP package for HTTP support.

EnabledAutomatic
static

Build static binary

DisabledAutomatic
terminfo

Use the terminfo package for enhanced console support.

EnabledAutomatic

EnabledAutomatic
type-witnesses

DisabledAutomatic
library

Build darcs library

EnabledAutomatic
color

Use ansi color escapes.

EnabledAutomatic
mmap

Compile with mmap support.

EnabledAutomatic
test

Compile unit tests (requires QuickCheck >= 2.1.0.0).

DisabledAutomatic
hpcDisabledAutomatic
deps-only

A cunning trick to have cabal install build dependencies

DisabledAutomatic

Use -f <flag> to enable a flag, or -f -<flag> to disable that flag. More info

#### Maintainer's Corner

For package maintainers and hackage trustees

[back to package description]
Darcs
=====
This is the source tree for darcs, a distributed version control system

http://www.darcs.net

Compilation and Installation
============================

Building Darcs requires the cabal package, version 1.6 or higher.  The
cabal-install package is also recommended.

Using GHC 6.10.3 or newer is STRONGLY RECOMMENDED. You can compile darcs with
GHC 6.8, but there are several caveats. If you are using 6.8.2 or older, please
disable mmap support (pass -f-mmap to cabal install or runghc Setup configure
below). Note that the GHC 6.8.2 that ships with Debian Lenny is not affected
and it should be safe to keep mmap enabled. It is also recommended to disable
use of Hackage zlib when compiling with GHC 6.8.2 (including the Debian Lenny
version): pass -f-zlib to cabal. When using zlib, we have seen occasional
crashes with error messages like "openBinaryFile: file locked" -- this is a
known GHC 6.8.2 bug (and is fixed in GHC 6.8.3). Last, if you are using a
64-bit system, darcs may hang when you exit a pager when compiled with GHC
older than 6.10.3. Although this is harmless, it is quite inconvenient.

If you have the "cabal-install" package on your system (that is, there is a
"cabal" executable in your path), you can use the following command to create
an executable in ~/.cabal/bin/darcs (this will also automatically fetch and
build dependencies from the Hackage server).

$cabal update$ cabal install

Otherwise, if you have the "cabal" package but not the "cabal-install"
package, run the following:

$runghc Setup configure$ runghc Setup build
\$ sudo runghc Setup install

You may also omit the last step and copy the darcs executable (found in
dist/build/darcs/darcs) to a location of your choosing.

More detailed instructions can be found at
including instructions on obtaining a copy of cabal-install.

Please also note that the cabal-based build by default requires the cURL
library (and development headers). If, for some reason, you cannot provide
cURL, please pass "-f-curl" to the configure step above.

Hacking
=======