/brz/remove-bazaar

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar

« back to all changes in this revision

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

  • Committer: Vincent Ladeuil
  • Date: 2012-01-18 14:09:19 UTC
  • mto: This revision was merged to the branch mainline in revision 6468.
  • Revision ID: v.ladeuil+lp@free.fr-20120118140919-rlvdrhpc0nq1lbwi
Change set/remove to require a lock for the branch config files.

This means that tests (or any plugin for that matter) do not requires an
explicit lock on the branch anymore to change a single option. This also
means the optimisation becomes "opt-in" and as such won't be as
spectacular as it may be and/or harder to get right (nothing fails
anymore).

This reduces the diff by ~300 lines.

Code/tests that were updating more than one config option is still taking
a lock to at least avoid some IOs and demonstrate the benefits through
the decreased number of hpss calls.

The duplication between BranchStack and BranchOnlyStack will be removed
once the same sharing is in place for local config files, at which point
the Stack class itself may be able to host the changes.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/ja/user-guide/specifying_revisions.txt
 
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
 | *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
 +----------------------------+--------------------------------------------+
 
67
 
 
68
これらのフォーマットの手短な紹介は下記のとおりです。
 
69
完全な詳細内容に関しては、 Bazaarユーザーリファレンスの `リビジョンの識別子`_ を参照してください。
 
70
 
 
71
.. _リビジョンの識別子: ../user-reference/index.html#revision-identifiers
 
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
 
 
91
**revid** は ``bzr log --show-ids`` や他のコマンドによって示される内部の
 
92
リビジョンIDの指定を可能にします。
 
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