/brz/remove-bazaar

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar

« back to all changes in this revision

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

  • Committer: John Arbash Meinel
  • Date: 2010-01-12 22:51:31 UTC
  • mto: This revision was merged to the branch mainline in revision 4955.
  • Revision ID: john@arbash-meinel.com-20100112225131-he8h411p6aeeb947
Delay grabbing an output stream until we actually go to show a diff.

This makes the test suite happy, but it also seems to be reasonable.
If we aren't going to write anything, we don't need to hold an
output stream open.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/ja/user-guide/stacked.txt
 
1
スタックブランチを利用する
 
2
==========================
 
3
 
 
4
スタックブランチとは？
 
5
-------------------------
 
6
 
 
7
スタックブランチ(stacked branch)は別のブランチのリビジョンを見つける方法を知っています。
 
8
スタックブランチはユニークなリビジョンのみを保存することで、速く作れたり\
 
9
効率的に保存したりします。
 
10
これらの観点から、スタックブランチは共用リポジトリと似ています。
 
11
しかしながら、スタックブランチは追加の利点があります:
 
12
 
 
13
* 新しいブランチはスタックされたブランチとは完全に異なる位置に設置できます。
 
14
 
 
15
* スタックブランチを削除すれば(共用リポジトリだと残ってしまう)
 
16
  本当のリビジョンも削除されます
 
17
 
 
18
* セキュリティは共用リポジトリよりも向上しています。
 
19
  スタックドオンリポジトリはスタックブランチにコミットする開発者に対して物理的にリードオンリーだからです。
 
20
 
 
21
これらの恩恵によって実験ブランチとコードホスティングサイトを含めたさまざまな\
 
22
シナリオに対してスタックブランチは理想的なものになります。
 
23
 
 
24
スタックブランチを作成する
 
25
-------------------------
 
26
 
 
27
スタックブランチを作成するには、branchコマンドの ``stacked`` オプションを使用します。
 
28
例です::
 
29
 
 
30
  bzr branch --stacked source-url my-dir
 
31
 
 
32
このコマンドによって ``my-dir`` がローカルリビジョンなしのスタックブランチ\
 
33
として作成されます。
 
34
定義されると、 ``source-url`` に関連づけされた公開ブランチは
 
35
*スタックドオン(stacked on)* の位置として使われます。
 
36
さもなければ、 ``source-url`` は *スタックドオン* の位置になります。
 
37
 
 
38
 
 
39
スタックチェックアウトを作成する
 
40
-----------------------------------
 
41
 
 
42
スタックチェックアウトを直接作成する機能はまもなくサポートされる予定です。
 
43
それまでの間、2段階の処理が必要です:
 
44
 
 
45
1. 上記で示されたようにスタックブランチを作成する。
 
46
 
 
47
2. ``reconfigure`` もしくは ``bind`` コマンドのどちらかを利用して
 
48
   ブランチをチェックアウトに変換する。
 
49
 
 
50
 
 
51
スタックブランチをプッシュする
 
52
---------------------------------
 
53
 
 
54
多くのプロジェクトの大部分の変更は
 
55
*開発トランク* or *現在の安定* ブランチといった既存のブランチを基礎としています。
 
56
これらの1つにスタックされた新しいブランチの作成は ``push`` コマンドを利用して
 
57
次のように簡単にできます::
 
58
 
 
59
  bzr push --stacked-on reference-url my-url
 
60
 
 
61
このコマンドによって ``reference-url`` にスタックされた ``my-url`` で新しいブランチが作成され
 
62
``reference-url`` でまだブランチにない現在のブランチのリビジョンのみを格納します。
 
63
 
 
64
ローカルブランチがスタックブランチとして作成された場合、
 
65
``push`` するには ``--stacked`` オプションを使うことが可能で
 
66
*stacked-on* な位置が明確になります。例です::
 
67
 
 
68
  bzr branch --stacked source-url my-dir
 
69
  cd my-dir
 
70
  (hack, hack, hack)
 
71
  bzr commit -m "fix bug"
 
72
  bzr push --stacked
 
73
 
 
74
 
 
75
スタックブランチの制限
 
76
----------------------
 
77
 
 
78
スタックブランチに関して覚えておくべき大事なことは、ほとんど全ての\
 
79
オペレーションでスタックドオンブランチが必要になることです。
 
80
これは両方のブランチがローカルもしくは同じサーバーにあるときは\
 
81
問題にはなりません。
 
82
 
 
83
スタックするブランチを変更する
 
84
-------------------------------
 
85
 
 
86
``bzr reconfigure`` コマンドを使ってスタックドオンブランチを変更したり\
 
87
スタックするのをやめたりすることができます。
 
88
``bzr reconfigure --unstacked`` を実行した場合、bzrは全ての参照されているデータを\
 
89
スタックドオンブランチからスタックされていたブランチにコピーしてくることに\
 
90
注意してください。
 
91
大きなレポジトリにおいては、これは時間がかかったりリポジトリサイズを増大\
 
92
させたりします。