GettingStarted

QuickStart

Get a copy of an existing project:

darcs get http://darcs.net       # via HTTP, or...
darcs get you@example.net:foo    # via SSH
cd foo
darcs pull                       # update

Retrieve files of a project without its history (faster):

darcs get --lazy http://darcs.net

Send patches by e-mail to the owner of a repository (when no commit access):

darcs send -o file.patch    # create a mail attachment

Create a new project:

mkdir foo
cd foo
darcs init
<edit foo.c>
darcs add foo.c
darcs whatsnew              # status/diff
darcs record                # commit
darcs changes               # log

Exchange patches between two branches:

cd ..                       # go out of the repos
darcs get foo bar           # create a clone of foo named bar
cd bar                      # change to that branch
<edit bar.c>
darcs record
darcs push                  # send changes to ../foo
darcs pull                  # get changes from ../foo

Publish your work on http://patch-tag.com

<create account "myname" on patch-tag.com>
<upload ssh key to patch-tag>
<create empty repository "myproject" on patch-tag>
darcs push myname@patch-tag.com:r/myname/myproject
<tell everyone to get your code with: darcs get http://patch-tag.com/r/myname/myproject>