This article is the one I always want when I start using a tool. Darcs didn't have it, so here we go!
Fri Sep 11 21:02:15 EST 2009 Trent W. Buck <[email protected]> * Provide one-stop documentation for very clueful newbies.
New patches: [Provide one-stop documentation for very clueful newbies. Trent W. Buck <[email protected]>**20090911110215 Ignore-this: b0d395dbc5947ab87266d60dcc9394ba ] hunk ./GettingStarted.page 4 Getting Started with Darcs ========================== +.. NOTE:: in a hurry? Try `QuickStart <>` instead. + Among the plethora of emerging version control systems -- Subversion, Arch, Monotone and so on -- Darcs stands out for its simplicity and thoughtful design. addfile ./QuickStart.page hunk ./QuickStart.page 1 +Getting Started (TL;DR edition) +=============================== + +.. COMMENT: The intended audience of this article is harried, clueful, + and familiar with VCSs in general, but not familiar with Darcs. + Cover the bare minimum, and optimize concision. Limit to a page. + Avoid options that aren't strictly necessary (e.g. -am). + +Create a new project:: + + mkdir foo + cd foo + darcs init + editor foo.c + darcs add foo.c + darcs whatsnew # status/diff + darcs record # commit + darcs changes # log + +Branches are just repos:: + + darcs get $PWD $PWD+bar # create branch + cd $PWD+bar # change to that branch + editor bar.c + darcs record + darcs pull # merge from HEAD/tip, and/or... + darcs push # merge from branch + +Publish your repo with any httpd, e.g. :: + + ln -s $PWD /var/www/ # or... + busybox httpd -p 8080 + +Clone/checkout a project:: + + darcs get http://example.net/foo # via HTTP, or... + darcs get [email protected]:foo # via SSH + cd foo + darcs pull # update/fetch + +Submit patches:: + + darcs send # via mail/HTTP, or... + darcs push # via SSH Context: [We're a bit more policy driven than I thought. Eric Kow <[email protected]>**20090909152412 Ignore-this: 6f104d42fcc010f2b69ed1b50c2ce299 ] [Small policy page. Eric Kow <[email protected]>**20090909150737 Ignore-this: c3cdb8f1bbdbaa7ff83ac7146a704896 ] [Fix a couple more broken links. Eric Kow <[email protected]>**20090909145833 Ignore-this: ffb63aea5a5d6fd87864089a39032329 ] [Fix some broken links from Development tidy up. Eric Kow <[email protected]>**20090909145521 Ignore-this: e3b38b17f68390c171b9c2dfd1c0b7b0 If only we had redirects. ] [topic wibble kowey <>**20090907213751 Ignore-this: 76a79cfe67ea27b2cf760ee1a7d7568e ] [An important fourth case. Eric Kow <[email protected]>**20090906204011 Ignore-this: 7a2e7cdf327cfa24c09e75f6a3ca09bd ] [Explain bug in get_extra commuting patch. Eric Kow <[email protected]>**20090906203731 Ignore-this: 49c9f059db7c706d5a0e0900942a1c8e As far as my limited understanding allows anyway. ] [Define commutation. Eric Kow <[email protected]>**20090906082503 Ignore-this: 968746f37ba71b144aab41b575ea7ee0 I'm sure it's a lousy definition, but I think having a lousy one beats having 'commute': TODO be the first entry of the glossary. ] [Define hunk and point out git/primpatch confusion. Eric Kow <[email protected]>**20090906074723 Ignore-this: 45134de78c28787c189aa0a71bc9dad4 ] [Use RST definitions and alphabetise. Eric Kow <[email protected]>**20090906074028 Ignore-this: 544a8192a0a34f35dcc1c29206ac4631 ] [Rearrange performance stuff for troubleshooting. Eric Kow <[email protected]>**20090905132602 Ignore-this: db59eee8254db68b771b02183896c556 ] [link to issue80 re out of memory bug kowey <>**20090904121741 Ignore-this: a377b819eab1d9b30734601b7570e9c4 ] [faq tip for smaller patch bundles kowey <>**20090904121558 Ignore-this: e97014761bef82c39a7d9f53e74b3d96 ] [darcs replace tips - only kowey <>**20090903101613 Ignore-this: 872c70b561a2e1d32537329e4a65faeb ] [twb is our doc manager (he said it himself!) kowey <>**20090903065357 Ignore-this: 2e334be89e43c2f825b0de949c8506b3 ] [the new failing foo convention kowey <>**20090902203936 Ignore-this: e47696ca921788253748d58ce4400d28 ] [link to multiple private key guide dagit <[email protected]>**20090901062135 Ignore-this: 79de5d20e8ff41bec6d439b392801352 ] [updated link to myself dagit <[email protected]>**20090901061904 Ignore-this: bb8505b7238a59eb53c1ddf9228e4d66 ] [Created People page for Jason Dagit (I wish this description field auto populated) dagit <[email protected]>**20090901061810 Ignore-this: f5cd169d1e2f4389343c43336356d8ee ] [added myself to review team dagit <[email protected]>**20090901061531 Ignore-this: 2a3462b7905672556e3fdb322206005d ] [Fix link. Petr Rockai <[email protected]>**20090831155207 Ignore-this: b8651367885114752cc9a9fa6d541476 ] [Clean up and update BuildingUnderWindows. Petr Rockai <[email protected]>**20090831155022 Ignore-this: ace9506fa8dca1e9abeff652ab0dc597 ] [Fix link. Petr Rockai <[email protected]>**20090831153046 Ignore-this: cc52c1285492596e2c1420ef350f5945 ] [Update TODO. Petr Rockai <[email protected]>**20090831153003 Ignore-this: 1e0bcb00fa21f66cc8605692eef1e925 ] [Minor formatting in Development/GettingStarted.page. Petr Rockai <[email protected]>**20090831152913 Ignore-this: e86ce7b6b3e580d9392b73d2bf0f816d ] [Reorganise Development, move Developer* pages to Development/ and clean up refs. Petr Rockai <[email protected]>**20090831152802 Ignore-this: 2c3fe9791a29373f9cf856d33451d04d ] [Update buildmaster URI. Petr Rockai <[email protected]>**20090831140430 Ignore-this: 98ff733d121721cdb7a5c7abd6ad8350 ] [busy dmitry kowey <>**20090831091958 Ignore-this: 5883148bf5e4f0504013b2b7edf57a3f ] [Fix ReST. mornfall <[email protected]>**20090830185253 Ignore-this: 873d07db4854351fb79a69e482421e4e ] [Add a basic Development/PatchReview page. Petr Rockai <[email protected]>**20090830185045 Ignore-this: ce5f975533d1449b0031b6cb9b84a10d ] [Short note about Ganesh's branch. Petr Rockai <[email protected]>**20090830130131 Ignore-this: 3c0b2d9cd8ac350b785b077d94fccb56 ] [I've made a branch abstracting out darcs-specific stuff Ganesh Sittampalam <[email protected]>**20090830093538 Ignore-this: 7ab1e621936be35d180b4115c7d05b00 ] [fixed formatting of literal blocks (intention would be also nice, though) tda <[email protected]>**20090830120800 Ignore-this: e6751ce723b57458f8eda0c24bf6ca17 ] [Crypt is inside src, indent correctly Kamil <[email protected]>**20090828183152 Ignore-this: e47a3802cb488f454076fb74aa45f195 ] [TAG 2009-08-28 (autotag) [email protected]**20090828103009 Ignore-this: 3d59d2305bf8bba773bb59f02b1614a4 ] Patch bundle hash: 09262fce63cee3b482286650f97980b12ef13fe8
_______________________________________________ darcs-users mailing list [email protected] http://lists.osuosl.org/mailman/listinfo/darcs-users
