← 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: John Arbash Meinel
  • Date: 2010-02-10 17:52:08 UTC
  • mfrom: (5021 +trunk)
  • mto: This revision was merged to the branch mainline in revision 5023.
  • Revision ID: john@arbash-meinel.com-20100210175208-bubuwav4uqigu291
Merge bzr.dev 5021 to resolve NEWS

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