~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/ja/user-reference/index.txt

  • Committer: John Arbash Meinel
  • Date: 2010-02-17 17:11:16 UTC
  • mfrom: (4797.2.17 2.1)
  • mto: (4797.2.18 2.1)
  • mto: This revision was merged to the branch mainline in revision 5055.
  • Revision ID: john@arbash-meinel.com-20100217171116-h7t9223ystbnx5h8
merge bzr.2.1 in preparation for NEWS entry.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.. This file is autogenerated from the output of
 
2
..     bzr help topics
 
3
..     bzr help commands
 
4
..     bzr help <cmd>
 
5
..
 
6
.. Generation time: 2009-01-09 07:03:09 +0000
 
7
 
 
8
##########################
 
9
Bazaarユーザーリファレンス
 
10
##########################
 
11
 
 
12
:Version:   1.11
 
13
:Generated: 2009-01-09
 
14
 
 
15
.. contents:: :depth: 2
 
16
 
 
17
-----
 
18
 
 
19
このチュートリアルについて
 
20
##########################
 
21
 
 
22
このマニュアルはBazaarのオンラインヘルプから生成されました。オンラインヘルプのシステムを
 
23
利用するためには次のコマンドを試してください。
 
24
 
 
25
    よく使われるコマンドの一覧を含めて紹介します::
 
26
 
 
27
        bzr help
 
28
 
 
29
    トピックの一覧とそれぞれの要約::
 
30
 
 
31
        bzr help topics
 
32
 
 
33
    コマンドの一覧とそれぞれの要約::
 
34
 
 
35
        bzr help commands
 
36
 
 
37
    特定のトピックもしくはコマンドに関する詳細な情報::
 
38
 
 
39
        bzr help topic-or-command-name
 
40
 
 
41
次のウェブサイトはBazaarに関する詳細な情報を提供します:
 
42
 
 
43
:ホームページ:                     http://www.bazaar-vcs.org/
 
44
:公式ドキュメント:                 http://doc.bazaar-vcs.org/
 
45
:Launchpad:                     https://launchpad.net/bzr/
 
46
 
 
47
概念
 
48
####
 
49
 
 
50
ブランチ
 
51
=========
 
52
 
 
53
ブランチは、すべての履歴を含む、プロジェクトの状態で構成されます。
 
54
すべてのブランチは関連づけされたリポジトリ(ブランチの履歴が保存される場所)を持ちますが、
 
55
複数のブランチは同じリポジトリを共有することもあります(共用リポジトリ)。
 
56
ブランチはコピーしたりマージしたりできます。
 
57
 
 
58
関連コマンド::
 
59
 
 
60
  init    ディレクトリをバージョン管理されたブランチに変更する。
 
61
  branch  ブランチの新しいコピーを作成する。
 
62
  merge   3方向マージ (3-way merge) を実行する。
 
63
 
 
64
 
 
65
チェックアウト
 
66
==============
 
67
 
 
68
チェックアウトはブランチに結びつけられたソースツリーなので、
 
69
ソースツリーにコミットするときに、コミットの内容はブランチに格納されます。
 
70
必要になるまでBazaarの分散型機能の一部を無視して、よりシンプルに、集中型のワークフローを利用できます。
 
71
共用リポジトリでチェックアウトを利用することはSVNもしくはCVSでの作業とよく似ていますが、同じ制限を持ちません。
 
72
そしてチェックアウトを利用することで望むワークフローがなんであれ他の人もプロジェクトに取り組むことができます。
 
73
 
 
74
チェックアウトはbzr checkoutコマンド("help checkout"を参照)によって作成されます。
 
75
これに別のブランチへのリファレンスを渡し、マスターブランチからのチェックアウトを作成したブランチへのリファレンスを
 
76
まだ含むローカルコピーを作成します。
 
77
 
 
78
何かコミットをすればこれらは他のブランチで最初に作成されます。
 
79
これによって作業内容のインスタントミラーが作成されるもしくは
 
80
それぞれの開発者が共同で作業して他の人の変更を継続的に統合するロックステップ開発を円滑にします。
 
81
 
 
82
しかしながらチェックアウトはまだBazaarの第一級のブランチで、すべての履歴をローカルで保存できます。
 
83
第一級のブランチがあるので、ローカルにコミットすることもできます。
 
84
たとえば、ネットワーク接続による一時的な遅延を回避したいのであれば、ローカルでもコミットできます。
 
85
これを行うには --local オプションを使います。
 
86
次にローカルではないコミットを行うときにすべてのローカルコミットはマスターブランチに行われます。
 
87
 
 
88
共用ブランチからのチェックアウトを使用しているとき、周期的に他の人による変更をすべてpullしたくなります。
 
89
これは"update"コマンドによってできます。
 
90
ローカルではないコミットの前に変更が適用される必要がありますが、
 
91
Bazaarは変更が存在することを伝え必要なときにこのコマンドを使うように提示します。
 
92
 
 
93
checkoutコマンドに--lightweightフラグを渡すことで"軽量"チェックアウトを作成することも可能です。
 
94
第一級のブランチではなく、主に作業ツリーで構成されるという点で、軽量チェックアウトはSVNのチェックアウトにより近いです。
 
95
履歴のオペレーションはマスターブランチに問い合わせをしなければならないので、
 
96
ネットワーク接続が関わる場合遅くなる可能性があることを意味します。
 
97
また、ローカルブランチを持たないので、ローカルでコミットできません。
 
98
 
 
99
マスターブランチに高速で信頼性のあるアクセス権限があるときに軽量チェックアウトは最も良く動作します。
 
100
マスターブランチが同じディスクもしくはLAN上にあれば、(ブランチのコピーの更新だけが必要なので)
 
101
リビジョンを変更するどのコマンドでも軽量ブランチは重量ブランチよりも速くなることを意味します。
 
102
一般的に重量チェックアウトは速いですが、マスターブランチが同じディスク上のあるときは、顕著な違いはありません。
 
103
 
 
104
チェックアウトの別の使い方はブランチを格納するツリーなしのリポジトリで使うことです。
 
105
ここでは異なるブランチに取り組むときチェックアウトが指定するマスターブランチを切り替えることで
 
106
1つの作業ツリーだけを維持します。
 
107
 
 
108
明確にチェックアウトにコミットするにはマスターブランチへの書き込み権限が必要です。
 
109
マスターブランチはsftp://といった書き込み可能なプロトコルでアクセスしなければならないので、
 
110
相手方で書き込み権限をもたなければならないことを意味します。
 
111
チェックアウトはローカルファイルシステムでも機能するので、すべての問題はファイルのパーミッションです。
 
112
 
 
113
"bind"コマンド("help bind"を参照)を使用することでチェックアウトのマスターを変更できます。
 
114
これによってコミットが送信される位置が変更されます。
 
115
bindコマンドはブランチをheavyチェックアウトに変換するためにも使用できます。
 
116
すべてのコミットがローカルで行われるようにheavyチェックアウトを通常のブランチに変換したい場合、
 
117
"unbind" コマンドを使用できます。
 
118
 
 
119
関連コマンド::
 
120
 
 
121
  checkout    チェックアウトを作成する。軽量チェックアウトを得るには --lightweight を渡す
 
122
  update      マスターブランチの変更をあなたのチェックアウトにpullする
 
123
  commit      マスターブランチに送信されるコミットを行う。
 
124
              重量チェックアウトであれば --localオプションによって
 
125
              マスターにコミットを送信せずにチェックアウトにコミットされます
 
126
  bind        送信されるチェックアウトにコミットされるマスターブランチを変更する
 
127
  unbind      コミットがローカルだけで行われるように重量チェックアウトをスタンドアロンのブランチに変換する
 
128
 
 
129
 
 
130
クリスクロス
 
131
============
 
132
 
 
133
ブランチの履歴のクリスクロス(Criss-cross)は通常期待されるよりも多くのコンフリクトを出すデフォルトのマージテクニックを必要とします。
 
134
 
 
135
複雑なマージの場合、 ``bzr merge --lca`` もしくは ``bzr merge --weave`` ではよりよい結果になるかもしれません。
 
136
作業ツリーを ``bzr revert`` して再度マージしたいと願うかもしれません。
 
137
代わりに、特定の衝突しているファイル上で ``bzr remerge`` を使います。
 
138
 
 
139
2つのブランチが同じものをマージしてお互いにマージし合う場合、
 
140
もしくは2つのブランチが同時にお互いをマージする場合、クリスクロスはブランチの中で発生します。
 
141
それぞれのブランチが目的の集中型ブランチからもしくはそのブランチからのみマージすることでこれらを回避できます("star topology")。
 
142
 
 
143
マージが動作する方法のためクリスクロスは問題を引き起こします。
 
144
Bazaarのデフォルトマージは三方向マージです; OTHERをTHISにマージするには比較、BASE用の基本を見つけなければなりません。
 
145
BASEを利用することで、THISとOTHERの違いが行を追加するワンサイドか、行を削除する別のサイドによるのかを決定できます。
 
146
 
 
147
クリスクロスはベースに関してよい選択肢がないことを意味します。
 
148
最近のマージポイントを選択することはワンサイドの変更を少し廃棄してしまう可能性があります。
 
149
(Bazaarが行う)古いマージポイントを選択することは余分な衝突が発せられることを意味します。
 
150
 
 
151
``weave`` マージタイプはこの問題の影響を受けません。
 
152
このタイプは違いの原因を決定するためにベースのリビジョンの代わりに行を起点とする検出方法を利用するからです。
 
153
 
 
154
 
 
155
ストレージフォーマット
 
156
=======================
 
157
 
 
158
古いクライアントが不正にデータにアクセスしないことを保証するために、
 
159
Bazaarのポリシーでは新しい機能が新しいメタデータを追加する必要があるときに
 
160
新しいフォーマットを導入することにしています。新しいストレージフォーマットは
 
161
パフォーマンスとスケーラビリティを改善するために導入することもあります。
 
162
 
 
163
フォーマットを選ぶために次のガイドラインを利用します(条件がtrueであると同時に停止):
 
164
 
 
165
* 既存のプロジェクトに取り組んでいる場合、プロジェクトが利用しているものを使用します。
 
166
  (デフォルトでBazaarはあなたの代わりにこれを行います)。
 
167
 
 
168
* Subversionリポジトリと連携するbzr-svnを利用している場合は、
 
169
  1.9-rich-rootを使用します。
 
170
 
 
171
* 大きなツリー(5000以上のパス)もしくは深い履歴(5000以上のリビジョン)を持つ
 
172
  プロジェクトに取り組んでいるのであれば、1.9を使用します。
 
173
 
 
174
* さもなければ、デフォルトのフォーマットを使用します。大抵のプロジェクトはこれで十分です。
 
175
 
 
176
(ディストロのパッケージを利用しているなどで)最新のBazaarを利用できない開発者がいるのであれば、
 
177
それに応じてガイドラインを調整してください。
 
178
たとえば、プロジェクトがBazaar 1.7を標準化している場合、1.9の代わりに1.6を選ぶことが必要です。
 
179
 
 
180
注: 現在サポートされるフォーマットの多くは2つのバリアントを持ちます:
 
181
plainのものとrich-rootのものです。
 
182
後者はツリーのrootに関する追加フィールドを含みます。
 
183
rich-rootフォーマットを利用する際にパフォーマンスコストはありませんが
 
184
rich-rootフォーマットからの変更をplainフォーマットに簡単にマージできません。
 
185
結果として、すべての投稿者がほぼ同時にリポジトリをアップグレードする必要があるので、
 
186
プロジェクトをrich-rootフォーマットに移行させるには調整が必要です。
 
187
(これまでのところrich-rootフォーマットをデフォルトにすることを遅らせてきた理由です。
 
188
将来の適切な時期にこれを行います。)
 
189
 
 
190
現在サポートされるフォーマットの完全なリストに関しては ``bzr help current-formats`` を参照してください。
 
191
利用可能で実験上もしくは廃止されたフォーマットに関しては ``bzr help other-formats`` を参照してください。
 
192
 
 
193
 
 
194
パターン
 
195
========
 
196
 
 
197
Bazaarはさまざまな時点でマッチするファイルを使用します。
 
198
たとえば、 ``add`` コマンドは無視するパターンにマッチするファイルとスキップし
 
199
プリファレンスはルールパターンを使用するファイルに関連づけできます。
 
200
パターン構文は下記のとおりです。
 
201
 
 
202
パターン上のトレーリングスラッシュは無視されます。
 
203
パターンがスラッシュを含むもしくは正規表現である場合、ブランチのroot全体から比較されます。
 
204
さもなければ、これはパスの最後のコンポーネントのみと比較されます。
 
205
rootディレクトリの中のファイルのみにマッチさせるには'./'を用意します。
 
206
絶対パスを指定するパターンは許可されていません。
 
207
 
 
208
パターンは次のようなglobのワイルドカードを含むことができます::
 
209
 
 
210
  ? - '/'以外の単独文字にマッチする
 
211
  * - '/'以外の0かそれ以上の文字数にマッチする
 
212
  /**/ - パスの中のゼロかそれ以上のディレクトリにマッチする
 
213
  [a-z] - 文字のグループの範囲内からの単独の文字にマッチする
 
214
 
 
215
パターンはPythonの正規表現にもなります。
 
216
正規表現のパターンは 'RE:' の接頭辞で始まる正規表現で識別されます。
 
217
正規表現のパターンは名前つきもしくは番号つきのグループを含むことはできません。
 
218
 
 
219
 
 
220
リポジトリ
 
221
===========
 
222
 
 
223
Bazaarのリポジトリはコミットされた情報が保存される場所です。
 
224
すべてのブランチと関連づけされたリポジトリが1つ存在します。
 
225
 
 
226
リポジトリは一種のデータベースです。
 
227
通常、パフォーマンスのためにBzrはこれを自動的に維持しますが、ある状況(たとえば短い期間にとても多くのコミットを行う)
 
228
 
 
229
データベースのインデックスを最適化するようbzrに求めるとよいでしょう。
 
230
これは'bzr pack' コマンドによって行われます。
 
231
 
 
232
デフォルトでは 'bzr init' を実行するだけで新しいブランチの中でリポジトリが作成されますが、
 
233
同じ位置で情報を共有するために複数のブランチを許可する共用リポジトリを作成することが可能です。
 
234
新しいブランチが作成されたとき使用できる共用リポジトリが存在するかどうかを最初に確認します。
 
235
 
 
236
同じプロジェクトのブランチが1つのリポジトリを共有するとき、一般的にスペースが大きく節約されます。
 
237
(たとえばリポジトリの範囲内でブランチを作成するなどの)いくつかのコマンドに対してこれは大きな時間の節約になります。
 
238
 
 
239
共用リポジトリを作るには、init-repositoryコマンド(もしくはエイリアスのinit-repo)を使います。
 
240
このコマンドは作成するリポジトリの位置をとります。
 
241
このことは'bzr init-repository repo'によって'repo'という名前のディレクトリが作成され
 
242
その中に共用リポジトリが格納されることを意味します。
 
243
このディレクトリの中に作成された新しいブランチはストレージ用にそれを使用します。
 
244
 
 
245
1つ以上のプロジェクトのブランチを作成するときに1つのリポジトリを作成することはよい考えです。
 
246
これは開発を行っている作業領域と、ホスティングプロジェクト用のサーバー領域の両方にあてはまります。
 
247
後者の場合、作業ツリーなしのブランチが欲しいことは良くあります。
 
248
ブランチのファイルは直接編集されないので作業ツリー用にディスクスペースを使い切る必要はありません。
 
249
作業ブランチを持たないリポジトリを作成するには、 'init-repository'に'--no-trees'オプションを渡します。
 
250
 
 
251
関連コマンド::
 
252
 
 
253
  init-repository   共用リポジトリを作成する。
 
254
                    新しいブランチが作業ツリーを作成しないものを作成するには--no-treesを使用する。
 
255
 
 
256
 
 
257
ルール
 
258
=======
 
259
 
 
260
紹介
 
261
-----
 
262
 
 
263
ルールはiniファイルフォーマットで定義されます。
 
264
セクションはファイルのglobパターンでそれぞれのセクションの内容は
 
265
そのパターンにマッチするファイル用のプリファレンスです。例です::
 
266
 
 
267
    [name *.bat]
 
268
    eol = dos
 
269
 
 
270
    [name *.html]
 
271
    keywords = escape
 
272
 
 
273
これらのようなプリファレンスは選択されたブランチの中で
 
274
選択されたファイル用にカスタムのふるまいを提供したいコマンドとプラグインに役立ちます。
 
275
 
 
276
 
 
277
ファイル
 
278
---------
 
279
 
 
280
すべてのブランチ用のデフォルトルールはオプションの ``BZR_HOME/rules`` ファイルで定義されます。
 
281
 
 
282
ルールのパターン
 
283
-----------------
 
284
 
 
285
パターンは順序づけされ1つマッチすると共に検索は停止します。
 
286
結果として、より明確なパターンをファイルのトップの方に置くべきです。
 
287
ルールパターンは無視パターンとまったく同じ仕様を利用します。
 
288
詳細は ``bzr help patterns`` を参照してください。
 
289
 
 
290
注: 角かっこを含むパターンはそれらが正しく解析されるようにクォートで囲まなければなりません。
 
291
 
 
292
 
 
293
スタンドアロンのツリー
 
294
=======================
 
295
 
 
296
スタンドアロンのツリーは関連リポジトリを持つ作業ツリーです。
 
297
他に依存していないので、これは独立して利用できるブランチです。
 
298
(bzr initを通して)スタンドアロンのツリーの作成は
 
299
既存のプロジェクトをバージョン管理の元に置くための最も速い方法です。
 
300
 
 
301
関連コマンド::
 
302
 
 
303
  init    ディレクトリをバージョン管理下にあるブランチにする。
 
304
 
 
305
 
 
306
同期化がずれているブランチ
 
307
==========================
 
308
 
 
309
チェックアウト、ツリーもしくはブランチを軽量ブランチに再設定するとき、
 
310
ローカルのブランチを破壊しなければなりません。
 
311
(チェックアウトに関して、これはキャッシュとして最初に提供するローカルブランチです。)
 
312
破壊されるブランチが同じ最終リビジョンを持たなければ、
 
313
軽量用チェックアウト用の新しい参照ブランチ、データが失われる可能性があるので、
 
314
Bazaarは拒否します。
 
315
 
 
316
この取り組み方は *なぜ* ブランチの同期がずれるのかによります。
 
317
 
 
318
チェックアウトが手元にありローカルコミットを行う場合、
 
319
"bzr update"(とおそらくは"bzr commit")を実行することで再び同期化できます。
 
320
 
 
321
ブランチが手元にあり、リモートブランチが時代遅れになっている場合、
 
322
"bzr push"を使用してローカルの変更をプッシュできます。
 
323
ローカルブランチが時代遅れであれば、"bzr pull"をできます。
 
324
両方のブランチに変更があれば、変更をマージ、コミットしてプッシュできます。
 
325
変更の一部が便利でなければ、"push --overwrite"もしくは代わりに"pull --overwrite"できます。
 
326
 
 
327
 
 
328
作業ツリー
 
329
===========
 
330
 
 
331
作業ツリーはディスク上に設置されたブランチのコンテンツなのでファイルを見て編集できます。
 
332
作業ツリーはブランチに変更を行う場所なので、
 
333
作業ツリーの現在の状態をコミットするとき、コミットに記録されるレコードです。
 
334
 
 
335
ブランチをリモートシステムにプッシュするとき、作業ツリーは作成されません。
 
336
ファイルがすでに存在すれば、ファイルは更新されません。
 
337
ブランチの情報は更新され作業ツリーは時代遅れとしてマークされます。
 
338
リモートの作業ツリーを更新するのは難しいです。
 
339
アンコミットされた変更が存在するもしくは更新によってリモートで扱うのが難しい内容の衝突が引き起こされるからです。
 
340
 
 
341
作業ツリーなしのブランチがあれば 作業ツリーを作成するために 'checkout' コマンドを使用できます。
 
342
ブランチから 'bzr checkout .' を実行すると作業ツリーが作成されます。
 
343
リモートでブランチが更新されると、そのディレクトリの中で'bzr update'を実行することで作業ツリーを更新できます。
 
344
 
 
345
望まない作業ツリーを持つブランチがある場合、安全であれば'remove-tree'コマンドはツリーを除外します。
 
346
ブランチにプッシュするとき更新されないリモート作業ツリーに関する警告を回避することでこれは可能です。
 
347
これは'--no-trees'リポジトリ('bzr help repositories'を参照)に取り組むときにも便利です。
 
348
 
 
349
プッシュするリモートマシン上で作業ブランチを持ちたい場合、
 
350
pushするごとにリモートブランチで'bzr update'を実行するか、
 
351
pushの間にツリーを更新する他の方法を使用できます。
 
352
rsyncを使用してpushと同じように作業ツリーを更新する'rspush'プラグインが存在します。
 
353
それぞれのプッシュの後で'bzr update'を自動的に実行する'push-and-update'プラグインも存在します。
 
354
 
 
355
便利なコマンド::
 
356
 
 
357
  checkout     ブランチが作業ツリーを持たないときにそれを作成する。
 
358
  remove-tree  これを行うときに安全であるときにブランチから作業ツリーを除外する。
 
359
  update       作業ツリーが関連ブランチから同期がずれているとき
 
360
               このコマンドによってブランチにマッチするツリーが更新される。
 
361
 
 
362
.. _formats: `ストレージフォーマット`_
 
363
.. _standalone-trees: `スタンドアロンのツリー`_
 
364
.. _sync-for-reconfigure: `同期化がずれているブランチ`_
 
365
.. _working-trees: `作業ツリー`_
 
366
 
 
367
 
 
368
 
 
369
リスト
 
370
#######
 
371
 
 
372
認証の設定
 
373
===========
 
374
 
 
375
 
 
376
Intent
 
377
------
 
378
 
 
379
``authentication.conf`` ファイルの中で多くの異なる認証ポリシーは記述できますが
 
380
特定のユーザーはすべてのブランチ用のユーザーとパスワードを指定しなくても
 
381
自分のニーズをカバーするわずかな定義だけが必要です。
 
382
 
 
383
このファイルの中で見つかる定義は与えられたurl用のクレデンシャルを見つけるために使われます。
 
384
一般的に同じクレデンシャルを必要とするリモートサーバーの周辺で宣言を分類することで可能な限り多くのブランチに対して
 
385
クレデンシャルを使用できます。
 
386
 
 
387
異なるサーバーによって使用されるクレデンシャルを宣言することも可能です。
 
388
 
 
389
intentは維持を最少にするためにこのファイルを可能な限り小さくするものです。
 
390
 
 
391
このファイルの中で関連のクレデンシャルが宣言されるとパスワード(セキュリティハザード)を埋め込まず
 
392
もしくは(他の人とURLの共有を有効にする)ユーザーなしでブランチのURLを利用できます。
 
393
 
 
394
次のURLよりも::
 
395
 
 
396
  bzr branch ftp://joe:secret@host.com/path/to/my/branch
 
397
 
 
398
シンプルになります::
 
399
 
 
400
  bzr branch ftp://host.com/path/to/my/branch
 
401
 
 
402
``authentication.conf`` ファイルを作成したことを前提とします::
 
403
 
 
404
  [myprojects]
 
405
  scheme=ftp
 
406
  host=host.com
 
407
  user=joe
 
408
  password=secret
 
409
 
 
410
 
 
411
認証の定義
 
412
-----------
 
413
 
 
414
bzrによってサポートされるさまざまなスキームによって使用される2種類の認証があります:
 
415
 
 
416
1. ユーザーとパスワード
 
417
 
 
418
``FTP`` は ``host`` 用に (``user`` 、 ``password``) を必要とします。
 
419
``SFTP`` は認証用にパスワードもしくはホストキーを使用できます。
 
420
しかしながら、sshエージェントはベターで、よりセキュアな解決方法です。
 
421
独自のセキュアではない方法を提供しないことにします。
 
422
 
 
423
2. ユーザー、領域とパスワード
 
424
 
 
425
ホストに対して認証するために ``HTTP`` と ``HTTPS`` は(``user, realm, password``)を必要とします。
 
426
``.htaccess`` ファイルを利用することで、たとえば、任意の ``host``
 
427
に対して (``user, realm, password``) をいくつか定義することが可能です。
 
428
ですので本当に必要なのは (``user``, ``password``, ``host``, ``path``)です。
 
429
``realm`` は定義で考慮されませんが、bzrにパスワードを催促される場合表示されます。
 
430
 
 
431
``HTTP proxy`` は適切なポートを指定することで ``HTTP`` (もしくは ``HTTPS``) として扱うことができます。
 
432
 
 
433
すべてのスキームを考慮するには、パスワードは認証定義の一式 (``scheme``, ``host``, ``port``, ``path``, ``user``, ``password``) から推定されます。
 
434
 
 
435
  * ``scheme``: 空にできます (定義の残りは任意のスキームに対して使用できることを意味する)、
 
436
    ``SFTP`` と ``bzr+ssh`` はここでは使うべきではありません。
 
437
    代わりに ``ssh`` が使われるべきです。これが認証に関して本当のスキームだからです。
 
438
 
 
439
  * ``host``: 空にできます (ホスト用のデフォルトとして振る舞う),
 
440
 
 
441
  * ``port`` は空にできます (ホストが同じスキームに対していくつかのサーバーを提供するときに便利)、
 
442
    数値の値のみが許可され、サーバーがスキームの標準ポートとは異なるポートを使用するときのみにこれは使用されます。
 
443
 
 
444
  * ``path``: 空にできます (FTPもしくはSFTPはこれを使用しません),
 
445
 
 
446
  * ``user``: 空にできます (デフォルトでは ``bzr`` はpythonの ``getpass.get_user()`` を使用),
 
447
 
 
448
  * ``password``: 常にパスワードをプロンプトで入力する方が望ましいのであれば空にできます。
 
449
 
 
450
任意のURLに対して、複数の定義を提供できます。
 
451
bzrは次のルールに従って (``user`` [, ``password``]) を選択します:
 
452
 
 
453
 1. 最初にマッチするものが優先される
 
454
 
 
455
 2. すべてにマッチする空のフィールド
 
456
 
 
457
 3. デコレータがリクエストされたURLに使用されていても ``scheme`` はマッチします。
 
458
 
 
459
 4. ``host`` は正確にマッチするか '.' で始まる場合、ドメインとしてふるまいます。
 
460
    (``project.bzr.sf.net`` は ``.bzr.sf.net`` にマッチしますが ``projectbzr.sf.net`` は ``bzr.sf.net`` にマッチしない)。
 
461
 
 
462
 5. ``port`` はリクエストされたURLに含まれる場合(正確にマッチする場合のみ)マッチします。
 
463
 
 
464
 6. ``path`` はリクエストされたURLに含まれる場合マッチします (そして上記のルール #2 によって、
 
465
    空のパスは任意の提供されたパスにマッチします)。
 
466
 
 
467
 
 
468
 
 
469
ファイルのフォーマット
 
470
----------------------
 
471
 
 
472
`設定ファイル`_ 用の一般ルールは変数ポリシー意外に当てはまります。
 
473
 
 
474
.. _設定ファイル: #configuration-settings
 
475
 
 
476
それぞれのセクションで認証の定義を記述します。
 
477
 
 
478
セクションの名前は任意の文字列で、 ``DEFAULT`` の値のみが保存され
 
479
*最後* のセクションとして現れます。
 
480
 
 
481
それぞれのセクションは次の内容を定義すべきです:
 
482
 
 
483
* ``user``: 使用されるログイン名
 
484
 
 
485
それぞれのセクションは次の内容を定義できます:
 
486
 
 
487
* ``host``: リモートサーバー
 
488
 
 
489
* ``port``: サーバーがリスンしているポート番号
 
490
 
 
491
* ``path``: ブランチの位置
 
492
 
 
493
* ``password``: パスワード
 
494
 
 
495
 
 
496
 
497
---
 
498
 
 
499
 
 
500
外部でホストされた個人プロジェクト
 
501
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
502
 
 
503
すべての接続は同じ ``user`` で行われ
 
504
(デフォルトのbzrのものが適切でない場合のためのリモートの接続)
 
505
パスワードはいくつかの例外とともに常に催促されます::
 
506
 
 
507
        # hobby.netのPetプロジェクト
 
508
        [hobby]
 
509
        host=r.hobby.net
 
510
        user=jim
 
511
        password=obvious1234
 
512
 
 
513
        # ホームサーバー
 
514
        [home]
 
515
        scheme=https
 
516
        host=home.net
 
517
        user=joe
 
518
        password=1essobV10us
 
519
 
 
520
        [DEFAULT]
 
521
        # ローカルユーザーがbarbazで、すべてのリモートサイト上ではfoobarとして
 
522
        user=foobar
 
523
 
 
524
 
 
525
ソースホスティングプロバイダ
 
526
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
527
 
 
528
shp.net(仮想)ドメインにおいて、それぞれのプロジェクトは独自のサイトを持ちます::
 
529
 
 
530
        [shpnet domain]
 
531
        # sftpを使用するが、sshは認証用に使用される
 
532
        scheme=ssh
 
533
        # '.' は 'shp.net' だけがマッチしないことを保証する
 
534
        host=.shp.net
 
535
        user=joe
 
536
        # bzrはsftp用のパスワードの提供を保証しません
 
537
        # パスワードをインタラクティブに入力したくなければ
 
538
        # sshエージェントを使用することを考えてください(pageant, ssh-agent、など)
 
539
 
 
540
HTTPS、SFTPサーバーとプロキシ
 
541
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
542
 
 
543
company.comにおいて、サーバーのホスティングリリースは統合ブランチの背後にはプロキシがあり、
 
544
2つのブランチは異なる認証ポリシーを使用します::
 
545
 
 
546
        [reference code]
 
547
        scheme=https
 
548
        host=dev.company.com
 
549
        path=/dev
 
550
        user=user1
 
551
        password=pass1
 
552
 
 
553
        # devサーバー上の開発ブランチ
 
554
        [dev]
 
555
        scheme=ssh # bzr+sshとsftpはここで利用可能
 
556
        host=dev.company.com
 
557
        path=/dev/integration
 
558
        user=user2
 
559
 
 
560
        # プロキシ
 
561
        [proxy]
 
562
        scheme=http
 
563
        host=proxy.company.com
 
564
        port=3128
 
565
        user=proxyuser1
 
566
        password=proxypass1
 
567
 
 
568
 
 
569
計画的な強化
 
570
-------------
 
571
 
 
572
次の内容はまだ実装されていませんが進行中の作業の一部として計画されています:
 
573
 
 
574
* ``password_encoding`` フィールドの追加は次のとおりです:
 
575
 
 
576
  - さまざまな難読化のエンコーディング(たとえばbase64)でパスワードを保存する。
 
577
 
 
578
  - パスワードの保存をプラグインに委譲する(たとえば.netrc)。
 
579
 
 
580
* ユーザーがユーザー名もしくはパスワードの入力を催促されたらクレデンシャルを更新する。
 
581
 
 
582
* ``HTTPS`` 用に ``verify_certificates`` フィールドを追加する。
 
583
 
 
584
``password_encoding`` と ``verify_certificates`` フィールドは認識されますが
 
585
実際の実装では無視されます。
 
586
 
 
587
 
 
588
バグトラッカーの設定
 
589
=====================
 
590
 
 
591
コミットを行うとき、その変更によって修正されたバグに関するメタデータは --fixes オプションを使用することで記録されます。
 
592
それぞれのバグが修正されたものとしてマークされるために、エントリーが '<url> <status>' を述べる 'bugs' リビジョンプロパティに含まれます。
 
593
(現在サポートされる ``status`` の値は ``fixed.`` だけです)
 
594
Launchpadの中心バグトラッカー用のサポートは組み込まれています。
 
595
他のバグトラッカーに関して、正しいURLが記録されるように設定が予め要求されます。
 
596
 
 
597
Launchpadに加えて、BazaarはBugzillaとTracに適切なURLの生成を直接サポートします。
 
598
プロジェクトが異なるバグトラッカーを使用するのであれば、そのサポートを追加するのは簡単です。
 
599
BugzillaもしくはTracを使用しているのであれば、
 
600
バグトラッカーの基底URLを格納する設定変数を設定することだけが必要です。
 
601
これらのオプションは ``bazaar.conf`` 、 ``branch.conf`` もしくは ``locations.conf`` のブランチ固有のセクションに入ります。
 
602
取り組むプロジェクトごとにこれらの値をセットアップできます。
 
603
 
 
604
注: それぞれのトラッカーに対して短縮名を提供するのであれば、望むのであればコミット時に1つもしくは複数のトラッカーで1つもしくは複数のバグを指定できます。
 
605
 
 
606
Launchpad
 
607
---------
 
608
 
 
609
バグ2を修正するコミットを記録するには ``bzr commit --fixes lp:2`` を使用します。
 
610
 
 
611
bugzilla_<tracker_abbreviation>_url
 
612
-----------------------------------
 
613
 
 
614
存在するのであれば、Bugzillaのバグトラッカーの位置は <tracker_abbreviation> によって参照されます。
 
615
そのバグトラッカーのバグをそのコミットで修正されたものとしてマークするためにはこのオプションは ``bzr commit --fixes`` と一緒に使用できます::
 
616
 
 
617
    bugzilla_squid_url = http://www.squid-cache.org/bugs
 
618
 
 
619
上記の例はSquidのバグ 1234が修正されたものとしてマークするために ``bzr commit --fixes squid:1234`` を許可します。
 
620
 
 
621
trac_<tracker_abbrevation>_url
 
622
------------------------------
 
623
 
 
624
存在するのであれば、Tracインスタンスの位置は <tracker_abbreviation> によって参照されます。
 
625
そのコミットによってバグが修正されたものとしてそのトラッカーの中でマークするためにこのオプションは ``bzr commit --fixes`` と一緒に使用できます::
 
626
 
 
627
    trac_twisted_url = http://www.twistedmatrix.com/trac
 
628
 
 
629
上記の例はTwistedのバグ1234を修正したものとしてマークするために ``bzr commit --fixes twisted:1234`` を許可します。
 
630
 
 
631
bugtracker_<tracker_abbrevation>_url
 
632
------------------------------------
 
633
 
 
634
存在するのであれば、一般的なバグトラッカーのインスタンスの位置は <tracker_abbreviation> によって参照されます。
 
635
位置は ``{id}`` プレースホルダーを含まなければなりません。プレースホルダーは特定のバグIDに置き換えられます。
 
636
そのコミットによってバグが修正されたものとしてそのトラッカーでマークするためにこのオプションを ``bzr commit --fixes`` と一緒に使用できます::
 
637
 
 
638
    bugtracker_python_url = http://bugs.python.org/issue{id}
 
639
 
 
640
上記の例はPythonのRoundupバグトラッカーのバグ1234を修正されたものとしてマークするために ``bzr commit --fixes python:1234`` を許可します::
 
641
 
 
642
    bugtracker_cpan_url = http://rt.cpan.org/Public/Bug/Display.html?id={id}
 
643
 
 
644
上記はCPANのRTバグトラッカー用です。
 
645
 
 
646
 
 
647
構成設定
 
648
=========
 
649
 
 
650
.. TODO: Should have some explanation of why you'd want things in
 
651
.. branch.conf.
 
652
 
 
653
 
 
654
環境変数の設定
 
655
---------------
 
656
 
 
657
大抵の設定が設定ファイルによって取り扱われる一方で、
 
658
半永久的ないくつかのオプションは環境変数を通して制御できます。
 
659
 
 
660
BZR_EMAIL
 
661
~~~~~~~~~
 
662
 
 
663
Bazaarによって使用されるEメールのIDを上書きする。よくあるフォーマット::
 
664
 
 
665
  "John Doe <jdoe@example.com>"
 
666
 
 
667
``email`` の設定値も参照してください。
 
668
 
 
669
BZR_PROGRESS_BAR
 
670
~~~~~~~~~~~~~~~~
 
671
 
 
672
進行状況の表示方法を上書きする。可能な値は "none"、 "dots"、 "tty"
 
673
 
 
674
BZR_SIGQUIT_PDB
 
675
~~~~~~~~~~~~~~~
 
676
 
 
677
SIGQUITが通常とおりに振る舞うようにするかもしくはブレークインデバッガーを起動するかどうか制御する。
 
678
 
 
679
* 0 = 標準のSIGQUITのふるまい(通常はコアダンプを伴ってexitする)
 
680
* 1 = ブレークインデバッガーを起動する (デフォルト)
 
681
 
 
682
BZR_HOME
 
683
~~~~~~~~
 
684
 
 
685
Bazaarによって使用されるホームディレクトリを上書きする
 
686
 
 
687
BZR_SSH
 
688
~~~~~~~
 
689
 
 
690
異なるSSHの実装を選択する。
 
691
 
 
692
BZR_PDB
 
693
~~~~~~~
 
694
 
 
695
デバッガもしくはエラーを立ち上げるか制御する。
 
696
 
 
697
* 0 = Standard behavior
 
698
* 1 = Launch debugger
 
699
 
 
700
BZR_REMOTE_PATH
 
701
~~~~~~~~~~~~~~~
 
702
 
 
703
bzr+sshプロトコルを使用する際に使用するBazaar実行ファイルへのパス。
 
704
 
 
705
設定値 ``bzr_remote_path`` も参照。
 
706
 
 
707
BZR_EDITOR
 
708
~~~~~~~~~~
 
709
 
 
710
コミットメッセージなどの際にBazaarが使用するエディタへのパス。
 
711
 
 
712
BZR_PLUGIN_PATH
 
713
~~~~~~~~~~~~~~~
 
714
 
 
715
Bazaarが使用するプラグインディレクトリへのパス。
 
716
 
 
717
BZRPATH
 
718
~~~~~~~
 
719
 
 
720
Bazaarがシェルシェルプラグインの外部コマンドを探すパス。
 
721
 
 
722
 
 
723
設定ファイル
 
724
-------------
 
725
 
 
726
設置場所
 
727
~~~~~~~~~
 
728
 
 
729
設定ファイルはLinux/Unixの場合 ``$HOME/.bazaar`` に
 
730
Windowsの場合 ``C:\Documents and Settings\<username>\Application Data\Bazaar\2.0`` に設置されます。
 
731
( ``bzr version`` を使用することでシステムに設置された位置をチェックできます)
 
732
 
 
733
この位置に3つの主要な設定ファイルが存在します:
 
734
 
 
735
* ``bazaar.conf`` はデフォルトの設定オプションを記述します
 
736
 
 
737
* ``locations.conf`` は特定のブランチの位置用の設定情報を記述します。
 
738
 
 
739
* ``authentication.conf`` はリモートサーバー用のクレデンシャル情報を記述します。
 
740
 
 
741
それぞれのブランチはそのブランチに固有な値を設定する設定ファイルも格納します。
 
742
このファイルはブランチの範囲内の ``.bzr/branch/branch.conf`` で見つかります。
 
743
このファイルはブランチのすべてのユーザーに見えます。
 
744
あなたのブランチ専用に設定値の1つを上書きしたいのであれば、 ``locations.conf`` で行うことができます。
 
745
 
 
746
一般的なフォーマット
 
747
~~~~~~~~~~~~~~~~~~~~
 
748
 
 
749
iniファイルは3つの種類のコントラクト: セクションヘッダー、セクション変数とコメントを持ちます。
 
750
 
 
751
コメント
 
752
^^^^^^^^^
 
753
 
 
754
コメント行は "#" で始まります("hash mark", "pound sign"  "number sign"とも呼ばれます)。
 
755
コメント行はiniファイルを解析するときBazaarによって無視されます。
 
756
 
 
757
セクションヘッダー
 
758
^^^^^^^^^^^^^^^~~~~
 
759
 
 
760
セクションヘッダーは行頭から始まり角かっこで囲まれた単語です。
 
761
典型的なセクションヘッダーは次のとおりです::
 
762
 
 
763
    [DEFAULT]
 
764
 
 
765
bazaar.confに対して現時点で唯一有効なセクションヘッダーは[DEFAULT]と[ALIASES]です。
 
766
セクションヘッダーは大文字と小文字を区別します。
 
767
デフォルトのセクションが提供する設定変数はブランチの設定ファイルで上書きできます。
 
768
 
 
769
``locations.conf`` に対して、
 
770
セクションにマッチする最長のものを持つセクションからの変数は潜在的に有効な別のセクションヘッダーを除外するために使われます。
 
771
セクションヘッダーはブランチ用のパスをセクションヘッダーとして使用します。次のような例があります::
 
772
 
 
773
    [http://mybranches.isp.com/~jdoe/branchdir]
 
774
    [/home/jdoe/branches/]
 
775
 
 
776
 
 
777
セクション変数
 
778
^^^^^^^^^^^^^^^
 
779
 
 
780
セクション変数はセクションの範囲に属します。セクション変数は変数名、等号と値を格納します。例です::
 
781
 
 
782
    email            = John Doe <jdoe@isp.com>
 
783
    check_signatures = require
 
784
 
 
785
 
 
786
変数のポリシー
 
787
^^^^^^^^^^^^^^^
 
788
 
 
789
セクションの中で定義された変数は名前つきのディレクトリもしくはURLに加えてそれらを格納する位置にも影響を与えます。
 
790
ポリシーは可変変数が含まれる位置のために解釈される方法を変更するために使用できます。現在は3つのポリシーが利用できます:
 
791
 
 
792
 none:
 
793
   値は含まれる位置に対して同じように解釈されます。
 
794
   これはデフォルトのふるまいです。
 
795
 norecurse:
 
796
   値はセクション名によって指定された正確な位置のみに対して使用されます。
 
797
 appendpath:
 
798
   for contained locations, 追加パスのコンポーネントは値に追加されます。
 
799
 
 
800
ポリシーは "$var:policy" 形式の名前を持つキーによって指定されます。
 
801
たとえば、ブランチのツリー用のpushの位置を定義するには、次の設定が使われます::
 
802
 
 
803
  [/top/location]
 
804
  push_location = sftp://example.com/location
 
805
  push_location:policy = appendpath
 
806
 
 
807
この設定によって、 ``/top/location/branch1`` 用のpush位置は ``sftp://example.com/location/branch1`` になります。
 
808
 
 
809
 
 
810
主要な設定ファイルのbazaar.conf
 
811
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
812
 
 
813
``bazaar.conf`` は ``[DEFAULT]`` と呼ばれる1つのセクションだけを許可します。
 
814
このデフォルトセクションはすべてのブランチ用のデフォルト設定オプションを格納します。
 
815
デフォルトセクションは ``locations.conf`` にブランチ固有のセクションを提供することで上書きできます。
 
816
 
 
817
典型的な ``bazaar.conf`` セクションは次のようになります::
 
818
 
 
819
    [DEFAULT]
 
820
    email             = John Doe <jdoe@isp.com>
 
821
    editor            = /usr/bin/vim
 
822
    check_signatures  = check-available
 
823
    create_signatures = when-required
 
824
 
 
825
 
 
826
ブランチの位置の設定ファイルのlocations.conf
 
827
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
828
 
 
829
``locations.conf`` によって特定のブランチ用に設定を上書きできます。
 
830
フォーマットは1つの重大な変更を伴うbazaar.confのデフォルトセクションに対してほとんど理想的です:
 
831
デフォルトを記述する代わりに、セクションヘッダーは値を上書きしたいブランチへのパスになります。
 
832
ワイルドカードの '?' と '*' がサポートされます::
 
833
 
 
834
    [/home/jdoe/branches/nethack]
 
835
    email = Nethack Admin <nethack@nethack.com>
 
836
 
 
837
    [http://hypothetical.site.com/branches/devel-branch]
 
838
    create_signatures = always
 
839
    check_signatures  = always
 
840
 
 
841
    [http://bazaar-vcs.org/bzr/*]
 
842
    check_signatures  = require
 
843
 
 
844
認証用の設定ファイル、authentication.conf
 
845
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
846
 
 
847
``authentication.conf`` によってリモートサーバー用のクレデンシャルを指定できます。
 
848
これはすべてのサポートされる転送と認証(たとえばsmtp)を必要とするbzrの一部に対して使用できます。
 
849
 
 
850
ファイルの構文は適用しない変数ポリシー用の他の例外を除いて同じルールに従います。
 
851
 
 
852
設定ファイルにおける認証の使い方の詳細な情報に関しては `認証の設定`_ を参照してください。
 
853
 
 
854
 
 
855
変数の共通オプション
 
856
---------------------
 
857
 
 
858
email
 
859
~~~~~
 
860
 
 
861
Eメールアドレスはブランチをコミットする際に使われます。よく次のような形式をとります::
 
862
 
 
863
    email = Full Name <account@hostname.tld>
 
864
 
 
865
editor
 
866
~~~~~~
 
867
 
 
868
コミットメッセージなしで *bzr commit* が実行された場合に使用されるエディタのパスです。
 
869
この設定は環境変数 ``BZR_EDITOR`` によって設定され、
 
870
環境変数 ``VISUAL`` と ``EDITOR`` によって上書きされます。
 
871
 
 
872
check_signatures
 
873
~~~~~~~~~~~~~~~~
 
874
 
 
875
署名用のふるまいを定義します。
 
876
 
 
877
require
 
878
    リビジョン用のgnupg署名が存在して有効でなければなりません。
 
879
 
 
880
ignore
 
881
    リビジョンのgnupgの署名をチェックしない。
 
882
 
 
883
check-available
 
884
    (デフォルト) リビジョン用のgnupgの署名が存在する場合、それらをチェックします。
 
885
    わるい署名であることが分かるとBazaarは失敗しますが、署名が存在しない場合は失敗しません。
 
886
 
 
887
create_signatures
 
888
~~~~~~~~~~~~~~~~~
 
889
 
 
890
リビジョン署名のふるまいを定義します。
 
891
 
 
892
always
 
893
    コミットされるすべての新しいリビジョンに署名する。
 
894
 
 
895
when-required
 
896
    (デフォルト) ブランチが署名つきのリビジョンを要求するときのみ新しくコミットされたリビジョンに署名する。
 
897
 
 
898
never
 
899
    ブランチが署名を要求する場合でも新しくコミットされたリビジョンに署名するのを拒否する。
 
900
 
 
901
recurse
 
902
~~~~~~~
 
903
 
 
904
``locations.conf`` でのみ便利です。
 
905
このセクション用の設定をサブディレクトリにも適用するかどうか定義します:
 
906
 
 
907
true
 
908
    (デフォルト このセクションはサブディレクトリにも適用される。
 
909
 
 
910
false
 
911
    このセクションはこのディレクトリのブランチのみに適用されその下のブランチには適用されない。
 
912
 
 
913
gpg_signing_command
 
914
~~~~~~~~~~~~~~~~~~~
 
915
 
 
916
(デフォルト: "gpg"). リビジョンの署名とチェックのために使用されるプログラム。例です::
 
917
 
 
918
    gpg_signing_command = /usr/bin/gnpg
 
919
 
 
920
bzr_remote_path
 
921
~~~~~~~~~~~~~~~
 
922
 
 
923
(デフォルト: "bzr").  bzr用のスマートサーバーを稼働させるために使われるコマンドへのパス。
 
924
この値はlocations.confでのみ指定が許可されます。理由は次のとおりです:
 
925
 
 
926
- branch.confがアクセスできる前に必要だから
 
927
- セキュリティリスクになるコマンドを指定するためにリモートのbranch.confファイルを許可するから
 
928
 
 
929
これはBZR_REMOTE_PATH 環境変数によって上書きされます。
 
930
 
 
931
smtp_server
 
932
~~~~~~~~~~~
 
933
 
 
934
(デフォルト: "localhost")。たとえば ``merge-directive --mail-to`` 、もしくはbzr-emailプラグインによって
 
935
BazaarがEメールを送信する必要があるときに使用するSMTPサーバー、
 
936
 
 
937
 
 
938
smtp_username, smtp_password
 
939
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
940
 
 
941
SMTPサーバーで認証するユーザーとパスワード。
 
942
smtp_usernameが設定されていて、smtp_passwordが設定されていなければ、Bazaarはパスワードを催促します。
 
943
Eメールを送信するためにSMTPサーバーが認証を必要とする場合のみこれらの設定が必要です。
 
944
 
 
945
mail_client
 
946
~~~~~~~~~~~
 
947
 
 
948
マージリクエストを送信するために使うメールクライアント。
 
949
デフォルトでは、Windowsではbzrは ``mapi`` を使うことを試みます。
 
950
他のプラットフォームでは、 ``xdg-email`` を試みます。
 
951
これらのどちらかが失敗すると、 ``editor`` に戻ります。
 
952
 
 
953
特定のクライアント用のサポートされた値:
 
954
 
 
955
:claws: Clawsを使用する。ファイル添付のダイアログはスキップする。
 
956
:evolution: Evolutionを使用する
 
957
:kmail: KMailを使用する
 
958
:mutt: Muttを使用する
 
959
:thunderbird: Mozilla ThunderbirdもしくはIcedoveを使用する。Thunderbird/Icedove 1.5に関して、
 
960
    これはxdg-emailが扱えないいくつかのバグに対処します。
 
961
 
 
962
サポートされる一般的な値は次のとおりです:
 
963
 
 
964
:default: 上記を参照。
 
965
:editor: マージリクエストを書くエディタを使用します。
 
966
    これはコミットID( ``bzr whoami`` を参照),
 
967
    smtp_serverと(オプションで)smtp_usernameとsmtp_passwordも使用します。
 
968
:mapi: Windowsで好きなメールクライアントを使用します。
 
969
:xdg-email: 好きなメールプラグラムを実行するためにxdg-emailを使用する
 
970
 
 
971
submit_branch
 
972
~~~~~~~~~~~~~
 
973
 
 
974
現在の作業内容を投稿しようとしているブランチ。
 
975
これは ``bzr send`` によって自動的に設定され ``submit:`` リビジョンスペックにも使用されます。
 
976
通常、これはブランチ単位ロケーション単位で設定されます。
 
977
 
 
978
public_branch
 
979
~~~~~~~~~~~~~
 
980
 
 
981
このブランチの公開されアクセス可能なバージョン
 
982
(このブランチが公開されてアクセス可能ではないことを暗示する)。
 
983
``bzr send`` によって使用されます(そして設定されます)。
 
984
 
 
985
 
 
986
ブランチ特有のオプション
 
987
-------------------------
 
988
 
 
989
これらのオプションは ``dirstate-tags`` もしくは後のフォーマットを使用するブランチにのみ適用します。
 
990
通常これらは自動的に ``.bzr/branch/branch.conf`` 設定される
 
991
もしくは手動で ``locations.conf`` もしくは ``bazaar.conf`` に設定されます。
 
992
 
 
993
append_revisions_only
 
994
~~~~~~~~~~~~~~~~~~~~~
 
995
 
 
996
"True"に設定されていればリビジョンはログにのみ追加され、削除されません。
 
997
この設定が有効なブランチは、他のブランチのログがそれ自身のリビジョンより長い場合、別のブランチからのみpullできます。
 
998
通常これは ``bzr init --append-revisions-only`` によって設定されます。
 
999
 
 
1000
parent_location
 
1001
~~~~~~~~~~~~~~~
 
1002
 
 
1003
存在すれば、pullもしくはmerge用のデフォルトブランチの位置。
 
1004
通常このオプションは ``pull --remember`` もしくは ``merge --remember`` によって設定されます。
 
1005
 
 
1006
push_location
 
1007
~~~~~~~~~~~~~
 
1008
 
 
1009
存在すれば、push用のデフォルトブランチの位置。
 
1010
通常このオプションは ``push --remember`` によって設定されます。
 
1011
 
 
1012
bound_location
 
1013
~~~~~~~~~~~~~~
 
1014
 
 
1015
チェックアウトとして振る舞うときコミットが向かう位置。
 
1016
通常このオプションは ``bind`` によって設定されます。
 
1017
 
 
1018
bound
 
1019
~~~~~
 
1020
 
 
1021
"True"に設定されていると、ブランチはチェックアウトとしてふるまい、bound_locationにそれぞれのコミットをpushします。
 
1022
通常このオプションは ``bind``/``unbind`` に設定されます。
 
1023
 
 
1024
 
 
1025
衝突のタイプ
 
1026
=============
 
1027
 
 
1028
オペレーションの中には、merge、revertとpullのように、作業ツリーの内容を修正するものがあります。
 
1029
これらの修正はプログラムで生成されるので、作業ツリーの現在の状態と衝突することがあります。
 
1030
多くの種類の変更はプログラムで結合できますが、 正しいことを行われているか時々人間だけしか判断できないことがあります。
 
1031
これが起きるとき Bazaarはあなたに衝突が存在するのでそれを解消するように伝えます。
 
1032
Bazaarに衝突が解消したことを伝えるコマンドは ``resolve`` ですが、
 
1033
これを実行できる前にいくつかのアクションを実行しなければなりません。
 
1034
 
 
1035
それぞれの衝突は下記のセクションで説明され、衝突を解消するために行わなければならないアクションの概要が説明されています。
 
1036
 
 
1037
 
 
1038
テキストの衝突
 
1039
---------------
 
1040
 
 
1041
典型的なメッセージは次のとおりです::
 
1042
 
 
1043
  Text conflict in FILE
 
1044
 
 
1045
テキストのマージが2つのセットのテキストの変更を完全に折り合いをつけられないときにこれらは生み出されます。
 
1046
BazaarはTHIS、OTHER、とBASEのエクステンションでそれぞれのバージョン用にファイルをemitします。
 
1047
THISはターゲットツリーからのファイルのバージョン、すなわち、変更をマージしようとしているツリーです。
 
1048
OTHERはターゲットにマージしようとしているバージョン、BASEは比較用のベースとして使われる古いバージョンです。
 
1049
 
 
1050
ファイルのメインコピーにおいて、Bazaarは調整できるすべての変更を含み、
 
1051
未調整の衝突は ``<<<<<<<`` のように "herringbone" マーカーによって囲まれます。
 
1052
 
 
1053
たとえば、初期のテキストが "The project leader released it."、でTHISはこれを "Martin Pool released it." に修正する一方で、
 
1054
OTHERは"The project leader released Bazaar."に修正します。衝突は次のようになります::
 
1055
 
 
1056
  <<<<<<< TREE
 
1057
  Martin Pool released it.
 
1058
  =======
 
1059
  The project leader released Bazaar.
 
1060
  >>>>>>> MERGE-SOURCE
 
1061
 
 
1062
正しい解消方法は"Martin Pool released Bazaar."になります。
 
1063
 
 
1064
ファイルのメインコピーを編集する、もしくはTHIS、OTHERとBASEバージョン上で外部ツールを起動することのどちらかでテキストの衝突を扱うことができます。
 
1065
テキストの衝突の解消において他のものから変更のセットの1つの選別はめったにないことは言っておく価値があります。
 
1066
 
 
1067
より頻繁に、2つのセットの変更はインテリジェントに結合しなければなりません。
 
1068
 
 
1069
メインコピーを編集するとき、 herringbone マーカーを必ず削除してください。
 
1070
編集作業を終えたとき、ファイルは衝突がけっして起こらないようであれば、コミットする準備ができています。
 
1071
 
 
1072
テキストの衝突を解消したとき、"bzr resolve"を実行するだけでBazaarは解消した衝突を自動検出します。
 
1073
 
 
1074
内容の衝突
 
1075
----------
 
1076
 
 
1077
典型的なメッセージ::
 
1078
 
 
1079
  Contents conflict in FILE
 
1080
 
 
1081
ターゲットツリーとマージソースの中の変更の衝突が存在するときにこの衝突は起こりますが、
 
1082
が衝突したアイテムはテキストファイルではありません。
 
1083
これらはバイナリファイルもしくはシンボリックリンクもしくはディレクトリになります。
 
1084
片方が削除され、もう一方が修正されたファイルでも起こり得ます。
 
1085
 
 
1086
テキストの衝突のように、BazaarはTHIS、OTHER とBASEファイルをエミットしますが
 
1087
(これらは通常のファイル、シンボリックリンクもしくはディレクトリになります)、
 
1088
これはherringbone衝突マーカーを持つファイルの"メインコピー"を含みません。
 
1089
"メインコピー"がTHISもくはOTHERにリネームされたときにこれは現れます。
 
1090
 
 
1091
これを解消するには、ファイルを通常の名前に戻すために "bzr mv" を使用し変更を手動で結合します。
 
1092
満足したときに、 "bzr resolve FILE" を実行します。この種の衝突が解消されたときにBazaarは自動検出できません。
 
1093
 
 
1094
重複したパス
 
1095
-------------
 
1096
 
 
1097
典型的なメッセージ::
 
1098
 
 
1099
  Conflict adding file FILE.  Moved existing file to FILE.moved.
 
1100
 
 
1101
時々Bazaarはすでに使用されているパス名を用いてファイルを作成しようとします。
 
1102
既存のファイルは "FILE.moved" にリネームされます。
 
1103
望むのであれば、これらのファイルの1つをリネームするか、それらの内容を結合できます。
 
1104
満足したら、衝突を解消したものとしてマークするために "bzr resolve FILE" を実行できます。
 
1105
 
 
1106
バージョン管理下にない親
 
1107
-------------------------
 
1108
 
 
1109
典型的なメッセージ::
 
1110
 
 
1111
    Conflict because FILE is not versioned, but has versioned children.
 
1112
 
 
1113
ときどきBazaarは親ディレクトリがバージョン管理されていないファイルを作成しようとします。
 
1114
ターゲットの中でディレクトリが削除されたときにこれが起こりますが、
 
1115
ソースの中の新しい子を持ちます。逆も同様です。
 
1116
この状況において、Bazaarは親ディレクトリも同様にバージョン管理します。
 
1117
この問題の解決方法は特定のシナリオに大きく依存します。
 
1118
ファイルもしくはディレクトリをリネームもしくは削除するとよいでしょう。
 
1119
満足したら、衝突を解消したものとして"bzr resolve FILE"を実行できます。
 
1120
 
 
1121
見つからない親
 
1122
---------------
 
1123
 
 
1124
典型的なメッセージ::
 
1125
 
 
1126
  Conflict adding files to FILE.  Created directory.
 
1127
 
 
1128
ターゲットの中でファイルを削除するときにこれが起こりますが、ソースの中に新しい子があります。
 
1129
これは "unversioned parent" の衝突と似ています。
 
1130
バージョン管理を解除される代わりに、親ディレクトリが *存在しない* ことを除いて、
 
1131
この状況において、Bazaarは見つからない親を作成します。
 
1132
この問題の解決方法は特定のシナリオに大いに依存します。
 
1133
ファイルもしくはディレクトリをリネームもしくは削除するとよいでしょう。
 
1134
満足したら、衝突を解消したものとして "bzr resolve FILE" を実行できます。
 
1135
 
 
1136
親を削除する
 
1137
------------
 
1138
 
 
1139
典型的なメッセージ::
 
1140
 
 
1141
  Conflict: can't delete FILE because it is not empty.  Not deleting.
 
1142
 
 
1143
これは"見つからない親"の反対です。ソースの中でディレクトリは削除されますが、
 
1144
ターゲットの中で新しい子はあります。Bazaarはディレクトリを保有し続けます。
 
1145
この問題の解消は特定のシナリオに大いに依存します。
 
1146
ファイルもしくはディレクトリをリネームもしくは削除するとよいでしょう。
 
1147
満足したら、衝突を解消したものとしてマークするために"bzr resolve FILE"を実行できます。
 
1148
 
 
1149
パスの衝突
 
1150
-----------
 
1151
 
 
1152
典型的なメッセージ::
 
1153
 
 
1154
  Path conflict: PATH1 / PATH2
 
1155
 
 
1156
ソースとターゲットがファイルの名前もしくは親ディレクトリを修正したときに起こります。
 
1157
Bazaarはソースからパス要素を使用します。
 
1158
ファイルをリネームできれば、衝突を解消したものとしてマークするために "bzr resolve FILE" を実行します。
 
1159
 
 
1160
親のループ
 
1161
-----------
 
1162
 
 
1163
典型的なメッセージ::
 
1164
 
 
1165
  Conflict moving FILE into DIRECTORY.  Cancelled move.
 
1166
 
 
1167
ソースとターゲットがそれぞれディレクトリを移動させたので、
 
1168
変更が適用可能であれば、ディレクトリはそれ自身を含むときにこれは起こります。
 
1169
例です::
 
1170
 
 
1171
  $ bzr init
 
1172
  $ bzr mkdir a
 
1173
  $ bzr mkdir b
 
1174
  $ bzr commit -m "BASE"
 
1175
  $ bzr branch . ../other
 
1176
  $ bzr mv a b
 
1177
  $ bzr commit -m "THIS"
 
1178
  $ bzr mv ../other/b ../other/a
 
1179
  $ bzr commit ../other -m "OTHER"
 
1180
  $ bzr merge ../other
 
1181
 
 
1182
この状況において、Bazaarは移動をキャンセルして、"a"を"b"の中に残しておきます。
 
1183
望むのであればディレクトリをリネームできれば
 
1184
衝突を解消したものとしてマークするために "bzr resolve FILE" を実行します。
 
1185
 
 
1186
ディレクトリではない親
 
1187
-----------------------
 
1188
 
 
1189
典型的なメッセージ::
 
1190
 
 
1191
  Conflict: FILE.new is not a directory, but has files in it.
 
1192
  Created directory.
 
1193
 
 
1194
片方がファイルをディレクトリを追加したとき、もう一方がディレクトリをファイルもしくはシンボリックリンクに変更したときにこれは起きます。
 
1195
例です::
 
1196
 
 
1197
  $ bzr init
 
1198
  $ bzr mkdir a
 
1199
  $ bzr commit -m "BASE"
 
1200
  $ bzr branch . ../other
 
1201
  $ rmdir a
 
1202
  $ touch a
 
1203
  $ bzr commit -m "THIS"
 
1204
  $ bzr mkdir ../other/a/b
 
1205
  $ bzr commit ../other -m "OTHER"
 
1206
  $ bzr merge ../other
 
1207
 
 
1208
 
 
1209
MalformedTransform
 
1210
-------------------
 
1211
 
 
1212
Bazaarに例外のMalformedTransformを起動させること可能です(非常にまれですが)。
 
1213
これはBazaarが解決できないファイルシステムの衝突に遭遇したことを意味します。
 
1214
通常これはバグを示します。これに遭遇したら教えて頂くようお願いします。
 
1215
バグトラッカーは https://launchpad.net/bzr/+bugs です。
 
1216
 
 
1217
 
 
1218
現在のストレージフォーマット
 
1219
============================
 
1220
 
 
1221
:pack-0.92:
 
1222
    (ネイティブ) (デフォルト) 0.92で新しく導入:
 
1223
    dirstate-tagsフォーマットリポジトリと互換性のあるデータを持つパックベースのフォーマット。
 
1224
    0.92以前のbzrリポジトリと相互運用できますが0.92以前のbzrでは読めません。
 
1225
    以前はknitpack-experimentalと呼ばれていました。詳細な情報に関しては、
 
1226
    http://doc.bazaar-vcs.org/latest/developers/packrepo.html を参照。
 
1227
 
 
1228
:1.6:
 
1229
    (ネイティブ) スタックをサポートするディレクトリに基づいたブランチとパック。
 
1230
 
 
1231
:1.6.1-rich-root:
 
1232
    (ネイティブ) スタックとリッチrootデータをサポートするブランチとパックベースのリポジトリ(bzr-svnが必要)
 
1233
 
 
1234
:1.9:
 
1235
    (ネイティブ) btreeインデックスを使用するブランチとパックベースのリポジトリ。
 
1236
 
 
1237
:1.9-rich-root:
 
1238
    (ネイティブ) btreeインデックスとrich rootデータを使用する
 
1239
    ブランチとパックベースのリポジトリ(bzr-svnに必要)。
 
1240
 
 
1241
 
 
1242
ストレージフォーマットは ``bzr help formats`` を参照。
 
1243
 
 
1244
 
 
1245
環境変数
 
1246
========
 
1247
 
 
1248
================ =================================================================
 
1249
BZRPATH          bzrがシェルプラグインコマンドを探すパス。
 
1250
BZR_EMAIL        ユーザーのEメールアドレス。EMAILを上書きする。
 
1251
EMAIL            ユーザーのEメールアドレス。
 
1252
BZR_EDITOR       コミットメッセージの編集用エディタ。EDITORを上書きする。
 
1253
EDITOR           コミットメッセージの編集用エディタ
 
1254
BZR_PLUGIN_PATH  bzrがプラグインを探すパス。
 
1255
BZR_HOME         .bazaarの設定ディレクトリを保持するディレクトリ。HOMEを上書きする。
 
1256
BZR_HOME (Win32) bazaar設定ディレクトリを保持するディレクトリ。APPDATAとHOMEを上書きする。
 
1257
BZR_REMOTE_PATH  リモート'bzr'コマンドのフルネーム(bzr+ssh:// URL用).
 
1258
BZR_SSH          SSHクライアント: paramiko (デフォルト), openssh, ssh, plink.
 
1259
BZR_LOG          .bzr.logの位置(ロギングを停止するには'/dev/null'を使う)。
 
1260
BZR_LOG (Win32)  .bzr.logの位置(ロギングを停止するには'NUL'を使う)。
 
1261
================ =================================================================
 
1262
 
 
1263
 
 
1264
ファイル
 
1265
========
 
1266
 
 
1267
:On Linux:   ~/.bazaar/bazaar.conf
 
1268
:On Windows: C:\\Documents and Settings\\username\\Application Data\\bazaar\\2.0\\bazaar.conf
 
1269
 
 
1270
ユーザーのデフォルト設定は上記のとおりです。
 
1271
``[DEFAULT]`` セクションすべての場所に適用される一般的な設定を定義するために使用できます。
 
1272
``[ALIASES]`` セクションは共通に使用されるオプション用のコマンドエイリアスを作成するために使用できます。
 
1273
 
 
1274
典型的な設定ファイルは次のとおりです::
 
1275
 
 
1276
  [DEFAULT]
 
1277
  email=John Doe <jdoe@isp.com>
 
1278
 
 
1279
  [ALIASES]
 
1280
  commit = commit --strict
 
1281
  log10 = log --short -r -10..-1
 
1282
 
 
1283
 
 
1284
グローバルオプション
 
1285
=====================
 
1286
 
 
1287
これらのオプションは任意のコマンドで使用可能で、コマンドの前で入力します(たとえば"bzr --profile help")。
 
1288
 
 
1289
--version      バージョン番号を表示する。コマンドの前に入力しなければならない。
 
1290
--no-aliases   このコマンドを実行する際にコマンドエイリアスを処理しない。
 
1291
--builtin      プラグインのコマンドではなく、組み込みのコマンドを使用する。
 
1292
               このオプションは他のプラグインの効果を抑制しない。
 
1293
--no-plugins   プラグインを処理しない。
 
1294
 
 
1295
--profile      ホットスポットプロファイラを使用するプロファイルの実行。
 
1296
--lsprof       lsprofプロファイラを使用したプロファイルの実行。
 
1297
--lsprof-file  lsprofプロファイラを使用するプロファイルを実行し、結果を指定ファイルに書き込む。
 
1298
               ファイル名が".txt"で終わる場合, テキストフォーマットが使用されます。
 
1299
               ファイル名が"callgrind.out"で始まる、もしくは".callgrind"で終わる場合、
 
1300
               KCacheGrind用に出力がフォーマットされる。
 
1301
               さもなければ、出力はpickleになる。
 
1302
--coverage     指定ディレクトリの行カバレージレポートを生成する。
 
1303
 
 
1304
プロファイリングに関する詳細な情報はdoc/developers/profiling.txtを参照してください。
 
1305
トラブルシューティングと開発を手助けするためのたくさんのデバッグフラッグも利用可能です。
 
1306
 
 
1307
-Dauth            使用される認証セクションをトレースする。
 
1308
-Derror           通常のエラーハンドリングの代わりに、常にエラー上のトラックバックを表示する。
 
1309
-Devil            割高なもしくはわるいスケーリングオペレーションを行うコールサイトをキャプチャする。
 
1310
-Dfetch           リポジトリ間のコピーの履歴をトレースする。
 
1311
-Dhashcache       ハッシュを決定するために作業ファイルが読み込まれるたびにログを記録する
 
1312
-Dhooks           フックの実行をトレースする。
 
1313
-Dhpss            スマートプロトコルリクエストとレスポンスをトレースする。
 
1314
-Dhttp            http接続、リクエストとレスポンスをトレースする。
 
1315
-Dindex           主要なindexオペレーションをトレースする。
 
1316
-Dknit            knitオペレーションをトレースする。
 
1317
-Dlock            lockdirロックがとられるもしくはリリースされるときをトレースする。
 
1318
-Dmerge           マージのデバッグ用の情報を表示する。
 
1319
-Dpack            packオペレーション用の情報を表示する。
 
1320
 
 
1321
 
 
1322
フック
 
1323
=======
 
1324
 
 
1325
紹介
 
1326
-----
 
1327
 
 
1328
*yyy* クラスの *xxx* タイプのフックを使用するには登録する必要があります::
 
1329
 
 
1330
  yyy.hooks.install_named_hook("xxx", ...)
 
1331
 
 
1332
例に関してはユーザーガイドの `フックを利用する`_ を参照してください。
 
1333
 
 
1334
.. _フックを利用する: ../user-guide/index.html#id186
 
1335
 
 
1336
それぞれのフックが含むクラスは下記のそれぞれのフックタイプの後で丸かっこの中で示されます。
 
1337
 
 
1338
それぞれの説明ではクライアント(bzrが実行されるマシン)もしくはサーバー
 
1339
(ブランチURLで示されるマシン)で実行されるか示します。
 
1340
これらは必ずしも同じマシンではありません。
 
1341
 
 
1342
以下の1つがtrueの場合(フックを含む)プラグインはサーバー上で実行されます:
 
1343
 
 
1344
  * リモートブランチがクライアントと同じマシン上にあり、クライアントはプラグインを有効にしている。
 
1345
 
 
1346
  * 接続はスマートサーバー経由で行われ("bzr://"、"bzr+ssh://"もしくは"bzr+http://"で
 
1347
    始まるURLでアクセスするもしくはスマートサーバーがHTTP経由で利用可能なときに
 
1348
    "http://"でアクセスする)、サーバーがプラグインを有効にしている。
 
1349
 
 
1350
 
 
1351
open (Branch)
 
1352
-------------
 
1353
 
 
1354
Branchオブジェクトが開いた後で、Branchオブジェクトによって呼び出されます。
 
1355
クライアントとサーバーで実行します。
 
1356
 
 
1357
post_push (Branch)
 
1358
------------------
 
1359
 
 
1360
``push`` が完了した後で実行されます。
 
1361
クライアントで実行します。
 
1362
 
 
1363
フックのシグネチャは (push_result) でメンバーを含みます。
 
1364
 
 
1365
  source_branch
 
1366
    データがpushされる場所(読み込みはロックされる)。
 
1367
    これは最も低いレイテンシブランチになります。
 
1368
 
 
1369
  target_branch
 
1370
    データが送信される直接の場所(書き込みがロックされる)。
 
1371
 
 
1372
  master_branch
 
1373
    target_branch、もしくはターゲットがバインドされたブランチの場合、
 
1374
    これはマスターロケーションになります(書き込みはロックされる)。
 
1375
 
 
1376
  local_branch
 
1377
    ターゲットがバインドされたブランチの場合、これがターゲットブランチになる、
 
1378
    そうでなければ、Noneになります。
 
1379
 
 
1380
  old_revno
 
1381
    push以前のブランチのリビジョン番号(たとえば10)。
 
1382
 
 
1383
  old_revid
 
1384
    push以前のリビジョンid (たとえば joe@foo.com-1234234-aoeua34)。
 
1385
 
 
1386
  new_revno
 
1387
    push後のブランチのリビジョン番号(たとえば12)。
 
1388
 
 
1389
  new_revid
 
1390
    push後のリビジョンid (たとえば joe@foo.com-5676566-boa234a)
 
1391
 
 
1392
 
 
1393
post_pull (Branch)
 
1394
------------------
 
1395
 
 
1396
``pull`` が完了し後で実行されます。
 
1397
 
 
1398
フックのシグネチャは (push_result) で次のメンバーを含みます:
 
1399
(source, local, master, old_revno, old_revid, new_revno, new_revid)。
 
1400
localはローカルのターゲットブランチもしくはNoneで、
 
1401
masterはターゲットのマスターブランチで、残りは見たとおりです。
 
1402
sourceでは読み込みがロックされターゲットブランチでは書き込みがロックされます。
 
1403
sourceはローカルの低レイテンシブランチになります。
 
1404
 
 
1405
 
 
1406
start_commit (MutableTree)
 
1407
--------------------------
 
1408
 
 
1409
``commit`` が作業ツリーの処理を始める前に作業ツリー上で実行されます。
 
1410
クライアントで実行します。
 
1411
 
 
1412
``pre_commit`` フック(下記を参照)とは異なり、
 
1413
``start_commit`` フックは作業ツリーを安全に変更できます。
 
1414
 
 
1415
フックのシグネチャはツリーがMutableTreeオブジェクトである場所(ツリー)です
 
1416
 
 
1417
 
 
1418
pre_commit (Branch)
 
1419
-------------------
 
1420
 
 
1421
``commit`` が完了する前に実行されます。
 
1422
クライアントで実行します。
 
1423
 
 
1424
フックのシグネチャは
 
1425
(local, master, old_revno, old_revid, future_revno, future_revid, tree_delta, future_tree)です。
 
1426
old_revnoはブランチに最初にコミットするためのNULL_REVISIONで、
 
1427
tree_deltaは基底リビジョンからの変更を記述するTreeDeltaオブジェクトで、
 
1428
future_treeはインメモリツリーでCommitBuilder.revision_tree()から得られます。
 
1429
フックはtree_deltaとfuture_treeを修正する *必要はありません* 。
 
1430
 
 
1431
 
 
1432
post_commit (Branch)
 
1433
--------------------
 
1434
 
 
1435
``commit`` が完了した後で実行されます。
 
1436
クライアントで実行します。
 
1437
 
 
1438
フックのシグネチャは (local, master, old_revno, old_revid, new_revno, new_revid)です。
 
1439
old_revidはブランチへの最初のコミットのためのNULL_REVISIONです。
 
1440
 
 
1441
 
 
1442
post_uncommit (Branch)
 
1443
----------------------
 
1444
 
 
1445
``uncommit`` が完了した後で実行されます。
 
1446
 
 
1447
apiのシグネチャは (local, master, old_revno, old_revid, new_revno, new_revid)です。
 
1448
localはローカルブランチもしくはNoneで、masterはターゲットブランチで、
 
1449
空のブランチは0のnew_revno、Noneのnew_revidを受け取ります。
 
1450
 
 
1451
 
 
1452
pre_change_branch_tip (Branch)
 
1453
-------------------------------
 
1454
 
 
1455
ブランチの書き込みがロックされている間に、ブランチチップが変更される前に実行されます。
 
1456
クライアントとサーバーで実行します。
 
1457
push、pull、commitとuncommitのすべてはこのフックを起動させることに注意してください。
 
1458
 
 
1459
フックのシグネチャは (params) で、paramsはメンバーを含むオブジェクトです。
 
1460
 
 
1461
  branch
 
1462
    チップが変更されるブランチ。
 
1463
 
 
1464
  old_revno
 
1465
    変更前のブランチのリビジョン番号(たとえば10)。
 
1466
 
 
1467
  old_revid
 
1468
    変更前のリビジョンid (たとえば joe@foo.com-1234234-aoeua34)。
 
1469
 
 
1470
  new_revno
 
1471
    変更後のブランチのリビジョン番号(たとえば12)。
 
1472
 
 
1473
  new_revid
 
1474
    変更後のリビジョンid (たとえば joe@foo.com-5676566-boa234a)。
 
1475
 
 
1476
ヘッドリビジョンはドットつきのリビジョン番号をけっして持たないので、old_revnoとnew_revnoメンバーは整数です。
 
1477
 
 
1478
 
 
1479
post_change_branch_tip (Branch)
 
1480
-------------------------------
 
1481
 
 
1482
ブランチの書き込みがまだロックされている間にブランチのチップが変更された後に実行されます。
 
1483
クライアントとサーバーで実行します。
 
1484
push、pull、commitとuncommitすべてがこのフックを起動させることに注意してください。
 
1485
 
 
1486
フックシグネチャは(params)で、paramsは次のメンバーを含むオブジェクトです。
 
1487
 
 
1488
  branch
 
1489
    チップが変更されるブランチ。
 
1490
 
 
1491
  old_revno
 
1492
    変更前のブランチのリビジョン番号 (たとえば10)。
 
1493
 
 
1494
  old_revid
 
1495
    変更前のリビジョンid(たとえば joe@foo.com-1234234-aoeua34)。
 
1496
 
 
1497
  new_revno
 
1498
    変更後のブランチのリビジョン番号(たとえば12)。
 
1499
 
 
1500
  new_revid
 
1501
    変更後のリビジョンid(たとえば joe@foo.com-5676566-boa234a)。
 
1502
 
 
1503
ヘッドリビジョンはドットつきのリビジョン番号をけっして持たないのでold_revnoとnew_revnoメンバーは整数です。
 
1504
 
 
1505
 
 
1506
set_rh (Branch)
 
1507
---------------
 
1508
 
 
1509
注意: このフックは廃止され近い将来の内に削除されます。
 
1510
代わりに ``post_change_branch_tip`` フックを使用してくださるようお願いします。
 
1511
 
 
1512
 
 
1513
transform_fallback_location (Branch)
 
1514
------------------------------------
 
1515
 
 
1516
スタックドブランチとして起動させ、フォールバックロケーションをアクティベイトします。
 
1517
 
 
1518
フックのシグネチャは(branch, url)です:
 
1519
 
 
1520
  branch
 
1521
    開いたブランチ。まだフォールバックロケーションがアクティベイトされなければ、
 
1522
    ブランチは半分ビルドされたものとして扱われることに注意してください。
 
1523
 
 
1524
  url
 
1525
    フォールバックロケーション用にブランチが指定されたURL。
 
1526
    フックはフォールバックロケーションを含むブランチのためにURLを返さなければなりません。
 
1527
    複数のフックが登録されていると、呼び出される順番は未定義で変更の影響を受けます。
 
1528
 
 
1529
(1.9の新しい機能)
 
1530
 
 
1531
 
 
1532
server_started (SmartTCPServer)
 
1533
-------------------------------
 
1534
 
 
1535
サーバーがディレクトリのサービスを提供始めるたびに起動します。
 
1536
サーバーで実行されます。
 
1537
フックのシグネチャは (backing urls, public url)です。
 
1538
 
 
1539
  backing_url
 
1540
    サーバー固有のディレクトリの位置を渡す(string) URLのリスト。
 
1541
 
 
1542
  public_url
 
1543
    ディレクトリ用の公開URL。
 
1544
 
 
1545
 
 
1546
server_stopped (SmartTCPServer)
 
1547
-------------------------------
 
1548
 
 
1549
サーバーがディレクトリの提供を停止するときに常に起動します。
 
1550
サーバーで実行します。
 
1551
フックのシグネチャは ``server_started`` と同じです。
 
1552
 
 
1553
 
 
1554
lock_acquired (LockDir)
 
1555
----------------------------
 
1556
 
 
1557
ロックの取得が成功したときにLockResultオブジェクトで呼び出されます(1.8で導入)。
 
1558
 
 
1559
lock_released (LockDir)
 
1560
----------------------------
 
1561
 
 
1562
ロックのリリースが成功したときにLockResultオブジェクトで呼び出されます(1.8で導入)。
 
1563
クライアントで実行します。
 
1564
 
 
1565
 
 
1566
commit_message_template (msgeditor)
 
1567
-----------------------------------
 
1568
 
 
1569
コミットメッセージテンプレートを生成するためにコミットによって起動する。
 
1570
それぞれのフックはコミットメッセージテンプレートを修正できます。
 
1571
フックのシグネチャは (commit, start_message)です:
 
1572
 
 
1573
  commit
 
1574
    進行中のコミットのための、コミットオブジェクト
 
1575
 
 
1576
  start_message
 
1577
    オリジナルのコミットメッセージで、初期はNone。
 
1578
 
 
1579
フックは新しいコミットメッセージテンプレートを返します。
 
1580
 
 
1581
(1.10の新しい機能)
 
1582
 
 
1583
 
 
1584
その他のストレージフォーマット
 
1585
==============================
 
1586
 
 
1587
実験的なフォーマットは次のとおりです。
 
1588
 
 
1589
:1.12-preview:
 
1590
    (ネイティブ) ビューとコンテンツのフィルタリングをサポートする作業ツリーフォーマット。
 
1591
 
 
1592
:1.12-preview-rich-root:
 
1593
    (ネイティブ) rich-rootデータをサポートする1.12-previewのバリアント(bzr-svnに必要)。
 
1594
 
 
1595
:development:
 
1596
    (ネイティブ) 現在の開発フォーマット。
 
1597
    pack-0.92 (とpack-0.92と互換性のある)フォーマットリポジトリにデータを変換できます。
 
1598
    このフォーマットのリポジトリとブランチはbzr.devによってのみ読み込みできます。
 
1599
    使用する前に http://doc.bazaar-vcs.org/latest/developers/development-repo.html
 
1600
    をご覧下さるようお願いします。
 
1601
 
 
1602
 
 
1603
:development-subtree:
 
1604
    (ネイティブ) 現在の開発フォーマット。サブツリーのバリアント。
 
1605
    pack-0.92-subtree (pack-0.92-subtreeと互換性のあるものなら何でも)フォーマットリポジトリ
 
1606
    から/へのデータの変換ができる。このフォーマットのリポジトリとブランチは
 
1607
    bzr.devによってのみ読み込みできます。
 
1608
    使用する前に http://doc.bazaar-vcs.org/latest/developers/development-repo.html
 
1609
    をご覧下さるようお願いします。
 
1610
 
 
1611
 
 
1612
廃止されたフォーマットは下記のとおりです。
 
1613
 
 
1614
:metaweave:
 
1615
    (ネイティブ) 0.8の暫定的なフォーマット。knitよりも遅い
 
1616
 
 
1617
:weave:
 
1618
    (ネイティブ) 0.8以前のフォーマット。knitよりも遅くチェックアウトと共用リポジトリをサポートしない。
 
1619
 
 
1620
:knit:
 
1621
    (ネイティブ) knitを使用するフォーマット。0.14とそれ以前のbzrとの相互運用に推奨される。
 
1622
 
 
1623
:dirstate:
 
1624
    (ネイティブ) 0.15での新しいフォーマット: ローカルオペレーションが速い。
 
1625
    ネットワークを通してアクセスするときは0.8とそれ以降のbzrと互換性がある。
 
1626
 
 
1627
:dirstate-tags:
 
1628
    (ネイティブ) 0.15での新しいフォーマット: 速いローカルオペレーションとネットワークオペレーションに関する改善されたスケーリング。
 
1629
    タグ用のサポートを追加。0.15以前のbzrとは互換性がない
 
1630
 
 
1631
:rich-root:
 
1632
    (ネイティブ) 1.0での新しいフォーマット。ツリーrootの扱いを改善。1.0以前のbzrと互換性がない。
 
1633
 
 
1634
 
 
1635
詳細なストレージフォーマットは ``bzr help formats`` を参照してください。
 
1636
 
 
1637
 
 
1638
リビジョンの識別子
 
1639
====================
 
1640
 
 
1641
リビジョンの識別子はブランチの履歴の特定の状態を参照します。
 
1642
これはリビジョン番号、もしくは ':' が後に続くキーワード、と他のパラメータになります。
 
1643
識別子の例として '3' 、 'last:1' 、 'before:yesterday' と 'submit:' などがあります。
 
1644
 
 
1645
'REV1' と 'REV2' がリビジョンの識別子である場合、
 
1646
'REV1..REV2' はリビジョンの範囲を表示します。
 
1647
例: '3647..3649' 、 'date:yesterday..-1' と 'branch:/path/to/branch1/..branch:/branch2'
 
1648
('..'周辺にはクォートもしくはスペースが存在しません)。
 
1649
 
 
1650
範囲は異なるコマンドによって異なる解釈がなされます。
 
1651
"log" コマンドに対して、範囲はログメッセージのシーケンスで、
 
1652
"diff" コマンドに対しては、範囲は(変更のシーケンスではなく)リビジョン間の変更を表示します。
 
1653
加えて、 "log" はclosed rangeを考慮するのに対して"diff"と"merge"はopen-endedとみなす、
 
1654
すなわち、これらは1つのendを含みますが他方は含みません。
 
1655
例です: "bzr log -r 3647..3649"はリビジョン3647、3648と3649のメッセージを表示するのに対して、
 
1656
"bzr diff -r 3647..3649"は3647と3648の間に行われた変更を含み、3649の変更は含みません。
 
1657
 
 
1658
リビジョン選択方法として使用されるキーワードは次のとおりです:
 
1659
 
 
1660
:revno:
 
1661
        番号を使用するリビジョンを選択する。
 
1662
:revid:
 
1663
        リビジョンidを使用するリビジョンを選択する。
 
1664
:last:
 
1665
        最後からn番目のリビジョンを選択する。
 
1666
:before:
 
1667
        指定されたリビジョンの親を選択する。
 
1668
:tag:
 
1669
        タグ名によって識別されるリビジョンを選択する。
 
1670
:date:
 
1671
        日付スタンプを基本とするリビジョンを選択する。
 
1672
:ancestor:
 
1673
        2番目のブランチで共通の祖先を選択する。
 
1674
:branch:
 
1675
        指定ブランチの最終リビジョンを選択する。
 
1676
:submit:
 
1677
        投稿ブランチで共通の祖先を選択する。
 
1678
 
 
1679
加えて、プラグインは他のキーワードを提供できます。
 
1680
 
 
1681
それぞれのキーワードの詳細な説明は下記のとおりです。
 
1682
 
 
1683
:revno:
 
1684
 
 
1685
    ブランチの履歴内のリビジョンを指定するために整数を使用する。
 
1686
    オプションとしてブランチを指定できます。接頭辞の 'revno:' はオプションです。
 
1687
    負の数はブランチの最後から数えます(-1は最後のリビジョン、-2はその前のリビジョン)。
 
1688
    負の数がブランチの履歴よりも大きい場合、最初のリビジョンが返されます。
 
1689
    例::
 
1690
 
 
1691
      revno:1                   -> このブランチの最初のリビジョンを返す
 
1692
      revno:3:/path/to/branch   -> '/path/to/branch' ブランチの3番目のリビジョンを返す
 
1693
      revno:-1                  -> ブランチの最後のリビジョン。
 
1694
      -2:http://other/branch    -> リモートブランチの最後から2番目のリビジョン。
 
1695
      -1000000                  -> 履歴がとても長くなければ、おそらくは最初のリビジョン。
 
1696
 
 
1697
:revid:
 
1698
 
 
1699
    特定のリビジョンidを提供します。
 
1700
    ブランチの祖先のリビジョンidを指定するために使用できます。
 
1701
    マージと、マージの追加を含む。
 
1702
    例::
 
1703
 
 
1704
      revid:aaaa@bbbb-123456789 -> リビジョン 'aaaa@bbbb-123456789' を選択する
 
1705
 
 
1706
:last:
 
1707
 
 
1708
    最後からn番目のリビジョンを取得するには正の数を提供する。
 
1709
    負の数の提供に関しては 'revno:' の仕様と同じです。
 
1710
    例::
 
1711
 
 
1712
      last:1        -> 最後のバージョンを返す。
 
1713
      last:3        -> 最後の2つ前のリビジョンを返す。
 
1714
 
 
1715
:before:
 
1716
 
 
1717
    そのリビジョンの親を返すリビジョンスペックを提供する。
 
1718
    主にブランチのリビジョンの履歴の中に存在しないリビジョンを検査する際に便利です。
 
1719
 
 
1720
    nullリビジョン(before:0)の親をリクエストするのは間違いです。
 
1721
 
 
1722
    例::
 
1723
 
 
1724
      before:1913    -> revno 1913の親を返す (revno 1912)
 
1725
      before:revid:aaaa@bbbb-1234567890  -> リビジョンaaaa@bbbb-1234567890の親を返す
 
1726
      bzr diff -r before:1913..1913
 
1727
            -> リビジョン1913とその親(1912)の間の変更を見つける
 
1728
               (リビジョン1913が導入する変更が行うこと)。
 
1729
               これは bzr diff -c 1913と同等です
 
1730
 
 
1731
:tag:
 
1732
 
 
1733
    タグはブランチに保存され、'tag'コマンドによって作成される。
 
1734
 
 
1735
:date:
 
1736
 
 
1737
    日付にマッチする最初のリビジョンを選択するためのデータスタンプを提供する。
 
1738
    日付は 'yesterday'、'today'、'tomorrow' もしくはYYYY-MM-DDの文字列です。
 
1739
    与えられた日付(深夜もしくは指定された時間のどちらか)の後の最初のエントリにマッチする。
 
1740
 
 
1741
    昨日以降のすべての変更を表示する方法の1つは次のとおりです::
 
1742
 
 
1743
        bzr log -r date:yesterday..
 
1744
 
 
1745
    例::
 
1746
 
 
1747
      date:yesterday            -> 昨日以降の最初のリビジョンを選択する
 
1748
      date:2006-08-14,17:10:14  -> August 14th, 2006 at 5:10pmの後の最初のリビジョンを選択する。
 
1749
 
 
1750
:ancestor:
 
1751
 
 
1752
    共通の祖先を選択するためにブランチへのパスを提供する。
 
1753
 
 
1754
    共通の祖先は両方のブランチの中に存在する最後のリビジョンです。
 
1755
    通常これはブランチポイントですが、マージされたリビジョンにもなり得ます。
 
1756
 
 
1757
    リモートブランチからマージしなかった変更を除外する一方で、
 
1758
    これはブランチが導入したすべての変更を返すために 'diff' でよく使用されます。
 
1759
 
 
1760
    例::
 
1761
 
 
1762
      ancestor:/path/to/branch
 
1763
      $ bzr diff -r ancestor:../../mainline/branch
 
1764
 
 
1765
:branch:
 
1766
 
 
1767
    最後のリビジョンを選択するためにブランチへのパスを提供する。
 
1768
 
 
1769
    例::
 
1770
 
 
1771
      branch:/path/to/branch
 
1772
 
 
1773
:submit:
 
1774
 
 
1775
    これに対する差分は、このブランチで行われたすべての変更を表示し、
 
1776
    マージされる予定のもののよい予測子です。
 
1777
    投稿ブランチはbundleとmergeコマンドによって使用されます。
 
1778
    投稿ブランチが指定されなければ、親ブランチが代わりに使用されます。
 
1779
 
 
1780
    共通の祖先は両方のブランチ内に存在する最終リビジョンです。
 
1781
    通常これはブランチポイントですが、マージされたリビジョンにもなり得ます。
 
1782
 
 
1783
    例::
 
1784
 
 
1785
      $ bzr diff -r submit:
 
1786
 
 
1787
 
 
1788
標準オプション
 
1789
===============
 
1790
 
 
1791
標準オプションはすべてのコマンドで有効です。
 
1792
 
 
1793
--help, -h     ヘルプメッセージを表示する。
 
1794
--verbose, -v  詳細な情報を表示する。
 
1795
--quiet, -q    エラーと警告のみ表示する。
 
1796
 
 
1797
グローバルオプションとは異なり、標準オプションはエイリアスで利用可能です。
 
1798
 
 
1799
 
 
1800
ステータスフラグ
 
1801
==================
 
1802
 
 
1803
簡潔な方法で作業ツリーへの変更を要約するためにステータスフラグが使用されます。これらは次の形式をとります::
 
1804
 
 
1805
   xxx   <filename>
 
1806
 
 
1807
カラムの意味は次のとおりです。
 
1808
カラム 1 - バージョン管理/リネーム::
 
1809
 
 
1810
  + バージョン管理されているファイル
 
1811
  - バージョン管理されていないファイル
 
1812
  R リネームされたファイル
 
1813
  ? 未知のファイル
 
1814
  C 衝突した内容を持つファイル
 
1815
  P マージを追加するためのエントリ(ファイルではない)
 
1816
 
 
1817
カラム 2 - コンテンツ::
 
1818
 
 
1819
  N 作成されたファイル
 
1820
  D 削除されたファイル
 
1821
  K 変更されたファイルの種類
 
1822
  M 修正されたファイル
 
1823
 
 
1824
カラム 3 - 実行::
 
1825
 
 
1826
  * 実行が少し変更された
 
1827
 
 
1828
 
 
1829
URLの識別子
 
1830
============
 
1831
 
 
1832
サポートされるURLの接頭辞::
 
1833
 
 
1834
  aftp://             アクティブFTPを利用したアクセス
 
1835
  bzr://              Bazaarスマートサーバーを利用したファーストアクセス
 
1836
  bzr+ssh://          SSHを通したBazaarスマートサーバーを利用したファーストアクセス
 
1837
  file://             標準ファイルシステムを利用したアクセス(デフォルト)
 
1838
  ftp://              パッシブFTPを利用したアクセス
 
1839
  http://             ウェブにエクスポートされたブランチへのリードオンリーのアクセス。
 
1840
  https://            SSLを利用したウェブにエクスポートされたブランチへのリードオンリーのアクセス。
 
1841
  sftp://             SFTPを利用したアクセス(大抵のSSHサーバーはSFTPを提供する)。
 
1842
 
 
1843
 
 
1844
.. _authentication: `認証の設定`_
 
1845
.. _bugs: `バグトラッカーの設定`_
 
1846
.. _configuration: `構成設定`_
 
1847
.. _conflicts: `衝突のタイプ`_
 
1848
.. _current-formats: `現在のストレージフォーマット`_
 
1849
.. _env-variables: `環境変数`_
 
1850
.. _global-options: `グローバルオプション`_
 
1851
.. _other-formats: `その他のストレージフォーマット`_
 
1852
.. _revisionspec: `リビジョンの識別子`_
 
1853
.. _standard-options: `標準オプション`_
 
1854
.. _status-flags: `ステータスフラグ`_
 
1855
.. _urlspec: `URLの識別子`_
 
1856
 
 
1857
 
 
1858
 
 
1859
コマンド
 
1860
#########
 
1861
 
 
1862
add
 
1863
===
 
1864
:目的: 指定したファイルもしくはディレクトリを追加する。
 
1865
:使い方:   bzr add [FILE...]
 
1866
 
 
1867
:オプション:
 
1868
  --dry-run            何が行われるか表示するが、実際には行わない。
 
1869
  -v, --verbose        詳細な情報を表示する。
 
1870
  --no-recurse         ディレクトリの内容を再帰的に追加しない。
 
1871
  -h, --help           ヘルプメッセージを表示する。
 
1872
  -q, --quiet          エラーと警告だけ表示する。
 
1873
  --file-ids-from=ARG  このツリーからファイルのidを探索する。
 
1874
 
 
1875
:説明:
 
1876
  non-recursiveモードでは、以前無視されたファイルであっても、
 
1877
  名前つきのすべてのアイテムが追加されます。
 
1878
  名前つきファイルがすでにバージョン管理されている場合は警告が表示されます。
 
1879
 
 
1880
  recursiveモード(デフォルト)では、ファイルは同じ方法で扱われますが、
 
1881
  ディレクトリに対するふるまいは異なります。
 
1882
  すでにバージョン管理されているディレクトリであれば警告は表示されません。
 
1883
  すべてのディレクトリは、バージョン管理されているかいないかに関わらず、
 
1884
  ファイルもしくはバージョン管理も無視もされているサブディレクトリのための検索対象になり、
 
1885
  これらは追加されます。
 
1886
  この検索はバージョン管理されたディレクトリにも再帰的に進められます。
 
1887
  名前が渡されなければ、'.'が想定されます。
 
1888
 
 
1889
  それゆえ単に 'bzr add' を実行すると現在未知であるファイルのすべてがバージョン管理されます。
 
1890
 
 
1891
  親ディレクトリがバージョン管理されていないファイルを追加すると
 
1892
  親およびそのrootまでも暗黙の内に追加されます。
 
1893
  このことが意味するのはディレクトリを明示的に追加する必要はなく、
 
1894
  ディレクトリの中のファイルを1つ追加するときにそれらのディレクトリも追加されます。
 
1895
 
 
1896
  --dry-runは追加されるファイルを表示しますが、それらを実際に追加しません。
 
1897
 
 
1898
  --file-ids-fromは提供されたパスからファイルのidの使用を試みます。
 
1899
  これは同じファイル名を持ちマッチするディレクトリの発見をするためにidを探し、また純粋なパスによって行います。
 
1900
  このオプションが必要になるのはめったにありませんが、後でマージする2つのブランチに同じ論理ファイルを追加する
 
1901
  ときに便利です(2つの異なる追加を衝突として表示しません)。
 
1902
  別のプロジェクトをこのプロジェクトのサブディレクトリにマージする際にも便利です。
 
1903
 
 
1904
:関連コマンド: `remove`_
 
1905
 
 
1906
 
 
1907
alias
 
1908
=====
 
1909
:目的: エイリアスの設定/設定解除と表示を行う。
 
1910
:使い方:   bzr alias [NAME]
 
1911
 
 
1912
:オプション:
 
1913
  -v, --verbose  詳細な情報を表示する。
 
1914
  -q, --quiet    エラーと警告だけ表示する。
 
1915
  --remove       エイリアスを削除する。
 
1916
  -h, --help     ヘルプメッセージを表示する。
 
1917
 
 
1918
:例:
 
1919
    現在のエイリアスを表示するには::
 
1920
 
 
1921
        bzr alias
 
1922
 
 
1923
    'll'用に指定されたエイリアスを表示するには::
 
1924
 
 
1925
        bzr alias ll
 
1926
 
 
1927
    'll'のエイリアスを設定するには::
 
1928
 
 
1929
        bzr alias ll="log --line -r-10..-1"
 
1930
 
 
1931
    'll'のエイリアスを削除するには::
 
1932
 
 
1933
        bzr alias --remove ll
 
1934
 
 
1935
 
 
1936
 
 
1937
annotate
 
1938
========
 
1939
:目的: ファイルのそれぞれの行のoriginを表示する。
 
1940
:使い方:   bzr annotate FILENAME
 
1941
 
 
1942
:オプション:
 
1943
  --all                 すべての行の注釈を表示する。
 
1944
  -v, --verbose         詳細な情報を表示する。
 
1945
  -h, --help            ヘルプメッセージを表示する。
 
1946
  -q, --quiet           エラーと警告のみを表示する。
 
1947
  --long                注釈のコミット日時を表示する。
 
1948
  --show-ids            内部のオブジェクトidを表示する。
 
1949
  -r ARG, --revision=ARG
 
1950
                        "help revisionspec"の詳細を参照。
 
1951
 
 
1952
:説明:
 
1953
  このコマンドは与えられたファイルの、変更によって導入されたリビジョン、
 
1954
  筆者と日付を示す注釈を左側で表示します。
 
1955
 
 
1956
  連続した行の続きに関してoriginが同じ場合、
 
1957
  --allオプションが渡されない限り、これはトップでのみ表示されます。
 
1958
 
 
1959
:エイリアス:  ann, blame, praise
 
1960
 
 
1961
 
 
1962
bind
 
1963
====
 
1964
:目的: 現在のブランチを提供されたブランチのチェックアウトに変換する。
 
1965
:使い方:   bzr bind [LOCATION]
 
1966
 
 
1967
:オプション:
 
1968
  -v, --verbose  詳細な情報を表示する。
 
1969
  -q, --quiet    エラーと警告だけ表示する。
 
1970
  -h, --help     ヘルプメッセージを表示する。
 
1971
 
 
1972
:説明:
 
1973
  チェックアウトに変換されると、コミットはローカルブランチに適用される前に
 
1974
  コミットはマスターブランチを継承しなければなりません。
 
1975
 
 
1976
  ローカルに設定されない限りバインドされたブランチは
 
1977
  マスターブランチのニックネームを使用します。
 
1978
  この場合、バインディングはローカルなニックネームをマスターのものに更新します。
 
1979
 
 
1980
:関連コマンド: `checkout`_, `unbind`_
 
1981
 
 
1982
 
 
1983
branch
 
1984
======
 
1985
:目的: ブランチの新しいコピーを作成する。
 
1986
:使い方:   bzr branch FROM_LOCATION [TO_LOCATION]
 
1987
 
 
1988
:オプション:
 
1989
  --stacked             ソースブランチを参照するスタックドブランチを作成する。
 
1990
                        すべてのオペレーションに関して
 
1991
                        新しいブランチはソースブランチの利用可能性に依存する。
 
1992
  -v, --verbose         詳細な情報を表示する。
 
1993
  --standalone          利用可能であっても共用リポジトリを使用しない。
 
1994
  -h, --help            ヘルプメッセージを表示する。
 
1995
  -q, --quiet           エラーと警告のみを表示する。
 
1996
  --hardlink            可能な作業ツリーファイルをハードリンクする。
 
1997
  -r ARG, --revision=ARG
 
1998
                        詳細は "help revisionspec" を参照。
 
1999
 
 
2000
:説明:
 
2001
  TO_LOCATIONが省略されると、FROM_LOCATIONの最終コンポーネントが使用されます。
 
2002
  言い換えると、 "branch ../foo/bar" は./bar を作成しようとします。
 
2003
  FROM_LOCATIONが/を持たない もしくは埋め込みのパスの区切り文字を持つ場合
 
2004
  冒頭のスキームもしくはドライブの識別子を剥ぎ取ることで、
 
2005
  FROM_LOCATIONからTO_LOCATIONが得られます。
 
2006
  たとえば、"branch lp:foo-bar"は./foo-barを作成しようとします。
 
2007
 
 
2008
  ブランチの特定のリビジョンを読み取るには、
 
2009
  "branch foo/bar -r 5"のような、--revisionパラメータを提供します。
 
2010
 
 
2011
:エイリアス:  get, clone
 
2012
:関連コマンド: `checkout`_
 
2013
 
 
2014
 
 
2015
break-lock
 
2016
==========
 
2017
:目的: リポジトリ、ブランチもしくは作業ディレクトリのデッドロックをブレークする。
 
2018
:使い方:   bzr break-lock [LOCATION]
 
2019
 
 
2020
:オプション:
 
2021
  -v, --verbose  詳細な情報を表示する。
 
2022
  -q, --quiet    エラーと警告だけ表示する。
 
2023
  -h, --help     ヘルプメッセージを表示する。
 
2024
 
 
2025
:説明:
 
2026
  警告: ロックを保持するプロセスが停止したときにのみロックはブレークします。
 
2027
 
 
2028
  'bzr info'コマンドを通して開いているロックに関する情報を得ることができます。
 
2029
 
 
2030
:例:
 
2031
    bzr break-lock
 
2032
 
 
2033
 
 
2034
 
 
2035
cat
 
2036
===
 
2037
:目的: 与えられたリビジョンのファイルの内容を標準出力に書き込む。
 
2038
:使い方:   bzr cat FILENAME
 
2039
 
 
2040
:オプション:
 
2041
  -r ARG, --revision=ARG
 
2042
                        詳細は"help revisionspec"を参照。
 
2043
  -v, --verbose         詳細な情報を表示する。
 
2044
  -q, --quiet           エラーと警告のみを表示する。
 
2045
  --name-from-revision  古いツリーのパス名。
 
2046
  -h, --help            ヘルプメッセージを表示する。
 
2047
 
 
2048
:説明:
 
2049
  リビジョンが指定されなければ、最後のリビジョンが使用されます。
 
2050
 
 
2051
  注意: バイナリファイルでこのコマンドを使用する際には
 
2052
        標準出力をリダイレクトするように気をつけてください。
 
2053
 
 
2054
:関連コマンド: `ls`_
 
2055
 
 
2056
 
 
2057
check
 
2058
=====
 
2059
:目的: 作業ツリーの構造、ブランチの一貫性、とリポジトリの履歴をバリデートする。
 
2060
:使い方:   bzr check [PATH]
 
2061
 
 
2062
:オプション:
 
2063
  -v, --verbose  詳細な情報を表示する。
 
2064
  --tree         現在のディレクトリに関連した作業ツリーをチェックする。
 
2065
  -q, --quiet    エラーと警告だけ表示する。
 
2066
  --repo         現在のディレクトリに関連したリポジトリをチェックする。
 
2067
  --branch       現在のディレクトリに関連したブランチをチェックする。
 
2068
  -h, --help     ヘルプメッセージを表示する。
 
2069
 
 
2070
:説明:
 
2071
  このコマンドはデータの破損もしくはbzrのバグを検出するために
 
2072
  ブランチとリポジトリストレージに関するさまざまな不変量をチェックします・
 
2073
 
 
2074
  問題が検出された場合のみ作業ツリーとブランチのチェックは出力をします。
 
2075
  リポジトリチェックの出力フィールドは次のとおりです:
 
2076
 
 
2077
      revisions: これはチェックされるリビジョンの番号です。
 
2078
          これは問題を示しません。
 
2079
      versionedfiles: これはチェックされるバージョン管理されたファイルの数です。
 
2080
          これは問題を示しません。
 
2081
      unreferenced ancestors: 他のテキストの祖先であるテキストは、
 
2082
          リビジョンの祖先によって適切に参照されません。
 
2083
          これはBazaarが対処できるsubtleな問題です。
 
2084
      unique file texts: チェックされるリビジョンで見つかる
 
2085
          ファイルの内容の合計数です。これは問題を示しません。
 
2086
      repeated file texts: チェックされるリビジョンで見つかる、
 
2087
          繰り返されるテキストの合計数です。
 
2088
          テキストのエントリが修正されたときにテキストは繰り返しできますが、
 
2089
          ファイルの内容は繰り返しできません。
 
2090
          これは問題を示しません。
 
2091
 
 
2092
  制限が指定されなければ、すべてのBazaarデータはチェックされる位置で見つかります。
 
2093
 
 
2094
:例:
 
2095
    'foo' でのツリーとブランチをチェックする::
 
2096
 
 
2097
        bzr check --tree --branch foo
 
2098
 
 
2099
    'bar'でのリポジトリのみをチェックする::
 
2100
 
 
2101
        bzr check --repo bar
 
2102
 
 
2103
    'baz' ですべてをチェックする::
 
2104
 
 
2105
        bzr check baz
 
2106
 
 
2107
:関連コマンド: `reconcile`_
 
2108
 
 
2109
 
 
2110
checkout
 
2111
========
 
2112
:目的: 既存のブランチの新しいチェックアウトを作成する。
 
2113
:使い方:   bzr checkout [BRANCH_LOCATION] [TO_LOCATION]
 
2114
 
 
2115
:オプション:
 
2116
  -v, --verbose         詳細な情報を表示する。
 
2117
  -h, --help            ヘルプメッセージを表示する。
 
2118
  --files-from=ARG      このツリーからファイルの内容を取得する。
 
2119
  -q, --quiet           エラーと警告のみを表示する。
 
2120
  --hardlink            利用可能な作業ツリーファイルをハードリンクする。
 
2121
  --lightweight         軽量チェックアウトを実行する。オペレーションに関して
 
2122
                        軽量チェックアウトはブランチへの権限に依存する。
 
2123
                        通常のチェックアウトはdiffやstatusのようなアクセスが
 
2124
                        不要な共通のオペレーションを実行可能で、
 
2125
                        ローカルコミットもサポートします。
 
2126
  -r ARG, --revision=ARG
 
2127
                        詳細は"help revisionspec"を参照。
 
2128
 
 
2129
:説明:
 
2130
  BRANCH_LOCATIONが省略されると、'.'で見つかるブランチ用に
 
2131
  チェックアウトは作業ツリーを再構成します。
 
2132
  作業ツリーを削除した場合もしくはこれがけっして作成されない場合
 
2133
  - すなわち、SFTPを使用してブランチを現在の位置にpushする場合、これは便利です。
 
2134
 
 
2135
  TO_LOCATIONが省略されると、BRANCH_LOCATIONの最後のコンポーネントが使用されます。
 
2136
  言い換えると、"checkout ../foo/bar" は./barを作成しようとします。
 
2137
  BRANCH_LOCATIONが has no /を持たないもしくはパスの区切り文字が埋め込まれている場合、
 
2138
  先頭のスキームもしくはドライブの識別子を除去することでBRANCH_LOCATIONからTO_LOCATIONが
 
2139
  得られます。たとえば、"checkout lp:foo-bar"は./foo-barを作成しようとします。
 
2140
 
 
2141
  特定のリビジョンのブランチを読み取るには、
 
2142
  "checkout foo/bar -r 5"のように--revisionパラメータを提供します。
 
2143
  これはすぐに時代遅れになりますが[なのでコミットできない]
 
2144
  役に立つことがあります(すなわち古いコードを検査するため)。
 
2145
 
 
2146
:エイリアス:  co
 
2147
:関連コマンド: `branch`_, `チェックアウト`_
 
2148
 
 
2149
 
 
2150
commit
 
2151
======
 
2152
:目的: 変更を新しいリビジョンにコミットする。
 
2153
:使い方:   bzr commit [SELECTED...]
 
2154
 
 
2155
:オプション:
 
2156
  -v, --verbose         詳細な情報を表示する。
 
2157
  --author=ARG          著者の名前がコミッターとは異なる場合、著者の名前を設定する。
 
2158
  --unchanged           何も変更されていなくてもコミットする。
 
2159
  --fixes=ARG           このリビジョンをバグが修正されたものとしてマークする。
 
2160
  -q, --quiet           エラーと警告のみを表示する。
 
2161
  --show-diff           メッセージが提供されないとき、
 
2162
                        メッセージエディタでステータスの要約と一緒に差分を表示する。
 
2163
  --strict              作業ツリーの中に未知のファイルが存在する場合コミットを拒否する。
 
2164
  -F MSGFILE, --file=MSGFILE
 
2165
                        このファイルからコミットメッセージを取得する。
 
2166
  -x ARG, --exclude=ARG
 
2167
                        与えられたパスへの変更を考慮しない。
 
2168
  -m ARG, --message=ARG
 
2169
                        新しいリビジョンの説明。
 
2170
  --local               バインドされたブランチにローカルコミットを実行する。
 
2171
                        通常のコミットが実行されるまで
 
2172
                        ローカルコミットはマスターブランチにpushされません。
 
2173
 
 
2174
  -h, --help            ヘルプメッセージを表示する。
 
2175
 
 
2176
:説明:
 
2177
  引数が渡されなければ、ツリー全体がコミットされます。
 
2178
 
 
2179
  選択されたファイルが指定されると、これらのファイルへの変更のみがコミットされます。
 
2180
  ディレクトリが指定されるとディレクトリとその中のすべてがコミットされます。
 
2181
 
 
2182
  excludesが渡されるとき、これらは選択されたファイルよりも優先されます。
 
2183
  たとえば、fooの範囲での変更のみコミットされますが、foo/barの範囲の変更はコミットされません::
 
2184
 
 
2185
    bzr commit foo -x foo/bar
 
2186
 
 
2187
  変更の著者がコミッターと同じ人物でなければ、
 
2188
  --authorオプションを使用して著者の名前を指定できます。
 
2189
  名前はコミッターidと同じフォーマットです。たとえば"John Doe <jdoe@example.com>"です。
 
2190
 
 
2191
  コミットされるツリーが無効である場合選択されたファイルのコミットが失敗することがあります。
 
2192
  次の一連のコマンドを考えてみましょう::
 
2193
 
 
2194
    bzr init foo
 
2195
    mkdir foo/bar
 
2196
    bzr add foo/bar
 
2197
    bzr commit foo -m "committing foo"
 
2198
    bzr mv foo/bar foo/baz
 
2199
    mkdir foo/bar
 
2200
    bzr add foo/bar
 
2201
    bzr commit foo/bar -m "committing bar but not baz"
 
2202
 
 
2203
  上記の例において、最終コミットは故意に失敗します。
 
2204
  これによってユーザーは、同時に、最初に個別に、もしくはまったく
 
2205
  リネームしたくないかどうかを決める機会を得ます。
 
2206
  (一般的なルールとして、判断がつかないとき、Bazaarは安全に物事を行う方針を持ちます。)
 
2207
 
 
2208
  注: マージの後の選択されたファイルのコミットはまだサポートされていません。
 
2209
 
 
2210
:エイリアス:  ci, checkin
 
2211
:関連コマンド: `bugs`_, `uncommit`_
 
2212
 
 
2213
 
 
2214
conflicts
 
2215
=========
 
2216
:目的: 衝突を持つファイルの一覧を表示する。
 
2217
:使い方:   bzr conflicts
 
2218
 
 
2219
:オプション:
 
2220
  --text         テキストの衝突を持つファイルのパスの一覧を表示する。
 
2221
  -v, --verbose  詳細な情報を表示する。
 
2222
  -q, --quiet    エラーと警告だけ表示する。
 
2223
  -h, --help     ヘルプメッセージを表示する。
 
2224
 
 
2225
:説明:
 
2226
  マージは2つのブランチの変更を結合するために最善を尽くしますが、
 
2227
  人間だけが修正できるある種の問題が存在します。
 
2228
  この問題に遭遇するとき、衝突がマークされます。
 
2229
  衝突はコミットする前に何かを修正する必要があることを意味します。
 
2230
 
 
2231
  通常の衝突は短く人間が読めるメッセージとして一覧が示されます。
 
2232
  --textが提供される場合、代わりに、テキストの衝突を持つファイルのパスの一覧が表示されます。
 
2233
  (これはテキストの衝突を持つファイルをすべて編集するために便利です。)
 
2234
 
 
2235
  問題を修正したらbzr resolveを使用します。
 
2236
 
 
2237
:関連コマンド: `resolve`_
 
2238
 
 
2239
 
 
2240
 
 
2241
deleted
 
2242
=======
 
2243
:目的: 作業ツリーの中で削除されたファイルの一覧を表示する。
 
2244
:使い方:   bzr deleted
 
2245
 
 
2246
:オプション:
 
2247
  --show-ids     内部のオブジェクトidを表示する。
 
2248
  -v, --verbose  詳細な情報を表示する。
 
2249
  -q, --quiet    エラーと警告だけ表示する。
 
2250
  -h, --help     ヘルプメッセージを表示する。
 
2251
 
 
2252
:関連コマンド: `ls`_, `status`_
 
2253
 
 
2254
 
 
2255
diff
 
2256
====
 
2257
:目的: リビジョンもしくはブランチの間の、作業ツリーの中の違いを表示する。
 
2258
:使い方:   bzr diff [FILE...]
 
2259
 
 
2260
:オプション:
 
2261
  --old=ARG             から比較するブランチ/ツリー。
 
2262
  -v, --verbose         詳細な情報を表示する。
 
2263
  -q, --quiet           エラーと警告のみを表示する。
 
2264
  -p ARG, --prefix=ARG  コロンによって区切られた2つの値として
 
2265
                        新旧のファイル名に追加される接頭辞を設定する(たとえば"old/:new/")。
 
2266
  --using=ARG           ファイルを比較するためにこのコマンドを使用する。
 
2267
  --new=ARG             へ比較するブランチ/ツリー。
 
2268
  -r ARG, --revision=ARG
 
2269
                        詳細は"help revisionspec"を参照。
 
2270
  --diff-options=ARG    これらのオプションを外部diffプログラムに渡す。
 
2271
  -c ARG, --change=ARG  指定されたリビジョンによって導入された変更を選択する。
 
2272
                        "help revisionspec"も参照。
 
2273
  -h, --help            ヘルプメッセージを表示する。
 
2274
 
 
2275
:説明:
 
2276
  引数が渡されなければ、現在のツリーに対するすべての変更の一覧が表示されます。
 
2277
  ファイルが渡されれば、これらのファイルの中の変更の一覧だけが表示されます。
 
2278
  リモートと複数のブランチは--oldと--newオプションを使用して比較できます。
 
2279
  これらのオプションが提供されなければ、両方のデフォルトは、存在すれば最初の引数、
 
2280
  引数が渡されなければ現在のツリーから得られます。
 
2281
 
 
2282
  "bzr diff -p1" は "bzr diff --prefix old/:new/"と同等で、
 
2283
  "patch -p1"に最適なパッチが生成されます。
 
2284
 
 
2285
:例:
 
2286
    作業ツリーと最終コミットの間の違いを表示する::
 
2287
 
 
2288
        bzr diff
 
2289
 
 
2290
    作業ツリーとリビジョン1の間の違い::
 
2291
 
 
2292
        bzr diff -r1
 
2293
 
 
2294
    リビジョン1とリビジョン2の間の違い::
 
2295
 
 
2296
        bzr diff -r1..2
 
2297
 
 
2298
    ブランチxxxのリビジョン1とリビジョン2の間の違い::
 
2299
 
 
2300
        bzr diff -r1..2 xxx
 
2301
 
 
2302
    NEWSファイルの違いだけ表示する::
 
2303
 
 
2304
        bzr diff NEWS
 
2305
 
 
2306
    NEWSファイルに対する作業ツリーの中の違いを表示する::
 
2307
 
 
2308
        bzr diff xxx/NEWS
 
2309
 
 
2310
    xxxブランチからこの作業ツリーの違いを表示する:
 
2311
 
 
2312
        bzr diff --old xxx
 
2313
 
 
2314
    NEWSファイルに対する2つのブランチの違いを表示する::
 
2315
 
 
2316
        bzr diff --old xxx --new yyy NEWS
 
2317
 
 
2318
    'bzr diff'と同じであるがold/とnew/でパスに接頭辞を追加する::
 
2319
 
 
2320
        bzr diff --prefix old/:new/
 
2321
 
 
2322
:Exitの値:
 
2323
    1 - 変更された
 
2324
    2 - 表現できない変更
 
2325
    3 - エラー
 
2326
    0 - 変更なし
 
2327
 
 
2328
 
 
2329
:エイリアス:  di, dif
 
2330
:関連コマンド: `status`_
 
2331
 
 
2332
 
 
2333
export
 
2334
======
 
2335
:目的: 現在のリビジョンを指定されたディレクトリもしくはアーカイブにエクスポートする。
 
2336
:使い方:   bzr export DEST [BRANCH_OR_SUBDIR]
 
2337
 
 
2338
:オプション:
 
2339
  -v, --verbose         詳細な情報を表示する。
 
2340
  --format=ARG          Type of file to export to.
 
2341
  -h, --help            ヘルプメッセージを表示する。
 
2342
  -q, --quiet           エラーと警告のみを表示する。
 
2343
  --root=ARG            エクスポートされたファイル内部のrootディレクトリの名前。
 
2344
  -r ARG, --revision=ARG
 
2345
                        詳細は"help revisionspec"を参照。
 
2346
 
 
2347
:説明:
 
2348
  リビジョンが指定されなければこれは最終コミットのリビジョンをエクスポートします。
 
2349
 
 
2350
  フォーマットはtar、tgz、tbz2のような"exporter"の名前になることができます。
 
2351
  何も渡されなければ、拡張子かrフォーマットを見つけようとします。
 
2352
  拡張子が見つからなければディレクトリにエクスポートします(--format=dirと同等)。
 
2353
 
 
2354
  rootが提供されると、これはコンテナフォーマット(tar、zip、その他)内部のrootディレクトリとして使用されます。
 
2355
  これが提供されなければエクスポートされるファイル名へのデフォルトになります。
 
2356
  rootオプションは'dir'フォーマットに対して効果がありません。
 
2357
 
 
2358
  ブランチが省略されると現在の作業ディレクトリを含むブランチが使用されます。
 
2359
 
 
2360
  注: ASCIIではないファイル名でのツリーのエクスポートはサポートされません。
 
2361
 
 
2362
    ==========================       =========================
 
2363
    サポートされるフォーマット        拡張子で自動検出
 
2364
    ==========================       =========================
 
2365
       dir                              (none)
 
2366
       tar                               .tar
 
2367
       tbz2                              .tar.bz2, .tbz2
 
2368
       tgz                               .tar.gz, .tgz
 
2369
       zip                               .zip
 
2370
    ==========================       =========================
 
2371
 
 
2372
 
 
2373
 
 
2374
help
 
2375
====
 
2376
:目的: コマンドもしくは他のトピックのヘルプを表示する。
 
2377
:使い方:   bzr help [TOPIC]
 
2378
 
 
2379
:オプション:
 
2380
  -v, --verbose  詳細な情報を表示する。
 
2381
  -q, --quiet    エラーと警告だけ表示する。
 
2382
  --long         すべてのコマンドのヘルプを表示する。
 
2383
  -h, --help     ヘルプメッセージを表示する。
 
2384
 
 
2385
:エイリアス:  ?, --help, -?, -h
 
2386
:関連コマンド: topics
 
2387
 
 
2388
 
 
2389
ignore
 
2390
======
 
2391
:目的: 指定されたファイルもしくはパターンを無視する。
 
2392
:使い方:   bzr ignore [NAME_PATTERN...]
 
2393
 
 
2394
:オプション:
 
2395
  --old-default-rules   bzr < 0.9で使用される無視ルールを書き出す。
 
2396
  -v, --verbose         詳細な情報を表示する。
 
2397
  -q, --quiet           エラーと警告のみを表示する。
 
2398
  -h, --help            ヘルプメッセージを表示する。
 
2399
 
 
2400
:説明:
 
2401
  パターンの構文の詳細は ``bzr help patterns`` を参照。
 
2402
 
 
2403
  無視リストからパターンを除外するには、.bzrignoreファイルを編集します。
 
2404
  追加した後で、コマンドを使用して間接的に、もしくはエディタを使用して
 
2405
  直接そのファイルを編集もしくは削除した後で、そのコミットを確認してください。
 
2406
 
 
2407
  注: シェルのワイルドカードを含む無視パターンはUnixのシェルからクォートされなければなりません。
 
2408
 
 
2409
:例:
 
2410
    トップレベルのMakefileを無視する::
 
2411
 
 
2412
        bzr ignore ./Makefile
 
2413
 
 
2414
    すべてのディレクトリのクラスファイルを無視する::
 
2415
 
 
2416
        bzr ignore "*.class"
 
2417
 
 
2418
    libディレクトリ下の.oファイルを無視する::
 
2419
 
 
2420
        bzr ignore "lib/**/*.o"
 
2421
 
 
2422
    libディレクトリ下の.oファイルを無視する::
 
2423
 
 
2424
        bzr ignore "RE:lib/.*\.o"
 
2425
 
 
2426
    "debian"トップレベルディレクトリ以外のすべてを無視する::
 
2427
 
 
2428
        bzr ignore "RE:(?!debian/).*"
 
2429
 
 
2430
:関連コマンド: `ignored`_, `パターン`_, `status`_
 
2431
 
 
2432
 
 
2433
ignored
 
2434
=======
 
2435
:目的: 無視するファイルとそれらにマッチするパターンの一覧を表示する。
 
2436
:使い方:   bzr ignored
 
2437
 
 
2438
:オプション:
 
2439
  -v, --verbose  詳細な情報を表示する。
 
2440
  -q, --quiet    エラーと警告だけ表示する。
 
2441
  -h, --help     ヘルプメッセージを表示する。
 
2442
 
 
2443
:説明:
 
2444
  無視されるファイルと無視パターンのすべての一覧を表示します。
 
2445
 
 
2446
  代わりにファイルの一覧だけを表示するには::
 
2447
 
 
2448
      bzr ls --ignored
 
2449
 
 
2450
:関連コマンド: `ignore`_, `ls`_
 
2451
 
 
2452
 
 
2453
info
 
2454
====
 
2455
:目的: 作業ツリー、ブランチもしくはリポジトリに関する情報を表示する。
 
2456
:使い方:   bzr info [LOCATION]
 
2457
 
 
2458
:オプション:
 
2459
  -v, --verbose  詳細な情報を表示する。
 
2460
  -q, --quiet    エラーと警告だけ表示する。
 
2461
  -h, --help     ヘルプメッセージを表示する。
 
2462
 
 
2463
:説明:
 
2464
  このコマンドはツリー、ブランチもしくはリポジトリに関連する既知の位置とフォーマットのすべてを表示します。
 
2465
  統計情報はそれぞれのレポートに含まれます。
 
2466
 
 
2467
  ブランチと作業ツリーは見つからないリビジョンもレポートします。
 
2468
 
 
2469
:関連項目: `リポジトリ`_, `revno`_, `作業ツリー`_
 
2470
 
 
2471
 
 
2472
init
 
2473
====
 
2474
:目的: ディレクトリをバージョン管理下にあるブランチにする。
 
2475
:使い方:   bzr init [LOCATION]
 
2476
 
 
2477
:オプション:
 
2478
  -v, --verbose         詳細な情報を表示する。
 
2479
  --create-prefix       ブランチに通じるパスがまだ存在していなければそれを作成する。
 
2480
  --append-revisions-only
 
2481
                        revnosもしくは既存のログを変更しない。
 
2482
                        リビジョンを追加するのみ。
 
2483
  -q, --quiet           エラーと警告のみを表示する。
 
2484
  -h, --help            ヘルプメッセージを表示する。
 
2485
 
 
2486
  ブランチのフォーマット::
 
2487
 
 
2488
    --format=ARG        このブランチのフォーマットを指定する。"help formats"を参照。
 
2489
    --1.12-preview      ビューとコンテンツのフィルタリングをサポートする作業ツリーフォーマット。
 
2490
    --1.12-preview-rich-root
 
2491
                        rich-rootデータをサポートする1.12-previewのバリアント(bzr-svnに必要)
 
2492
    --1.6               スタックをサポートするリポジトリに基づいたブランチとパック。
 
2493
    --1.6.1-rich-root   スタックとリッチなrootデータをサポートするリポジトリに基づいた
 
2494
                        ブランチとパック(bzr-svnに必要)。
 
2495
    --1.9               btreeインデックスを使用するリポジトリに基づいたブランチとパック
 
2496
    --1.9-rich-root     btreeインデックスとリッチrootデータを使用する
 
2497
                        リポジトリに基づいたブランチとパック(bzr-svnに必要)。
 
2498
    --default           0.92の新しい機能: dirstate-tagsフォーマットリポジトリと
 
2499
                        互換性のあるデータを持つパックベースのフォーマット。
 
2500
                        0.92以前のbzrリポジトリと相互運用しますが
 
2501
                        bzr < 0.92では読むことができません。
 
2502
                        以前はknitpack-experimentalと呼ばれていました。
 
2503
                        詳細な情報は http://doc.bazaar-vcs.org/latest/developers/packrepo.html を参照。
 
2504
    --development       現在の開発フォーマット。データをpack-0.92 (とpack-0.92と互換性のある)
 
2505
                        フォーマットリポジトリに変換できる。
 
2506
                        このフォーマットのリポジトリとブランチはbzr.devによってのみ読み込みできます。
 
2507
                        使用する前に http://doc.bazaar-vcs.org/latest/developers/development-repo.html を参照して頂くようお願いします。
 
2508
    --development-subtree
 
2509
                        現在の開発フォーマットで、subtreeバリアント。
 
2510
                        データをpack-0.92-subtree(とpack-0.92-subtreeと互換性のある)
 
2511
                        フォーマットリポジトリに変換できる。
 
2512
                        このフォーマットのリポジトリとブランチはbzr.devでのみ読み込みできる。
 
2513
                        使用する前に http://doc.bazaar-vcs.org/latest/developers/development-
 
2514
                        repo.html をご覧いただくようお願いします。
 
2515
    --dirstate          0.15の新しいフォーマット: 速いローカルオペレーション。
 
2516
                        ネットワークを通したアクセスのときbzr 0.8とそれ以降と互換性がある。
 
2517
    --dirstate-tags     0.15の新しいフォーマット: 速いローカルオペレーションで
 
2518
                        ネットワークオペレーションに関するスケーリングを改善。
 
2519
                        タグのサポートを追加。bzr < 0.15とは互換性がない。
 
2520
    --knit              knitsを使用するフォーマット。bzr <= 0.14との相互運用に推奨。
 
2521
    --metaweave         0.8での暫定フォーマット。knitよりも遅い。
 
2522
    --pack-0.92         0.92の新しいフォーマット: dirstate-tagsフォーマットリポジトリと
 
2523
                        互換性のあるデータを持つパックベースのフォーマット。
 
2524
                        0.92以前のbzrリポジトリと相互運用できるがbzr < 0.92.によって読み込みできない。
 
2525
                        以前はknitpack-experimentalと呼ばれていた。
 
2526
                        詳細な情報に関しては、 http://doc
 
2527
                        .bazaar-vcs.org/latest/developers/packrepo.html を参照。
 
2528
    --rich-root         1.0の新しいフォーマット。ツリーrootのベターな扱い。
 
2529
                        bzr < 1.0と互換性がない。
 
2530
    --rich-root-pack    1.0の新しいフォーマット: rich-rootデータをサポートする
 
2531
                        pack-0.92のバリアント(bzr-svnに必要)。
 
2532
    --weave             0.8以前のフォーマット。knitよりも遅く
 
2533
                        チェックアウトもしくは共用リポジトリをサポートしない。
 
2534
 
 
2535
:説明:
 
2536
  空のブランチを作成するもしくは既存のプロジェクトをインポートする前に使用します。
 
2537
 
 
2538
  親ディレクトリの位置にリポジトリが存在する場合、
 
2539
  ブランチの履歴はリポジトリに保存されます。
 
2540
  さもなければinitは.bzrのディレクトリに独自の履歴を運ぶスタンドアロンのブランチを作成します。
 
2541
 
 
2542
  ロケーションにブランチがすでにあるが作業ツリーがない場合、ツリーは'bzr checkout'で投入できます。
 
2543
 
 
2544
  ファイルのツリーをインポートする方法のレシピです::
 
2545
 
 
2546
      cd ~/project
 
2547
      bzr init
 
2548
      bzr add .
 
2549
      bzr status
 
2550
      bzr commit -m "imported project"
 
2551
 
 
2552
:関連コマンド: `branch`_, `checkout`_, `init-repository`_
 
2553
 
 
2554
 
 
2555
init-repository
 
2556
===============
 
2557
:目的: ブランチを保持する共用リポジトリを作成する。
 
2558
:使い方:   bzr init-repository LOCATION
 
2559
 
 
2560
:オプション:
 
2561
  --no-trees            リポジトリのブランチはデフォルトで作業ツリーを持ちません。
 
2562
  -v, --verbose         詳細な情報を表示する。
 
2563
  -q, --quiet           エラーと警告のみを表示する。
 
2564
  -h, --help            ヘルプメッセージを表示する。
 
2565
 
 
2566
  ブランチのフォーマット::
 
2567
 
 
2568
    --format=ARG        このブランチのフォーマットを指定する。"help formats"を参照。
 
2569
    --1.12-preview      ビューとコンテンツのフィルタリングをサポートする作業ツリーフォーマット。
 
2570
    --1.12-preview-rich-root
 
2571
                        rich-rootデータをサポートする1.12-previewのバリアント(bzr-svnに必要)
 
2572
    --1.6               スタックをサポートするリポジトリに基づいたブランチとパック。
 
2573
    --1.6.1-rich-root   スタックとリッチなrootデータをサポートするリポジトリに基づいた
 
2574
                        ブランチとパック(bzr-svnに必要)。
 
2575
    --1.9               btreeインデックスを使用するリポジトリに基づいたブランチとパック
 
2576
    --1.9-rich-root     btreeインデックスとリッチrootデータを使用する
 
2577
                        リポジトリに基づいたブランチとパック(bzr-svnに必要)。
 
2578
    --default           0.92の新しい機能: dirstate-tagsフォーマットリポジトリと
 
2579
                        互換性のあるデータを持つパックベースのフォーマット。
 
2580
                        0.92以前のbzrリポジトリと相互運用しますが
 
2581
                        bzr < 0.92では読むことができません。
 
2582
                        以前はknitpack-experimentalと呼ばれていました。
 
2583
                        詳細な情報は http://doc.bazaar-vcs.org/latest/developers/packrepo.html を参照。
 
2584
    --development       現在の開発フォーマット。データをpack-0.92 (とpack-0.92と互換性のある)
 
2585
                        フォーマットリポジトリに変換できる。
 
2586
                        このフォーマットのリポジトリとブランチはbzr.devによってのみ読み込みできます。
 
2587
                        使用する前に http://doc.bazaar-vcs.org/latest/developers/development-repo.html を参照して頂くようお願いします。
 
2588
    --development-subtree
 
2589
                        現在の開発フォーマットで、subtreeバリアント。
 
2590
                        データをpack-0.92-subtree(とpack-0.92-subtreeと互換性のある)
 
2591
                        フォーマットリポジトリに変換できる。
 
2592
                        このフォーマットのリポジトリとブランチはbzr.devでのみ読み込みできる。
 
2593
                        使用する前に http://doc.bazaar-vcs.org/latest/developers/development-
 
2594
                        repo.html をご覧いただくようお願いします。
 
2595
    --dirstate          0.15の新しいフォーマット: 速いローカルオペレーション。
 
2596
                        ネットワークを通したアクセスのときbzr 0.8とそれ以降と互換性がある。
 
2597
    --dirstate-tags     0.15の新しいフォーマット: 速いローカルオペレーションで
 
2598
                        ネットワークオペレーションに関するスケーリングを改善。
 
2599
                        タグのサポートを追加。bzr < 0.15とは互換性がない。
 
2600
    --knit              knitsを使用するフォーマット。bzr <= 0.14との相互運用に推奨。
 
2601
    --metaweave         0.8での暫定フォーマット。knitよりも遅い。
 
2602
    --pack-0.92         0.92の新しいフォーマット: dirstate-tagsフォーマットリポジトリと
 
2603
                        互換性のあるデータを持つパックベースのフォーマット。
 
2604
                        0.92以前のbzrリポジトリと相互運用できるがbzr < 0.92.によって読み込みできない。
 
2605
                        以前はknitpack-experimentalと呼ばれていた。
 
2606
                        詳細な情報に関しては、 http://doc
 
2607
                        .bazaar-vcs.org/latest/developers/packrepo.html を参照。
 
2608
    --rich-root         1.0の新しいフォーマット。ツリーrootのベターな扱い。
 
2609
                        bzr < 1.0と互換性がない。
 
2610
    --rich-root-pack    1.0の新しいフォーマット: rich-rootデータをサポートする
 
2611
                        pack-0.92のバリアント(bzr-svnに必要)。
 
2612
    --weave             0.8以前のフォーマット。knitよりも遅く
 
2613
                        チェックアウトもしくは共用リポジトリをサポートしない。
 
2614
 
 
2615
:説明:
 
2616
  ブランチのディレクトリではなく、リポジトリにリビジョンを保存する
 
2617
  リポジトリディレクトリの元で作成された新しいブランチ。
 
2618
 
 
2619
  --no-treesオプションが使用されるとリポジトリのブランチはデフォルトで作業ツリーを持ちません。
 
2620
 
 
2621
:例:
 
2622
    ブランチだけを保有する共用リポジトリを作成する::
 
2623
 
 
2624
        bzr init-repo --no-trees repo
 
2625
        bzr init repo/trunk
 
2626
 
 
2627
    軽量チェックアウトを作成する::
 
2628
 
 
2629
        bzr checkout --lightweight repo/trunk trunk-checkout
 
2630
        cd trunk-checkout
 
2631
        (add files here)
 
2632
 
 
2633
:エイリアス:  init-repo
 
2634
:関連項目: `branch`_, `checkout`_, `init`_, `リポジトリ`_
 
2635
 
 
2636
 
 
2637
log
 
2638
===
 
2639
:目的: ブランチ、ファイル、もしくはディレクトリのログを表示する。
 
2640
:使い方:   bzr log [LOCATION]
 
2641
 
 
2642
:オプション:
 
2643
  -v, --verbose         それぞれのリビジョンで変更されたファイルを表示する。
 
2644
  -q, --quiet           エラーと警告のみを表示する。
 
2645
  -l N, --limit=N       出力を最初のNのリビジョンに制限する。
 
2646
  --forward             最古から最新までを表示する。
 
2647
  --timezone=ARG        ローカル、オリジナル、utcのタイムゾーンを表示する。
 
2648
  --show-ids            内部オブジェクトidを表示する。
 
2649
  -r ARG, --revision=ARG
 
2650
                        詳細は"help revisionspec"を参照。
 
2651
  -m ARG, --message=ARG
 
2652
                        メッセージが正規表現にマッチするリビジョンを表示する。
 
2653
  -c ARG, --change=ARG  指定されたリビジョンだけを表示する。"help revisionspec"も参照。
 
2654
  -h, --help            ヘルプメッセージを表示する。
 
2655
 
 
2656
  ログのフォーマット::
 
2657
    --log-format=ARG    指定されたログフォーマットを使用する。
 
2658
    --line              リビジョン単位の1行のログフォーマット
 
2659
    --long              詳細なログフォーマット
 
2660
    --short             適切に短いログフォーマット
 
2661
 
 
2662
:説明:
 
2663
  デフォルトでは作業ディレクトリを含むブランチのログを表示する。
 
2664
 
 
2665
  ログの範囲をリクエストするには、-r begin..endコマンドを使用できます。
 
2666
  -r revisionは指定したリビジョンをリクエストし、
 
2667
  -r ..end もしくは -r begin.. も有効です。
 
2668
 
 
2669
:例:
 
2670
    現在のブランチのログ::
 
2671
 
 
2672
        bzr log
 
2673
 
 
2674
    ファイルのログ::
 
2675
 
 
2676
        bzr log foo.c
 
2677
 
 
2678
    ブランチの最後の10リビジョンのログ::
 
2679
 
 
2680
        bzr log -r -10.. http://server/branch
 
2681
 
 
2682
 
 
2683
 
 
2684
ls
 
2685
==
 
2686
:目的: ツリーのファイルの一覧を表示する。
 
2687
:使い方:   bzr ls [PATH]
 
2688
 
 
2689
:オプション:
 
2690
  --from-root           ブランチのrootから相対的なパスを出力する。
 
2691
  --ignored             無視されたファイルを出力する。
 
2692
  --kind=ARG            特定の種類:file、directory、symlinkのエントリの一覧を表示する。
 
2693
  -v, --verbose         詳細な情報を表示する。
 
2694
  -V, --versioned       バージョン管理されたファイルを出力する。
 
2695
  --unknown             未知のファイルを出力する。
 
2696
  -h, --help            ヘルプメッセージを表示する。
 
2697
  -q, --quiet           エラーと警告のみを表示する。
 
2698
  --non-recursive       サブディレクトリで再帰的処理を行わない。
 
2699
  --show-ids            内部オブジェクトidを表示する。
 
2700
  --null                ファイルの間に改行の代わりに NUL (\0) 区切り文字を書く。
 
2701
  -r ARG, --revision=ARG
 
2702
                        詳細は"help revisionspec"を参照。
 
2703
 
 
2704
:関連項目: `cat`_, `status`_
 
2705
 
 
2706
 
 
2707
merge
 
2708
=====
 
2709
:目的: 三方向マージを実行する。
 
2710
:使い方:   bzr merge [LOCATION]
 
2711
 
 
2712
:オプション:
 
2713
  --pull                すでに対象が完全にソースにマージされる場合、
 
2714
                        マージよりもソースからpullする。
 
2715
                        これが起きるとき、結果をコミットする必要はない。
 
2716
  --remember            指定されたロケーションをデフォルトとして記録する。
 
2717
  --force               目的のツリーがコミットされていない変更を持っていてもマージする。
 
2718
  -v, --verbose         詳細な情報を表示する。
 
2719
  --reprocess           誤った衝突を減らすために再処理する。
 
2720
  -h, --help            ヘルプメッセージを表示する。
 
2721
  -q, --quiet           エラーと警告のみを表示する。
 
2722
  --uncommitted         ブランチの変更の代わりに、作業ツリーからコミットされていない変更を適用する。
 
2723
 
 
2724
  -d ARG, --directory=ARG
 
2725
                        作業ディレクトリを含むものよりも、マージするブランチ。
 
2726
  --show-base           衝突のベースリビジョンテキストを表示する。
 
2727
  --preview             マージする代わりに、マージの差分を表示する。
 
2728
  -c ARG, --change=ARG  指定されたリビジョンで導入された変更を選択する。
 
2729
                        "help revisionspec"も参照。
 
2730
  -r ARG, --revision=ARG
 
2731
                        詳細は"help revisionspec"を参照。
 
2732
 
 
2733
  マージアルゴリズム::
 
2734
    --merge-type=ARG    特定のマージアルゴリズムを選択する。
 
2735
    --diff3             外部diff3を使用するマージ
 
2736
    --lca               新しいLCAマージ
 
2737
    --merge3            ネイティブのdiff3スタイルのマージ
 
2738
    --weave             weaveベースのマージ
 
2739
 
 
2740
:説明:
 
2741
  マージのソースはブランチの形式、もしくはbzr sendで生成された
 
2742
  mergeディレクティブを含むファイルへのパスの形式で指定できます。
 
2743
  どちらも指定されなければ、デフォルトは上流ブランチもしくは
 
2744
  --rememberを使用して最近マージされたブランチです。
 
2745
 
 
2746
  マージをブランチするとき、デフォルトではチップがマージされます。
 
2747
  異なるリビジョンをピックするには、--revisionを渡します。
 
2748
  2つの値を指定する場合、最初の値はBASEとして、2番目の値はOTHERとして使用されます。
 
2749
  個別のリビジョン、もしくはこのように利用可能なリビジョンのサブセットをマージすることは
 
2750
  一般的に"チェリーピック"として言及されます。
 
2751
 
 
2752
  リビジョン番号はマージされるブランチに対して常に相対的です。
 
2753
 
 
2754
  デフォルトでは、bzrは、自動的に適切なベースを検出して、
 
2755
  他のブランチからすべてのネットワークでマージしようとします。
 
2756
  これが失敗すると、明示的なベースを渡すことが必要になることがあります。
 
2757
 
 
2758
  マージは2つのブランチの変更を結合するために最善を尽くしますが、
 
2759
  人間だけが修正できる種類の問題があります。
 
2760
  この問題に遭遇するとき、衝突マークがつけられます。
 
2761
  衝突はコミットする前に何かを修正する必要があることを意味します。
 
2762
 
 
2763
  問題を修正したらbzr resolveを使用します。bzr conflictsも参照してください。
 
2764
 
 
2765
  デフォルトのブランチセットが存在しない場合、最初のマージはそれを設定します。
 
2766
  その後で、デフォルトを使用するブランチを省略できます。
 
2767
  デフォルトを変更するには、--rememberを使用します。
 
2768
  リモートロケーションがアクセス可能場合のみ値は保存されます。
 
2769
 
 
2770
  マージの結果は目的の作業ディレクトリに設置されます。
 
2771
  このディレクトリは(bzr diffで)閲覧、テスト、
 
2772
  とマージの結果を記録するためにコミット可能です。
 
2773
 
 
2774
  --forceが渡されない限り、コミットされていない変更が存在すればマージの実行は拒否されます。
 
2775
 
 
2776
:例:
 
2777
    bzr.devから最新のリビジョンをマージするには::
 
2778
 
 
2779
        bzr merge ../bzr.dev
 
2780
 
 
2781
    bzr.devからリビジョン82を含めて変更をマージするには::
 
2782
 
 
2783
        bzr merge -r 82 ../bzr.dev
 
2784
 
 
2785
    以前の変更なしに、82で導入された変更をマージするには::
 
2786
 
 
2787
        bzr merge -r 81..82 ../bzr.dev
 
2788
 
 
2789
    /tmp/mergeに含まれるmergeディレクトリを適用するには:
 
2790
 
 
2791
        bzr merge /tmp/merge
 
2792
 
 
2793
:関連項目: `remerge`_, `status-flags`_, `update`_
 
2794
 
 
2795
 
 
2796
missing
 
2797
=======
 
2798
:目的: 2つのブランチの間のmergeされていない/pullされていない リビジョンを表示する。
 
2799
:使い方:   bzr missing [OTHER_BRANCH]
 
2800
 
 
2801
:オプション:
 
2802
  --reverse            リビジョンの順序をリバースする。
 
2803
  --this               --mine-onlyと同じ。
 
2804
  -h, --help           ヘルプメッセージを表示する。
 
2805
  -q, --quiet          エラーと警告だけ表示する。
 
2806
  --other              --theirs-onlyと同じ。
 
2807
  --include-merges     マージされたリビジョンを表示する。
 
2808
  --mine-only          ローカルブランチの変更のみを表示する。
 
2809
  --show-ids           内部オブジェクトidを表示する。
 
2810
  --theirs-only        リモートブランチの変更のみを表示する。
 
2811
  -v, --verbose        詳細な情報を表示する。
 
2812
 
 
2813
  ログフォーマット::
 
2814
    --log-format=ARG   指定したログフォーマットを使用する。
 
2815
    --line             リビジョンごとの1行のログフォーマット
 
2816
    --long             詳細なログフォーマット
 
2817
    --short            適切に短いログフォーマット
 
2818
 
 
2819
:説明:
 
2820
  OTHER_BRANCHはlocalもしくはremoteになります。
 
2821
 
 
2822
:関連項目: `merge`_, `pull`_
 
2823
 
 
2824
 
 
2825
mkdir
 
2826
=====
 
2827
:目的: バージョン管理下にある新しいディレクトリを作成する。
 
2828
:使い方:   bzr mkdir DIR...
 
2829
 
 
2830
:オプション:
 
2831
  -v, --verbose  詳細な情報を表示する。
 
2832
  -q, --quiet    エラーと警告だけ表示する。
 
2833
  -h, --help     ヘルプメッセージを表示する。
 
2834
 
 
2835
:説明:
 
2836
  これはディレクトリの作成と追加と同等です。
 
2837
 
 
2838
 
 
2839
 
 
2840
mv
 
2841
==
 
2842
:目的: ファイルを移動もしくはリネームする。
 
2843
:使い方:
 
2844
    bzr mv OLDNAME NEWNAME
 
2845
 
 
2846
    bzr mv SOURCE... DESTINATION
 
2847
 
 
2848
 
 
2849
:オプション:
 
2850
  --after        ファイルがすでに移動しているので、ファイルのbzr識別子のみを移動させる。
 
2851
  -v, --verbose  詳細な情報を表示する。
 
2852
  -q, --quiet    エラーと警告だけ表示する。
 
2853
  -h, --help     ヘルプメッセージを表示する。
 
2854
 
 
2855
:説明:
 
2856
  最後の引数がバージョン管理されているディレクトリの場合、
 
2857
  他のすべての名前はそこに移動します。
 
2858
  さもなければ、2つの引数だけにしなければならず
 
2859
  ファイルは新しい名前に変更されます。
 
2860
 
 
2861
  OLDNAMEがファイルシステム上に存在しないがバージョン管理されていて
 
2862
  NEWNAMEはファイルシステム上に存在せずバージョン管理もされていない場合、
 
2863
  mvはファイルが手動で移動させられその変更を反映するために
 
2864
  内部インベントリだけを更新することを想定します。
 
2865
  多くのSOURCEファイルをDESTINATIONに移動させるときも同じです。
 
2866
 
 
2867
  ブランチの間でファイルを移動させることはできません。
 
2868
 
 
2869
:エイリアス:  move, rename
 
2870
 
 
2871
 
 
2872
nick
 
2873
====
 
2874
:目的: ブランチのニックネームを表示もしくは設定する。
 
2875
:使い方:   bzr nick [NICKNAME]
 
2876
 
 
2877
:オプション:
 
2878
  -v, --verbose  詳細な情報を表示する。
 
2879
  -q, --quiet    エラーと警告だけ表示する。
 
2880
  -h, --help     ヘルプメッセージを表示する。
 
2881
 
 
2882
:説明:
 
2883
  設定が解除されると、ツリーのrootディレクトリの名前がニックネームとして使用されます。
 
2884
  現在のニックネームを表示するには、引数なしで実行します。
 
2885
 
 
2886
  ローカルに設定されていない限りバインドされたブランチはマスターブランチのニックネームを使用します。
 
2887
 
 
2888
:関連コマンド: `info`_
 
2889
 
 
2890
 
 
2891
pack
 
2892
====
 
2893
:目的: リポジトリ内のデータを圧縮する。
 
2894
:使い方:   bzr pack [BRANCH_OR_REPO]
 
2895
 
 
2896
:オプション:
 
2897
  -v, --verbose  詳細な情報を表示する。
 
2898
  -q, --quiet    エラーと警告だけ表示する。
 
2899
  -h, --help     ヘルプメッセージを表示する。
 
2900
 
 
2901
:関連コマンド: `リポジトリ`_
 
2902
 
 
2903
 
 
2904
plugins
 
2905
=======
 
2906
:目的: インストールされたプラグインの一覧を表示する。
 
2907
:使い方:   bzr plugins
 
2908
 
 
2909
:オプション:
 
2910
  -v, --verbose  詳細な情報を表示する。
 
2911
  -q, --quiet    エラーと警告だけ表示する。
 
2912
  -h, --help     ヘルプメッセージを表示する。
 
2913
 
 
2914
:説明:
 
2915
  このコマンドはプラグインのバージョンとそれぞれの手短な説明を含めて
 
2916
  インストールされたプラグインの一覧を表示します
 
2917
 
 
2918
  --verboseはそれぞれのプラグインが設置されたパスを表示します。
 
2919
 
 
2920
  プラグインはコードを追加したり置き換えたりすることで
 
2921
  リビジョン管理システムを拡張する外部コンポーネントです。
 
2922
  コマンドの上書き、新しいコマンドの追加、追加のネットワーク転送の提供や
 
2923
  ログ出力のカスタマイズなどを含めて
 
2924
  プラグインはさまざまなことを行うことができます。
 
2925
 
 
2926
  プラグインを見つけてインストール方法を含めた詳細な情報に関しては、
 
2927
  Bazaarのウェブサイト、http://bazaar-vcs.org を参照してください。
 
2928
  プログラミング言語のPyhonを利用して
 
2929
  新しいコマンドを作成する方法に関する手引きもあります。
 
2930
 
 
2931
 
 
2932
 
 
2933
pull
 
2934
====
 
2935
:目的: このブランチを別のブランチのミラーにする。
 
2936
:使い方:   bzr pull [LOCATION]
 
2937
 
 
2938
:オプション:
 
2939
  -v, --verbose         pullされたリビジョン用のログを表示する。
 
2940
  --remember            デフォルトとして指定されたロケーションを記録する。
 
2941
  -h, --help            ヘルプメッセージを表示する。
 
2942
  -q, --quiet           エラーと警告のみを表示する。
 
2943
  -d ARG, --directory=ARG
 
2944
                        作業ディレクトリを含むものよりもpullするブランチ。
 
2945
  --overwrite           ブランチの間の違いを無視して無条件で上書きする。
 
2946
  -r ARG, --revision=ARG
 
2947
                        詳細は"help revisionspec"を参照。
 
2948
 
 
2949
:説明:
 
2950
  このコマンドは分岐されていないブランチのみで動作します。
 
2951
  目的のブランチの最新の変更コミットが親にマージされなかった場合(直接もしくは間接)、
 
2952
  ブランチは分岐したものとして見なされます。
 
2953
 
 
2954
  ブランチが分岐していれば、あるブランチからの変更を他のブランチに統合するために
 
2955
  'bzr merge'を使用できます。
 
2956
  一旦あるブランチがマージされると、他のブランチは再びそれをpullできるようになります。
 
2957
 
 
2958
  ローカルの変更を忘れてリモートブランチを満たすようにブランチを更新したいだけなら、
 
2959
  pull --overwriteを使用します。
 
2960
 
 
2961
  デフォルトのロケーションが存在しない場合、最初のpullはこれを設定します。
 
2962
  その後で、デフォルトを使用するロケーションを省略できます。
 
2963
  デフォルトを変更するには、--rememberを使用します。
 
2964
  リモートロケーションがアクセスできる場合のみ値は保存されます。
 
2965
 
 
2966
  注: 位置がブランチのフォーマットもしくはbzr sendで生成されたmergeディレクトリを格納する
 
2967
      ファイルへのパスで指定できます。
 
2968
 
 
2969
:関連項目: `push`_, `status-flags`_, `update`_
 
2970
 
 
2971
 
 
2972
push
 
2973
====
 
2974
:目的: このブランチのミラーを更新する。
 
2975
:使い方:   bzr push [LOCATION]
 
2976
 
 
2977
:オプション:
 
2978
  -v, --verbose         詳細な情報を表示する。
 
2979
  --remember            指定された位置をデフォルトとして覚える。
 
2980
  --create-prefix       まだ存在しなればブランチへのパスを作成する。
 
2981
  -h, --help            ヘルプメッセージを表示する。
 
2982
  -q, --quiet           エラーと警告のみを表示する。
 
2983
  --stacked-on=ARG      コミットの履歴に関して別のブランチを参照するスタックドブランチを作成する。
 
2984
                        参照されるブランチに存在しない作業内容は作成されたブランチに格納される。
 
2985
  --use-existing-dir    デフォルトでは、ターゲットのディレクトリが存在するが
 
2986
                        まだコントロールディレクトリを持たない場合pushは失敗する。
 
2987
                        このフラグはpushの続行を可能にする。
 
2988
  -d ARG, --directory=ARG
 
2989
                        作業ディレクトリを含むブランチよりも、pushするブランチ
 
2990
  --stacked             親ブランチの公開位置を参照するスタックドブランチを作成する。
 
2991
  --overwrite           ブランチ間の違いを無視して無条件に上書きする。
 
2992
  -r ARG, --revision=ARG
 
2993
                        詳細は"help revisionspec"を参照。
 
2994
 
 
2995
:説明:
 
2996
  これは割高でリモートファイルシステムではサポートされないので、
 
2997
  ターゲットブランチは投入された作業ツリーを持ちません。
 
2998
 
 
2999
  スマートサーバーもしくはプロトコルの中には将来作業ツリーを導入しないものがあります。
 
3000
 
 
3001
  このコマンドは分岐されていないブランチでのみ動作します。
 
3002
  目的のブランチの最新のコミットがソースブランチによって(直接もしくは間接的に)マージされなければ
 
3003
  ブランチは分岐されたものとして見なされます。
 
3004
 
 
3005
  ブランチが分岐されると、他のブランチを完全に置き換えるために
 
3006
  'bzr push --overwrite'を使用できます。この場合、マージされていない変更は廃棄されます。
 
3007
 
 
3008
  他のブランチに異なる変更があることを保証したい場合は、
 
3009
  他のブランチからマージを行い(bzr help mergeを参照)、それをコミットします。
 
3010
  その後で'--overwrite'なしでpushを行うことができるようになります。
 
3011
 
 
3012
  デフォルトのpush位置の設定がなければ、最初のpushはこれを設定します。
 
3013
  その後では、デフォルトを省略できます。
 
3014
  デフォルトを変更するには、--rememberを使用します。
 
3015
  リモート位置がアクセスできる場合のみ値は保存されます。
 
3016
 
 
3017
:関連項目: `pull`_, `update`_, `working-trees`_
 
3018
 
 
3019
 
 
3020
reconcile
 
3021
=========
 
3022
:目的: ブランチのメタデータを調整する。
 
3023
:使い方:   bzr reconcile [BRANCH]
 
3024
 
 
3025
:オプション:
 
3026
  -v, --verbose  詳細な情報を表示する。
 
3027
  -q, --quiet    エラーと警告だけ表示する。
 
3028
  -h, --help     ヘルプメッセージを表示する。
 
3029
 
 
3030
:説明:
 
3031
  これは以前の実在しないオペレーションもしくはbzrの更新によって
 
3032
  引き起こされるデータのミスマッチを訂正できます。
 
3033
  'bzr check'もしくはbzrの開発者がそのコマンドを実行するようにアドバイスするのであれば、
 
3034
  このコマンドを実行することだけが必要になります。
 
3035
 
 
3036
  2番目のブランチが提供されると、
 
3037
  ブランチをまたがる調整も行われます。これによってbzrの初期のバージョンでは存在しなかった
 
3038
  ツリーのroot idのようなデータがチェックされ、両方のブランチで正しく表示されます。
 
3039
 
 
3040
  同時にデータが再圧縮されるのでディスクスペースの節約やパフォーマンスのゲインにつながります。
 
3041
 
 
3042
  ブランチはローカルディスクもしくはsftpのようにリスト可能なシステム上になければなりません。
 
3043
 
 
3044
:関連項目: `check`_
 
3045
 
 
3046
 
 
3047
reconfigure
 
3048
===========
 
3049
:目的: bzrディレクトリのタイプを再設定する。
 
3050
:使い方:   bzr reconfigure [LOCATION]
 
3051
 
 
3052
:オプション:
 
3053
  --force               ローカルの変更が失われていた場合でも再設定を実行する。
 
3054
  -v, --verbose         詳細な情報を表示する。
 
3055
  -q, --quiet           エラーと警告のみを表示する。
 
3056
  --bind-to=ARG         チェックアウトをバインドするブランチ。
 
3057
  -h, --help            ヘルプメッセージを表示する。
 
3058
 
 
3059
  Target type:
 
3060
    --branch            作業ツリーを持たないバインドされていないブランチに再設定する。
 
3061
    --checkout          作業ツリーを持つバインドされたブランチに再設定する。
 
3062
    --lightweight-checkout
 
3063
                        軽量チェックアウトに再設定する(ローカルの履歴はなし)。
 
3064
    --standalone        スタンドアロンブランチに再設定する(すなわち共用リポジトリの使用を停止する)。
 
3065
    --tree              作業ツリーを持つバインドされていないブランチに再設定する。
 
3066
    --use-shared        共用リポジトリを使用するように再設定する。
 
3067
 
 
3068
:説明:
 
3069
  ターゲットの設定を指定しなければなりません。
 
3070
 
 
3071
  チェックアウトに関しては指定されていなければ、bind-toのロケーションは自動検出されます。
 
3072
  優先順位は
 
3073
  1. 軽量チェックアウトに関しては、現在バインドされているロケーション。
 
3074
  2. チェックアウトに使用されるブランチに関しては、以前バインドされたロケーション。
 
3075
  3. pushのロケーション。
 
3076
  4. 親のロケーション。
 
3077
  これらが利用できなければ、--bind-toを指定しなければなりません。
 
3078
 
 
3079
:関連項目: `ブランチ`_, `チェックアウト`_, `スタンドアロンのツリー`_, `作業ツリー`_
 
3080
 
 
3081
 
 
3082
remerge
 
3083
=======
 
3084
:目的: マージを再び行う。
 
3085
:使い方:   bzr remerge [FILE...]
 
3086
 
 
3087
:オプション:
 
3088
  -v, --verbose       詳細な情報を表示する。
 
3089
  --reprocess         誤った衝突を減らすために再処理する。
 
3090
  -q, --quiet         エラーと警告のみ表示する。
 
3091
  --show-base         衝突内のベースリビジョンのテキストを表示する。
 
3092
  -h, --help          ヘルプメッセージを表示する。
 
3093
 
 
3094
  マージアルゴリズム:
 
3095
    --merge-type=ARG  特定のマージアルゴリズムを指定する。
 
3096
    --diff3           外部diff3を使用するマージ
 
3097
    --lca             新しいLCAマージ
 
3098
    --merge3          ネイティブのdiff3スタイルのマージ
 
3099
    --weave           weaveベースのマージ
 
3100
 
 
3101
:説明:
 
3102
  衝突を解消している間に異なるマージテクニックを試したい場合はこれを使用します。
 
3103
  マージテクニックの中には他のものよりもすぐれたものがあり、
 
3104
  remergeによって異なるファイルで異なるテクニックを試すことができます。
 
3105
  remergeのオプションはmergeのものと同じ意味とデフォルトを持ちます。
 
3106
  違いは未解決のマージが存在するときのみremergeは実行できて
 
3107
  特定のファイルを指定できることです。
 
3108
 
 
3109
:例:
 
3110
    すべてのファイルのマージを再実行し、通常のTHISとOTHERテキストに加えて、
 
3111
    衝突領域のベーステキストを表示する::
 
3112
 
 
3113
        bzr remerge --show-base
 
3114
 
 
3115
    weaveマージアルゴリズムを使用して"foobar"のマージを再実行して、
 
3116
    衝突領域のサイズを減らすために追加処理を行う::
 
3117
 
 
3118
        bzr remerge --merge-type weave --reprocess foobar
 
3119
 
 
3120
 
 
3121
 
 
3122
remove
 
3123
======
 
3124
:目的: ファイルもしくはディレクトリを除外する。
 
3125
:使い方:   bzr remove [FILE...]
 
3126
 
 
3127
:オプション:
 
3128
  --new         けっしてコミットされなかったファイルのみを除外する。
 
3129
  -v, --verbose  詳細な情報を表示する。
 
3130
  -q, --quiet    エラーと警告だけ表示する。
 
3131
  -h, --help     ヘルプメッセージを表示する。
 
3132
 
 
3133
  削除戦略:
 
3134
    --force      指定されたファイルがリカバーできないまたは空のディレクトリではなくても
 
3135
                 これらすべてを削除する。
 
3136
    --keep       ファイルを削除しない。
 
3137
    --safe       ファイルを安全にリカバーできるのであればファイルを削除することだけ行う(デフォルト)。
 
3138
 
 
3139
:説明:
 
3140
  このコマンドによってbzrは指定されたファイルへの変更の追跡を止めます。
 
3141
  rebertコマンドで容易に復元できるのであればbzrはこれらのファイルを削除します。
 
3142
  オプションもしくはパラメータが与えられなければbzrは追跡されているファイルをスキャンしますが
 
3143
  ツリーの中で見つからなければそれらの追跡を停止します。
 
3144
 
 
3145
:エイリアス:  rm, del
 
3146
 
 
3147
 
 
3148
remove-tree
 
3149
===========
 
3150
:目的: 与えられたブランチ/チェックアウトから作業ツリーを除外する。
 
3151
:使い方:   bzr remove-tree [LOCATION]
 
3152
 
 
3153
:オプション:
 
3154
  --force        コミットされていない変更があっても作業ツリーを除外する。
 
3155
  -v, --verbose  詳細な情報を表示する。
 
3156
  -q, --quiet    エラーと警告だけ表示する。
 
3157
  -h, --help     ヘルプメッセージを表示する。
 
3158
 
 
3159
:説明:
 
3160
  軽量チェックアウトは作業ツリーと大差ないので、これはそれに対する実行を拒絶します。
 
3161
 
 
3162
  作業ツリーを再現するには、"bzr checkout"を使用します。
 
3163
 
 
3164
:関連項目: `checkout`_, `working-trees`_
 
3165
 
 
3166
 
 
3167
renames
 
3168
=======
 
3169
:目的: リネームされたファイルの一覧を表示する。
 
3170
:使い方:   bzr renames [DIR]
 
3171
 
 
3172
:オプション:
 
3173
  -v, --verbose  詳細な情報を表示する。
 
3174
  -q, --quiet    エラーと警告だけ表示する。
 
3175
  -h, --help     ヘルプメッセージを表示する。
 
3176
 
 
3177
:関連項目: `status`_
 
3178
 
 
3179
 
 
3180
resolve
 
3181
=======
 
3182
:目的: 衝突を解消されたものとしてマークする。
 
3183
:使い方:   bzr resolve [FILE...]
 
3184
 
 
3185
:オプション:
 
3186
  --all          このツリーのすべての衝突を解消する。
 
3187
  -v, --verbose  詳細な情報を表示する。
 
3188
  -q, --quiet    エラーと警告だけ表示する。
 
3189
  -h, --help     ヘルプメッセージを表示する。
 
3190
 
 
3191
:説明:
 
3192
  2つのブランチの間の変更を結合するためにマージは最善を尽くしますが、
 
3193
  人間だけが修正できる種類の問題があります。
 
3194
  この問題に遭遇するとき、衝突がマークされます。
 
3195
  衝突はコミットする前に何かを修正する必要があることを意味します。
 
3196
 
 
3197
  一旦問題を修正すれば、自動的にテキストの衝突を修正したものとしてマークするために"bzr resolve"を使用し、
 
3198
  特定の衝突を解消したものとしてマークするためにFILEをresolveします。
 
3199
  すべての衝突が解消されたものとしてマークするにはor "bzr resolve --all"を行います。
 
3200
 
 
3201
:関連コマンド: `bzr conflicts`
 
3202
 
 
3203
:エイリアス:  resolved
 
3204
 
 
3205
 
 
3206
revert
 
3207
======
 
3208
:目的: ファイルを以前のリビジョンに差し戻す。
 
3209
:使い方:   bzr revert [FILE...]
 
3210
 
 
3211
:オプション:
 
3212
  -v, --verbose         詳細な情報を表示する。
 
3213
  -h, --help            ヘルプメッセージを表示する。
 
3214
  -q, --quiet           エラーと警告のみを表示する。
 
3215
  --forget-merges       ファイルを変更せずに、未解決のマージマーカーを取り除く。
 
3216
  --no-backup           差し戻しされたファイルのバックアップを保存しない。
 
3217
  -r ARG, --revision=ARG
 
3218
                        詳細は"help revisionspec"を参照。
 
3219
 
 
3220
:説明:
 
3221
  指定されたテキストだけを差し戻すファイルのリストを渡します。
 
3222
  さもなければ、すべてのファイルが差し戻されます。
 
3223
  '--revision'でリビジョンが指定されなければ、最後にコミットされたリビジョンが使用されます。
 
3224
 
 
3225
  以前のリビジョンに差し戻さずに、いくつかの変更を除外するには、代わりにmergeを使用します。
 
3226
  たとえば、"merge . --revision -2..-3"は-2で導入された変更を除外しますが、
 
3227
  -1で導入された変更には影響を与えません。
 
3228
  hunk-by-hunkベースである変更を除外するには、Shelfプラグインを参照してください。
 
3229
 
 
3230
  デフォルトでは、手動で変更されてきたファイルは最初にバックアップされます。
 
3231
  (マージのみで変更されたファイルはバックアップされません。)
 
3232
  バックアップファイルの名前には '.~#~' が追加されます。#は番号です。
 
3233
 
 
3234
  ファイルを提供する場合、現在のパス名もしくはターゲットリビジョンからのパス名を使用できます。
 
3235
  名前でファイルを"undelete"するためにrevertを使用できます。
 
3236
  ディレクトリに名前をつけると、そのディレクトリのすべての内容が差し戻されます。
 
3237
 
 
3238
  そのリビジョン以降に新しく追加されたファイルは削除されます。適切であればバックアップは維持されます。
 
3239
  未知のファイルを持つディレクトリは削除されません。
 
3240
 
 
3241
  作業ツリーは未解決のマージされたリビジョンのリストを含みます。
 
3242
  これは次のコミットで親として含まれます。
 
3243
  通常は、ファイルを差し戻すのと同様にrevertはそのリストをクリーンにします。
 
3244
  ファイルが指定されていれば、revertは未解決のマージリストをそのままにしてファイルだけを差し戻します。
 
3245
  すべてのファイルを差し戻すがマージの記録を維持するにはツリーのrootで"bzr revert ."を使用し、
 
3246
  ファイルの差し戻しを行わずに未解決のマージリストをクリアするには"bzr revert --forget-merges"を使用します。
 
3247
 
 
3248
:関連項目: `cat`_, `export`_
 
3249
 
 
3250
 
 
3251
revno
 
3252
=====
 
3253
:目的: 現在のリビジョン番号を表示する。
 
3254
:使い方:   bzr revno [LOCATION]
 
3255
 
 
3256
:オプション:
 
3257
  -v, --verbose  詳細な情報を表示する。
 
3258
  -q, --quiet    エラーと警告だけ表示する。
 
3259
  -h, --help     ヘルプメッセージを表示する。
 
3260
 
 
3261
:説明:
 
3262
  これはこのブランチのリビジョン番号と等しいです。
 
3263
 
 
3264
:関連項目: `info`_
 
3265
 
 
3266
 
 
3267
root
 
3268
====
 
3269
:目的: ツリーのrootディレクトリを表示する。
 
3270
:使い方:   bzr root [FILENAME]
 
3271
 
 
3272
:オプション:
 
3273
  -v, --verbose  詳細な情報を表示する。
 
3274
  -q, --quiet    エラーと警告だけ表示する。
 
3275
  -h, --help     ヘルプメッセージを表示する。
 
3276
 
 
3277
:説明:
 
3278
  The rootは.bzrコントロールディレクトリを持つもっとも近い同封ディレクトリです。
 
3279
 
 
3280
send
 
3281
====
 
3282
:目的: 変更を投稿するためにメールを送るもしくはmergeディレクティブを作成する。
 
3283
:使い方:   bzr send [SUBMIT_BRANCH] [PUBLIC_BRANCH]
 
3284
 
 
3285
:オプション:
 
3286
  -f ARG, --from=ARG    作業ディレクトリを含むブランチよりも、投稿フォームを生成するブランチ。
 
3287
  --remember            投稿と公開ブランチを覚える。
 
3288
  --mail-to=ARG         このアドレスにリクエストメールを送信する。
 
3289
  --format=ARG          指定されたフォーマットを使用する。
 
3290
                        "0.9": バンドルフォーマット 0.9、マージディレクティブ 1。
 
3291
                        "4": バンドルフォーマット 4、マージディレクティブ 2 (デフォルト)。
 
3292
  --no-bundle           バンドルをmergeディレクティブに含めない。
 
3293
  -h, --help            ヘルプメッセージを表示する。
 
3294
  -q, --quiet           エラーと警告のみを表示する。
 
3295
  -o ARG, --output=ARG  mergeディレクティブをこのファイルに書き込む; stdout用に-を使用する。
 
3296
  -m ARG, --message=ARG
 
3297
                        メッセージの文字列。
 
3298
  -r ARG, --revision=ARG
 
3299
                        詳細は"help revisionspec"を参照。
 
3300
  --no-patch            mergeディレクティブにプレビューパッチを含めない。
 
3301
  -v, --verbose         詳細な情報を表示する。
 
3302
 
 
3303
:説明:
 
3304
  mergeディレクティブはmergeリクエストを行うために必要な多くのものを提供します:
 
3305
 
 
3306
  * 実行するマージのマシンが理解できる説明
 
3307
 
 
3308
  * リクエストされた変更のプレビューであるオプションのパッチ
 
3309
 
 
3310
  * リビジョンデータのオプションバンドル、
 
3311
    ブランチからデータを読み込まずに、mergeディレクトリからの変更を直接適用できるようになります。
 
3312
 
 
3313
  --no-bundleが指定されると、public_branchが必要です(また最新でなければなりません)、
 
3314
  受け取り手がpublic_branchを使用するマージを実行できるように
 
3315
  後で他の人がチェックできるように、知っているのであればpublic_branchを常に含まれていなければなりません。
 
3316
 
 
3317
  投稿ブランチのデフォルトは親ですが、上書きできます。
 
3318
  提供されれば投稿ブランチと公開ブランチの両方が記録されます。
 
3319
 
 
3320
  public_branchがsubmit_branchに知られていれば、
 
3321
  その公開と投稿ブランチはマージのインストラクションで使用されます。
 
3322
  これはそのローカルミラーに対してpublic_branchを設定すれば、
 
3323
  そのミラーは実際の投稿ブランチとして使用できることを意味します。
 
3324
 
 
3325
  メールは好きなプログラムで送信されます。
 
3326
  Windowsではこれは透過的です(MAPIが使用される)。
 
3327
  Linuxでは、xdg-emailユーティリティを必要とします。
 
3328
  望ましいクライアントが見つからなければ(もしくは使用できなければ)、エディタが使用されます。
 
3329
 
 
3330
  特定のメールプログラムを使用するには、mail_client設定オプションを設定します。
 
3331
  (Thunderbird 1.5に関して、これはいくつかのバグに対処します。)
 
3332
  特定のクライアント用にサポートされる値は"claws"、"evolution"、"kmail"、"mutt"、と"thunderbird";
 
3333
  一般的なオプションは"default"、"editor"、"emacsclient"、"mapi"、と"xdg-email"です。
 
3334
  プラグインがサポートされるクライアントを追加することもあります。
 
3335
 
 
3336
  メールが送信されている場合、to addressが必要になります。
 
3337
  これはコマンドライン、submit_to設定オプションをブランチ自身に設定するか、
 
3338
  投稿ブランチでchild_submit_to設定オプションを設定することで提供できます。
 
3339
 
 
3340
  現在2つのフォーマットがサポートされています: "4"はリビジョンバンドルフォーマット4
 
3341
  とマージディレクトリフォーマット2です。
 
3342
  これは古いフォーマットよりも顕著に速く小さいです。
 
3343
  これはBazaar 0.19とそれ以降で互換性があります。
 
3344
  これはデフォルトです。
 
3345
  "0.9"はリビジョンバンドルフォーマット0.9とマージディレクティブフォーマット1を使用します。
 
3346
  これは0.12 - 0.18と互換性があります。
 
3347
 
 
3348
  mergeもしくはpullコマンドを使用することでmergeディレクトリが適用されます。
 
3349
 
 
3350
:関連項目: `merge`_, `pull`_
 
3351
 
 
3352
 
 
3353
serve
 
3354
=====
 
3355
:目的: bzrサーバーを稼働させる。
 
3356
:使い方:   bzr serve
 
3357
 
 
3358
:オプション:
 
3359
  --allow-writes     デフォルトではサーバーはリードオンリーのサーバーです。
 
3360
                     --allow-writesを提供すると提供されるディレクトリと
 
3361
                     その下の内容への書き込み権限を有効にできる。
 
3362
  -v, --verbose      詳細な情報を表示する。
 
3363
  -q, --quiet        エラーと警告のみを表示する。
 
3364
  --directory=ARG    このディレクトリの内容をサーブする。
 
3365
  --port=ARG         [hostname:]portnumber形式で指名されたポート上で接続するためにリスンする。
 
3366
                     0をポート番号として割り当てるとポートは動的な割り当てになります。
 
3367
                     デフォルトのポートは4155です。
 
3368
  --inet             inetdもしくはsshdからの使用のためにstdin/outでserveする。
 
3369
  -h, --help         ヘルプメッセージを表示する。
 
3370
 
 
3371
:エイリアス:  server
 
3372
 
 
3373
 
 
3374
shelve
 
3375
======
 
3376
:目的: いくつかの変更を現在のツリーから一時的に退避する。
 
3377
:使い方:   bzr shelve [FILE...]
 
3378
 
 
3379
:オプション:
 
3380
  --all                 すべての変更を退避する。
 
3381
  -v, --verbose         詳細な情報を表示する。
 
3382
  --list                退避された変更の一覧を表示する。
 
3383
  -h, --help            ヘルプメッセージを表示する。
 
3384
  -q, --quiet           エラーと警告だけ表示する。
 
3385
  -m ARG, --message=ARG
 
3386
                        メッセージの文字列。
 
3387
  -r ARG, --revision=ARG
 
3388
                        詳細に関しては"help revisionspec"を参照。
 
3389
 
 
3390
  writer:
 
3391
    --plain             プレーンテキスト形式での差分の出力。
 
3392
 
 
3393
:説明:
 
3394
  shelveによって変更を一時的に"棚に上げる"、すなわち邪魔にならない場所に置くことができます。
 
3395
  'unshelve'コマンドで後で元に戻すことができます。
 
3396
 
 
3397
  shelve --listが指定されると、以前退避された変更の一覧が表示されます。
 
3398
 
 
3399
  shelveは不適切に混ぜられた変更のいくつかのセットの分離を手助けすることを目的としています。
 
3400
  すべての変更を除去したいだけで後で退避する必要がなければ、revertを使用します。
 
3401
  一度にすべてのテキストの変更をshelveするには、shelve --allを使用します。
 
3402
 
 
3403
  ファイル名が指定されると、それらのファイルの変更のみ退避されます。
 
3404
  他のファイルは手つかずのままです。
 
3405
 
 
3406
  リビジョンが指定されれば、そのリビジョン以降の変更は退避されます。
 
3407
 
 
3408
  複数のアイテムを退避することができ、デフォルトでは、
 
3409
  'unshelve'は最近shelveされた変更を復元します。
 
3410
 
 
3411
:関連項目: `unshelve`_
 
3412
 
 
3413
sign-my-commits
 
3414
===============
 
3415
:目的: 与えられたコミッターですべてのコミットに署名する。
 
3416
:使い方:   bzr sign-my-commits [LOCATION] [COMMITTER]
 
3417
 
 
3418
:オプション:
 
3419
  --dry-run      実際に署名しない。
 
3420
                 署名されるリビジョンを表示するだけ。
 
3421
  -v, --verbose  詳細な情報を表示する。
 
3422
  -q, --quiet    エラーと警告だけ表示する。
 
3423
  -h, --help     ヘルプメッセージを表示する。
 
3424
 
 
3425
:説明:
 
3426
  位置が指定されなければローカルツリーが使用されます。
 
3427
  コミッターが指定されなければデフォルトのコミッターが使用されます。
 
3428
 
 
3429
  これはすでにシグネチャを持つコミットには署名しません。
 
3430
 
 
3431
 
 
3432
 
 
3433
split
 
3434
=====
 
3435
:目的: ツリーのサブディレクトリを個別のツリーに分割する。
 
3436
:使い方:   bzr split TREE
 
3437
 
 
3438
:オプション:
 
3439
  -v, --verbose  詳細な情報を表示する。
 
3440
  -q, --quiet    エラーと警告だけ表示する。
 
3441
  -h, --help     ヘルプメッセージを表示する。
 
3442
 
 
3443
:説明:
 
3444
  このコマンドは'rich-root' もしくは 'rich-root-pack'のように
 
3445
  リッチrootをサポートするフォーマットでターゲットツリーを生み出します。
 
3446
  これらのフォーマットは'dirstate-tags'のような初期のフォーマットに変換できません。
 
3447
 
 
3448
  TREEの引数は作業ツリーのサブディレクトリになります。
 
3449
  そのサブディレクトリは独自のブランチを持つ独立したツリーに変換されます。
 
3450
  トップレベルツリーのコミットは新しいサブツリーに適用されません。
 
3451
 
 
3452
 
 
3453
 
 
3454
status
 
3455
======
 
3456
:目的: ステータスの要約を表示する。
 
3457
:使い方:   bzr status [FILE...]
 
3458
 
 
3459
:オプション:
 
3460
  -S, --short           短いステータスインジケーターを表示する。
 
3461
  -v, --verbose         詳細な情報を表示する。
 
3462
  -V, --versioned       バージョン管理されたファイルだけを表示する。
 
3463
  --no-pending          未解決のマージを表示しない。
 
3464
  -h, --help            ヘルプメッセージを表示する。
 
3465
  -q, --quiet           エラーと警告のみを表示する。
 
3466
  --show-ids            内部オブジェクトidを表示する。
 
3467
  -c ARG, --change=ARG  指定されたリビジョンで導入された変更を選択する。
 
3468
                        "help revisionspec"を参照。
 
3469
  -r ARG, --revision=ARG
 
3470
                        詳細は"help revisionspec"を参照。
 
3471
 
 
3472
:説明:
 
3473
  これはバージョン管理されたファイルと未知のファイルを状態で
 
3474
  分類してレポートします。利用可能な状態は次のとおりです:
 
3475
 
 
3476
  added
 
3477
      作業ツリーでバージョン管理されているが以前のリビジョンではない。
 
3478
 
 
3479
  removed
 
3480
      以前のリビジョンでバージョン管理されているが作業コピーでは移動もしくは削除されている。
 
3481
 
 
3482
  renamed
 
3483
      以前のリビジョンから変更されたファイルのパス;
 
3484
      テキストも変更されていることがある。
 
3485
      これは親ディレクトリがリネームされたファイルを含む。
 
3486
 
 
3487
  modified
 
3488
      以前のリビジョン以降変更されたテキスト。
 
3489
 
 
3490
  kind changed
 
3491
      変更されたファイルの種類(たとえばファイルからディレクトリへ)。
 
3492
 
 
3493
  unknown
 
3494
      バージョン管理されていないかつ無視パターンにマッチしない。
 
3495
 
 
3496
  無視されるファイルを見るには'bzr ignored'を使用します。
 
3497
  ファイルテキストへの詳細な変更に関しては、'bzr diff'を使用します。
 
3498
 
 
3499
  --shortもしくは-Sは、Subversionのstatusコマンドに似た、
 
3500
  それぞれのアイテムに対するステータスフラグを提供することに注意してください。
 
3501
  svn -qと似たような出力を得るには、bzr status -SVを使用します。
 
3502
 
 
3503
  引数が指定されなければ、作業ディレクトリ全体のステータスが示されます。
 
3504
  さもなければ、指定されたファイルもしくはディレクトリのステータスのみが報告されます。
 
3505
  ディレクトリが渡されれば、そのディレクトリ内部のすべてに関するステータスが報告されます。
 
3506
 
 
3507
  1つのリビジョンの引数が渡されれば、ステータスはそのリビジョンに対して
 
3508
  2つの引数の場合は2つのリビジョンの間で算出されます。
 
3509
 
 
3510
:エイリアス:  st, stat
 
3511
:関連項目: `diff`_, `revert`_, `status-flags`_
 
3512
 
 
3513
 
 
3514
switch
 
3515
======
 
3516
:目的: チェックアウトのブランチを設定してupdateする。
 
3517
:使い方:   bzr switch TO_LOCATION
 
3518
 
 
3519
:オプション:
 
3520
  --force        ローカルコミットが失われていても切り替える。
 
3521
  -v, --verbose  詳細な情報を表示する。
 
3522
  -q, --quiet    エラーと警告だけ表示する。
 
3523
  -h, --help     ヘルプメッセージを表示する。
 
3524
 
 
3525
:説明:
 
3526
  軽量チェックアウトに対して、これは参照されているブランチを変更します。
 
3527
  重量チェックアウトに対して、これはローカルコミットがなく、
 
3528
  バインドされたブランチがないことを確認して、
 
3529
  ローカルブランチを新しいロケーションのミラーにしてそれにバインドします。
 
3530
 
 
3531
  両方の場合において、作業ツリーはupdateされコミットされてない変更はマージされます。
 
3532
  ユーザーは望むのであればcommitもしくはrevertできます。
 
3533
 
 
3534
  マージの追加にはswithを使用する前にcommitもしくはrevertする必要があります。
 
3535
 
 
3536
  swithするブランチへのパスは現在のブランチの親ディレクトリに対して相対的に指定できます。
 
3537
  たとえば、現在/path/to/branchのチェックアウトの中にいるのであれば
 
3538
  'newbranch'を指定すれば/path/to/newbranchでのブランチが発見されます。
 
3539
 
 
3540
  ローカルに設定されていない限りバインドされたブランチはマスターブランチのニックネームを使用します。
 
3541
  この場合、switchを行うとローカルのニックネームはマスターのものに更新されます。
 
3542
 
 
3543
 
 
3544
tag
 
3545
===
 
3546
:目的: リビジョンを名づけっるタグを作成、削除もしくは修正する。
 
3547
:使い方:   bzr tag TAG_NAME
 
3548
 
 
3549
:オプション:
 
3550
  --force               既存のタグを置き換える。
 
3551
  -v, --verbose         詳細な情報を表示する。
 
3552
  -h, --help            ヘルプメッセージを表示する。
 
3553
  -q, --quiet           エラーと警告のみを表示する。
 
3554
  -d ARG, --directory=ARG
 
3555
                        タグを設置するブランチ
 
3556
  -r ARG, --revision=ARG
 
3557
                        詳細は"help revisionspec"を参照。
 
3558
  --delete              置き換えるよりもタグを削除する。
 
3559
 
 
3560
:説明:
 
3561
  タグはリビジョンに人間が理解できる名前を与えます。
 
3562
  -r (--revision)オプションをとるコマンドは-rtag:Xに渡されます。
 
3563
  Xは以前作成されたタグです。
 
3564
 
 
3565
  タグはブランチに保存されます。
 
3566
  branch、push、pullもしくはmergeを行うときタグはあるブランチから他のブランチにコピーされます。
 
3567
 
 
3568
  --forceを渡さない限り、既存のタグ名を与えるとエラーになります。
 
3569
  この場合新しいリビジョンを示すようにタグは移動します。
 
3570
 
 
3571
  タグをリネームする(名前を変更するが同じリビジョンで維持する)には、
 
3572
  ``bzr tag new-name -r tag:old-name`` と ``bzr tag --delete oldname`` を実行します。
 
3573
 
 
3574
:関連項目: `commit`_, `tags`_
 
3575
 
 
3576
 
 
3577
tags
 
3578
====
 
3579
:目的: タグの一覧を表示する。
 
3580
:使い方:   bzr tags
 
3581
 
 
3582
:オプション:
 
3583
  --sort=ARG            異なる基準でタグをソートする。
 
3584
                        "alpha": 辞書式でタグをソートする(デフォルト)。
 
3585
                        "time": 年代順でタグをソートする。
 
3586
  -v, --verbose         詳細な情報を表示する。
 
3587
  -q, --quiet           エラーと警告のみを表示する。
 
3588
  -d ARG, --directory=ARG
 
3589
                        タグが表示されるブランチ。
 
3590
  --show-ids            内部オブジェクトidを表示する。
 
3591
  -r ARG, --revision=ARG
 
3592
                        詳細は"help revisionspec"を参照。
 
3593
  -h, --help            ヘルプメッセージを表示する。
 
3594
 
 
3595
:説明:
 
3596
  このコマンドはこれらが参照するタグ名とリビジョンのテーブルを表示します。
 
3597
 
 
3598
:関連項目: `tag`_
 
3599
 
 
3600
 
 
3601
testament
 
3602
=========
 
3603
:目的: リビジョンのtestament(署名のフォーム)を表示する。
 
3604
:使い方:   bzr testament [BRANCH]
 
3605
 
 
3606
:オプション:
 
3607
  -v, --verbose         詳細な情報を表示する。
 
3608
  -h, --help            ヘルプメッセージを表示する。
 
3609
  -q, --quiet           エラーと警告のみを表示する。
 
3610
  --long                長いフォーマットのtestamentを生成する。
 
3611
  --strict              厳密なフォーマットのtestamentを生成する。
 
3612
  -r ARG, --revision=ARG
 
3613
                        詳細は"help revisionspec"を参照。
 
3614
 
 
3615
 
 
3616
 
 
3617
unbind
 
3618
======
 
3619
:目的: 現在のチェックアウトを通常のブランチに変換する。
 
3620
:使い方:   bzr unbind
 
3621
 
 
3622
:オプション:
 
3623
  -v, --verbose  詳細な情報を表示する。
 
3624
  -q, --quiet    エラーと警告だけ表示する。
 
3625
  -h, --help     ヘルプメッセージを表示する。
 
3626
 
 
3627
:説明:
 
3628
  unbindした後で、ローカルブランチは独立したものとして見なされ
 
3629
  その後のコミットはローカルのみで行われます。
 
3630
 
 
3631
:関連項目: `bind`_, `チェックアウト`_
 
3632
 
 
3633
 
 
3634
uncommit
 
3635
========
 
3636
:目的: 最後にコミットされたリビジョンを削除する。
 
3637
:使い方:   bzr uncommit [LOCATION]
 
3638
 
 
3639
:オプション:
 
3640
  --dry-run             実際には変更しない。
 
3641
  -v, --verbose         詳細な情報を表示する。
 
3642
  -h, --help            ヘルプメッセージを表示する。
 
3643
  -q, --quiet           エラーと警告のみを表示する。
 
3644
  --force               すべての質問にyesと答える。
 
3645
  --local               チェックアウトのときローカルブランチからコミットのみを削除する。
 
3646
  -r ARG, --revision=ARG
 
3647
                        詳細は"help revisionspec"を参照。
 
3648
 
 
3649
:説明:
 
3650
  --verboseは削除されているものを表示します。
 
3651
  --dry-runはすべてのモーションを経験しますが、実際には何も削除しません。
 
3652
 
 
3653
  --revisionが指定されると、指定されたリビジョンでブランチをそのままにするために
 
3654
  リビジョンをuncommitします。たとえば、"bzr uncommit -r 15"はリビジョン15でのブランチを
 
3655
  そのままにします。
 
3656
 
 
3657
  uncommitは新しいコミットの準備ができている作業ツリーをそのままにします。
 
3658
  唯一行われる変更はコミット以前に存在していた追加マージをリストアすることです。
 
3659
 
 
3660
:関連項目: `commit`_
 
3661
 
 
3662
unshelve
 
3663
========
 
3664
:目的: shelveされた変更を復元する。
 
3665
:使い方Usage:   bzr unshelve [SHELF_ID]
 
3666
 
 
3667
:オプション:
 
3668
  -v, --verbose    詳細な情報を表示する。
 
3669
  -q, --quiet      エラーと警告だけ表示する。
 
3670
  -h, --help       ヘルプメッセージを表示する。
 
3671
 
 
3672
  アクション:
 
3673
    --apply        変更を適用してshelfから削除する。
 
3674
    --delete-only  変更を適用せずにそれらを削除する。
 
3675
    --dry-run      編子を表示するがそれらを適用もしくは除外しない。
 
3676
 
 
3677
:説明:
 
3678
  デフォルトでは、最近shelveされた変更が復元されます。
 
3679
  んまでパッチを指定したとしてもそれらの変更が代わりに復元されます。
 
3680
  変更がお互いに依存しないときにこれはもっとも良く機能します。
 
3681
 
 
3682
:関連項目: `shelve`_
 
3683
 
 
3684
 
 
3685
update
 
3686
======
 
3687
:目的: ブランチにコミットした最新コードにツリーを更新する。
 
3688
:使い方:   bzr update [DIR]
 
3689
 
 
3690
:オプション:
 
3691
  -v, --verbose  詳細な情報を表示する。
 
3692
  -q, --quiet    エラーと警告だけ表示する。
 
3693
  -h, --help     ヘルプメッセージを表示する。
 
3694
 
 
3695
:説明:
 
3696
  このコマンドは作業ツリーでマージを実行し、衝突を生成することがあります。
 
3697
  ローカルの変更がある場合、updateを完了させるために
 
3698
  updateの後でそれらをコミットする必要があります。
 
3699
 
 
3700
  ローカルの変更を破棄したい場合、updateの後で'bzr commit'の代わりに
 
3701
  'bzr revert'を使用できます。
 
3702
 
 
3703
:エイリアス:  up
 
3704
:関連項目: `pull`_, `status-flags`_, `working-trees`_
 
3705
 
 
3706
 
 
3707
upgrade
 
3708
=======
 
3709
:目的: ブランチのストレージを現在のフォーマットにアップグレードする。
 
3710
:使い方:   bzr upgrade [URL]
 
3711
 
 
3712
:オプション:
 
3713
  -v, --verbose         詳細な情報を表示する。
 
3714
  -q, --quiet           エラーと警告のみを表示する。
 
3715
  -h, --help            ヘルプメッセージを表示する。
 
3716
 
 
3717
  ブランチのフォーマット::
 
3718
 
 
3719
    --format=ARG        このブランチのフォーマットを指定する。"help formats"を参照。
 
3720
    --1.12-preview      ビューとコンテンツのフィルタリングをサポートする作業ツリーフォーマット。
 
3721
    --1.12-preview-rich-root
 
3722
                        rich-rootデータをサポートする1.12-previewのバリアント(bzr-svnに必要)
 
3723
    --1.6               スタックをサポートするリポジトリに基づいたブランチとパック。
 
3724
    --1.6.1-rich-root   スタックとリッチなrootデータをサポートするリポジトリに基づいた
 
3725
                        ブランチとパック(bzr-svnに必要)。
 
3726
    --1.9               btreeインデックスを使用するリポジトリに基づいたブランチとパック
 
3727
    --1.9-rich-root     btreeインデックスとリッチrootデータを使用する
 
3728
                        リポジトリに基づいたブランチとパック(bzr-svnに必要)。
 
3729
    --default           0.92の新しい機能: dirstate-tagsフォーマットリポジトリと
 
3730
                        互換性のあるデータを持つパックベースのフォーマット。
 
3731
                        0.92以前のbzrリポジトリと相互運用しますが
 
3732
                        bzr < 0.92では読むことができません。
 
3733
                        以前はknitpack-experimentalと呼ばれていました。
 
3734
                        詳細な情報は http://doc.bazaar-vcs.org/latest/developers/packrepo.html を参照。
 
3735
    --development       現在の開発フォーマット。データをpack-0.92 (とpack-0.92と互換性のある)
 
3736
                        フォーマットリポジトリに変換できる。
 
3737
                        このフォーマットのリポジトリとブランチはbzr.devによってのみ読み込みできます。
 
3738
                        使用する前に http://doc.bazaar-vcs.org/latest/developers/development-repo.html を参照して頂くようお願いします。
 
3739
    --development-subtree
 
3740
                        現在の開発フォーマットで、subtreeバリアント。
 
3741
                        データをpack-0.92-subtree(とpack-0.92-subtreeと互換性のある)
 
3742
                        フォーマットリポジトリに変換できる。
 
3743
                        このフォーマットのリポジトリとブランチはbzr.devでのみ読み込みできる。
 
3744
                        使用する前に http://doc.bazaar-vcs.org/latest/developers/development-
 
3745
                        repo.html をご覧いただくようお願いします。
 
3746
    --dirstate          0.15の新しいフォーマット: 速いローカルオペレーション。
 
3747
                        ネットワークを通したアクセスのときbzr 0.8とそれ以降と互換性がある。
 
3748
    --dirstate-tags     0.15の新しいフォーマット: 速いローカルオペレーションで
 
3749
                        ネットワークオペレーションに関するスケーリングを改善。
 
3750
                        タグのサポートを追加。bzr < 0.15とは互換性がない。
 
3751
    --knit              knitsを使用するフォーマット。bzr <= 0.14との相互運用に推奨。
 
3752
    --metaweave         0.8での暫定フォーマット。knitよりも遅い。
 
3753
    --pack-0.92         0.92の新しいフォーマット: dirstate-tagsフォーマットリポジトリと
 
3754
                        互換性のあるデータを持つパックベースのフォーマット。
 
3755
                        0.92以前のbzrリポジトリと相互運用できるがbzr < 0.92.によって読み込みできない。
 
3756
                        以前はknitpack-experimentalと呼ばれていた。
 
3757
                        詳細な情報に関しては、 http://doc
 
3758
                        .bazaar-vcs.org/latest/developers/packrepo.html を参照。
 
3759
    --rich-root         1.0の新しいフォーマット。ツリーrootのベターな扱い。
 
3760
                        bzr < 1.0と互換性がない。
 
3761
    --rich-root-pack    1.0の新しいフォーマット: rich-rootデータをサポートする
 
3762
                        pack-0.92のバリアント(bzr-svnに必要)。
 
3763
    --weave             0.8以前のフォーマット。knitよりも遅く
 
3764
                        チェックアウトもしくは共用リポジトリをサポートしない。
 
3765
 
 
3766
:説明:
 
3767
  ときどきこのコマンドを実行するにcheckコマンドもしくはbzrの開発者がアドバイスすることがあります。
 
3768
  デフォルトフォーマットが変更されたときアップグレードする他のオペレーションの実行中に警告されることもあります。
 
3769
 
 
3770
:関連コマンド: `check`_
 
3771
 
 
3772
 
 
3773
version
 
3774
=======
 
3775
:目的: bzrのバージョンを表示する
 
3776
:使い方:   bzr version
 
3777
 
 
3778
:オプション:
 
3779
  --short        バージョン番号だけを表示する。
 
3780
  -v, --verbose  詳細な情報を表示する。
 
3781
  -q, --quiet    エラーと警告だけ表示する。
 
3782
  -h, --help     ヘルプメッセージを表示する。
 
3783
 
 
3784
 
 
3785
 
 
3786
version-info
 
3787
============
 
3788
:目的: このツリーに関するバージョン情報を表示する。
 
3789
:使い方:   bzr version-info [LOCATION]
 
3790
 
 
3791
:オプション:
 
3792
  --all                 すべての入手可能な情報を含める。
 
3793
  -v, --verbose         詳細な情報を表示する。
 
3794
  --check-clean         ツリーがクリーンであるかチェックする。
 
3795
  --include-history     リビジョンの履歴を含める。
 
3796
  -q, --quiet           エラーと警告のみを表示する。
 
3797
  --template=ARG        出力用のテンプレート。
 
3798
  --include-file-revisions
 
3799
                        それぞれのファイルに対する最終リビジョンを含める。
 
3800
  -h, --help            ヘルプメッセージを表示する。
 
3801
 
 
3802
  フォーマット::
 
3803
    --format=ARG        出力フォーマットを選択する。
 
3804
    --custom            カスタムテンプレートベースのフォーマットでのバージョン情報。
 
3805
    --python            Pythonフォーマットでのバージョン情報。
 
3806
    --rio               RIOフォーマット(シンプルなテキスト)でのバージョン情報(デフォルト)。
 
3807
 
 
3808
:説明:
 
3809
  バージョンに関する情報をアプリケーションのソースコードに追加するために
 
3810
  このコマンドを使用できます。出力のフォーマットはサポートされているもの1つか
 
3811
  テンプレートに基づいてカスタマイズされたものです。
 
3812
 
 
3813
  例::
 
3814
 
 
3815
    bzr version-info --custom \
 
3816
      --template="#define VERSION_INFO \"Project 1.2.3 (r{revno})\"\n"
 
3817
 
 
3818
  現在のリビジョン番号を含むフォーマットされた文字列でCヘッダファイルを生成します。
 
3819
  テンプレートでのサポートされた他の変数は次のとおりです:
 
3820
 
 
3821
    * {date} - 最終リビジョンの日付
 
3822
    * {build_date} - 現在の日付
 
3823
    * {revno} - リビジョン番号
 
3824
    * {revision_id} - リビジョンid
 
3825
    * {branch_nick} - ブランチのニックネーム
 
3826
    * {clean} - ソースコードがコミットされていない変更を含むときは0でそれ以外は1
 
3827
 
 
3828
 
 
3829
 
 
3830
whoami
 
3831
======
 
3832
:目的: bzrのユーザーidを表示もしくは設定する。
 
3833
:使い方:   bzr whoami [NAME]
 
3834
 
 
3835
:オプション:
 
3836
  --email        Eメールアドレスのみ表示する。
 
3837
  -v, --verbose  詳細な情報を表示する。
 
3838
  -q, --quiet    エラーと警告のみを表示する。
 
3839
  --branch       グローバルの代わりに現在のブランチ用のIDを設定する。
 
3840
  -h, --help     ヘルプメッセージを表示する。
 
3841
 
 
3842
:例:
 
3843
    現在のユーザーのEメールを表示する::
 
3844
 
 
3845
        bzr whoami --email
 
3846
 
 
3847
    現在のユーザーを設定する::
 
3848
 
 
3849
        bzr whoami "Frank Chu <fchu@example.com>"
 
3850
 
 
3851
 
 
3852
 
 
3853