The darcs package

[Tags: gpl]

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

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]

Properties

Versions2.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
Change logNone available
Dependenciesarray (>=0.1 && <0.3), base (==3.*), bytestring (>=0.9.0 && <0.10), containers (>=0.1 && <0.3), directory (==1.0.*), filepath (==1.1.*), hashed-storage (>=0.3.6 && <0.4), haskeline (>=0.6.1 && <0.7), html (==1.0.*), HTTP (>=3000.0 && <4000.1), HUnit (>=1.0), mmap (>=0.2), 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), terminfo (==0.3.*), test-framework (>=0.2.2), test-framework-hunit (>=0.2.2), test-framework-quickcheck2 (>=0.2.2), unix (>=1.0 && <2.4), utf8-string (==0.3.*), zlib (>=0.5.1.0 && <0.6.0.0) [details]
LicenseGPL
AuthorDavid Roundy <droundy@darcs.net>, <darcs-users@darcs.net>
Maintainer<darcs-users@darcs.net>
StabilityExperimental
CategoryDevelopment
Home pagehttp://darcs.net/
Source repositoryhead: darcs get http://darcs.net/
Executablesunit, darcs, witnesses
UploadedThu Jul 23 13:27:36 UTC 2009 by PetrRockai
DistributionsDebian:2.10.1, Fedora:2.8.5, FreeBSD:2.10.1
Downloads8976 total (355 in last 30 days)
Votes
0 []
StatusDocs not available [build log]
All reported builds failed as of 2015-05-26 [all 1 reports]

Modules

Flags

NameDescriptionDefaultType
curlUse libcurl for HTTP support.EnabledAutomatic
curl-pipeliningUse libcurl's HTTP pipelining.DisabledAutomatic
httpUse the pure Haskell HTTP package for HTTP support.EnabledAutomatic
bytestringUse the external bytestring package.EnabledAutomatic
zlibUse the external zlib binding package.EnabledAutomatic
utf8-stringUse the external utf8-string binding package.EnabledAutomatic
terminfoUse the terminfo package for enhanced console support.EnabledAutomatic
type-witnessesUse GADT type witnesses.DisabledAutomatic
colorUse ansi color escapes.EnabledAutomatic
mmapCompile with mmap support.EnabledAutomatic
testCompile unit tests (requires QuickCheck >= 2.1.0.0).DisabledAutomatic

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

Downloads

Maintainers' corner

For package maintainers and hackage trustees

Readme for darcs-2.3.0

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
============================

Darcs currently supports two build systems: a cabal-based system and a legacy
autotools-based system, and a cabal-based system. CABAL IS RECOMMENDED and the
autotools system is deprecated: in future releases, autotools support will be
removed.

If a "configure" file is present, autotools is supported.  If a
"Setup.lhs" file is present, cabal is supported.  Currently there is a
separate source tarball for each build system; either can be used in
unstable checkouts.

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.

Using Cabal
-----------

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

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 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.

Using Autotools
---------------

If you have the normal, autotools-based tarball, this sequence should work
for you (if you are in doubt, this is likely the case):

    $ ./configure
    $ make
    # make install

You first need to run `autoconf` if you obtained the source tree from the
darcs repository (but this is not needed for release tarballs).

For more information, please see the manual:

 * http://www.darcs.net/manual
 * doc/manual/darcs.ps


Hacking
=======
For more information about darcs hacking and best practices please check
the darcs wiki at http://wiki.darcs.net/DarcsWiki

Of particular interest are the following documents:
  * http://wiki.darcs.net/index.html/DeveloperFAQ
  * http://wiki.darcs.net/index.html/DeveloperTips

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

Happy hacking!