darcs: a distributed, interactive, smart revision control system

[ development, gpl, library ] [ Propose Tags ]

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.


[Skip to Readme]

Modules

[Index]

Flags

Automatic Flags
NameDescriptionDefault
curl

Use libcurl for HTTP support.

Enabled
http

Use the pure Haskell HTTP package for HTTP support.

Enabled
network-uri

Get Network.URI from the network-uri package

Enabled
static

Build static binary

Disabled
terminfo

Use the terminfo package for enhanced console support.

Enabled
threaded

Use threading and SMP support.

Enabled
library

Build darcs library

Enabled
executable

Build darcs executable

Enabled
color

Use ansi color escapes.

Enabled
mmap

Compile with mmap support.

Enabled
hpcDisabled
test

Build test harness

Disabled
optimize

Build with optimizations (-O2)

Enabled
warn-as-error

Build with warnings-as-errors

Disabled
force-char8-encoding

Allow base 4.5 or above on Unix. base 4.4 introduces a change in the behaviour of filenames that requires API calls in base 4.5 to workaround. So base 4.4 is not supported at all.

Disabled
libiconv

Explicitly link against the libiconv library.

Disabled

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

Downloads

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Candidates

Versions [RSS] 2.1.2.1, 2.1.2.2, 2.1.98.2, 2.1.99.0, 2.2.0, 2.2.1, 2.3.0, 2.3.1, 2.4, 2.4.1, 2.4.3, 2.4.4, 2.5, 2.5.1, 2.5.2, 2.8.0, 2.8.1, 2.8.2, 2.8.3, 2.8.4, 2.8.5, 2.10.0, 2.10.1, 2.10.2, 2.10.3, 2.12.0, 2.12.1, 2.12.2, 2.12.3, 2.12.4, 2.12.5, 2.14.0, 2.14.1, 2.14.2, 2.14.3, 2.14.4, 2.14.5, 2.16.1, 2.16.2, 2.16.3, 2.16.4, 2.16.5, 2.18.1, 2.18.2, 2.18.3
Change log NEWS
Dependencies array (>=0.1 && <0.6), base (>=4 && <4.8), bytestring (>=0.9.0 && <0.11), cmdlib (>=0.2.1 && <0.4), containers (>=0.1 && <0.6), directory (>=1.0.0.0 && <1.3.0.0), extensible-exceptions (>=0.1 && <0.2), filepath (>=1.1.0.0 && <1.5.0.0), FindBin (>=0.0 && <0.1), hashed-storage (>=0.5.6 && <0.6), haskeline (>=0.6.3 && <0.8), html (>=1.0 && <1.1), HTTP (>=4000.0.8 && <4000.3), HUnit (>=1.0), mmap (>=0.5 && <0.6), mtl (>=1.0 && <2.3), network (>=2.2), network-uri (>=2.6), old-time (>=1.0 && <1.2), parsec (>=2.0 && <3.2), process (>=1.0.0.0 && <1.3.0.0), QuickCheck (>=2.3), random (>=1.0 && <1.1), regex-compat (>=0.95.1), regex-posix (>=0.95.1), shellish (>=0.1.3 && <0.2), tar (>=0.3 && <0.5), terminfo (>=0.3 && <0.4), test-framework (>=0.4.0), test-framework-hunit (>=0.2.2), test-framework-quickcheck2 (>=0.2.8), text (>=0.11.0.6 && <1.2), unix (>=1.0 && <2.8), unix-compat (>=0.1.2), utf8-string (>=0.3.6 && <0.4), vector (>=0.7), Win32 (>=2.0), zlib (>=0.5.1.0 && <0.6.0.0) [details]
License LicenseRef-GPL
Author David Roundy <droundy@darcs.net>, <darcs-devel@darcs.net>
Maintainer <darcs-devel@darcs.net>
Category Development
Home page http://darcs.net/
Source repo head: darcs get http://darcs.net/
Uploaded by GaneshSittampalam at 2014-08-25T20:34:31Z
Distributions Arch:2.18.2, Debian:2.14.5, Fedora:2.16.5, FreeBSD:2.10.1, NixOS:2.18.3
Reverse Dependencies 2 direct, 0 indirect [details]
Executables darcs-test, darcs
Downloads 52445 total (215 in the last 30 days)
Rating 2.5 (votes: 3) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs available [build log]
Successful builds reported [all 1 reports]

Readme for darcs-2.8.5

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

For more information, visit the darcs web site:

   http://www.darcs.net


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

Building Darcs is best done with the Haskell Platform:
http://www.haskell.org/platform/. Any release of darcs should build with
the most recent version of the Platform at the time of the release. This
will also generally apply to unstable versions.

If you are not using the Platform, then you need GHC and Cabal.
The versions required can be found in the darcs.cabal file under
'build-tools' and 'Cabal-Version' respectively.

The cabal-install package is also recommended.

If you have the Platform or otherwise 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
<http://www.haskell.org/haskellwiki/Cabal/How_to_install_a_Cabal_package>
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
=======
For more information about darcs hacking and best practices please check
the darcs wiki at http://wiki.darcs.net

Of particular interest are the following documents:
  * http://wiki.darcs.net/Development/GettingStarted
  * http://wiki.darcs.net/Development/FAQ

Comments about do-notation warnings
===================================
You may find a number of comments (163 of them at the time of writing) looking
like:
-- Warning:  A do-notation statement discarded a result of type Whatever.
They signal warnings issued by GHC that have been automatically silenced.
See http://bugs.darcs.net/issue1988 for more detail.

These warnings were most certainly harmless, but who knows... If you stumble
upon one such comment, take a minute or two to check if it is really okay to
ignore the return value (look for "_ <- " on the line next to the comment).  If
everything is correct, please remove the comment and send a patch (mentioning
issue1988).  If it isn't, you have found a bug, congratulations!  Fix it, or
fill a bug report on http//bugs.darcs.net/.  Finally, if in doubt, leave it as
is.  Many thanks.

Testing
=======
For more information about the test suite, including how to run specific
tests please read tests/README.test_maintainers.txt.

Happy hacking!