<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> <!--Converted with LaTeX2HTML 2008 (1.71) original version by: Nikos Drakos, CBLU, University of Leeds * revised and updated by: Marcus Hennecke, Ross Moore, Herb Swan * with significant contributions from: Jens Lippmann, Marek Rouchal, Martin Wilck and others --> <HTML> <HEAD> <TITLE>Darcs 2.2.0 (release) Darcs </TITLE> <META NAME="description" CONTENT="Darcs 2.2.0 (release) Darcs "> <META NAME="keywords" CONTENT="darcs"> <META NAME="resource-type" CONTENT="document"> <META NAME="distribution" CONTENT="global"> <META NAME="Generator" CONTENT="LaTeX2HTML v2008"> <META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css"> <LINK REL="STYLESHEET" HREF="darcs.css"> <LINK REL="next" HREF="node1.html"> </HEAD> <BODY > <!--Navigation Panel--> <A NAME="tex2html29" HREF="node1.html"> <IMG WIDTH="22" HEIGHT="22" title="Next" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="./next.png"></A> <IMG WIDTH="22" HEIGHT="22" title="Up" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="./up_g.png"> <IMG WIDTH="22" HEIGHT="22" title="Previous" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="./prev_g.png"> <A NAME="tex2html27" HREF="node1.html"> <IMG WIDTH="22" HEIGHT="22" title="Contents" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="./contents.png"></A> <BR> <B> Next:</B> <A NAME="tex2html30" HREF="node1.html">Contents</A> <B> <A NAME="tex2html28" HREF="node1.html">Contents</A></B> <BR> <BR> <!--End of Navigation Panel--> <P> <P> <H1 ALIGN="CENTER"> Darcs 2.2.0 (release) <BR><FONT SIZE="+2"><I>Darcs</I></FONT> </H1> <DIV> <P ALIGN="CENTER"><STRONG>David Roundy </STRONG></P> </DIV> <P> <BR><HR> <!--Table of Child-Links--> <A NAME="CHILD_LINKS"></A> <UL> <LI><A NAME="tex2html31" HREF="node1.html">Contents</A> <LI><A NAME="tex2html32" HREF="node2.html">Introduction</A> <UL> <LI><A NAME="tex2html33" HREF="node2.html#SECTION00210000000000000000">Features</A> <LI><A NAME="tex2html34" HREF="node2.html#SECTION00220000000000000000">Switching from CVS</A> <LI><A NAME="tex2html35" HREF="node2.html#SECTION00230000000000000000">Switching from arch</A> </UL> <BR> <LI><A NAME="tex2html36" HREF="node3.html">Building darcs</A> <UL> <LI><A NAME="tex2html37" HREF="node3.html#SECTION00310000000000000000">Prerequisites</A> <LI><A NAME="tex2html38" HREF="node3.html#SECTION00320000000000000000">Building on Mac OS X</A> <LI><A NAME="tex2html39" HREF="node3.html#SECTION00330000000000000000">Building on Microsoft Windows</A> <LI><A NAME="tex2html40" HREF="node3.html#SECTION00340000000000000000">Building from tarball</A> <LI><A NAME="tex2html41" HREF="node3.html#SECTION00350000000000000000">Building darcs from the repository</A> <LI><A NAME="tex2html42" HREF="node3.html#SECTION00360000000000000000">Submitting patches to darcs</A> </UL> <BR> <LI><A NAME="tex2html43" HREF="node4.html">Getting started</A> <UL> <LI><A NAME="tex2html44" HREF="node4.html#SECTION00410000000000000000">Creating your repository</A> <LI><A NAME="tex2html45" HREF="node4.html#SECTION00420000000000000000">Making changes</A> <LI><A NAME="tex2html46" HREF="node4.html#SECTION00430000000000000000">Making your repository visible to others</A> <LI><A NAME="tex2html47" HREF="node4.html#SECTION00440000000000000000">Getting changes made to another repository</A> <LI><A NAME="tex2html48" HREF="node4.html#SECTION00450000000000000000">Moving patches from one repository to another</A> <UL> <LI><A NAME="tex2html49" HREF="node4.html#SECTION00451000000000000000">All pulls</A> <LI><A NAME="tex2html50" HREF="node4.html#SECTION00452000000000000000">Send and apply manually</A> <LI><A NAME="tex2html51" HREF="node4.html#SECTION00453000000000000000">Push</A> <LI><A NAME="tex2html52" HREF="node4.html#SECTION00454000000000000000">Push --apply-as</A> <LI><A NAME="tex2html53" HREF="node4.html#SECTION00455000000000000000">Sending signed patches by email</A> </UL> <LI><A NAME="tex2html54" HREF="node4.html#SECTION00460000000000000000">Reducing disk space usage</A> <UL> <LI><A NAME="tex2html55" HREF="node4.html#SECTION00461000000000000000">Linking between repositories</A> <LI><A NAME="tex2html56" HREF="node4.html#SECTION00462000000000000000">Alternate formats for the pristine tree</A> </UL> </UL> <BR> <LI><A NAME="tex2html57" HREF="node5.html">Configuring darcs</A> <UL> <LI><A NAME="tex2html58" HREF="node5.html#SECTION00510000000000000000">prefs</A> <LI><A NAME="tex2html59" HREF="node5.html#SECTION00520000000000000000">Environment variables</A> <LI><A NAME="tex2html60" HREF="node5.html#SECTION00530000000000000000">General-purpose variables</A> <LI><A NAME="tex2html61" HREF="node5.html#SECTION00540000000000000000">Remote repositories</A> <LI><A NAME="tex2html62" HREF="node5.html#SECTION00550000000000000000">Highlighted output</A> <LI><A NAME="tex2html63" HREF="node5.html#SECTION00560000000000000000">Character escaping and non-ASCII character encodings</A> </UL> <BR> <LI><A NAME="tex2html64" HREF="node6.html">Best practices</A> <UL> <LI><A NAME="tex2html65" HREF="node6.html#SECTION00610000000000000000">Introduction</A> <LI><A NAME="tex2html66" HREF="node6.html#SECTION00620000000000000000">Creating patches</A> <UL> <LI><A NAME="tex2html67" HREF="node6.html#SECTION00621000000000000000">Changes</A> <LI><A NAME="tex2html68" HREF="node6.html#SECTION00622000000000000000">Keeping or discarding changes</A> <LI><A NAME="tex2html69" HREF="node6.html#SECTION00623000000000000000">Unrecording changes</A> <LI><A NAME="tex2html70" HREF="node6.html#SECTION00624000000000000000">Special patches and pending</A> </UL> <LI><A NAME="tex2html71" HREF="node6.html#SECTION00630000000000000000">Using patches</A> <UL> <LI><A NAME="tex2html72" HREF="node6.html#SECTION00631000000000000000">Dependencies</A> <LI><A NAME="tex2html73" HREF="node6.html#SECTION00632000000000000000">Branches: just normal repositories</A> <LI><A NAME="tex2html74" HREF="node6.html#SECTION00633000000000000000">Moving patches around--no versions</A> <LI><A NAME="tex2html75" HREF="node6.html#SECTION00634000000000000000">Tags--versions</A> <LI><A NAME="tex2html76" HREF="node6.html#SECTION00635000000000000000">Conflicts</A> <LI><A NAME="tex2html77" HREF="node6.html#SECTION00636000000000000000">Resolving conflicts</A> </UL> <LI><A NAME="tex2html78" HREF="node6.html#SECTION00640000000000000000">Use a Global Cache</A> <LI><A NAME="tex2html79" HREF="node6.html#SECTION00650000000000000000">Distributed development with one primary developer</A> <LI><A NAME="tex2html80" HREF="node6.html#SECTION00660000000000000000">Development by a small group of developers in one office</A> <LI><A NAME="tex2html81" HREF="node6.html#SECTION00670000000000000000">Personal development</A> <UL> <LI><A NAME="tex2html82" HREF="node6.html#SECTION00671000000000000000">Private patches</A> </UL> </UL> <BR> <LI><A NAME="tex2html83" HREF="node7.html">Repository formats</A> <UL> <LI><A NAME="tex2html84" HREF="node7.html#SECTION00710000000000000000">Introduction</A> <LI><A NAME="tex2html85" HREF="node7.html#SECTION00720000000000000000">Darcs 1 format</A> <LI><A NAME="tex2html86" HREF="node7.html#SECTION00730000000000000000">Hashed format</A> <LI><A NAME="tex2html87" HREF="node7.html#SECTION00740000000000000000">Darcs 2 format</A> </UL> <BR> <LI><A NAME="tex2html88" HREF="node8.html">Darcs commands</A> <UL> <LI><A NAME="tex2html89" HREF="node8.html#SECTION00810000000000000000">Common options to darcs commands</A> <LI><A NAME="tex2html90" HREF="node8.html#SECTION00820000000000000000">Options apart from darcs commands</A> <LI><A NAME="tex2html91" HREF="node8.html#SECTION00830000000000000000">Getting help</A> <UL> <LI><A NAME="tex2html92" HREF="node8.html#SECTION00831000000000000000">darcs help</A> </UL> <LI><A NAME="tex2html93" HREF="node8.html#SECTION00840000000000000000">Creating repositories</A> <UL> <LI><A NAME="tex2html94" HREF="node8.html#SECTION00841000000000000000">darcs initialize</A> <LI><A NAME="tex2html95" HREF="node8.html#SECTION00842000000000000000">darcs get</A> <LI><A NAME="tex2html96" HREF="node8.html#SECTION00843000000000000000">darcs put</A> </UL> <LI><A NAME="tex2html97" HREF="node8.html#SECTION00850000000000000000">Modifying the contents of a repository</A> <UL> <LI><A NAME="tex2html98" HREF="node8.html#SECTION00851000000000000000">darcs add</A> <LI><A NAME="tex2html99" HREF="node8.html#SECTION00852000000000000000">darcs remove</A> <LI><A NAME="tex2html100" HREF="node8.html#SECTION00853000000000000000">darcs mv</A> <LI><A NAME="tex2html101" HREF="node8.html#SECTION00854000000000000000">darcs replace</A> </UL> <LI><A NAME="tex2html102" HREF="node8.html#SECTION00860000000000000000">Working with changes</A> <UL> <LI><A NAME="tex2html103" HREF="node8.html#SECTION00861000000000000000">darcs record</A> <LI><A NAME="tex2html104" HREF="node8.html#SECTION00862000000000000000">darcs pull</A> <LI><A NAME="tex2html105" HREF="node8.html#SECTION00863000000000000000">darcs push</A> <LI><A NAME="tex2html106" HREF="node8.html#SECTION00864000000000000000">darcs send</A> <LI><A NAME="tex2html107" HREF="node8.html#SECTION00865000000000000000">darcs apply</A> </UL> <LI><A NAME="tex2html108" HREF="node8.html#SECTION00870000000000000000">Seeing what you've done</A> <UL> <LI><A NAME="tex2html109" HREF="node8.html#SECTION00871000000000000000">darcs whatsnew</A> <LI><A NAME="tex2html110" HREF="node8.html#SECTION00872000000000000000">darcs changes</A> <LI><A NAME="tex2html111" HREF="node8.html#SECTION00873000000000000000">darcs show</A> <UL> <LI><A NAME="tex2html112" HREF="node8.html#SECTION00873100000000000000">darcs show authors</A> <LI><A NAME="tex2html113" HREF="node8.html#SECTION00873200000000000000">darcs show contents</A> <LI><A NAME="tex2html114" HREF="node8.html#SECTION00873300000000000000">darcs show files</A> <LI><A NAME="tex2html115" HREF="node8.html#SECTION00873400000000000000">darcs show tags</A> <LI><A NAME="tex2html116" HREF="node8.html#SECTION00873500000000000000">darcs show repo</A> </UL> </UL> <LI><A NAME="tex2html117" HREF="node8.html#SECTION00880000000000000000">More advanced commands</A> <UL> <LI><A NAME="tex2html118" HREF="node8.html#SECTION00881000000000000000">darcs tag</A> <LI><A NAME="tex2html119" HREF="node8.html#SECTION00882000000000000000">darcs setpref</A> <LI><A NAME="tex2html120" HREF="node8.html#SECTION00883000000000000000">darcs check</A> <LI><A NAME="tex2html121" HREF="node8.html#SECTION00884000000000000000">darcs optimize</A> </UL> <LI><A NAME="tex2html122" HREF="node8.html#SECTION00890000000000000000">Undoing, redoing and running in circles</A> <UL> <LI><A NAME="tex2html123" HREF="node8.html#SECTION00891000000000000000">darcs amend-record</A> <LI><A NAME="tex2html124" HREF="node8.html#SECTION00892000000000000000">darcs rollback</A> <LI><A NAME="tex2html125" HREF="node8.html#SECTION00893000000000000000">darcs unrecord</A> <LI><A NAME="tex2html126" HREF="node8.html#SECTION00894000000000000000">darcs obliterate</A> <LI><A NAME="tex2html127" HREF="node8.html#SECTION00895000000000000000">darcs revert</A> <LI><A NAME="tex2html128" HREF="node8.html#SECTION00896000000000000000">darcs unrevert</A> </UL> <LI><A NAME="tex2html129" HREF="node8.html#SECTION008100000000000000000">Advanced examination of the repository</A> <UL> <LI><A NAME="tex2html130" HREF="node8.html#SECTION008101000000000000000">darcs diff</A> <LI><A NAME="tex2html131" HREF="node8.html#SECTION008102000000000000000">darcs annotate</A> <LI><A NAME="tex2html132" HREF="node8.html#SECTION008103000000000000000">darcs show</A> <UL> <LI><A NAME="tex2html133" HREF="node8.html#SECTION008103100000000000000">darcs show authors</A> <LI><A NAME="tex2html134" HREF="node8.html#SECTION008103200000000000000">darcs show contents</A> <LI><A NAME="tex2html135" HREF="node8.html#SECTION008103300000000000000">darcs show files</A> <LI><A NAME="tex2html136" HREF="node8.html#SECTION008103400000000000000">darcs show tags</A> <LI><A NAME="tex2html137" HREF="node8.html#SECTION008103500000000000000">darcs show repo</A> </UL> </UL> <LI><A NAME="tex2html138" HREF="node8.html#SECTION008110000000000000000">Rarely needed and obscure commands</A> <UL> <LI><A NAME="tex2html139" HREF="node8.html#SECTION008111000000000000000">darcs convert</A> <LI><A NAME="tex2html140" HREF="node8.html#SECTION008112000000000000000">darcs mark-conflicts</A> <LI><A NAME="tex2html141" HREF="node8.html#SECTION008113000000000000000">darcs dist</A> <LI><A NAME="tex2html142" HREF="node8.html#SECTION008114000000000000000">darcs trackdown</A> <UL> <LI><A NAME="tex2html143" HREF="node8.html#SECTION008114100000000000000">Example usage</A> </UL> <LI><A NAME="tex2html144" HREF="node8.html#SECTION008115000000000000000">darcs repair</A> </UL> </UL> <BR> <LI><A NAME="tex2html145" HREF="node9.html">Theory of patches</A> <UL> <LI><A NAME="tex2html146" HREF="node9.html#SECTION00910000000000000000">Background</A> <LI><A NAME="tex2html147" HREF="node9.html#SECTION00920000000000000000">Introduction</A> <LI><A NAME="tex2html148" HREF="node9.html#SECTION00930000000000000000">Applying patches</A> <UL> <LI><A NAME="tex2html149" HREF="node9.html#SECTION00931000000000000000">Hunk patches</A> <LI><A NAME="tex2html150" HREF="node9.html#SECTION00932000000000000000">Token replace patches</A> </UL> <LI><A NAME="tex2html151" HREF="node9.html#SECTION00940000000000000000">Patch relationships</A> <LI><A NAME="tex2html152" HREF="node9.html#SECTION00950000000000000000">Commuting patches</A> <UL> <LI><A NAME="tex2html153" HREF="node9.html#SECTION00951000000000000000">Composite patches</A> <LI><A NAME="tex2html154" HREF="node9.html#SECTION00952000000000000000">How merges are actually performed</A> </UL> <LI><A NAME="tex2html155" HREF="node9.html#SECTION00960000000000000000">Conflicts</A> <LI><A NAME="tex2html156" HREF="node9.html#SECTION00970000000000000000">Patch string formatting</A> </UL> <BR> <LI><A NAME="tex2html157" HREF="node10.html">DarcsRepo format</A> <LI><A NAME="tex2html158" HREF="node11.html">The GNU General Public License</A> <UL> <LI><A NAME="tex2html159" HREF="node11.html#SECTION001110000000000000000">Version 2, June 1991</A> <LI><A NAME="tex2html160" HREF="node11.html#SECTION001120000000000000000">Preamble</A> <LI><A NAME="tex2html161" HREF="node11.html#SECTION001130000000000000000">Appendix: How to Apply These Terms to Your New Programs</A> </UL> <BR> <LI><A NAME="tex2html162" HREF="node12.html">About this document ...</A> </UL> <!--End of Table of Child-Links--> <BR><HR> <ADDRESS> 2009-01-22 </ADDRESS> </BODY> </HTML>