« back to all changes in this revision
Viewing changes to doc/ja/tutorials/tutorial.txt
- browse files at revision 4634.99.1
- compare with another revision
- compare with revision 1237
- download diff
- download tarball
- view history from revision 4634.99.1
- Committer: Naoki INADA
- Date: 2009-10-29 10:01:19 UTC
- mto: (4634.97.3 2.0)
- mto: This revision was merged to the branch mainline in revision 4798.
- Revision ID: inada-n@klab.jp-20091029100119-uckv9t7ej2qrghw3
import doc-ja rev90
- files added:
- doc/index.ja.txt
- doc/ja
- doc/ja/_static
- doc/ja/_templates
- doc/ja/mini-tutorial
- doc/ja/tutorials
- doc/ja/upgrade-guide
- doc/ja/user-guide
- doc/ja/user-guide/images
- doc/ja/user-reference
- files modified:
- doc/index.txt
added
removed
doc/ja/tutorials/tutorial.txt
1
.. This file is in Python ReStructuredText format - it can be formatted
2
.. into HTML or text. In the future we plan to extract the example commands
3
.. and automatically test them.
4
5
.. This text was previously on the wiki at
6
.. http://bazaar.canonical.com/IntroductionToBzr
7
.. but has been moved into the source tree so it can be kept in sync with
8
.. the source and possibly automatically checked.
9
10
======================
11
Bazaar チュートリアル
12
======================
13
14
15
.. Introduction
16
17
はじめに
18
============
19
20
もし、もう分散型バージョン管理に慣れ親しんでいるなら、
21
"Bazaarに自己紹介する" の節までとばしてください。
22
もし、分散型でないバージョン管理に慣れ親しんでいるけれど分散型バージョン管理は\
23
よくわからないのであれば、"分散バージョン管理と分散でないバージョン管理の違い"まで\
24
とばしてください。
25
それ以外の場合、コーヒーか紅茶(訳注:日本茶でもいいですよ)を用意して、\
26
リラックスして読み始めてください。
27
28
バージョン管理の目的
29
====================
30
31
なにかのテキストデータ(プログラムのソースコード、Webサイト、Unixシステムでの\
32
設定ファイルなど)を扱う作業をしているとしましょう。
33
なにかミスをして、重大なデグレードを引き起こしてしまうかもしれません。
34
例えばメールサーバーの設定ファイルを消してしまったり、だいじなプロジェクトの\
35
ソースコードを壊してしまったりすることがあります。
36
だいじな情報を失って、何が何でも取り戻したいと思った経験があるのであれば、\
37
きっとあなたはBazaarを使う準備ができています。
38
39
Bazaarをはじめとするバージョン管理システムは、ディレクトリに起こった変更を\
40
**ブランチ (branch)** というディレクトリよりも複雑なものの中に入れて\
41
追跡します。
42
ブランチはディレクトリの中に何が入っているかだけでなく、過去のいろいろな\
43
時点でのディレクトリの中身を格納しています。
44
なので、望まぬ変更をしてしまったときには過去の時点の状態に戻すことができます。
45
46
バージョン管理システムは、ユーザーが "**リビジョン (revision)** をコミット"
47
することで変更をブランチに保存します。
48
このときに生成されるリビジョンとは、本質的にいって、前回保存したときからの\
49
変更点になります。
50
51
リビジョンはそれ以外のものも持っています(原文:These revisions have other
52
uses as well.)
53
たとえば、オプションのログメッセージをつけることで、変更が何を意味して\
54
いるのかというコメントを残すことができます。
55
実際に利用されるログメッセージは、 "Webテンプレートをテーブルを閉じるように\
56
修正" とか "sftpに対応した。 #595 を修正。" といったものです。
57
58
こういったログが保存されているおかげで、たとえば後になって sftp に問題が発生\
59
したときに、問題が発生するようになったのがどの時点なのか目星をつけることが\
60
できます。
61
62
63
分散バージョン管理と分散でないバージョン管理の違い
64
===================================================
65
66
多くのバージョン管理システムはサーバーに配置されています。
67
バージョン管理されているコードに対して作業をしたい場合、サーバーに接続して\
68
コードを "チェックアウト (checkout)" する必要があります。
69
そうすると、変更やコミットができるディレクトリができます。
70
バージョン管理システムのクライアントは、バージョン管理システムのサーバーに\
71
コミットされた変更を保存します。この方式は集中型として知られています。
72
73
集中型にはいくつかの欠点があります。
74
集中型バージョン管理システムは、動作するためにサーバーとの接続を要求します。
75
このことは、サーバーがどこかインターネット上にあって、あなたのマシンが\
76
インターネットに接続できないときに問題になります。
77
もしくは、あなたのマシンがインターネットに接続できてもサーバーが落ちている\
78
ときにもやはり問題になります。
79
80
分散バージョン管理システムは、ブランチをクライアントと同じマシンに置くことで\
81
この問題を解決しています。
82
Bazaarの場合、ブランチはバージョン管理されているコードと同じディレクトリに\
83
保存されます。
84
これにより、ユーザーは(たとえオフラインであったとしても)好きなときに変更を保存\
85
(**コミット (commit)**)することができます。
86
インターネット接続が必要になるのは、どこか別の場所にあるブランチの変更にアクセス\
87
するときだけです。
88
89
.. TODO:
90
.. Performing this tracking by hand is a awkward process that over time
91
.. becomes unwieldy. の部分の訳が判らない。
92
93
多くの人が必要としていることは、ディレクトリ内でおこったファイルやサブディレクトリ\
94
の変更を追跡することです。
95
この追跡を手でおこなうのは面倒で不恰好な作業です。
96
これは、Bazaarのようなバージョン管理システムの目的のひとつです。
97
バージョン管理システムはユーザーが指示したときにディレクトリツリーの
98
**リビジョン (revision)** を作ることでこの作業を自動化します。
99
100
バージョン管理システムは単に保存したりundoしたりするだけではありません。
101
たとえばBazaarでは、ソフトウェアのあるブランチから変更を取り出して、\
102
関連する別のブランチに適用することができます。このとき、変更を取り出す\
103
ブランチは別の人のものであってもかまいません。これにより、開発者のグループは\
104
お互いに書き込み権を与えることなく共同作業することができます。
105
106
.. Bazaar remembers the ''ancestry'' of a revision: the previous revisions
107
.. that it is based upon. A single revision may have more than one direct
108
.. descendant, each with different changes, representing a divergence in the
109
.. evolution of the tree. By branching, Bazaar allows multiple people to
110
.. cooperate on the evolution of a project, without all needing to work in
111
.. strict lock-step. Branching can be useful even for a single developer.
112
113
Bazaarではリビジョンの ''親 (ancestry)'' 、つまりそのリビジョンの元になった\
114
リビジョンを記録しています。
115
ひとつのリビジョンは複数の、それぞれ別の変更を含む子供リビジョンを持つことが\
116
あり、それはツリーの進化が分岐していることを意味しています。
117
Bazaarではブランチを作ることによって、複数の人が厳しい lock-step をとらなくても\
118
協力することができます。
119
ブランチを作ることは個人での開発でも便利です。
120
121
.. Introducing yourself to Bazaar
122
123
Bazaarに自己紹介する
124
=====================
125
126
.. Bazaar installs a single new command, **bzr**. Everything else is a
127
subcommand of this. You can get some help with ``bzr help``. Some arguments
128
are grouped in topics: ``bzr help topics`` to see which topics are available.
129
130
Bazaarは **bzr** という新しいコマンドをひとつインストールします。
131
他の全ては bzr のサブコマンドになります。
132
``bzr help`` コマンドでいくつかのヘルプを見られます。
133
幾つかの話題は topic にまとめられていて、 ``bzr help topics`` で\
134
利用可能なトピックの一覧を見られます。
135
136
バージョン管理システムの一つの機能は、誰が何を変更したのかを追跡することです。
137
分散型バージョン管理システムでは、各開発者がグローバルユニークなIDを持つ\
138
必要があります。
139
ほとんどの人はこのIDとして利用できる eメールアドレス を持っています。
140
Bazaarはコンピュータのユーザー名とホスト名から自動でメールアドレスを\
141
生成します。Bazaarが自動で作成したメールアドレス以外のものを使いたい\
142
場合、３つの選択肢があります。
143
144
1. ``bzr whoami`` を使ってメールアドレスを設定します。これはグローバルなIDを設定\
145
する最も簡単な方法です。グローバルなIDを設定するには::
146
147
% bzr whoami "Your Name <email@example.com>"
148
149
特定のブランチでべつのアドレスを使いたい場合、そのブランチのディレクトリの\
150
なかで次のコマンドを実行します::
151
152
% bzr whoami --branch "Your Name <email@example.com>"
153
154
#. ``?/.bazaar/bazaar.conf`` [1]_ の中のメールアドレスを、以下のようにして\
155
設定します。 ``[DEFAULT]`` の部分が大文字と小文字を区別するので注意して\
156
ください::
157
158
[DEFAULT]
159
email=Your Name <email@isp.com>
160
161
特定のブランチにおける設定は、 ``?/.bazaar/locations.conf``
162
にブランチのセクションを作成して次のように書くことができます。 ::
163
164
[/the/path/to/the/branch]
165
email=Your Name <email@isp.com>
166
167
168
#. 環境変数 ``$BZR_EMAIL`` もしくは ``$EMAIL`` (``$BZR_EMAIL`` の方が優先\
169
されます)にメールアドレスを設定することで、上の二つの方法で設定された\
170
オプションを上書きすることができます。
171
172
.. [1] Windowsではユーザー設定ファイルはアプリケーションデータディレクトリに\
173
おかれます。なので、設定ファイルの場所は ``?/.bazaar/branch.conf`` ではなく\
174
``C:\Documents and Settings\<username>\Application Data\Bazaar\2.0\branch.conf``
175
になります。
176
同じことが ``locations.conf``, ``ignore``, ``plugins`` ディレクトリも\
177
同じです。
178
179
ブランチを作る
180
==============
181
182
履歴はデフォルトではブランチの .bzr ディレクトリの中に保存されます。
183
184
.. これは現行のバージョンでできるのでは？: In a
185
future version of Bazaar, there will be a facility to store it in a
186
separate repository, which may be remote.
187
188
既存のディレクトリの中で ``bzr init`` をすると新しいブランチを作成できます::
189
190
% mkdir tutorial
191
% cd tutorial
192
% ls -a
193
./ ../
194
% pwd
195
/home/mbp/work/bzr.test/tutorial
196
%
197
% bzr init
198
% ls -aF
199
./ ../ .bzr/
200
%
201
202
ファイルには３つのクラス、 unknown, ignored, versioned があります。
203
**add** コマンドはファイルを versioned にし、そのファイルへの変更の記録を\
204
開始します::
205
206
% echo 'hello world' > hello.txt
207
% bzr status
208
unknown:
209
hello.txt
210
% bzr add hello.txt
211
added hello.txt
212
% bzr status
213
added:
214
hello.txt
215
216
もし間違えたファイルを add してしまった場合、そのファイルを unversioned
217
状態に戻すために ``bzr remove`` してください。
218
この場合の ``bzr remove`` は、ほかの場合 [2]_ とちがってファイルを削除\
219
しません。
220
221
.. [2] ``bzr remove`` はファイルがバージョン管理されていて何も変更されて\
222
いない場合に、そのファイルを削除します。 ``--keep`` オプションで常に\
223
ファイルを残すことができます。 ``--force`` オプションで常にファイルを\
224
削除することもできます。
225
226
.. Branch locations
227
228
ブランチの場所
229
===============
230
231
すべての履歴はブランチに格納されます。ブランチとは、管理用のファイルを\
232
含んだただのディレクトリです。デフォルトでは、svnやsvkのような、分離した\
233
リポジトリやデータベースはありません。分離したリポジトリを作成することも\
234
できます(``bzr init-repo`` コマンドを参照してください)。大規模なブランチを\
235
利用する場合や、中規模のブランチをたくさん利用する場合にはリポジトリを\
236
分離するといいでしょう。
237
238
自分のコンピュータのファイルシステム上にあるブランチを参照するときは\
239
ブランチを格納しているディレクトリ名で指定できます。 bzr は http や ftp\
240
経由でブランチにアクセスすることもできます。例::
241
242
% bzr log http://bazaar-vcs.org/bzr/bzr.dev/
243
% bzr log sftp://bazaar-vcs.org/bzr/bzr.dev/
244
245
プラグインをインストールすれば、 rsync プロトコルを使ってブランチにアクセス\
246
することもできます。
247
248
ブランチを指定した場所に置く方法については、 `ブランチを公開する`_ 節を\
249
ご覧ください。
250
251
.. Reviewing changes
252
253
変更をレビューする
254
===================
255
256
一仕事終えたら、それを履歴に **コミット (commit)** しましょう。
257
新しい機能を追加したり、バグを直したり、コードやドキュメントを更新したら\
258
いつでもコミットするのは良いことです。
259
すべてのリビジョンが良い状態であるようにするために、コミットする前にコードを\
260
コンパイルしたりテストスイートを実行するのも良い習慣です。
261
コミットする前にコミットしようとしているものを確認するためにレビューすることが\
262
できます。
263
264
この目的で便利な二つのコマンドがあります。 **status** と **diff** です。
265
266
bzr status
267
----------
268
269
**status** コマンドは、今の作業ツリーが最後のリビジョンからどのように\
270
変更されたのかを教えてくれます::
271
272
% bzr status
273
modified:
274
foo
275
276
``bzr status`` は変更が無かったり無視されているファイルを隠します。
277
status コマンドはオプションとして、確認対象となる複数のファイル名やディレクトリ名を\
278
渡すことができます。
279
280
bzr diff
281
--------
282
283
**diff** コマンドは通常の unified diff フォーマットですべてのファイルの\
284
テキストの変更を表示します。
285
このコマンドの出力を pipe 経由で、''patch'', ''diffstat'', ''fileterdiff'',
286
''colordiff'' といったコマンドに渡すことができます。 ::
287
288
% bzr diff
289
=== added file 'hello.txt'
290
--- hello.txt 1970-01-01 00:00:00 +0000
291
+++ hello.txt 2005-10-18 14:23:29 +0000
292
@@ -0,0 +1,1 @@
293
+hello world
294
295
296
``-r`` オプションをつけると、作業ツリーを古いリビジョンと比較したり、\
297
二つのリビジョン間の差分を見ることができます。 ::
298
299
% bzr diff -r 1000.. # everything since r1000
300
% bzr diff -r 1000..1100 # changes from 1000 to 1100
301
302
``--diff-options`` オプションをつけると、 bzr は外部の diff プログラムに\
303
オプションをつけて起動します。 例::
304
305
% bzr diff --diff-options --side-by-side foo
306
307
プロジェクトによっては二つのファイルに接頭辞がついた patch が好まれます。
308
``--prefix`` オプションでそのような接頭辞をつけることができます。
309
ショートカットとして、 ``bzr diff -p1`` は ``patch -p1`` コマンドが受け付ける\
310
形で差分を出力します。
311
312
313
.. Committing changes
314
315
変更をコミットする
316
==================
317
318
作業ツリーの状態に満足したら、ブランチに **コミット (commit)** しましょう。
319
コミットとは作業ツリーの状態のスナップショットを保持するリビジョンを新しく作ることです。
320
321
bzr commit
322
----------
323
324
.. The **commit** command takes a message describing the changes in the
325
.. revision. It also records your userid, the current time and timezone, and
326
.. the inventory and contents of the tree. The commit message is specified
327
.. by the ``-m`` or ``--message`` option. You can enter a multi-line commit
328
.. message; in most shells you can enter this just by leaving the quotes open
329
.. at the end of the line.
330
331
**commit** コマンドはそのリビジョンの変更を説明するメッセージを受け取ります。
332
また、あなたのユーザーID、今の時間とタイムゾーン、ツリーの内容をあわせて記録します。
333
コミットメッセージは ``-m`` もしくは ``--message`` オプションで指定できます。
334
複数行のコメントも利用できます。多くのシェルはクォートを開いたままで改行する\
335
ことで複数行の入力が可能です。
336
337
::
338
339
% bzr commit -m "added my first file"
340
341
.. You can also use the ``-F`` option to take the message from a file. Some
342
.. people like to make notes for a commit message while they work, then
343
.. review the diff to make sure they did what they said they did. (This file
344
.. can also be useful when you pick up your work after a break.)
345
346
メッセージをファイルで渡すには ``-F`` オプションを使います。
347
コミットメッセージを先に作成し、それとdiffを合わせてレビューすることで、
348
コミットメッセージとコミット内容が一致していることを確認する人もいます。
349
(このファイルは休憩から戻ってきて作業を思い出すときにも役に立つでしょう)
350
351
.. Message from an editor
352
353
エディタからメッセージを入力する
354
----------------------------------
355
356
.. If you use neither the ``-m`` nor the ``-F`` option then bzr will open an
357
.. editor for you to enter a message. The editor to run is controlled by
358
.. your ``$VISUAL`` or ``$EDITOR`` environment variable, which can be overridden
359
.. by the ``editor`` setting in ``?/.bazaar/bazaar.conf``; ``$BZR_EDITOR`` will
360
.. override either of the above mentioned editor options. If you quit the
361
.. editor without making any changes, the commit will be cancelled.
362
363
``-m`` オプションも ``-F`` オプションも指定しなかった場合、 bzr はメッセージを\
364
入力するためにエディタを立ち上げます。
365
このエディタは ``$VISUAL`` か ``$EDITOR`` 環境変数で制御することができます。
366
この環境変数を `` /.bazaar/bazaar.conf`` 内の ``editor`` を設定して上書き\
367
することができ、さらに ``$BZR_EDITOR`` 環境変数がそれらすべてを上書きします。
368
もし何も変更せずにエディタを閉じたなら、コミットはキャンセルされます。
369
370
.. The file that is opened in the editor contains a horizontal line. The part
371
.. of the file below this line is included for information only, and will not
372
.. form part of the commit message. Below the separator is shown the list of
373
.. files that are changed in the commit. You should write your message above
374
.. the line, and then save the file and exit.
375
376
エディタで開かれるファイルには水平線が含まれています。この線より下の部分は\
377
参考用であり、コミットメッセージには含まれません。
378
水平線の下にはコミットで変更されるファイルのリストが表示されます。
379
メッセージは水平線の上に書く必要があります。そうしたら、ファイルを保存して\
380
エディタを終了してください。
381
382
.. If you would like to see the diff that will be committed as you edit the
383
.. message you can use the ``--show-diff`` option to ``commit``. This will include
384
.. the diff in the editor when it is opened, below the separator and the
385
.. information about the files that will be committed. This means that you can
386
.. read it as you write the message, but the diff itself wont be seen in the
387
.. commit message when you have finished. If you would like parts to be
388
.. included in the message you can copy and paste them above the separator.
389
390
``commit`` コマンドに ``--show-diff`` オプションをつけると、コミットされる\
391
変更の diff を見ることができます。この diff はエディタが開いたときに水平線\
392
やコミットされるファイルの情報よりも下に含まれます。
393
なので、コミットメッセージを書くときに diff を見ることができますが、\
394
コミットメッセージ自体には diff が含まれません。
395
コミットメッセージに diff を含めたい場合は、水平線より上にコピーペースト\
396
してください。
397
398
.. Selective commit
399
400
選択コミット
401
----------------
402
403
.. If you give file or directory names on the commit command line then only
404
.. the changes to those files will be committed. For example::
405
406
commit コマンドにファイル名やディレクトリ名を渡したとき、それらのファイルの\
407
変更だけがコミットされます。 例 ::
408
409
% bzr commit -m "documentation fix" commit.py
410
411
.. By default bzr always commits all changes to the tree, even if run from a
412
.. subdirectory. To commit from only the current directory down, use::
413
414
デフォルトでは bzr は、サブディレクトリから実行される場合でもすべての変更を\
415
コミットします。
416
カレントディレクトリ以下だけをコミットする場合は、次のようにします ::
417
418
% bzr commit .
419
420
421
.. Removing uncommitted changes
422
423
コミットされていない変更を削除する
424
===================================
425
426
.. If you've made some changes and don't want to keep them, use the
427
.. **revert** command to go back to the previous head version. It's a good
428
.. idea to use ``bzr diff`` first to see what will be removed. By default the
429
.. revert command reverts the whole tree; if file or directory names are
430
.. given then only those ones will be affected. ``bzr revert`` also clears the
431
.. list of pending merges revisions.
432
433
不要な変更がある場合、 **revert** コマンドで最後のリビジョンの状態に戻る\
434
ことができます。
435
revert するまえに ``bzr diff`` で何が削除されるのかを確認しておくと良いでしょう。
436
デフォルトでは revert コマンドはツリー全体を revert します。ファイル名や\
437
ディレクトリ名が指定されている場合は、そのファイルだけが revert されます。
438
``bzr revert`` はマージ待ちリビジョンのリストも削除します。
439
440
441
.. Ignoring files
442
443
ファイルを無視する
444
===================
445
446
.. The .bzrignore file
447
448
.bzrignore ファイル
449
-------------------
450
451
.. Many source trees contain some files that do not need to be versioned,
452
.. such as editor backups, object or bytecode files, and built programs. You
453
.. can simply not add them, but then they'll always crop up as unknown files.
454
.. You can also tell bzr to ignore these files by adding them to a file
455
.. called ``.bzrignore`` at the top of the tree.
456
457
多くのソースツリーはバージョン管理する必要のないファイルをたくさん含んでいます。
458
たとえば、エディタのバックアップファイルや、オブジェクトファイル、バイトコード、
459
ビルドされたプログラムなどです。
460
こういったファイルを単に add しないこともできますが、そうすると毎回 unknown file
461
としてたびたび出現することになります。
462
ツリートップにある ``.bzrignore`` とよばれるファイルにそれらのファイルを追加する\
463
ことで、bzrにそれらのファイルを無視させることができます。
464
465
.. This file contains a list of file wildcards (or "globs"), one per line.
466
.. Typical contents are like this::
467
468
このファイルは行ごとにワイルドカード (もしくは"glob") のリストを含みます。
469
典型的な内容の例です::
470
471
*.o
472
*?
473
*.tmp
474
*.py[co]
475
476
.. If a glob contains a slash, it is matched against the whole path from the
477
.. top of the tree; otherwise it is matched against only the filename. So
478
.. the previous example ignores files with extension ``.o`` in all
479
.. subdirectories, but this example ignores only ``config.h`` at the top level
480
.. and HTML files in ``doc/``::
481
482
glob がスラッシュを含む場合、ツリーのトップからのパス全体にマッチします。
483
そうでない場合は、単にファイル名にマッチします。
484
なので、上の例はすべてのサブディレクトリの ``.o`` 拡張子を持つファイルを無視\
485
しますが、次の例ではツリーのトップにある ``config.h`` ファイルと、 ``doc/``
486
ディレクトリ以下のHTMLファイルだけを無視します::
487
488
./config.h
489
doc/*.html
490
491
.. To get a list of which files are ignored and what pattern they matched,
492
.. use ``bzr ignored``::
493
494
どのファイルがどのパターンにマッチして無視されているのかを、 ``bzr ignored``
495
コマンドで表示することができます::
496
497
% bzr ignored
498
config.h ./config.h
499
configure.in? *?
500
501
.. It is OK to have either an ignore pattern match a versioned file, or to
502
.. add an ignored file. Ignore patterns have no effect on versioned files;
503
.. they only determine whether unversioned files are reported as unknown or
504
.. ignored.
505
506
バージョン管理されているファイルが無視パターンにマッチしたり無視リストに\
507
入っていても大丈夫です。無視パターンはバージョン管理されたファイルには\
508
影響しません。バージョン管理されていないファイルを 'unknown' として扱うか\
509
'ignored' として扱うかを決めるためだけに使われます。
510
511
512
.. The ``.bzrignore`` file should normally be versioned, so that new copies
513
.. of the branch see the same patterns::
514
515
``.bzrignore`` ファイルは普通はバージョン管理されます。なのでそのブランチの\
516
コピーでも同じパターンが無視されます。 ::
517
518
% bzr add .bzrignore
519
% bzr commit -m "Add ignore patterns"
520
521
522
.. Global ignores
523
524
グローバルの無視設定
525
---------------------
526
527
.. There are some ignored files which are not project specific, but more user
528
.. specific. Things like editor temporary files, or personal temporary files.
529
.. Rather than add these ignores to every project, bzr supports a global
530
.. ignore file in ``?/.bazaar/ignore`` [1]_. It has the same syntax as the
531
.. per-project ignore file.
532
533
エディタの一時ファイルや個人の一時ファイルなど、\
534
幾つかの無視ファイルはプロジェクト依存ではなくてユーザー依存です。
535
こういったファイルを全プロジェクトで無視設定するかわりに、グローバルの\
536
無視設定ファイル ``~/.bazaar/ignore`` を利用できます。
537
これはプロジェクトの ignore ファイルと同じ文法で記述します。
538
539
540
.. Examining history
541
542
履歴を閲覧する
543
===============
544
545
bzr log
546
-------
547
548
.. The ``bzr log`` command shows a list of previous revisions. The ``bzr log
549
.. --forward`` command does the same in chronological order to get most
550
.. recent revisions printed at last.
551
552
``bzr log`` コマンドは過去のリビジョンのリストを表示します。
553
``bzr log --forward`` コマンドは同じ内容を、時系列順で最新のものが最後に\
554
くるように出力します。
555
556
.. As with ``bzr diff``, ``bzr log`` supports the ``-r`` argument::
557
558
``bzr diff`` と同じように、 ``bzr log`` も ``-r`` 引数をサポートします::
559
560
% bzr log -r 1000.. # リビジョン r1000 とそれ以降すべて
561
% bzr log -r ..1000 # r1000 とそれ以前のすべて
562
% bzr log -r 1000..1100 # r1000 から r1100 まで
563
% bzr log -r 1000 # リビジョン r1000 だけ
564
565
.. % bzr log -r 1000.. # Revision 1000 and everything after it
566
.. % bzr log -r ..1000 # Everything up to and including r1000
567
.. % bzr log -r 1000..1100 # changes from 1000 to 1100
568
.. % bzr log -r 1000 # The changes in only revision 1000
569
570
571
.. Branch statistics
572
573
ブランチの情報
574
=================
575
576
.. The ``bzr info`` command shows some summary information about the working
577
.. tree and the branch history.
578
579
``bzr info`` コマンドは作業ツリーとブランチの履歴に関する情報の要約を表示します。
580
581
582
.. Versioning directories
583
584
ディレクトリをバージョン管理する
585
================================
586
587
.. bzr versions files and directories in a way that can keep track of renames
588
.. and intelligently merge them::
589
590
bzr はファイルとディレクトリを、名前の変更を追跡して賢くマージできるように\
591
バージョン管理します::
592
593
% mkdir src
594
% echo 'int main() {}' > src/simple.c
595
% bzr add src
596
added src
597
added src/simple.c
598
% bzr status
599
added:
600
src/
601
src/simple.c
602
603
604
.. Deleting and removing files
605
606
ファイルを削除する
607
===================
608
609
.. You can delete files or directories by just deleting them from the working
610
.. directory. This is a bit different to CVS, which requires that you also
611
.. do ``cvs remove``.
612
613
ファイルを削除するのは、単純に作業ツリーからファイルを削除するだけでできます。
614
これは、 ``cvs remove`` が必要な CVS とは少し異なります。
615
616
.. ``bzr remove`` makes the file un-versioned, but may or may not delete the
617
.. working copy [2]_. This is useful when you add the wrong file, or decide that
618
.. a file should actually not be versioned.
619
620
``bzr remove`` はファイルをバージョン管理対象からはずしますが、作業ツリーから\
621
削除することも削除しないこともできます。 [2]_
622
これは間違ったファイルを追加してしまったり、あるファイルをバージョン管理するのを\
623
やめる場合に便利です。
624
625
::
626
627
% rm -r src
628
% bzr remove -v hello.txt
629
? hello.txt
630
% bzr status
631
removed:
632
hello.txt
633
src/
634
src/simple.c
635
unknown:
636
hello.txt
637
638
.. If you remove the wrong file by accident, you can use ``bzr revert`` to
639
.. restore it.
640
641
もし間違ってファイルを削除してしまった場合、 ``bzr revert`` でリストアできます。
642
643
644
.. Branching
645
646
ブランチを作る
647
==============
648
649
.. Often rather than starting your own project, you will want to submit a
650
.. change to an existing project. To do this, you'll need to get a copy of
651
.. the existing branch. Because this new copy is potentially a new branch,
652
.. the command is called **branch**::
653
654
自分でプロジェクトを始めるのではなく、既存のプロジェクトに変更を加えたい場合があります。
655
この場合、既存のブランチのコピーを取得する必要があります。
656
このコピーは新しいブランチになるので、このコマンドは **branch** という名前になっています::
657
658
% bzr branch http://bazaar-vcs.org/bzr/bzr.dev
659
% cd bzr.dev
660
661
.. This copies down the complete history of this branch, so we can do all
662
.. operations on it locally: log, annotate, making and merging branches.
663
.. There will be an option to get only part of the history if you wish.
664
665
.. XXX: There will be の訳これでいい？
666
667
これでブランチの完全な履歴をコピーできたので、すべての操作 (log, annotate,
668
branch の作成とマージなど) をローカルで実行できます。
669
履歴の一部だけを取得するオプションも追加される予定です。
670
671
.. You can also get a copy of an existing branch by copying its directory,
672
.. expanding a tarball, or by a remote copy using something like rsync.
673
674
既存のブランチをコピーするには、普通にディレクトリをコピーしたり、tarballを\
675
展開したり、リモートから rsync のような方法でコピーすることもできます。
676
677
.. Following upstream changes
678
679
上流の変更を追いかける
680
==========================
681
682
.. You can stay up-to-date with the parent branch by "pulling" in their
683
changes::
684
685
変更を "pull" することで手元のブランチを上流のブランチに対して最新に保つことが\
686
できます。
687
688
% bzr pull
689
690
.. After this change, the local directory will be a mirror of the source. This
691
.. includes the ''revision-history'' - which is a list of the commits done in
692
.. this branch, rather than merged from other branches.
693
694
.. XXX This includes～がわからない.
695
696
このコマンドを実行した後、ローカルディレクトリはpull元のミラーになります。
697
ミラーするものには、 ''revision-history'' を含みます。つまり、別のブランチから\
698
マージするのではなくて、このブランチに対してコミットした履歴になります。
699
700
.. This command only works if your local (destination) branch is either an
701
.. older copy of the parent branch with no new commits of its own, or if the
702
.. most recent commit in your local branch has been merged into the parent
703
.. branch.
704
705
このコマンドはローカルの(pull先)ブランチが親ブランチの古いコピーで独自の\
706
あたらしいリビジョンを一切含まないか、ローカルブランチへの最新のコミットが\
707
親ブランチにマージされているときにのみ成功します。
708
709
.. Merging from related branches
710
711
関連ブランチからマージする
712
=============================
713
714
.. If two branches have diverged (both have unique changes) then ``bzr
715
.. merge`` is the appropriate command to use. Merge will automatically
716
.. calculate the changes that exist in the branch you're merging from that
717
.. are not in your branch and attempt to apply them in your branch.
718
719
二つのブランチが分岐している(互いに異なる変更を持っている)とき、
720
``bzr merge`` コマンドの出番です。
721
merge はマージ元ブランチにあって手元のブランチにない変更を自動で探して、\
722
その変更を手元に適用しようと試みます。
723
724
::
725
726
% bzr merge URL
727
728
729
.. If there is a conflict during a merge, 3 files with the same basename
730
.. are created. The filename of the common base is appended with ".BASE",
731
.. the filename of the file containing your changes is appended with
732
.. ".THIS" and the filename with the changes from the other tree is
733
.. appended with ".OTHER". Using a program such as kdiff3, you can now
734
.. comfortably merge them into one file. In order to commit you have to
735
.. rename the merged file (".THIS") to the original file name. To
736
.. complete the conflict resolution you must use the resolve command,
737
.. which will remove the ".OTHER" and ".BASE" files. As long as there
738
.. exist files with .BASE, .THIS or .OTHER the commit command will
739
.. report an error.
740
741
マージ中に衝突(conflict)が発生した場合、同じ基本名(basename)をもつ\
742
3つのファイルが作成されます。
743
共通の祖先になるファイルのファイル名には ".BASE" が、
744
手元のブランチの変更を含むファイル名には ".THIS" が、
745
マージ元の変更を含むファイル名には ".OTHER" が末尾に追加されます。
746
kdiff3 のようなプログラムを利用してこれらのファイルをひとつに\
747
マージすることができます。
748
コミットするには、マージされた ".THIS" ファイルを元のファイル名に\
749
リネームします。
750
衝突の解決を完了するには、 resolve コマンドを使います。
751
このコマンドは ".OTHER" と ".BASE" ファイルを削除します。
752
.BASE, .THIS, .OTHER ファイルが残っている場合、 commit コマンドは\
753
エラーを報告します。
754
755
::
756
757
% kdiff3 file.BASE file.OTHER file.THIS
758
% mv file.THIS file
759
% bzr resolve file
760
761
[**TODO**: explain conflict markers within files]
762
763
764
ブランチを公開する
765
======================
766
767
.. You don't need a special server to publish a bzr branch, just a normal web
768
.. server. Just mirror the files to your server, including the .bzr
769
.. directory. One can push a branch (or the changes for a branch) by one of
770
.. the following three methods:
771
772
bzrのブランチを公開するには特別なサーバーは必要ありません、普通のWebサーバーが\
773
使えます。
774
.bzr ディレクトリを含めてファイルをサーバーにミラーしてください。
775
ブランチをpush(やブランチに対する操作)するのに以下の3つの方法があります。
776
777
.. * The best method is to use bzr itself to do it.
778
779
* 最良の方法は bzr 自体を使うことです。
780
781
::
782
783
% bzr push sftp://servername.com/path/to/directory
784
785
.. (The destination directory must already exist unless the
786
.. ``--create-prefix`` option is used.)
787
788
(push先ディレクトリがすでに存在するか、 ``--create-prefix`` オプションを\
789
利用する必要があります。)
790
791
.. * Another option is the ``rspush`` plugin that comes with BzrTools, which
792
.. uses rsync to push the changes to the revision history and the working
793
.. tree.
794
795
* 別の選択肢は bzrtools に含まれる ``rspush`` プラグインを利用することです。
796
これはリモートの履歴と作業ツリーに変更を push するのに rsync を利用します。
797
798
.. * You can also copy the files around manually, by sending a tarball, or using
799
.. rsync, or other related file transfer methods. This is usually less safe
800
.. than using ``push``, but may be faster or easier in some situations.
801
802
* 手動で、 tarball を送ったり rsync を使ったりほかの転送方法を利用してファイルを\
803
送ることで
804
805
806
.. Moving changes between trees
807
808
変更をツリー間で移動する
809
============================
810
811
.. It happens to the best of us: sometimes you'll make changes in the wrong
812
.. tree. Maybe because you've accidentally started work in the wrong directory,
813
.. maybe because as you're working, the change turns out to be bigger than you
814
.. expected, so you start a new branch for it.
815
816
どんな人にでもありえることですが、適切ではないツリー上で変更してしまうことがあります。
817
単純に作業するディレクトリを間違えたり、変更がよそうよりも大きくなってしまったりして、
818
その変更のために新しいブランチを作りなおすことがあります。
819
820
.. To move your changes from one tree to another, use
821
822
変更をあるツリーから別のツリーに移動するには
823
824
::
825
826
% cd NEWDIR
827
% bzr merge --uncommitted OLDDIR
828
829
.. This will apply all of the uncommitted changes you made in OLDDIR to NEWDIR.
830
.. It will not apply committed changes, even if they could be applied to NEWDIR
831
.. with a regular merge. The changes will remain in OLDDIR, but you can use ``bzr
832
.. revert OLDDIR`` to remove them, once you're satisfied with NEWDIR.
833
834
これですべてのコミットされていないOLDDIR上の変更がNEWDIRに適用されます。
835
コミットされていない変更は、通常のmergeでNEWDIRに適用することができる場合でも適用されません。
836
OLDDIR上の変更はそのまま残りますが、NEWDIRの状態に満足したら ``bzr revert OLDDIR``
837
で削除することができます。
838
839
.. NEWDIR does not have to be a copy of OLDDIR, but they should be related.
840
.. The more different they are, the greater the chance of conflicts.
841
842
NEWDIRはOLDDIRのコピーである必要はありませんが、関連しているべきです。
843
両者の違いが大きければそれだけ衝突が起こる可能性が大きくなります。
Loggerhead is a web-based interface for Breezy
Version: 2.0.1