~bzr-pqm/bzr/bzr.dev : contents of doc/ja/user-guide/setting_up

~bzr-pqm/bzr/bzr.dev : (revision 6621)

4634.99.1 by Naoki INADA import doc-ja rev90	1	Eメールを設定する
	2	=================
	3
	4	.. Bazaarでコミット用のEメールを指定するさまざまな方法の説明です。
	5
	6	なぜBazaarでEメールアドレスをセットアップするのか？
	7	---------------------------------------------------
	8
	9	リビジョンが作成されたとき誰がどのリビジョンをコミットしたのかわかるように
	10	Bazaarは指定されたEメールアドレスをリビジョンに保存します。
	11	Eメールアドレスは検証されないので、それゆえ偽造できるので、プロジェクトに関わる人々を信用しなければなりません。
	12
	13	加えて、リビジョンのEメールアドレスはクレジットかつ/もしくは注釈に関してリビジョンの筆者とコンタクトをとる別の方法を提供します。
	14
	15	Eメールアドレスをセットアップする方法
	16	--------------------------------------
	17
	18	Eメールアドレスが設定されていない場合、Bazaarはユーザー名とホスト名に基づいて推測を試みます。
	19	これは望む状況ではないかもしれないので、Bazaarに使うメールを伝える方法は3つ存在します:
	20
	21	いくつかの設定ファイルの1つにEメールを設定できます。
	22	他の設定値のように、 ``bazaar.conf`` で一般的な設定として設定できます。
	23	特定のブランチ、もしくは複数のブランチの一式用に値を上書きしたい場合、 ``locations.conf`` を利用できます。
	24	``.bzr/branch/branch.conf`` も動作しますが、
	25	他の人であってもそのブランチへのすべてのコミットで同じEメールアドレスが使われます。
	26
	27	優先順位は
	28
	29	1. ``BZR_EMAIL`` 環境変数が設定されている場合
	30	#. Eメールが現在のブランチの ``locations.conf`` ファイルに対して設定されている場合。
	31	#. Eメールが現在のブランチの ``.bzr/branch/branch.conf`` ファイルに設定されている場合。
	32	#. Eメールがデフォルトの ``bazaar.conf`` 設定ファイルで設定されている場合。
	33	#. `EMAIL` 環境変数が設定されている場合
	34	#. Bazaarはユーザー名とホスト名から推測しようとします。
	35
	36	Bazaarが現在のEメールと考えるものを確認するには、 ``whoami`` ("who am i?") コマンドを使います::
	37
	38	% bzr whoami
	39	Joe Cool <joe@example.com>
5875.1.1 by INADA Naoki Update Japanese docs.	40
4634.99.1 by Naoki INADA import doc-ja rev90	41	'whoami'コマンドでEメールを設定する
	42	------------------------------------
	43
	44	Eメールをグローバルに設定するにはwhoamiコマンドを使用します::
	45
	46	% bzr whoami "Joe Cool <joe@example.com>"
	47
	48	もしくは現在のブランチのみの場合::
	49
	50	% bzr whoami --branch "Joe Cool <joe@example.com>"
	51
	52	これらのコマンドによってグローバルな ``bazaar.conf`` もしくはブランチの ``branch.conf`` ファイルがそれぞれ修正されます。
	53
	54	デフォルトの設定ファイルでEメールを設定する
	55	--------------------------------------------
	56
	57	デフォルトのiniファイルを使うには、 ``bazaar.conf`` ファイル
5875.1.1 by INADA Naoki Update Japanese docs.	58	(Unix では ``~/.bazaar/`` 、Windowsでは ``%APPDATA%\bazaar\2.0\`` )を作成し編集して
5875.1.1 by INADA Naoki Update Japanese docs.	59	下記で示すようにEメールアドレスを設定します。
4634.99.1 by Naoki INADA import doc-ja rev90	60	DEFAULTは大文字と個別を区別して、大文字でなければならないことに注意をお願いします。
	61	::
	62
	63	[DEFAULT]
	64	email=Your Name <name@isp.com>
	65
	66
5875.1.1 by INADA Naoki Update Japanese docs.	67	iniファイルのフォーマットの詳細情報に関しては、Bazaarユーザーリファレンスの
5875.1.1 by INADA Naoki Update Japanese docs.	68	`構成設定 <../user-reference/index.html#configuration-settings>`_ を参照してください。
4634.99.1 by Naoki INADA import doc-ja rev90	69
	70	ブランチ単位でEメールを設定する
	71	--------------------------------
	72
	73	2番目のアプローチは ``locations.conf`` 設定ファイルを使用してブランチごとにEメールを設定する方法です::
	74
	75	[/some/branch/location]
	76	email=Your Name <name@other-isp.com>
	77
	78	これによってブランチのEメールアドレスは ``/some/branch/location`` に設定され、
	79	上記の ``bazaar.conf`` で指定されたデフォルトの値を上書きします。
	80
	81	環境変数を通してEメールを設定する
	82	---------------------------------
	83
	84	Bazaarが利用する最後の方法は ``BZR_EMAIL`` と ``EMAIL`` 環境変数に対するチェックです。
	85	一般的に、スクリプトのコンテキストでEメールを上書きするためにこの方法を利用できます。
	86	一般的なデフォルトの値に設定したい場合、上記のiniの方法を参照して下さるようお願いします。
	87
	88	スパムに関する懸念事項
	89	-----------------------
	90
	91	スパムの標的にされないようにEメールアドレスを共有したくない人達がいます。
	92	公開された場所で自分でブランチもしくはチェンジセットを公開しない限り、BazaarはけっしてEメールアドレスを露出しません。
5875.1.1 by INADA Naoki Update Japanese docs.	93	他の人があなたに作業内容に関して連絡できるように実際のアドレスを使うことを強くお勧めしますが、必須ではありません。
4634.99.1 by Naoki INADA import doc-ja rev90	94	メールアドレスは難読にしたり、宛先がわからず戻ってくるようにする、もしくは `spamgourmet.cm` のような
4634.99.1 by Naoki INADA import doc-ja rev90	95	アンチスパムサービスの検査をうけさせたりします。