DARCS(1) General Commands Manual DARCS(1) (NAME) darcs - (SYNOPSIS) darcs command ... : darcs help [ [darcs_subcommand]] darcs initialize [] darcs add ... darcs whatsnew [file|directory]... darcs record [file|directory]... darcs clone [] darcs pull [repository]... darcs push [repository] darcs move ... darcs remove ... darcs replace ... darcs log [file|directory]... darcs annotate [file|directory] darcs diff [file|directory]... darcs show contents [file]... darcs show dependencies darcs show files [file|directory]... darcs show index darcs show pristine darcs show repo darcs show authors darcs show tags darcs show patch-index darcs test [[initialization] command] darcs revert [file|directory]... darcs unrevert darcs amend [file|directory]... darcs rebase pull [repository]... darcs rebase apply darcs rebase suspend darcs rebase unsuspend darcs rebase edit darcs rebase obliterate darcs rebase log darcs rebase upgrade darcs rollback [file|directory]... darcs unrecord darcs obliterate darcs clean [file|directory]... darcs tag [tagname] darcs setpref darcs send [repository] darcs apply darcs optimize clean darcs optimize http darcs optimize reorder darcs optimize enable-patch-index darcs optimize disable-patch-index darcs optimize compress darcs optimize uncompress darcs optimize relink darcs optimize upgrade darcs optimize cache darcs dist darcs mark-conflicts [file|directory]... darcs repair darcs convert darcs-2 [] darcs convert export darcs convert import [] darcs fetch [repository]... (DESCRIPTION) (Darcs) : . . . darcs record ( commit ) . darcs push darcs pull . (OPTIONS) . COMMANDS . `darcs command --help` . (Selecting Patches): --patches (extended) . regex(7) . --matches () : () (not) (and) (or) . C (! && ||) . --patches=regex --matches='name regex' --hash=HASH --matches='hash HASH' --from-patch --to-patch --from-match='name... --to-match='name... --from-hash --to-hash --from-match='hash...' --to-match='hash...' --from-* --to-* : `darcs log --from-patch='html.*docu' --to-match='date 20040212'` `darcs log --from-hash=368089c6969 --to-patch='^fix.*renamed or moved.$'` () : exact STRING - STRING . name REGEX - REGEX . author REGEX - REGEX . hunk REGEX - REGEX (hunk patch). comment REGEX - REGEX (log). hash HASH - HASH ( ) . date DATE - DATE . touch REGEX - . : darcs log --match 'exact "Resolve issue17: use dynamic memory allocation."' darcs log --match 'name issue17' darcs log --match 'name "^[Rr]esolve issue17>"' darcs log --match 'author "David Roundy"' darcs log --match 'author droundy' darcs log --match 'author droundy@darcs.net' darcs log --match 'hunk "foo = 2"' darcs log --match 'hunk "^instance .* Foo where$"' darcs log --match 'comment "prevent deadlocks"' darcs log --match 'hash c719567e92c3b0ab9eddd5290b705712b8b918ef' darcs log --match 'hash c7195' darcs log --match 'date "2006-04-02 22:41"' darcs log --match 'date "tea time yesterday"' darcs log --match 'touch src/foo.c' darcs log --match 'touch src/' darcs log --match 'touch "src/*.(c|h)"' (COMMANDS) darcs help [ [darcs_subcommand]] darcs help darcs . darcs help foo darcs foo . / (Most used/starting out): darcs initialize [] darcs initialize . _darcs . . darcs record --look-for-adds . Initialize init . Darcs (patch semantics) . darcs-1 darcs-2 darcs-3 . . darcs-2 . darcs-1 --darcs-1 darcs-1 . darcs-3 (EXPERIMENTAL) 2.16 . . darcs-3 3.0 . initialize clone _darcs/prefs/ . --with-prefs-templates boring binaries . --no-prefs-templates . 'ALL no-prefs-templates' ~/darcs/defaults . darcs add ... (working tree) ( ) Darcs ( ). darcs add Darcs . Darcs darcs add -r * darcs record -l darcs . (symlinks) . Darcs <<>> (boring) . --boring (override) . Darcs . --case-ok . OS X ( ReadMe README). --case-ok ! darcs whatsnew [file|directory]... darcs whatsnew . . --summary . --look-for-adds darcs add . : o `A f` `A d/` . o `R f` `R d/` . o `M f -N +M rP` `N` `M` `P` . o `f -> g` . o `a f` `a d/` --look-for-adds . o (!) `R! foo.c` . `duplicated` . --machine-readable --summary . `M f` : `F f` `T g` ( 'From f To g'). darcs whatsnew Darcs . ( ) --unified ( ). diff darcs diff darcs diff . ( ) . darcs record [file|directory]... darcs record (patch) . . . Darcs ( darcs help environment ) ( ) ( ) . -m --edit-long-comment . . . -p . --logfile . _darcs/patch_description.txt . ( `Fred Bloggs `). Darcs : --author _darcs/prefs/author ( ) ~/.darcs/author ( ) $DARCS_EMAIL $EMAIL. Darcs ~/.darcs/author . ~/.darcs/author ( ). Darcs . --ask-deps . . . . --pipe ( ). record --pipe (long comment) . (stdin) . darcs . ( ) . --pipe : What is the date? Mon Nov 15 13:38:01 EST 2004 Who is the author? David Roundy What is the log? One or more comment lines darcs setpref ( ). . --set-scripts-executable . darcs clone . ( `make all`) --no-test . ( ) --unified . darcs clone [] Clone . . Darcs . --lazy (<< >>). . Darcs (hard link) . . . NTFS HFS+ ( ext UFS ZFS) . FAT . Darcs (packs) darcs optimize http . . Darcs clone . ssh . . (tag) darcs clone --tag . . (context file) darcs log --context . --context . . --to-patch --to-match . darcs optimize reorder . --set-scripts-executable . (<<#!>>) . --inherit-default defaultrepo . 'ALL --inherit-default' ~/darcs/defaults . clone : defaultrepo ( --set-default ) defaultrepo . defaultrepo (--no-inherit-default) . initialize clone _darcs/prefs/ . --with-prefs-templates boring binaries . --no-prefs-templates . 'ALL no-prefs-templates' ~/darcs/defaults . darcs pull [repository]... Pull ( --repodir) . Pull (URLs) _darcs/prefs/defaultrepo . (--union) . --intersection darcs . --complement darcs . --reorder . . --inherit-default defaultrepo . 'ALL --inherit-default' ~/darcs/defaults . push pull send : --set-default defaultrepo () defaultrepo . defaultrepo (--no-inherit-default) . darcs help apply . darcs push [repository] Push pull . Push . --reorder-patches pull apply : ( ) ( ) () . (tag) . --apply-as darcs sudo . . . darcs push ssh . darcs 2.5 . --no-compress . --inherit-default defaultrepo . 'ALL --inherit-default' ~/darcs/defaults . push pull send : --set-default defaultrepo () defaultrepo . defaultrepo (--no-inherit-default) . (Preparing patches before recording): darcs move ... Darcs . Darcs `darcs mv` Darcs . ( `darcs remove` ) . Darcs . --case-ok . OS X ( `ReadMe` `README`).` --case-ok ! darcs remove ... `darcs remove` `darcs add` . ( ). ( pull) . darcs replace ... Darcs (Lexical substitution) . . . . (Tokenize) : ( ) . ( `[A-Za-z0-9_]`).` ( `[A-Za-z0-9_.-]`).` --token-chars . . . `[A-Z]` . (Caret ^) . `[^:0` passwd(5) . --token-chars . --token-chars . Darcs . --force `darcs rollback` . : --token-chars ASCII UTF-8 . << >> (High-bit) . a ISO 8859-1 () ISO 8859-7 . --token-chars (Literal whitespace) . `[^ 0t]` . regex(7) POSIX ( `[[:alnum:]]`) --token-chars . (Querying the repository): darcs log [file|directory]... `darcs log` --repo . . . . --from-tag --from-patch . --to-tag --to-patch . --last --max-count . . `darcs log foo.c --max-count 3` foo.c `darcs log --last 3 foo.c` foo.c . . --human-readable . --machine-readable . --context Darcs ( `darcs clone --context`).` --xml-output XML ... ( ) ASCII UTF-8 . darcs annotate [file|directory] `darcs annotate` . () . --machine-readable . darcs diff [file|directory]... `darcs diff` . () . `darcs whatsnew` . `darcs whatsnew` . diff . --patch . . --from-patch --to-patch <<>> <<>> . (Tag) (Match) `darcs diff --from-tag 1.0 --to-tag 1.1`. `darcs optimize reorder` . diff(1) -rN -u (Unified format) . --no-unified . --diff-opts --diff-opts=-ud --diff-opts=-wU9. --diff-command . . (Shell) . %1 %2 . : darcs diff -p . --diff-command "meld %1 %2" --diff-opts . darcs show subcommand . . darcs show contents [file]... show contents . show contents () . darcs show dependencies . (Dot Language) https://www.graphviz.org/doc/info/lang.html . (Transitively reduced) . . `darcs help patterns` . : darcs show dependencies --from-tag=. | dot -Tpdf -o FILE.pdf (!) . N N^3 (Commutation) . darcs show files [file|directory]... `darcs show files` . `darcs whatsnew --summary` . << >> (Pending) (Record) . ( ) --no-pending . `darcs show files` --no-files --no-directories . ( ). . --null (Null) . `xargs -0` . : darcs show files -0 | xargs -0 ls -ldS darcs show index `darcs show index` `_darcs/index` . sha256 . darcs show pristine `darcs show pristine` (Pristine) . sha256 . darcs show repo `darcs show repo` `_darcs` ( `_darcs`) . << >> (Weak Hash) . . . << >> . --no-enum-patches O(n) O(1) . . --xml-output . darcs show authors `darcs show authors` . --verbose ( ) . . Darcs `.authorspellings` . () . . `.authorspelling` : name
[, regexp ]* : [ ] . . `.authorspelling` + (Metacharacters) (Literal) . . ( ) . ^ $ . `darcs show authors` . `darcs log` . `.authorspelling` : -- This is a comment. Fred Nurk John Snagge , John, snagge@, js@(si|mit).edu Chuck Jones Jr. , cj+user@example.com darcs show tags tags . ( ASCII) . . darcs show patch-index --verbose (Patch index) . darcs test [[initialization] command] () . ( `darcs setpref` ). . ( ). --linear --bisect . --linear (head) . (head) . --bisect () . . --backoff (head) . . . (Monotonous) --linear --bisect . ( head <<>> <<>> ). . << >> (Untestable) . . . --shrink-failures . . --no-shrink-failures . (Undoing and correcting): darcs revert [file|directory]... `darcs revert` . `darcs record` () . `--all` . . ( `darcs rev -a` `darcs rec -a`) `darcs unrevert` . `darcs revert` . darcs unrevert `unrevert` ( `darcs rev -a` `darcs rec -a`). . (Darcs) (unreversion) . darcs amend [file|directory]... `amend` <<>> (draft) <<>> . `amend` . `--unrecord` . `DRAFT:` . `darcs amend --edit-long-comment` . `--name`/`-m` : darcs amend --match 'name "DRAFT: foo"' --name 'foo2' `darcs record` `amend` . foo.c bar.c : darcs amend --match 'touch foo.c' bar.c . . . . `--not-in-remote` . `defaultrepo` . `defaultrepo` . <<>> (upstream) . `--match` `author` . ` match Your Name` `~/.darcs/defaults` . darcs rebase subcommand `darcs rebase` . . . ( push pull clone send ) . . `darcs rebase obliterate` . . . . . . (unsuspend) . . . << >>. . `darcs revert` . . darcs rebase pull [repository]... . darcs rebase apply (patch bundle) . darcs rebase suspend . . . . . `--not-in-remote` . `defaultrepo` . `defaultrepo` . <<>> (upstream) . `--match` `author` . ` match Your Name` `~/.darcs/defaults` . darcs rebase unsuspend . darcs rebase edit . darcs rebase obliterate . darcs rebase log . darcs rebase upgrade rebase . rebase . . darcs rollback [file|directory]... `rollback` . . . `rollback` ( ) . `revert` `rollback` (record) `unrevert` . darcs unrecord `unrecord` `record` : . `darcs whatsnew` (record) (revert) . . . . . `--not-in-remote` . `defaultrepo` . `defaultrepo` . <<>> (upstream) . `--match` `author` . ` match Your Name` `~/.darcs/defaults` . darcs obliterate `obliterate` . . (obliterate) ! -O . (patch bundle) `darcs apply` . `darcs send` . . . . . `--not-in-remote` . `defaultrepo` . `defaultrepo` . <<>> (upstream) . `--match` `author` . ` match Your Name` `~/.darcs/defaults` . darcs clean [file|directory]... . `darcs revert -l/--look-for-adds` . `--boring` ** . `darcs revert` . (Direct modification of the repository): darcs tag [tagname] `darcs tag` . ( ). . ** . . `R` `t` `darcs clone --tag t R` . `--patch` . `darcs clone --tag '^t$'` . `darcs show tags` . : . <<>> (clean) . push pull . . . . `--ask-deps` . `darcs tag` `--pipe` `darcs record` . darcs setpref (preference) . `darcs setpref` . : * test -- * predist -- `darcs dist` * boringfile -- (boring file) * binariesfile -- GNU autotools `make test` : darcs setpref test 'autoconf && ./configure && make && make test' (merging) : . . (Exchanging patches by e-mail): darcs send [repository] `send` . `send` (URL) . `send` push pull send / . . --output --output-auto-name --to . --output . --output-auto-name . --to . HTTP . --mail _darcs/prefs/email ( ) . --cc . _darcs/prefs/post (URL) mailto: http:// . (post) . . --subject . . --in-reply-to In-Reply-To References . (reply) . --edit-description . --sendmail-command . . : %s (subject) %t (to) %c (cc) %b (body) %f (from) %a (URL-encoded). %< . evolution msmtp : evolution "mailto:%T?subject=%S&attach=%A&cc=%C&body=%B" msmtp -t %< --author (return address) darcs send . A B : o --author A B B . o --from A From: ( ) A B . o --from --author B . sendmail --sendmail-command . configure . --from . --inherit-default defaultrepo . 'ALL --inherit-default' ~/darcs/defaults . push pull send : --set-default (local defaultrepo) defaultrepo . defaultrepo (host) (--no-inherit-default) . darcs apply darcs apply . darcs send darcs push SSH . . MIME . MIME (MIME boundary) Courier Mail.app . gpg(1) --verify pubring.gpg pubring.gpg . --test ( darcs setpref ) . darcs apply --all . --interactive . . (--no-allow-conflicts). --mark-conflicts . ( ) . . . . . darcs mark-conflicts . --external-merge . %a ( ) %1 %2 %o . xxdiff : --external-merge='xxdiff -m -O -M %o %1 %a %2' --allow-conflicts . darcs pull --union ( ). darcs mark-conflicts . darcs mark-conflicts . (Other commands): darcs optimize subcommand darcs optimize . . darcs optimize clean . . darcs optimize http << >> (repository packs) HTTP darcs clone . . . darcs optimize reorder ( ) <<>> . (CPU) . --shallow . --deep . . (lazy clones) . darcs optimize enable-patch-index (patch index) annotate log. darcs optimize disable-patch-index . darcs optimize compress (inventories) (pristine) zlib (RFC 1951) ( ) . . darcs optimize uncompress darcs optimize compress . darcs optimize uncompress (inventories) (pristine) zlib (RFC 1951) ( ) . . darcs optimize uncompress darcs optimize compress . darcs optimize relink darcs optimize relink (peers) (hard-link) . _darcs/prefs/sources --sibling ( ) . . cp -r darcs clone (pull) . darcs optimize upgrade . darcs optimize cache . (bucketed) . darcs dist darcs dist ( _darcs ). --tag. ( ) --dist-name . predist ( darcs setpref ) . autotools autoconf && automake . --zip predist . darcs mark-conflicts [file|directory]... . v v v ===== * * * ^ ^ ^ : v v v v v v v initial state ============= first choice ************* ...more choices... ************* last choice ^ ^ ^ ^ ^ ^ ^ (revert) darcs mark-conflicts darcs apply darcs pull --allow-conflicts . ( ) . (record) darcs mark-conflicts . () . <<>> . (tag) . <> . . . darcs record --ask-deps . darcs repair darcs repair . (pristine) . . . . --dry-run ( ) . darcs convert subcommand . . darcs convert darcs-2 [] darcs-1 darcs-2 . : Darcs 1.x darcs-1 darcs-2 . . : o ( ). o () . initialize clone _darcs/prefs/ . --with-prefs-templates boring binaries . --no-prefs-templates . 'ALL no-prefs-templates' ~/darcs/defaults . darcs convert export (export). : $ cd repo $ git init ../mirror $ darcs convert export | (cd ../mirror && git fast-import) (marksfiles): $ cd repo $ git init ../mirror $ touch ../mirror/git.marks $ darcs convert export --read-marks darcs.marks --write-marks darcs.marks | (cd ../mirror && git fast-import --import-marks=git.marks --export-marks=git.marks) (amend) . . : o fast-export . o . : darcs convert import [] (import). ( darcs help init ). : $ (cd gitrepo && git fast-export --all -M) | darcs convert import darcsmirror : . . initialize clone _darcs/prefs/ . --with-prefs-templates boring binaries . --no-prefs-templates . 'ALL no-prefs-templates' ~/darcs/defaults . darcs fetch [repository]... fetch pull . apply . fetch pull pull . (ENVIRONMENT) HOME and APPDATA $HOME/.darcs ( ) %APPDATA%/darcs ( ) . () . DARCS_EDITOR, VISUAL, and EDITOR Darcs . $DARCS_EDITOR $VISUAL $EDITOR . nano . nano PATH vi emacs emacs -nw ( ) edit . DARCS_PAGER and PAGER Darcs (pager) . Darcs $DARCS_PAGER $PAGER . less . $DARCS_PAGER ( $PAGER) . DARCS_DONT_COLOR, DARCS_ALWAYS_COLOR, and DARCS_ALTERNATIVE_COLOR ANSI darcs (hunk) . DARCS_DONT_COLOR 1 . ANSI ( less -R) DARCS_ALWAYS_COLOR 1 darcs . DARCS_ALTERNATIVE_COLOR 1 darcs ANSI (bold) (reverse video) . DARCS_DONT_ESCAPE_TRAILING_SPACES and DARCS_DONT_ESCAPE_TRAILING_CR darcs (space) ( ) . DARCS_DONT_ESCAPE_TRAILING_SPACES 1 . (carriage return) : DARCS_DONT_ESCAPE_TRAILING_CR. DARCS_DONT_ESCAPE_ANYTHING, DARCS_DONT_ESCAPE_EXTRA, DARCS_ESCAPE_EXTRA, DARCS_DONT_ESCAPE_ISPRINT, and DARCS_ESCAPE_8BIT (locale) Darcs . darcs ASCII . UTF-8 - ISO/IEC-8859 ( ) . ASCII backspace ( ) darcs . ^< > < > . Darcs . ASCII . UTF-16 UTF-32 . : DARCS_DONT_ESCAPE_ANYTHING 1 . . (pipe) darcs . . DARCS_DONT_ESCAPE_EXTRA DARCS_ESCAPE_EXTRA darcs . . . . DARCS_DONT_ESCAPE_TRAILING_CR (carriage return) ( DOS) . darcs DARCS_DONT_ESCAPE_ISPRINT DARCS_USE_ISPRINT ( ) . - ISO-8859 darcs . ( ) DARCS_ESCAPE_8BIT 1 . darcs ASCII ASCII . DARCS_TMPDIR and TMPDIR Darcs . darcs diff . /tmp _darcs ( ) . _darcs/prefs/tmpdir $DARCS_TMPDIR $TMPDIR . DARCS_KEEP_TMPDIR DARCS_KEEP_TMPDIR darcs . Darcs ( darcs setpref) darcs record . DARCS_EMAIL and EMAIL ( Fred Bloggs ). Darcs : --author _darcs/prefs/author ( ) ~/.darcs/author ( ) $DARCS_EMAIL $EMAIL. Darcs ~/.darcs/author . ~/.darcs/author ( ). Darcs . SENDMAIL darcs send sendmail(8) . --sendmail-command $SENDMAIL /usr/sbin/sendmail /usr/lib/sendmail . DARCS_SLOPPY_LOCKS : darcs: takeLock [...]: atomic_create [...]: unsupported operation DARCS_SLOPPY_LOCKS=True (export) . DARCS_SSH [user@]host:[dir] Darcs ssh(1) . $DARCS_SSH SSH . . . DARCS_SCP and DARCS_SFTP Darcs darcs transfer-mode . Darcs 1 Darcs SFTP . transfer-mode Darcs scp(1) sftp(1) . $DARCS_SCP $DARCS_SFTP $DARCS_SSH . sftp DARCS_SCP=sftp . scp darcs clone ssh . DARCS_SCP=rsync . SSH_PORT () SSH Darcs ( SSH) . SSH SSH ssh_config(5) . OpenSSH Host *.example.net Port 443 ~/.ssh/config . DARCS_CONNECTION_TIMEOUT darcs . . curl . (FILES) _darcs/prefs/motd _darcs/prefs/motd << >> (message of the day) --quiet pull . _darcs/prefs/email _darcs/prefs/email darcs send . . _darcs/prefs/post _darcs/prefs/post darcs send (URL) mailto: http:// . (post) . _darcs/prefs/author _darcs/prefs/author ( ) David Roundy . $DARCS_EMAIL $EMAIL . _darcs/prefs/defaults darcs. : COMMAND FLAG VALUE COMMAND ALL . FLAG -- verbose --verbose. VALUE . . . ( ALL) . : . ALL darcs . ALL . darcs : ALL ignore-times _darcs/prefs/defaults . --disable . . amend : amend disable .darcs/defaults . . _darcs/prefs/boring _darcs/prefs/boring (regex) (object files). boring . boring . darcs setpref 'boringfile' ( darcs setpref boringfile .boring .boring darcs ). boringfile _darcs/prefs/boring boringfile . boring ~/.darcs/boring darcs . darcs boring (boring) . boring darcs add darcs add newdir newdir/* . --look-for-adds whatsnew record . darcs boring . _darcs/prefs/binaries _darcs/prefs/binaries . Darcs ^Z NULL . binaries . darcs setpref 'binariesfile' ( darcs setpref binariesfile ./.binaries .binaries darcs ). boring ~/.darcs/binaries . _darcs/prefs/defaultrepo (URL) pull push send optimize relink . Darcs --set-default . _darcs/prefs/sources defaultrepo darcs ( push pull send) . . : cache:/home/droundy/.cache/darcs readonly:/home/otheruser/.cache/darcs repo:http://darcs.net cache: darcs () - readonly: repo: ( ) . : darcs . .cache/darcs ( darcs .darcs/cache ) $XDG_CACHE_HOME/darcs : https://specifications.freedesktop.org/basedir-spec/basedir-spec- latest.html darcs ( ) darcs (hard links) . . darcs . darcs _darcs/prefs/sources . ( ) darcs . (timeouts) ( NFS automounter ) darcs . --lazy . _darcs/prefs/tmpdir /tmp _darcs ( ) . _darcs/prefs/tmpdir $DARCS_TMPDIR $TMPDIR . _darcs/prefs/prefs darcs setpref . . (BUGS) http://bugs.darcs.net Darcs . ( ) bugs@darcs.net . (SEE ALSO) Darcs . : http://darcs.net (LICENSE) Darcs (GNU GPL) ( ) / . 2.18.5 (release) DARCS(1)