~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/ja/user-guide/specifying_revisions.txt

Add a NEWS entry and prepare submission.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
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