← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

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

  • Committer: Vincent Ladeuil
  • Date: 2009-04-27 16:10:10 UTC
  • mto: (4310.1.1 integration)
  • mto: This revision was merged to the branch mainline in revision 4311.
  • Revision ID: v.ladeuil+lp@free.fr-20090427161010-7swfzeagf63cpixd
Fix bug #367726 by reverting some default user handling introduced
while fixing bug #256612.

* bzrlib/transport/ssh.py:
(_paramiko_auth): Explicitly use getpass.getuser() as default
user.

* bzrlib/transport/ftp/_gssapi.py:
(GSSAPIFtpTransport._create_connection): Explicitly use
getpass.getuser() as default user.

* bzrlib/transport/ftp/__init__.py:
(FtpTransport._create_connection): Explicitly use
getpass.getuser() as default user.

* bzrlib/tests/test_sftp_transport.py:
(TestUsesAuthConfig.test_sftp_is_none_if_no_config)
(TestUsesAuthConfig.test_sftp_doesnt_prompt_username): Revert to
None as the default user.

* bzrlib/tests/test_remote.py:
(TestRemoteSSHTransportAuthentication): The really offending one:
revert to None as the default user.

* bzrlib/tests/test_config.py:
(TestAuthenticationConfig.test_username_default_no_prompt): Update
test (and some PEP8).

* bzrlib/smtp_connection.py:
(SMTPConnection._authenticate): Revert to None as the default
user.

* bzrlib/plugins/launchpad/account.py:
(_get_auth_user): Revert default value handling.

* bzrlib/config.py:
(AuthenticationConfig.get_user): Fix doc-string. Leave default
value handling to callers.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/ja/user-guide/introducing_bazaar.txt
1
 
Bazaarの紹介
2
 
=============
3
 
 
4
 
Bazaarとは？
5
 
-------------
6
 
 
7
 
Bazaarはみんなのコラボレーションを手助けするツールです。
8
 
これは(たとえばソフトウェアのソースコードなどの)ファイルのグループの変化の\
9
 
段階のスナップショットを提供するためにファイルの変更を追跡します。
10
 
この情報を利用することで、Bazaarはあなたの作業と他の人の作業の成果を簡単にマージします。
11
 
 
12
 
Bazaarのようなツールはバージョン管理ツール(version control systems: VCS)と呼ばれ\
13
 
長い間ソフトウェアの開発者の間で人気がありました。
14
 
Bazaarは使いやすく、柔軟で簡単にセットアップできるので、ソフトウェアの開発者だけでなく、\
15
 
テクニカルライター、ウェブデザイナー、翻訳者のようなファイルとドキュメントに取り組む\
16
 
人達にも理想的なツールです。
17
 
 
18
 
このガイドは、個人で使うのかチームで使うのかに関わらずBazaarのインストールと使い方の手引きをします。
19
 
すでに分散型のバージョン管理システムに慣れ親しんでおりすぐとりかかりたいのであれば、\
20
 
このセクションを流し読みして `さらに学ぶ`_ のセクションに移動するとよいでしょう。
21
 
 
22
 
バージョン管理システムの小史
23
 
-----------------------------
24
 
 
25
 
バージョン管理ツールは数十年の間に進化してきました。
26
 
簡単に説明すると、ツールは4世代に渡ります:
27
 
 
28
 
 1. ファイルのバージョン管理ツール、たとえばSCCS、RCS
29
 
 2. ファイルのバージョン管理ツール - 集中型、たとえばCVS
30
 
 3. ファイルのバージョン管理ツール - 第二世代集中型、たとえばSubversion
31
 
 4. ファイルのバージョン管理ツール - 分散型、たとえばBazaar
32
 
 
33
 
Bazaarの設計と実装は前世代のすべてのツールから学んだことに基づいています。
34
 
とりわけ、Bazaarは集中型と分散型の両方のバージョン管理モデルをサポートするので\
35
 
ツールを変更せずに複数のモデルに対応できます。
36
 
 
37
 
集中型 vs 分散型
38
 
-----------------
39
 
 
40
 
従来の多くのVCSツールはファイルのツリーに対する履歴(**リポジトリ**, *repository*)
41
 
を提供する中央サーバーが必要です。
42
 
ファイルに対する作業に取り組むために、ユーザーはサーバーに接続してファイルを\
43
 
**チェックアウト** (*checkout*) する必要があります。
44
 
チェックアウトにより、ユーザーが修正できるツリー(**作業ツリー**, *working tree*)ができます。
45
 
これらの変更を記録(**コミット**, *commit*)するためには、集中型のサーバーにアクセスする権限が必要で、\
46
 
コミットをする前に作業内容を最新バージョンとマージしなければなりません。
47
 
このアプローチは集中型モデルとして知られます。
48
 
 
49
 
集中型モデルは長期にわたって有用であることを示してきましたが顕著な欠点がいくつかあります。
50
 
先ず第一に、集中型のVCSはバージョン管理機能を利用するためにはサーバーに接続できることを要求します。
51
 
二番目に、集中型のモデルは変更の **スナップショットの記録** のふるまいと変更の **公開**
52
 
のふるまいと密接にリンクさせます。
53
 
これは状況によってはよいこともありますが別の状況では品質にわるい影響を与えることがあります。
54
 
 
55
 
分散型のVCSツールは単独の集中型のレポジトリではなく複数のレポジトリをユーザーとチームに持たせます。
56
 
Bazaarでは通常、履歴はバージョン管理されているコードと同じ場所に保存されます。
57
 
これによってユーザーは、オフラインであってもコミットするべきタイミングで変更をコミットできます。
58
 
ネットワークのアクセスは変更を公開するもしくは別の場所の変更にアクセスするときのみ求められます。
59
 
 
60
 
実際、分散型VCSツールを賢く使うことでオフライン作業を超えたいくつかの開発者にとっての利点があります。
61
 
 
62
 
 * 開発者が実験用のブランチを作るのが簡単になります
63
 
 * 仲間とのアドホックなコラボレーションが簡単になります
64
 
 * ルーチンタスクの時間が減ります - より創造的な活動に時間を割けます
65
 
 * "feature-wide" コミットの利用を通してリリース管理の柔軟性が増します
66
 
 * トランクの質と安定性を高い水準で維持でき、それによって作業者のストレスが少なくなります
67
 
 * オープンソースのコミュニティにおいて:
68
 
 
69
 
   * コア開発者ではない人が作成と変更の維持をしやすくなります
70
 
   * コア開発者が外部の開発者と共同作業をしてコアのチームに組み込むことが楽になります
71
 
 
72
 
 * 会社において、分散されたチームや外部のチームと連携するのが簡単になります
73
 
 
74
 
分散型VCSツールの集中型より優れた点の詳細な一覧に関しては、 http://wiki.bazaar.canonical.com/BzrWhy を参照してください。
75
 
 
76
 
 
77
 
Bazaarの主要な機能
78
 
-------------------
79
 
 
80
 
Bazaarは現存する唯一のVCSツールではありませんが、多くのチームとコミュニティにとって\
81
 
よい選択肢になる優れた機能をいくつか持ちます。
82
 
別のVCSツールとの比較の要約はBazaarのWiki、 http://wiki.bazaar.canonical.com/ で見つかります。
83
 
 
84
 
多くの機能の中で、とりわけ強調するものがあります:
85
 
BazaarはPythonで書かれた完全にフリーなソフトウェアです。
86
 
結果として、改善に貢献することは簡単です。
87
 
手を貸して頂けるのであれば、 http://wiki.bazaar.canonical.com/BzrSupport を参照して頂くようお願いします。
88
 
 
89
 
 
90
 
さらに学ぶ
91
 
-----------
92
 
 
93
 
このマニュアルではBazaarの簡単な紹介と効果的な使い方を提供します。
94
 
すべてのユーザーは、少なくとも次の点について書かれたこの章の残りを読むことが推奨されます:
95
 
 
96
 
 * ユーザーが知る必要のある中心的な概念を説明します
97
 
 * Bazaarを利用した人気のある方法をいくつか紹介します
98
 
 
99
 
2-6章ではさまざまなタスクを実現するためにBazaarを使う方法を詳しく説明します。
100
 
Bazaarを使い始めた後で最初から最後まで読むことをほとんどの方にお勧めします。
101
 
7章とそれ以降はコアの機能を理解した上でBazaarを利用する際に手助けになる追加情報を提供します。
102
 
この教材は必要なときに任意の順番で読むことができます。
103
 
 
104
 
すでに他のバージョン管理ツールに慣れ親しんでいるのであれば、次のドキュメントを読んですぐに始めるとよいでしょう:
105
 
 
106
 
 * 5分でBazaar_ - ミニチュートリアル
107
 
 * Bazaarクィックスタートカード_ - よく使われるコマンドを1ページにまとめた要約。
108
 
 
109
 
加えて、オンラインのヘルプと `Bazaarユーザーリファレンス`_
110
 
は利用可能なコマンドとオプションのすべての詳細を提供します。
111
 
 
112
 
.. _5分でBazaar: ../mini-tutorial/index.html
113
 
.. _Bazaarクィックスタートカード: ../quick-reference/quick-start-summary.svg
114
 
.. _Bazaarユーザーリファレンス: ../user-reference/bzr_man.html
115
 
 
116
 
このマニュアルがお役に立てることを願っております。Bazaarの残りのドキュメントの改善を提案したいのであれば、
117
 
メーリングリスト(bazaar@lists.canonical.com)に連絡して頂けるようお願いします。