This is cl-darcs, a darcs client written in Common Lisp.  I started
writing it because the original client requires GHC (the Glasgow
Haskell Compiler), which is not available on all platforms.

* Compiling

If you use CLISP or SBCL, you can use cl-darcs as a standalone
executable with an interface very similar to the real darcs.  Just
run:

./configure && make && make install

You can also use cl-darcs from the REPL, by installing it as an ASDF
system:

ln -s $PWD/cl-darcs.asd /path/to/asdf-systems/

* Usage

See the manual in the doc directory.

* Known bugs and misfeatures

cl-darcs is brittle and might eat your data.  Getting a remote
repository or pulling patches from it will not affect it; what happens
with the target repository varies slighly.  Make backups of data you
care about, and report bugs!

cl-darcs seems to cope well with either just pulling patches from a
remote source, or just recording patches, but the combination of these
two activities hasn't been extensively tested.

Some combinations of merger patches are not properly handled.  You
should be able to get a tree with a real darcs client, and then use
cl-darcs for pulling new patches.

Repositories can be fetched only from local files and HTTP.  Patches
can only be applied to local repositories.

Tags are not faithfully reproduced.

Checkpoints are not used.

* Compatibility

cl-darcs works on CLISP and SBCL on Unix-like systems; it has also
been reported to work on Lispworks.  Getting it to work on other Lisp
implementations should be simple; grep the code for #+clisp or #+sbcl.
For other operating systems, modify MAKE-TEMP-FILE-NAME in util.lisp
accordingly.

* Dependencies

 - split-sequence: http://www.cl-user.net/asp/libs/split-sequence
 - Drakma: http://weitz.de/drakma/
 - PURI: http://puri.b9.com/
 - trivial-gray-streams: http://www.cl-user.net/asp/libs/trivial-gray-streams
 - Ironclad: http://www.cl-user.net/asp/libs/ironclad
 - FLEXI-STREAMS: http://weitz.de/flexi-streams/
 - CL-FAD: http://weitz.de/cl-fad/
 - CL-PPCRE: http://weitz.de/cl-ppcre/
 - CL-DIFFLIB: http://www.cliki.net/CL-DIFFLIB

All of these are ASDF-INSTALLable.

* License

cl-darcs is covered by the GPL, like the original darcs client.
ifstar.lisp and inflate.lisp were borrowed from Franz Inc, and are
public domain and LLGPL, respectively.

* Links

Project page: http://common-lisp.net/project/cl-darcs/
Mailing list: cl-darcs-devel@common-lisp.net
	      http://common-lisp.net/cgi-bin/mailman/listinfo/cl-darcs-devel

The original darcs: http://www.darcs.net/


Local variables:
mode: outline
End: