~bzr-pqm/bzr/bzr.dev

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
=================
5分でわかるBazaar
=================

.. _introduction:

イントロダクション
===================

Bazaarは分散型バージョン管理システムで、ソフトウェアプロジェクトの共同作業を楽にしてくれます。

これから5分ほどで、ファイルをバージョン管理下に置き、変更をそれらに記録して、\
作業内容を確認し、公開して作業内容をマージしてもらうためにプロジェクトのtrunkに\
送る方法などを学びます。

詳細な紹介内容を望むのであれば、 `さらに学ぶ`_ をご覧ください。


インストール方法
=================

このガイドではBazaarをインストールする方法を説明しませんが、通常はとても簡単です。
インストール方法の手引きは次の通りです:

- **GNU/Linux:** おそらくBazaarはあなたのGNU/Linuxディストリビューションに含まれています。
- **Windows:** `Windowsのためのインストールの手引き`_.
- **Mac OS X:** `Mac OS Xのためのインストールの手引き`_.

別のプラットフォームとソースコードからインストールする方法に関しては、 ダウンロード_
と インストール方法_ のページを参照してください。

.. _Windowsのためのインストールの手引き: http://wiki.bazaar.canonical.com/WindowsDownloads
.. _Mac OS Xのためのインストールの手引き: http://wiki.bazaar.canonical.com/MacOSXBundle
.. _ダウンロード: http://wiki.bazaar.canonical.com/Download
.. _インストール方法: http://wiki.bazaar.canonical.com/InstallationFaq


まずは自己紹介
=================

作業にとりかかる前に、まずあなたが誰なのかをBazaarに教えてあげましょう。
そうすることで、履歴の中からあなたの作業を正確に識別することができます。

次のように入力してください(もちろん、あなたの名前とEメールアドレスで)::

  $ bzr whoami "John Doe <john.doe@gmail.com>"

こうするとBazaarは、あなたの名前やEメールアドレスが入った設定ファイルを作成\
もしくは修正します。

名前とEメールアドレスが正しく登録されているか確認しましょう ::

  $ bzr whoami
  John Doe <john.doe@gmail.com>


ファイルをバージョン管理する
=============================

Bazaarで扱うディレクトリといくつかのファイルを作りましょう::

 $ mkdir myproject
 $ cd myproject
 $ mkdir subdirectory
 $ touch test1.txt test2.txt test3.txt subdirectory/test4.txt

**Windowsユーザーのための注意:** Windows Explorerを使ってディレクトリを作成し、\
そのディレクトリの中で右クリックをして ``新規作成`` を選択し、ファイルを作成します。

Bazaarにあなたのプロジェクトディレクトリを初期化させましょう::

  $ bzr init

何も起きていないように見えても心配しないでください。
Bazaarはファイルとリビジョンの履歴を保存する branch_ を作りました。

.. _branch: http://wiki.bazaar.canonical.com/Branch

次のステップはBazaarに管理して欲しいファイルを教えることです。
``bzr add`` を実行するとすべてのディレクトリとファイルがプロジェクトに\
再帰的に追加されます::

 $ bzr add
 added subdirectory
 added test1.txt
 added test2.txt
 added test3.txt
 added subdirectory/test4.txt

次に、これらをブランチにコミットしてスナップショットをとります。
コミットを行った理由を説明するメッセージを追加します::

  $ bzr commit -m "Initial import"

Bazaarは分散型バージョン管理システムなので、コミットするために\
サーバーに接続する必要はありません。
代わりに、Bazaarはブランチとすべてのコミットをあなたが作業している\
ディレクトリ内部に保存します;
``.bzr`` というサブディレクトリをご覧ください。


ファイルを変更する
===================

ファイルを変更してブランチにその変更をコミットしてみましょう。

好きなエディタで ``test1.txt`` を編集し、何を行ったのかを確認します::

 $ bzr diff
 === modified file 'test1.txt'
 --- test1.txt   2007-10-08 17:56:14 +0000
 +++ test1.txt   2007-10-08 17:46:22 +0000
 @@ -0,0 +1,1 @@
 +test test test

作業をBazaarのブランチにコミットします::

  $ bzr commit -m "Added first line of text"
  Committed revision 2.


リビジョンのログを眺める
=========================

ログを閲覧することでブランチの履歴がわかります::

  $ bzr log
  ------------------------------------------------------------
  revno: 2
  committer: John Doe <john.doe@gmail.com>
  branch nick: myproject
  timestamp: Mon 2007-10-08 17:56:14 +0000
  message:
    Added first line of text
  ------------------------------------------------------------
  revno: 1
  committer: John Doe <john.doe@gmail.com>
  branch nick: myproject
  timestamp: Mon 2006-10-08 17:46:22 +0000
  message:
    Initial import


sftpでブランチを公開する
=========================

ブランチを公開する方法は複数あります。
SFTPサーバーがすでにあるもしくは容易にセットアップできるのであれば、\
ブランチをそこで公開できます。

そうでなければ、このセクションをとばして、Bazaarのための無料ホスティング\
サービスである、 Launchpad_ で公開しましょう。

.. _Launchpad: https://launchpad.net/

``www.example.com/myproject`` でブランチを公開することを前提とします::

 $ bzr push --create-prefix sftp://your.name@example.com/~/public_html/myproject
 2 revision(s) pushed.

Bazaarはリモートサーバー上で ``myproject`` ディレクトリを作りブランチを\
そこにpushします。

これで誰でも次のコマンドを入力すればあなたのブランチをコピーできます::

 $ bzr branch http://www.example.com/myproject

**注:** sftpを使うためには、 ``paramiko`` と ``pyCrypto`` をインストールする必要があります。
詳細は http://wiki.bazaar.canonical.com/InstallationFaq を参照してください。


Launchpadでブランチを公開する
==============================

Launchpadはフリーソフトウェアのための開発とホスティングのためのツールが\
ひとまとめになったものです。これをブランチを公開するために利用できます。

Launchpadのアカウントを持っていなければ、 `アカウントのサインアップのガイド`_
に従ってアカウントを作り、 `SSHキーを登録`_ してください。

.. _アカウントのサインアップのガイド: https://help.launchpad.net/CreatingYourLaunchpadAccount
.. _SSHキーを登録: https://launchpad.net/people/+me/+editsshkeys

次のコマンドを(``john.doe`` を自分のLaunchpadアカウント名に変更して)実行してください::

 $ bzr push bzr+ssh://john.doe@bazaar.launchpad.net/~john.doe/+junk/myproject

**注:** ``+junk`` はこのブランチがLaunchpad上の特定のプロジェクトに関連していないことを意味します。

これで、誰でも次のコマンドを入力することでブランチのコピーを作ることができます::

 $ bzr branch http://bazaar.launchpad.net/~john.doe/+junk/myproject

ブランチとリビジョンの履歴に関する情報は https://code.launchpad.net/people/+me/+junk/myproject
でも見ることができます。

別のブランチから自分用のコピーを作る
=====================================

他人のコードに取り組むために、ブランチのコピーを作ることができます。
実際の世界の例として、BazaarのGTKインターフェイスを見てみましょう::

  $ bzr branch http://bazaar.launchpad.net/~bzr/bzr-gtk/trunk bzr-gtk.john
  Branched 292 revision(s).

Bazaarはbzr-gtkのtrunkブランチからすべてのファイルをダウンロードして\
リビジョンの履歴をそろえ、bzr-gtk.johnというコピーを作ります。

これで、ブランチのコピーを手に入れたのでネットの接続のあるなしに\
関わらず変更をコミットできます。
ブランチはいつでも公開することで共有でき、bzr-gtkチームがあなたの作品を\
使いたいと思ったときにBazaarは彼らがあなたのブランチから彼らのブランチに\
マージし直す作業を簡単にしてくれます。


メインのブランチから自分のブランチを更新する
=============================================

変更を自分のブランチにコミットする一方で、他の人がコードを親のブランチに\
コミットしているということもよくあります。

自分のブランチを最新に維持するには、親ブランチから自分のブランチへと変更を\
マージします::

  $ bzr merge
  Merging from saved parent location: http://bazaar.launchpad.net/~bzr/bzr-gtk/trunk
  All changes applied successfully.

何が変更されたのか確認します::

  $ bzr diff

変更に満足したら、それらを自分のブランチにコミットします::

  $ bzr commit -m "Merge from main branch"
  Committed revision 295.


作業を親のブランチにマージする
==============================

bzr-gtkの個人ブランチに取り組んだ後で、あなたの変更を上流のプロジェクトに\
戻したいことがあるかもしれません。
最も簡単な方法はマージディレクティブを使うことです。

マージディレクティブ(merge directive)とは、コンピュータに特定のマージを実行\
させるためのリクエストです。
マージディレクティブは大抵、マージをレビューするためのパッチと、マージを実行する\
のに必要となるリビジョン、もしくはリビジョンを取得できるブランチを含みます。

次のコマンドの ``mycode.patch`` を適当な名前に書き換えて、マージのディレクティブを作ります::

 $ bzr send -o mycode.patch
 Using saved parent location: http://bazaar.launchpad.net/~bzr/bzr-gtk/trunk

これでbzr-gtkのプロジェクトにマージディレクティブをEメールで送ることが可能に\
なりました。彼らが納得すれば、親ブランチにマージすることができます。


さらに学ぶ
==========

Bazaarに関する詳細な内容は `Bazaarのユーザーガイド <../user-guide/index.html>`_ で調べることができます。

コマンドラインでBazaarを学ぶには::

  $ bzr help

Bazaarのコマンドを学ぶには::

  $ bzr help commands

''foo'' トピックもしくはコマンドを学ぶには::

  $ bzr help foo