GNU Arch が
どうなるか分からない ので、バージョン管理に
darcs の勉強も始めた。そこで、
GNU Arch quick start みたいに
darcs の quick start をメモしてみる。書くのは、昨日作った JavaScript
outEntry.js を例に、
darcs でファイルを新規管理する時の手順。
新規にプロジェクトを立ち上げる
カレント・ディレクトリーにファイル
outEntry.js があるとする。これを
darcs で管理し始める手順は次の通り。
$ darcs initialize ; _darcs ディレクトリーの作成
$ darcs add outEntry.js ; ファイルをレポジトリーに登録
$ darcs record --all ; 登録を反映
What is the patch name? Initial revision. ; パッチの名前をつける
Do you want to add a long comment? [yn] n ; コメントをつけるなら y
Finished recording patch 'Initial revision.'
以上で準備はお終い。複数のファイルを登録する時は
$ darcs add outEntry.js ChangeLog README README.*
のようにする。
darcs は
GNU Arch と違いレポジトリーを集めて管理したりしない。同じ、分散型バージョン管理といっても、毛色が違うみたい。どちらかというと
RCS に近く、
RCS ディレクトリーに当たるのが
_darcs になる。
RCS と同じようにレポジトリーをフロッピーで運べる気軽さはあるものの、レポジトリーごと
rm -rf してしまう怖さがある。
メール・アドレスの設定
何の設定もなしに
darcs record --all を実行すると、
darcs は log に付けるメール・アドレスを (初回のみ) 訊いてくる。
Darcs needs to know what name (conventionally an email address) to use as the
patch author, e.g. 'Fred Bloggs <fred@bloggs.invalid>'. If you provide one
now it will be stored in the file '_darcs/prefs/author' and used as a default
in the future. To change your preferred author address, simply delete or edit
this file.
What is your email address? at-aka@email.address
これを止めさせるには、環境変数
EMAIL か
DARCS_EMAIL を設定するか、
~/.darcs/defaults に author の設定をする。
defaults ファイルの書式は次の通り。
ALL author Masayuki Ataka <at-aka@email.address>
はじめの一歩
ファイルを変更したら、変更個所を確認。
$ darcs whatsnew ; 最新リビジョンとの差分を表示
{
hunk ./outEntry.js 7
+function gid (id){
+ return document.getElementById(id);
+}
+
hunk ./outEntry.js 36
- document.getElementById('category_'+num).innerHTML = txt;
+ gid('category_'+num).innerHTML = txt;
hunk ./outEntry.js 50
- var ul = document.getElementById ('bb');
+ var ul = gid ('bb');
}
問題がなければ、commit。
$ darcs record
hunk ./outEntry.js 7
+function gid (id){
+ return document.getElementById(id);
+}
+
Shall I record this patch? (1/3) [ynWsfqadjk], or ? for help: y
hunk ./outEntry.js 36
- document.getElementById('category_'+num).innerHTML = txt;
+ gid('category_'+num).innerHTML = txt;
Shall I record this patch? (2/3) [ynWsfqadjk], or ? for help: y
hunk ./outEntry.js 50
- var ul = document.getElementById ('bb');
+ var ul = gid ('bb');
Shall I record this patch? (3/3) [ynWsfqadjk], or ? for help: y
What is the patch name? New function gid.
Do you want to add a long comment? [yn] n
Finished recording patch 'New function gid.'
darcs のチェック・インは面白くて、修正部分の小さな固まりごとに
これは今回のパッチに含めるか?
と聞いてくる。コーディング中に typo を見つけた時なんか、この機能は便利。typo 部分だけ commit することができる。
いちいち聞かれたくない時は、
-a オプションを付ける。
修正が終わったら、ログを見ましょ。
$ darcs changes
Sat Sep 17 00:47:40 JST 2005 Masayuki Ataka <at-aka@email.address>
* New function gid.
Sat Sep 17 00:07:00 JST 2005 Masayuki Ataka <at-aka@email.address>
* Initial revision.
-s オプションで、詳しいログが見れる。
$ darcs changes -s
Sat Sep 17 00:47:40 JST 2005 Masayuki Ataka <at-aka@email.address>
* New function gid.
M ./outEntry.js -2 +6
Sat Sep 17 00:07:00 JST 2005 Masayuki Ataka <at-aka@email.address>
* Initial revision.
A ./outEntry.js
