Mercurial チートシート¶

設定ファイルの場所¶

ユーザ名の設定¶

設定ファイルに次の項目を追加します。

[ui]
username=Takumi IINO <takumi@timedia.co.jp>

help(hg help)¶

% hg help

サブコマンドのhelp(hg help [COMMAND])¶

% hg help [コマンド]

% hg help help           # helpのhelpを表示

グローバルオプションを表示¶

hgのオプションに-vを追加する

% hg -v help log

リポジトリの新規作成(hg init)¶

% mkdir hello
% cd hello
% hg init

リポジトリのクローン(hg clone)¶

% hg clone http://selenic.com/hg mercurial-repo
requesting all changes
adding changesets
adding manifests
adding file changes
added 13537 changesets with 26617 changes to 1971 files
updating to branch default
872 files updated, 0 files merged, 0 files removed, 0 files unresolved
%

コミットログを確認する(hg log)¶

% hg log       # 全てのログを表示
% hg log -l 10 # 最新10個のログを表示
% hg log -l 10 --branch default # ブランチを指定してログを表示

サマリー(hg summary)¶

% hg summary
parent: 13536:fac040b7e822 tip
 merge: drop resolve state for mergers with identical contents (issue2680)
branch: default
commit: (clean)
update: (current)
%

現在のリビジョン(hg parents)¶

% hg parents
changeset:   13536:fac040b7e822
tag:         tip
user:        Matt Mackall <mpm@selenic.com>
date:        Sat Mar 05 16:34:59 2011 -0600
summary:     merge: drop resolve state for mergers with identical contents (issue2680)

%

最新のリビジョン(hg tip)¶

% hg tip
changeset:   13536:fac040b7e822
tag:         tip
user:        Matt Mackall <mpm@selenic.com>
date:        Sat Mar 05 16:34:59 2011 -0600
summary:     merge: drop resolve state for mergers with identical contents (issue2680)

%

現在のブランチ(hg branch)¶

% hg branch
default
%

ブランチの一覧とブランチ毎の最新のリビジョン(hg branches)¶

% hg branches
default                    13536:fac040b7e822
stable                     13534:4ec34de8bbb1 (inactive)
%

指定したリビジョンに移動(hg update [REV])¶

% hg update [リビジョン]
#+END_SRC
#+BEGIN_SRC sh
% hg parent --template "{rev}\n"
13536
% hg update 13524 # リビジョン 13524に移動
10 files updated, 0 files merged, 0 files removed, 0 files unresolved
% hg parent --template "{rev}\n"
13524
%

最新のリビジョンに移動(hg update)¶

% hg update
#+END_SRC
#+BEGIN_SRC sh
% hg parent --template "{rev}\n"
13524
% hg update # 最新のリビジョンに移動
10 files updated, 0 files merged, 0 files removed, 0 files unresolved
% hg parent --template "{rev}\n"
13536
%

ブランチの移動(hg update [BRANCH])¶

% hg update [ブランチ名]

% hg branch
default
% hg update stable
22 files updated, 0 files merged, 0 files removed, 0 files unresolved
% hg branch
stable
%

ファイルを追加する(hg add)¶

% echo 'puts "Hello, mercurial."' > hello.rb
% hg add hello.rb
%

コミットする(hg commit)¶

% hg tip
changeset:   -1:000000000000
tag:         tip
user:
date:        Thu Jan 01 00:00:00 1970 +0000

% hg commit -m "add hello.rb"
% hg tip
changeset:   0:c0d1b673238b
tag:         tip
user:        Takumi IINO <takumi@timedia.co.jp>
date:        Sun Mar 06 22:27:01 2011 +0900
summary:     add hello.rb

%

変更を確認する(hg diff)¶

% sed -i -e s/m/M/ hello.rb
% hg diff
diff -r c0d1b673238b hello.rb
--- a/hello.rb  Sun Mar 06 22:27:01 2011 +0900
+++ b/hello.rb  Sun Mar 06 22:34:35 2011 +0900
@@ -1,1 +1,1 @@
-puts "Hello, mercurial."
+puts "Hello, Mercurial."
%
% # もう一つ追加してみる
% echo 'print "Hello, Mercurial.\n";' > hello.pl
% hg add hello.pl
% hg diff hello.pl
diff -r c0d1b673238b hello.pl
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/hello.pl  Sun Mar 06 22:36:56 2011 +0900
@@ -0,0 +1,1 @@
+print "Hello, Mercurial.\n";
%

変更されたファイル一覧(hg status)¶

% hg status
M hello.rb
A hello.pl
%

変更を取り消す(hg revert)¶

% hg revert hello.pl
% hg status
M hello.rb
? hello.pl
%
% hg add hello.pl # またaddしておこう

コミットを取り消す(hg rollback)¶

% hg commit -m "add perl sample" # 二つの変更をコミットしてしまった
% hg diff -c 1
diff -r c0d1b673238b -r 30b4e1e501a3 hello.pl
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/hello.pl  Sun Mar 06 22:42:41 2011 +0900
@@ -0,0 +1,1 @@
+print "Hello, Mercurial.\n";
diff -r c0d1b673238b -r 30b4e1e501a3 hello.rb
--- a/hello.rb  Sun Mar 06 22:27:01 2011 +0900
+++ b/hello.rb  Sun Mar 06 22:42:41 2011 +0900
@@ -1,1 +1,1 @@
-puts "Hello, mercurial."
+puts "Hello, Mercurial."
%
% hg rollback
repository tip rolled back to revision 0 (undo commit)
working directory now based on revision 0
%
% hg commit -m "camelize" hello.rb
% hg commit -m "add perl sample"
%

最新のコミットのみrollback可能

% hg log --template "{rev}:{node}: {desc}\n"
2:c0266fae871b5783d4f4a50faf0694d41df01418: add perl sample
1:f491ca2a61140034ed906d7d45893838493246c8: camelize
0:c0d1b673238bd257f79a7c2779f1e0d8e24d3524: add hello.rb
%
% hg rollback
repository tip rolled back to revision 1 (undo commit)
working directory now based on revision 1
%
% hg rollback
no rollback information available
%
% hg log --template "{rev}:{node}: {desc}\n"
1:f491ca2a61140034ed906d7d45893838493246c8: camelize
0:c0d1b673238bd257f79a7c2779f1e0d8e24d3524: add hello.rb
%
% hg commit -m "add perl sample"
% hg log --template "{rev}:{node}: {desc}\n"
2:c0266fae871b5783d4f4a50faf0694d41df01418: add perl sample
1:f491ca2a61140034ed906d7d45893838493246c8: camelize
0:c0d1b673238bd257f79a7c2779f1e0d8e24d3524: add hello.rb
%

multiple headsを作る(hg update [REV] & hg commit)¶

% hg log --template "{rev}:{node}: {desc}\n"
2:c0266fae871b5783d4f4a50faf0694d41df01418: add perl sample
1:f491ca2a61140034ed906d7d45893838493246c8: camelize
0:c0d1b673238bd257f79a7c2779f1e0d8e24d3524: add hello.rb
%
% # 一つ前に戻る
% hg update 1
0 files updated, 0 files merged, 1 files removed, 0 files unresolved
% hg parents --template "{rev}:{node}\n"
1:f491ca2a61140034ed906d7d45893838493246c8
%
% # 二つ目のheadsを作る
% echo 'print "Hello, Mercurial."' > hello.py
% hg add hello.py
% hg commit -m "add python sample"
created new head
%

multiple headsの確認(hg heads)¶

% hg heads
changeset:   3:980f8866917a
tag:         tip
parent:      1:f491ca2a6114
user:        Takumi IINO <takumi@timedia.co.jp>
date:        Mon Mar 07 00:10:18 2011 +0900
summary:     add python sample

changeset:   2:46f0166b17d8
user:        Takumi IINO <takumi@timedia.co.jp>
date:        Sun Mar 06 22:53:57 2011 +0900
summary:     add perl sample

%

2つのmultiple headsの統合(hg merge)¶

% hg merge
1 files updated, 0 files merged, 0 files removed, 0 files unresolved
(branch merge, don't forget to commit)
% hg status
M hello.pl
%
% # この状態でparentsを確認すると二つあることがわかる。
% hg parents --template "{rev}:{node}\n"
3:980f8866917a1098d08f1e1b85dc396fecbc83ad
2:46f0166b17d886637c30e6f486b23043be56b22e
%
% hg commit -m "merge changeset: 2:46f0166b17d8"
% hg heads
changeset:   4:4b83e608a7d0
tag:         tip
parent:      3:980f8866917a
parent:      2:46f0166b17d8
user:        Takumi IINO <takumi@timedia.co.jp>
date:        Mon Mar 07 00:17:50 2011 +0900
summary:     merge changeset: 2:46f0166b17d8

% ls
hello.pl  hello.py  hello.rb
%

3つのmultiple headsの統合(hg merge -r [REV])¶

衝突の解決(hg resolve)¶

ブランチの作成(hg branch [NAME])¶

% hg branch makefile_fix
marked working directory as branch makefile_fix
% hg branch
makefile_fix
%
% # コミット前はブランチ一覧には登場しない
% hg branches
default                       11:1597cc35cade
%
% # hg summaryでブランチの次のコミットの確認
% hg summary
parent: 11:1597cc35cade tip
 guileがelispを置き換えるなら考える
branch: makefile_fix
commit: 1 unknown (new branch)
update: (current)
%
% hg commit -m "start makefile_fix branch"
% hg branches
makefile_fix                  12:7293a6112d50
default                       11:1597cc35cade (inactive)
%

“別のブランチ”の変更の取り込み(hg merge)¶

makefile_fixの変更をdefaultブランチに取り込む¶

% hg up default
1 files updated, 0 files merged, 0 files removed, 0 files unresolved

makefile_fixの変更をdefaultブランチに取り込む

% hg merge makefile_fix
1 files updated, 0 files merged, 0 files removed, 0 files unresolved
(branch merge, don't forget to commit)
% hg ci -m "merge makefile_fix"
% hg log -l 1
changeset:   15:4e0ddd138f6b
tag:         tip
parent:      11:1597cc35cade
parent:      14:3cb402ea1e44
user:        Takumi IINO <takumi@timedia.co.jp>
date:        Sun Mar 20 21:58:05 2011 +0900
summary:     merge makefile_fix

%

ブランチを閉じる(hg commit –close-branch)¶

% hg branch
default
[takumi@takumi-THINK:~/sandbox/hello-repo.back(2)]
% hg up makefile_fix
0 files updated, 0 files merged, 0 files removed, 0 files unresolved
% hg commit --close-branch -m "finish."
% hg branch
makefile_fix
% hg branches
default                       15:4e0ddd138f6b
% hg branches --closed
default                       15:4e0ddd138f6b
makefile_fix                  16:f976730a0346 (closed)
% hg up default
0 files updated, 0 files merged, 0 files removed, 0 files unresolved
%

“別のリポジトリの同じブランチ”の変更の取り込み(hg pull)¶

すでに変更を加えていた場合の”別のリポジトリの同じブランチ”の変更の取り込み(hg pull)¶

“別のリポジトリの同じブランチ”へ変更の送信(hg push)¶

タグをつける(hg tag)¶

% hg parents --template "{rev}:{node}\n"
22:650e447b9fb133f3013b61acb2d36145f1c3e6cd
%
% hg tag v0.0.1
% hg log -l 1
changeset:   23:5d7a5fdc0b1a
tag:         tip
user:        Takumi IINO <takumi@timedia.co.jp>
date:        Sun Mar 20 23:12:38 2011 +0900
summary:     Added tag v0.0.1 for changeset 650e447b9fb1

%

よく見ると.hgtagsというファイルが新規作成されている。

% ls -a
./  ../  .hg/  .hgtags  hello.cl  hello.hs  hello.pl  hello.py  hello.rb  hello.scm  Makefile
% cat .hgtags
650e447b9fb133f3013b61acb2d36145f1c3e6cd v0.0.1
%