~bzr-pqm/bzr/bzr.dev

4634.99.1 by Naoki INADA
import doc-ja rev90
1
.. _specifying-revisions:
2
3
リビジョンを指定する
4
====================
5
6
.. _revision-identifiers-and-ranges:
7
8
リビジョンの識別子と範囲
9
-------------------------
10
11
Bazaarは1つのリビジョンもしくはリビジョンの範囲を指定するための豊富な表現方法を持ちます。
12
リビジョンの範囲を指定するには、上限と下限を ``..`` のシンボルで区切ります。例です::
13
14
    $ bzr log -r 1..4
15
16
境界値の片方を省略できます::
17
18
    $ bzr log -r 1..
19
    $ bzr log -r ..4
20
21
コマンドの中には範囲ではなく1つのリビジョンだけをとるものがあります。例です::
22
23
    $ bzr cat -r 42 foo.c
24
25
他の場合、範囲は必要ですが、範囲の長さを1つにします。
26
これに関連したコマンドについて、 ``-c`` オプションは次のように使われます::
27
28
    $ bzr diff -c 42
29
30
.. _available-revision-identifiers:
31
32
利用可能なリビジョンの識別子
33
------------------------------
34
35
リビジョン、もしくは範囲の境界、は
36
下記に示される異なるフォーマットを利用して渡すことができます。
37
38
 +----------------------+--------------------------------------------+
39
 |  引数の型            | 説明                                       |
40
 +----------------------+--------------------------------------------+
41
 | *number*             | リビジョン番号                             |
42
 +----------------------+--------------------------------------------+
43
 | **revno**:*number*   | 正のリビジョン番号                         |
44
 +----------------------+--------------------------------------------+
45
 | **last**:*number*    | 負のリビジョン番号                         |
46
 +----------------------+--------------------------------------------+
47
 | **revid**:*guid*     | グローバルでユニークなリビジョンID         |
48
 +----------------------+--------------------------------------------+
49
 | **before**:*rev*     | ''rev''の左端の親                          |
50
 +----------------------+--------------------------------------------+
51
 | **date**:*value*     | 渡された日付の後の最初のエントリ           |
52
 +----------------------+--------------------------------------------+
53
 | **tag**:*value*      | 渡されたタグにマッチするリビジョン         |
54
 +----------------------+--------------------------------------------+
55
 | **ancestor**:*path*  | ブランチからのマージされた最新のリビジョン |
56
 +----------------------+--------------------------------------------+
57
 | **branch**:*path*    | 別のブランチの最新リビジョン               |
58
 +----------------------+--------------------------------------------+
59
 | **submit**:*path*    | 投稿ブランチの共通の祖先                   |
60
 +----------------------+--------------------------------------------+
61
62
これらのフォーマットの手短な紹介は下記のとおりです。
63
完全な詳細内容に関しては、 Bazaarユーザーリファレンスの `リビジョンの識別子`_ を参照してください。
64
65
.. _リビジョンの識別子: ../user-reference/bzr_man.html#revision-identifiers
66
67
番号
68
~~~~~
69
70
正の数は現在のブランチにおけるリビジョン番号を表します。
71
リビジョン番号は ``bzr log`` の出力の中で "revno"とラベルされます。
72
最初の10のリビジョンのログを表示するには::
73
74
    $ bzr log -r ..10
75
76
負の数は最新リビジョンから数えます。-1は最後にコミットされたリビジョンです。
77
78
最新の10のリビジョンのログを表示するには::
79
80
    $ bzr log -r -10..
81
82
revid
83
~~~~~
84
85
**revid** は ``bzr log`` と他のコマンドによって示される内部のリビジョンIDの指定を可能にします。
86
87
例です::
88
89
    $ bzr log -r revid:Matthieu.Moy@imag.fr-20051026185030-93c7cad63ee570df
90
91
before
92
~~~~~~
93
94
**before**
95
    ''rev''は''rev'' の左端の親を指定します。
96
    これはリビジョンの履歴で ''rev'' の前に現れるリビジョン、
97
    もしくは ''rev'' がコミットされたときに最新であったリビジョンです。
98
99
''rev'' はリビジョンの識別子であり連結できます。
100
101
例です::
102
103
    $ bzr log -r before:before:4
104
    ...
105
    revno: 2
106
    ...
107
108
date
109
~~~~
110
111
**date**
112
    ''value'' は真夜中もしくは指定された時刻での与えられた日付の、
113
    深夜12時か指定された時刻の後の最初の履歴エントリにマッチします。
114
115
正式な値は次のとおりです:
116
117
 * **yesterday**
118
 * **today**
119
 * **tomorrow**
120
 * **YYYY-MM-DD** 書式の日付
121
 * **YYYY-MM-DD,HH:MM:SS** 書式の日付/時間、2番目はオプションです (コンマに注意)
122
123
"今日のログエントリすべてをください"ということを伝える適切な方法は次のとおりです::
124
125
    $ bzr log -r date:yesterday..date:today
126
127
Ancestor
128
~~~~~~~~
129
130
**ancestor**:*path*
131
    現在のブランチと異なるブランチ間の共通の祖先を指定します。
132
    これはマージの目的に使われる同じ祖先です。
133
134
*path* はリモートブランチのURLもしくはローカルブランチへのファイルパスになります。
135
136
たとえば、 ``../parent`` からフォークされた以降のブランチで行われた変更を見るには::
137
138
    $ bzr diff -r ancestor:../parent
139
140
Branch
141
~~~~~~
142
143
branch
144
   ``path`` は別のブランチの最新リビジョンを指定します。
145
146
``path`` はリモートブランチのURLもしくはローカルブランチへのファイルパスです。
147
148
たとえば、手元のブランチと別のブランチの間の違いを取得するには::
149
150
    $ bzr diff -r branch:http://example.com/bzr/foo.dev
151