**Distributed. Interactive. Smart.**

Darcs is a free, open source, source code management system.

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

Darcs is **Interactive**. It asks you questions in response to
simple commands, giving you choices in your work flow. Choose to
record one change in a file, while ignoring another. See each patch
name while updating, even view the full "diff" for interesting
patches.
`Compare darcs' work flow with Subversion's <WorkFlowsVsSubversion>`_.

Darcs is **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 <SpontaneousBranches>`_ with darcs.

--------------

Welcome to the Darcs wiki. The Darcs home page is
`http://darcs.net <http://darcs.net>`_ , so read that first.

News
----


-  `News <News>`_

Download and Install Darcs
--------------------------


-  `Download Darcs <Binaries>`_ - latest source and binaries for
   all platforms
-  `Building darcs <http://www.darcs.net/manual/node3.html>`_

Getting started
---------------


-  `Getting Started <GettingStarted>`_ with darcs by example
-  `Overview of darcs features <Features>`_
-  `Official Manual <http://www.darcs.net/manual/>`_ (Also in
   `Postscript <http://www.darcs.net/manual/darcs.ps>`_ and
   `one big HTML file <http://www.darcs.net/manual/bigpage.html>`_)
   Includes building instructions.
-  `Frequently Asked Questions (FAQ) <FrequentlyAskedQuestions>`_
   and hopefully some answers too
-  `Best Practices <BestPractices>`_ -- a new and evolving page
   with suggestions for common situations
-  `Hints and Tips <HintsAndTips>`_
-  `Understanding darcs <http://en.wikibooks.org/wiki/Understanding_darcs>`_
   the wikibook

Support
-------


-  `users mailing list <http://lists.osuosl.org/mailman/listinfo/darcs-users>`_
   for questions comments and bug reports
-  browse the
   `official <http://lists.osuosl.org/pipermail/darcs-users/>`_ or
   `gmane <http://news.gmane.org/gmane.comp.version-control.darcs.user>`_
   archives or
   `mail-archive.com <http://www.mail-archive.com/darcs-users@darcs.net/>`_
   archives
-  `Search with Google <http://www.google.com/search?q=site:darcs.net++inurl:darcs-users+your_terms_here>`_.
-  IRC channel: #darcs on freenode.net
-  If you think you've found a bug in darcs you can submit a report
   to `bugs@darcs.net <mailto:bugs@darcs.net>`_

Other documentation
-------------------


-  OS-specific documentation
-  `Windows <Windows>`_
-  `RelatedSoftware <RelatedSoftware>`_ - software that works with
   darcs
-  `Diagnostic Messages <DiagnosticMessages>`_ A guide to
   diagnostic messages produced by darcs
-  Darcs Cheat Sheet
   `PDF <http://parmenioon.free.fr/darcs-cheat-sheet.pdf>`_
   `Scribus Source <http://parmenioon.free.fr/darcs-cheat-sheet.sla>`_,
   by Paul Bedaride

Converting to Darcs
~~~~~~~~~~~~~~~~~~~


-  CVS users:
-  Learn about `differences <DifferencesFromCVS>`_, then
   `convert your CVS archives <ConvertingFromCvs>`_
-  `Interoperating with CVS <InteroperabilityWithCvs>`_
-  Arch users: Learn about `differences <DifferencesFromArch>`_,
   then `convert your Arch archives <ConvertingFromArch>`_
-  Subversion users:
-  Learn about `differences <DifferencesFromSubversion>`_, then
   `convert your Subversion archives <ConvertingFromSubversion>`_
-  See also `MigratingFromSubversion <MigratingFromSubversion>`_
   for a quick reference guide

See `RelatedSoftware <RelatedSoftware>`_ for converting from darcs

Publications
~~~~~~~~~~~~


-  `http://osdir.com/Article2571.phtml <http://osdir.com/Article2571.phtml>`_
   "Interview with David Roundy of Darcs on Source Control" by Mark
   Stosberg
-  `http://mark.stosberg.com/Tech/darcs/cvs\_switch/easier.html <http://mark.stosberg.com/Tech/darcs/cvs_switch/easier.html>`_
   "Benefits from a real world switch from CVS to darcs" by Mark
   Stosberg
-  `An introduction to darcs <http://slipgate.za.net/darcs/darcs_osdc/slides/start.html>`_
   - slides by Yuval Kogman at OSDC::Israel::2006
-  `Slides from talks <Talks>`_ on darcs and darcs-related issues
   by David Roundy
-  `http://bulma.net/body.phtml?nIdNoticia=2333 <http://bulma.net/body.phtml?nIdNoticia=2333>`_
   "Control de versions redux" by Pau Rul\\xc2\\xb7lan (written in
   Catalan), but Carmen was translated to spanish here: "Control de
   versiones
   redux"`http://bulma.net/body.phtml?nIdNoticia=2335 <http://bulma.net/body.phtml?nIdNoticia=2335>`_
-  `http://thetruedelight.blogspot.com/2007/01/bash-alias-for-darcs-users-ive-been.html <http://thetruedelight.blogspot.com/2007/01/bash-alias-for-darcs-users-ive-been.html>`_
   "Bash alias for darcs user" by Alex Dong

Development
-----------


-  `API documentation for darcs (Haddock) <http://darcs.net/api-doc>`_
   (also
   `haddock/hoogle for darcs-unstable <http://joyful.com/repos/darcs-unstable/api-doc>`_)
-  `the darcs buildbots <http://buildbot.darcs.net/>`_
-  `DeveloperFAQ <DeveloperFAQ>`_ - Frequently Asked Questions for
   the budding darcs hacker
-  `DeveloperTips <DeveloperTips>`_ - Tips and tricks for the said
   budding darcs hacker
-  `DeveloperGettingStarted <DeveloperGettingStarted>`_ -
   Structured guide for new and wannabe developers
-  `DarcsInternals <DarcsInternals>`_ - Explanations on how various
   darcs subsystems work
-  `development list <http://lists.osuosl.org/mailman/listinfo/darcs-devel>`_
   for contributing to (or observing) darcs development
-  browse the
   `official <http://lists.osuosl.org/pipermail/darcs-devel/>`_ or
   `gmane <http://news.gmane.org/gmane.comp.version-control.darcs.devel>`_
   archives
-  `Search with Google <http://www.google.com/search?q=site:darcs.net++inurl:darcs-devel+your_terms_here>`_.
-  `Listing of unassigned "Probably easy" bugs for new darcs hackers. <http://bugs.darcs.net/issue?@columns=title,id,activity,status&@sort=-activity&@group=priority&@filter=topic,status,assignedto&@pagesize=50&@startwith=0&topic=6&status=-1,1,2,3,4,5,6,7&assignedto=-1>`_
-  `IdeasForDarcs <IdeasForDarcs>`_ - Have an idea for how darcs
   could work better? Check here first!
-  `Document and discuss performance issues <Performance>`_
-  `How to add a new darcs command <AddACommand>`_

Further information
-------------------


-  `Official homepage <http://darcs.net>`_
-  ` People behind darcs <DarcsTeam>`_
-  `PatchTheory <PatchTheory>`_ - all this patch theory related
-  `Third party comparisons which mention darcs <VersionControlComparisons>`_
-  `Blog Buzz <BlogBuzz>`_ -- see what people are blogging about
   darcs
-  `Projects using darcs <ProjectsUsingDarcs>`_
-  for historical reference:
   `the original announcement of darcs <http://www.haskell.org/pipermail/haskell-cafe/2003-April/004139.html>`_
   Still don't see what you want? The
   `Site navigation <SiteNavigation>`_ page offers more ways to browse
   the site.

How to edit this page: click Login at top; log in, creating a wiki
account if needed; click Edit (Text) at top left

--------------


-  `CategoryHomepage <CategoryHomepage>`_