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