← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

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

  • Committer: Patch Queue Manager
  • Date: 2011-09-22 14:12:18 UTC
  • mfrom: (6155.3.1 jam)
  • Revision ID: pqm@pqm.ubuntu.com-20110922141218-86s4uu6nqvourw4f
(jameinel) Cleanup comments bzrlib/smart/__init__.py (John A Meinel)

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/ja/user-guide/stacked.txt
1
1
スタックブランチを利用する
2
2
==========================
3
3
 
 
4
.. _motivation:
 
5
 
 
6
ユースケース
 
7
--------------
 
8
 
 
9
あるプロジェクトで作業しようとしていて、公開されているリポジトリに対して
 
10
読み込みアクセスはできるものの書き込みができないとしましょう。
 
11
公開されているリポジトリと同じホストで自分のブランチを公開したりバックアップ
 
12
したりする場合、スタックブランチを使うことができるかもしれません。
 
13
 
 
14
スタックブランチの他のユースケースとしては、実験的なブランチと、コード
 
15
ホスティングサイトが挙げられます。これらのシナリオではスタックブランチの
 
16
特性がぴったりあいます。
 
17
 
 
18
 
4
19
スタックブランチとは？
5
20
-------------------------
6
21
 
7
 
スタックブランチ(stacked branch)は別のブランチのリビジョンを見つける方法を知っています。
8
 
スタックブランチはユニークなリビジョンのみを保存することで、速く作れたり\
9
 
効率的に保存したりします。
 
22
スタックブランチ(stacked branch)は別の(スタック先)ブランチのリビジョンを
 
23
見つける方法を知っています。
 
24
スタックブランチはスタック先ブランチには存在しないユニークなリビジョンのみを
 
25
保存することで、ブランチの作成を高速にしたり、ディスク利用効率を向上します。
10
26
これらの観点から、スタックブランチは共用リポジトリと似ています。
11
27
しかしながら、スタックブランチは追加の利点があります:
12
28
 
13
29
* 新しいブランチはスタックされたブランチとは完全に異なる位置に設置できます。
14
30
 
15
31
* スタックブランチを削除すれば(共用リポジトリだと残ってしまう)
16
 
  本当のリビジョンも削除されます
 
32
  リビジョンの情報も削除されます
17
33
 
18
34
* セキュリティは共用リポジトリよりも向上しています。
19
 
  スタックドオンリポジトリはスタックブランチにコミットする開発者に対して物理的にリードオンリーだからです。
 
35
  スタック先のリポジトリはスタックブランチにコミットする開発者に対して
 
36
  物理的にリードオンリーだからです。
20
37
 
21
 
これらの恩恵によって実験ブランチとコードホスティングサイトを含めたさまざまな\
22
 
シナリオに対してスタックブランチは理想的なものになります。
23
38
 
24
39
スタックブランチを作成する
25
 
-------------------------
 
40
--------------------------
26
41
 
27
42
スタックブランチを作成するには、branchコマンドの ``stacked`` オプションを使用します。
28
43
例です::
58
73
 
59
74
  bzr push --stacked-on reference-url my-url
60
75
 
61
 
このコマンドによって ``reference-url`` にスタックされた ``my-url`` で新しいブランチが作成され
62
 
``reference-url`` でまだブランチにない現在のブランチのリビジョンのみを格納します。
 
76
このコマンドでは、 ``reference-url`` にスタックした新しいブランチを ``my-url``
 
77
に作成し、 ``reference-url`` には無いリビジョンだけをそこに格納します。
 
78
``my-url`` は ``reference-url`` と同じホストでも構いません。
 
79
 
 
80
.. The following text is hidden because bug 375013 breaks the example.
 
81
   When bug 375013 is fixed, we should unhide this text.
 
82
      - Andrew Bennetts, 10 March 2010
63
83
 
64
84
ローカルブランチがスタックブランチとして作成された場合、
65
85
``push`` するには ``--stacked`` オプションを使うことが可能で
66
 
*stacked-on* な位置が明確になります。例です::
 
86
スタック先の位置を省略できます。::
67
87
 
68
88
  bzr branch --stacked source-url my-dir
69
89
  cd my-dir
71
91
  bzr commit -m "fix bug"
72
92
  bzr push --stacked
73
93
 
 
94
この使い方は、上述したユースケースにマッチしています。
 
95
 
74
96
 
75
97
スタックブランチの制限
76
98
----------------------
77
99
 
78
100
スタックブランチに関して覚えておくべき大事なことは、ほとんど全ての\
79
 
オペレーションでスタックドオンブランチが必要になることです。
 
101
オペレーションでスタック先ブランチが必要になることです。
80
102
これは両方のブランチがローカルもしくは同じサーバーにあるときは\
81
103
問題にはなりません。
82
104
 
 
105
また、ほとんどの履歴がスタック先リポジトリに格納されているので、スタック先
 
106
リポジトリへのアクセスがネットワーク経由だった場合に ``bzr log``
 
107
のようなコマンドが遅くなるかもしれません。
 
108
 
83
109
スタックするブランチを変更する
84
110
-------------------------------
85
111