/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/plugins.txt

  • Committer: Vincent Ladeuil
  • Date: 2012-01-18 14:09:19 UTC
  • mto: This revision was merged to the branch mainline in revision 6468.
  • Revision ID: v.ladeuil+lp@free.fr-20120118140919-rlvdrhpc0nq1lbwi
Change set/remove to require a lock for the branch config files.

This means that tests (or any plugin for that matter) do not requires an
explicit lock on the branch anymore to change a single option. This also
means the optimisation becomes "opt-in" and as such won't be as
spectacular as it may be and/or harder to get right (nothing fails
anymore).

This reduces the diff by ~300 lines.

Code/tests that were updating more than one config option is still taking
a lock to at least avoid some IOs and demonstrate the benefits through
the decreased number of hpss calls.

The duplication between BranchStack and BranchOnlyStack will be removed
once the same sharing is in place for local config files, at which point
the Stack class itself may be able to host the changes.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/ja/user-guide/plugins.txt
 
1
プラグインを利用する
 
2
=====================
 
3
 
 
4
.. Information on how to use plugins in Bazaar.
 
5
 
 
6
プラグインとは？
 
7
-----------------
 
8
 
 
9
プラグインは主にサードパーティによって作られたBazaarのための外部コンポーネントです。
 
10
プラグインは新しい機能を追加することでBazaarを補強する能力があります。
 
11
プラグインは現在の機能を置き換えることでBazaarのふるまいを変更することもできます。
 
12
プラグインのサンプルのアプリケーションは次のとおりです:
 
13
 
 
14
* コマンドをオーバーライドする
 
15
* 新しいコマンドを追加する
 
16
* 追加のネットワーク転送機能を提供する
 
17
* ログの出力をカスタマイズする
 
18
 
 
19
プラグインを通してできるカスタマイズの可能性は際限がありません。
 
20
実際、開発者が新しい機能を公式のコードベースに含める前にテストするための方法としてプラグインは機能します。
 
21
プラグインは機能の引退時でも同様に役立ちます。たとえば廃止されたファイルのフォーマットがある日Bazaarのコアから除外されるかもしれませんが\
 
22
代わりにプラグインとして利用できます。
 
23
 
 
24
プラグインはユーザーにとって、外部の開発者にとっても、Bazaar自身にもよいものです。
 
25
 
 
26
プラグインが見つかる場所
 
27
-------------------------
 
28
 
 
29
http://wiki.bazaar.canonical.com/BzrPlugins ページで
 
30
プラグインのリストが見つかります。
 
31
 
 
32
プラグインをインストールする方法
 
33
---------------------------------
 
34
 
 
35
プラグインのインストール作業はとても簡単です！　まだ作られていなければ、
 
36
Bazaarの設定ディレクトリの元で ``plugins`` ディレクトリを作ります。
 
37
Unix の場合は ``~/.bazaar/`` でWindowsの場合は
 
38
``C:\Documents and Settings\<username>\Application Data\Bazaar\2.0\`` です。
 
39
このディレクトリの範囲内では(下記では$BZR_HOMEとして言及される) それぞれのプラグインは独自のサブディレクトリに設置されます。
 
40
 
 
41
プラグインはとりわけBazaarのブランチとよく連携します。
 
42
たとえば、 GNU/Linux のメインのユーザーアカウント用に bzrtools
 
43
プラグインをインストールするためには、次のコマンドを実行します::
 
44
 
 
45
    bzr branch http://panoramicfeedback.com/opensource/bzr/bzrtools
 
46
    ~/.bazaar/plugins/bzrtools
 
47
 
 
48
プラグインをインストールするディレクトリの名前はPythonの有効な識別子でなければなりません。
 
49
このことはディレクトリは特定の文字だけを含まなければならないことを意味します。とりわけハイフン (``-``) を含んではなりません。
 
50
``bzr-gtk`` を ``$BZR_HOME/plugins/bzr-gtk`` にインストールするよりも、 ``$BZR_HOME/plugins/gtk`` にインストールします。
 
51
 
 
52
プラグインの代替用の場所
 
53
-------------------------
 
54
 
 
55
必要なパーミッションがあれば、プラグインをシステム全体のベースに
 
56
インストールすることもできます。
 
57
 
 
58
環境変数 ``BZR_PLUGIN_PATH`` をプラグインが含まれるディレクトリに
 
59
設定することで個人のプラグインの場所を上書きできます。
 
60
(詳細な解説は
 
61
`ユーザーリファレンス <../user-reference/configuration-help.html#bzr-plugin-path>`_ 
 
62
を参照してください。)
 
63
 
 
64
 
 
65
インストールされたプラグインの一覧を表示する
 
66
---------------------------------------------
 
67
 
 
68
これを行うためには、次のようにpluginsコマンドを使います::
 
69
 
 
70
    bzr plugins
 
71
 
 
72
それぞれのプラグインの名前、場所とバージョンが表示されます。
 
73
 
 
74
プラグインによって追加された新しいコマンドは ``bzr help commands`` を実行することで見ることができます。
 
75
プラグインによって提供されたコマンドはブラケットの中のプラグインの名前に従って表示されます。
 
76
 
 
77
人気のあるプラグイン
 
78
--------------------
 
79
 
 
80
次の表は人気のあるプラグインのサンプルです。
 
81
 
 
82
  ================ ================= ==================================
 
83
  カテゴリ         名前              説明
 
84
  ================ ================= ==================================
 
85
  GUI              QBzr              QtベースのGUIツール
 
86
  GUI              bzr-gtk           GTKベースのGUIツール
 
87
  GUI              bzr-eclipse       Eclipseとの統合
 
88
  General          bzrtools          その他。shelfを含めた機能の強化
 
89
  General          difftools         外部の差分ツールヘルパー
 
90
  General          extmerge          外部のマージツールヘルパー
 
91
  Integration      bzr-svn           Subversionをリポジトリとして利用する
 
92
  Migration        cvsps             CVSパッチセットを移行させる
 
93
  ================ ================= ==================================
 
94
 
 
95
あなた独自のプラグインを書きたい場合、難しいことではありません。
 
96
始めるためには付録の `プラグインを書く <writing_a_plugin.html>`_
 
97
の項目をご覧ください。