Commit: 248e76e81e5745e9a9f435a3bd54b89e6f71af0c - msmtp_doc_ja (git)

Commit MetaInfo

• Revision: 248e76e81e5745e9a9f435a3bd54b89e6f71af0c (tree)
• Time: 2011-03-20 23:02:16
• Author: akngw <akngw@user...>
• Commiter: akngw

Log Message

クロスリファレンスの部分を書き直し。

Change Summary

• modified: msmtp.texi

Incremental Difference

--- a/msmtp.texi
+++ b/msmtp.texi
@@ -146,7 +146,7 @@ msmtp は、システム全体用の設定ファイルと個々のユーザ用
 @item account @var{name} [: @var{account}[,@dots{}]]
 @cmindex account
 指定された名前の新しいアカウント定義を開始します。
-現在のデフォルト値がそれぞれ設定されます (参照 @ref{defaults})。
+現在のデフォルト値がそれぞれ設定されます (@pxref{defaults})。
 アカウント名の後に、コロン一つと、そこまでで定義済みのアカウントのリストが指定された場合は、新しいアカウントは、デフォルト値が設定された上で、リストに現れるアカウントの設定をすべて継承します。
 @anchor{host}
 @item host @var{hostname}
@@ -177,7 +177,7 @@ LMTP の場合は "lmtp" です。
 使用するプロトコルを設定します。
 現在は、SMTP と LMTP だけをサポートしています。
 SMTP がデフォルト値です。
-デフォルトのポートについては @ref{port} を参照してください。
+デフォルトのポートについては別のセクションを参照してください(@pxref{port})。
 @anchor{domain}
 @item domain @var{argument}
 @cmindex domain
@@ -256,7 +256,7 @@ Debian ベースのシステムでは、@samp{ca-certificates} パッケージ
 @item tls_crl_file [@var{file}]
 @cmindex tls_crl_file
 このコマンドは、TLS の失効証明書リスト (CRL:Certificate Revocation List) のファイルを設定したり、未設定にしたりします。
-このファイルは、@ref{tls_trust_file} コマンドで厳密なサーバ証明書の検証を有効にしたりしたような場合に、その検証の間に使われます。
+このファイルは、tls_trust_file コマンド (@pxref{tls_trust_file}) で厳密なサーバ証明書の検証を有効にしたりしたような場合に、その検証の間に使われます。
 このコマンドにより、失効した証明書を検出する検証手続きが可能になります。
 @xref{Transport Layer Security}.
 @anchor{tls_fingerprint}
@@ -332,9 +332,9 @@ envelope-from アドレスを自動で付加する機能を有効または無効
 デフォルトは @samp{off} です。@*
 有効の場合、user@@domain 形式の envelope-from アドレスを生成します。
 ローカル部分は @code{USER} に設定されますが、それに失敗すると、@code{LOGNAME} に設定され、またそれも失敗すると、現在のユーザのログイン名に設定されます。
-ドメイン部分は @samp{maildomain} コマンドで設定できます (@ref{maildomain} を参照)。
+ドメイン部分は @samp{maildomain} コマンドで設定できます (@pxref{maildomain})。
 maildomain が空の場合は、ドメイン部分を持たず、ユーザ名だけで envelope-from アドレスを構成します。@*
-この機能が無効の場合、envelope-from アドレスは @samp{from} コマンドで明示されなければなりません (@ref{from} を参照)。@*
+この機能が無効の場合、envelope-from アドレスは @samp{from} コマンドで明示されなければなりません (@pxref{from})。@*
 @xref{Envelope-from address}.
 @anchor{from}
 @item from [@var{address}]
@@ -373,7 +373,8 @@ envelope-from アドレスの生成の際のドメイン部分を設定します
 @item keepbcc [(on|off)]
 @cmindex keepbcc
 このコマンドは、メール送信の際に、Bcc ヘッダを削除するのか残すのかを制御します。
-デフォルトでは Bcc ヘッダを削除します。@xref{Bcc header}.
+デフォルトでは Bcc ヘッダを削除します。
+@xref{Bcc header}.
 @anchor{logfile}
 @item logfile [@var{file}]
 @cmindex logfile
@@ -460,7 +461,7 @@ SMTP サーバに関する情報を表示して終了します。
 
 @subsection 設定オプション
 このカテゴリのオプションの大半は設定ファイルのコマンドに対応します。
-詳細は、@ref{Configuration files} を参照してください。
+@xref{Configuration files}.
 @table @samp
 @item -C @var{filename}
 @itemx --file=@var{filename}
@@ -473,43 +474,51 @@ SMTP サーバに関する情報を表示して終了します。
 @opindex --account
 @samp{default} という名前のアカウントの代わりに指定されたアカウントを使います。
 このオプションは @samp{--host} オプションと一緒に使うことはできません。
-@xref{アカウントの選択}.
+@xref{Choosing an account}.
 @itemx --host=@var{hostname}
 @opindex --host
 コマンドラインからの設定でこの SMTP サーバを使います。
 設定ファイルのデータはいずれも使いません。
 このオプションは @samp{--account} オプションと一緒に使うことはできません。
 設定ファイルの読み込みはしないようになります。
-@xref{アカウントの選択}.
+@xref{Choosing an account}.
 @itemx --port=@var{number}
 @opindex --port
-接続するポート番号を設定します。@xref{port}.
+接続するポート番号を設定します。
+@xref{port}.
 @itemx --timeout=(off|@var{seconds})
 @opindex --timeout
-ネットワークタイムアウトを設定します。@xref{timeout}.
+ネットワークタイムアウトを設定します。
+@xref{timeout}.
 古いバージョンとの互換性のために、このオプションの別名として、@samp{--connect-timeout} を受け付けます。
 @itemx --protocol=(smtp|lmtp)
 @opindex --protocol
-プロトコルを設定します。@xref{protocol}.
+プロトコルを設定します。
+@xref{protocol}.
 @itemx --domain=[@var{argument}]
 @opindex --domain
-SMTP EHLO (または LMTP LHLO) コマンドの引数を設定します。@xref{domain}.
+SMTP EHLO (または LMTP LHLO) コマンドの引数を設定します。
+@xref{domain}.
 @anchor{--auth}
 @itemx --auth[=(on|off|@var{method})]
 @opindex --auth
 認証を有効にしたり無効にしたりします。
-認証方法を選択することもできます。@xref{auth}.
+認証方法を選択することもできます。
+@xref{auth}.
 @anchor{--user}
 @itemx --user=[@var{username}]
 @opindex --user
-認証に使うユーザ名を設定したり解除したりします。@xref{user}.
+認証に使うユーザ名を設定したり解除したりします。
+@xref{user}.
 @anchor{--passwordeval}
 @itemx --passwordeval=[@var{eval}]
 @opindex --passwordeval
-認証に使うパスワードを評価します。@xref{passwordeval}.
+認証に使うパスワードを評価します。
+@xref{passwordeval}.
 @itemx --tls[=(on|off)]
 @opindex --tls
-TLS/SSL を有効にしたり無効にしたりします。@xref{tls}.
+TLS/SSL を有効にしたり無効にしたりします。
+@xref{tls}.
 @anchor{--tls-starttls}
 @itemx --tls-starttls[=(on|off)]
 @opindex --tls-starttls
@@ -550,7 +559,8 @@ TLS 暗号化に対して、サーバ証明書のチェックを有効にした
 @anchor{--tls-force-sslv3}
 @itemx --tls-force-sslv3[=(on|off)]
 @opindex --tls-force-sslv3
-TLS/SSL のバージョンを強制的に SSLv3 にします。@xref{tls_force_sslv3}.
+TLS/SSL のバージョンを強制的に SSLv3 にします。
+@xref{tls_force_sslv3}.
 @anchor{--tls-min-dh-prime-bits}
 @itemx --tls-min-dh-prime-bits=[@var{bits}]
 @opindex --tls-min-dh-prime-bits
@@ -559,7 +569,8 @@ Diffie-Hellman (DH) 素数のビットサイズの最小値を設定したり未
 @anchor{--tls-priorities}
 @itemx --tls-priorities=[@var{priorities}]
 @opindex --tls-priorities
-TLS プライオリティを設定したり未設定にしたりします。@xref{tls_priorities}.
+TLS プライオリティを設定したり未設定にしたりします。
+@xref{tls_priorities}.
 @end table
 
 @subsection sendmail モード特有のオプション
@@ -580,39 +591,45 @@ envelope-from アドレスを設定します。
 @xref{from}.@*
 (@samp{--account} や @samp{--host} で) アカウントが未選択だった場合、このオプションは指定された envelope-from アドレスを持つ (@samp{from} コマンドで設定されている) 最初のアカウントを選択します。
 そのようなアカウントが見つからなければ "default" を使います。
-@xref{アカウントの選択}.
+@xref{Choosing an account}.
 @anchor{--maildomain}
 @itemx --maildomain=[@var{domain}]
 @opindex --maildomain
 生成される envelope-from アドレスのドメイン部分を設定します。
-@samp{auto_from} が on のときにだけ使います。@xref{maildomain}.
+@samp{auto_from} が on のときにだけ使います。
+@xref{maildomain}.
 @anchor{--dsn-notify}
 @item -N (off|@var{condition})
 @itemx --dsn-notify=(off|@var{condition})
 @opindex -N
 @opindex --dsn-notify
-DSN 通知の条件を設定したり未設定にしたりします。@xref{dsn_notify}.
+DSN 通知の条件を設定したり未設定にしたりします。
+@xref{dsn_notify}.
 @anchor{--dsn-return}
 @item -R (off|@var{amount})
 @itemx --dsn-return=(off|@var{amount})
 @opindex -R
 @opindex --dsn-return
-DSN 通知の分量を設定したり未設定にしたりします。@xref{dsn_return}.
+DSN 通知の分量を設定したり未設定にしたりします。
+@xref{dsn_return}.
 sendmail と互換にするために、@samp{headers} の別名として @samp{hdrs} を受け付けることに注意してください。
 @anchor{--keepbcc}
 @itemx --keepbcc[=(on|off)]
 @opindex --keepbcc
-Bcc ヘッダの保存を有効にしたり無効にしたりします。@xref{keepbcc}.
+Bcc ヘッダの保存を有効にしたり無効にしたりします。
+@xref{keepbcc}.
 @anchor{--logfile}
 @item -X [@var{file}]
 @itemx --logfile=[@var{file}]
 @opindex -X
 @opindex --logfile
-ログファイルを設定したり未設定にしたりします。@xref{logfile}.
+ログファイルを設定したり未設定にしたりします。
+@xref{logfile}.
 @anchor{--syslog}
 @itemx --syslog[=(on|off|@var{facility})]
 @opindex --syslog
-syslog によるロギングを有効にしたり無効にしたりします。@xref{syslog}.
+syslog によるロギングを有効にしたり無効にしたりします。
+@xref{syslog}.
 @item -t
 @itemx --read-recipients
 @opindex -t
@@ -633,7 +650,7 @@ sendmail との互換性のため、次のオプションは受け付けます
 @samp{-O option=@var{value}}, @samp{-ox @var{value}}
 
 
-@anchor{アカウントの選択}
+@anchor{Choosing an account}
 @section アカウントの選択
 
 使用するアカウントを選択する方法は三つあります。
@@ -708,7 +725,7 @@ SMTP サーバは TLS を、次の二つのうち一つの方法で使うこと
 SMTP のセッションは通常通り始めますが、クライアントが、TLS による暗号化を始めたい時に STARTTLS コマンドを送信します。
 このモードのデフォルトポートは SMTP のデフォルトポートの 25 (smtp) です。
 @end itemize
-msmtp では、@samp{tls_starttls} コマンド (@ref{tls_starttls} 参照) や @samp{--tls-starttls} オプション (@ref{--tls-starttls} 参照) でこの二つのモードを切り換えることができます。
+msmtp では、@samp{tls_starttls} コマンド (@pxref{tls_starttls}) や @samp{--tls-starttls} オプション (@pxref{--tls-starttls}) でこの二つのモードを切り換えることができます。
 
 TLS が開始すると、サーバは、サーバ自体を識別するための証明書を送信します。
 この証明書には、証明書所有者、証明書発行者、証明書発行日、証明書有効期限に関する情報が含まれています。
@@ -717,7 +734,7 @@ TLS が開始すると、サーバは、サーバ自体を識別するための
 
 TLS を使うには、@samp{tls_trust_file} コマンドか @samp{--tls-trust-file} オプションを使って完全なサーバ証明書の検証を行うようにするか、あるいは、ある特定のピア証明書を @samp{tls_fingerprint} コマンドか @samp{--tls-fingerprint} オプションを用いて信頼するか、またあるいは、@samp{tls_certcheck off} か @samp{--tls-certcheck=off} を使って全ての証明書検証を無効にするかのいずれかを行なう必要があります。
 警告: 証明書の検証を無効にした場合、TLS/SSL のセッションは中間者攻撃に対して脆弱になります！
-@ref{tls_trust_file}、@ref{--tls-trust-file}、@ref{tls_certcheck}、@ref{--tls-certcheck} を参照。
+@xref{tls_trust_file}, @ref{--tls-trust-file}, @ref{tls_certcheck}, and @ref{--tls-certcheck}.
 
 あなたのシステムが、システム全体で信頼できる認証局の証明書を全て集めたファイルを用意しているならば、設定ファイルの @samp{defaults} セクションでこのファイルをただ使うのが最も簡単です。
 Debian ベースのシステムの場合、例えば、@samp{tls_trust_file /etc/ssl/certs/ca-certificates.crt} というコマンドを記述すれば間に合うでしょう。
@@ -739,13 +756,13 @@ $ msmtp --serverinfo --host=smtp.example.com --tls=on \
 
 サーバが要求した場合は、クライアントが証明書を送ることもできます。
 これによりサーバはクライアントの身元を確認することができます。
-@ref{Authentication} にある EXTERNAL の仕組みを参照してください。
+別のセクションにある EXTERNAL の仕組みを参照してください (@pxref{Authentication})。
 クライアント証明書を設定するのに、@samp{tls_key_file}/@samp{tls_cert_file} コマンドあるいは@samp{--tls-key-file}/@samp{--tls-cert-file} オプションを使うことができます。
-@ref{tls_key_file}/@ref{--tls-key-file}、@ref{tls_cert_file}/@ref{--tls-cert-file} を参照してください。
+@xref{tls_key_file}/@ref{--tls-key-file}, and @ref{tls_cert_file}/@ref{--tls-cert-file}.
 注意が必要ですが、GnuTLS は、サーバが通知してきた認証局の一つと一致したときにだけ、クライアント証明書を送信します。
 クライアント証明書を設定したのにサーバに送信されないときは、恐らく、その証明書が、サーバが信頼している認証局から発行されたものではなかったからでしょう。
 
-TLS のパラメータを微調整する必要があったり、サーバとの接続に問題があったりする場合は、@ref{tls_force_sslv3}、@ref{tls_min_dh_prime_bits}、@ref{tls_priorities} コマンドを見てください。
+TLS のパラメータを微調整する必要があったり、サーバとの接続に問題があったりする場合は、tls_force_sslv3 コマンド、tls_min_dh_prime_bits コマンド、tls_priorities コマンドを見てください (@pxref{tls_force_sslv3}, @ref{tls_min_dh_prime_bits}, and @ref{tls_priorities})。
 
 
 @node Authentication
@@ -785,7 +802,8 @@ Kerberos フレームワークが安全な認証を引き受けますので、
 @item @samp{EXTERNAL}@*
 この方法は特別な認証方法です:
 実際の認証は SMTP プロトコルの外側で行われます。
-通常、TLS クライアント証明書を送信することによって行なわれます。 (@xref{Transport Layer Security}.)@*
+通常、TLS クライアント証明書を送信することによって行なわれます。
+@xref{Transport Layer Security}.@*
 EXTERNAL の方法は、指定されたユーザで認証が成功することをただ確認するだけです (ユーザ名が与えられなければ、認証が成功したことを確認します@footnote{訳注: いまいち意味不明だけども。とにかく成功したことを確認するということか})。
 ですので、認証の為にこの方法を使う必要は無いかもしれませんし、サーバが EXTERNAL の方法をサポートしていなくても、このことが TLS のクライアント証明書による認証をサポートしていないということを意味するわけではありません。@*
 この認証方法は自動では選択されませんので、手動で設定する必要があります。@*
@@ -797,7 +815,7 @@ sendmail 8.12.11 は、TLS クライアント証明書が送信された後 EXTE
 ユーザ名とパスワードが必要で、ともに BASE64 エンコーディングで送信され、簡単にプレインテキストに復号できます。
 @item @samp{NTLM}@*
 これは、標準的でない、わかりにくい認証方法です。
-ユーザ名とパスワードが必要で、場合によって、特別なドメインパラメータが必要となります (@ref{ntlmdomain} を見よ) 。
+ユーザ名とパスワードが必要で、場合によって、特別なドメインパラメータが必要となります (@pxref{ntlmdomain}) 。
 認証データがプレインテキストで送信されることはありませんが、NTLM がオープンスタンダードではありませんので、不完全で安全でないとみなすべきです。
 @end itemize
 
@@ -806,7 +824,7 @@ sendmail 8.12.11 は、TLS クライアント証明書が送信された後 EXTE
 
 認証に使うデータは @samp{user} と @samp{password} コマンドで設定できます。
 あるいは @samp{--user} オプションを使ってください。
-@ref{user}、@ref{password}、@ref{--user} を見てください。
+@xref{user}, @ref{password}, and @ref{--user}.
 もしパスワードが設定されていなくて、認証中にパスワードが必要となった場合
 には、msmtp はパスワードを探します。
 まず、@samp{passwordeval} が設定されていれば、そのコマンドを評価します。
@@ -821,7 +839,8 @@ Mac OS X キーチェインのパスワードを管理するには、Keychain Ac
 @samp{account name}は msmtp の @samp{user} 引数と同じです。
 @samp{keychain item name} は @code{smtp://<hostname>} で、ここで、@code{<hostname>} は msmtp の @samp{host} 引数と対応します。
 
-認証方法は @samp{auth} コマンドか @samp{--auth} オプションで選択できますが、@samp{on} 引数を使って msmtp に認証方法を選択させるだけで通常は十分です。@ref{auth}、@ref{--auth} を見てください。
+認証方法は @samp{auth} コマンドか @samp{--auth} オプションで選択できますが、@samp{on} 引数を使って msmtp に認証方法を選択させるだけで通常は十分です。
+@xref{auth}, and @ref{--auth}.
 
 msmtp が認証方法を選択する場合、決して安全でない方法は選択しません。
 TLS が有効な場合 サーバへの接続は TLS によって保護されているので、このコンテキストでの認証方法は全て安全だとみなされます。
@@ -843,12 +862,12 @@ SMTP サーバが DSN 拡張をサポートしていなければなりません
 まず最初のパラメータは、いつそういったメッセージが生成されるべきかを制御します。
 全く生成しないか、配送失敗の時、あるいは、遅配の時、成功した時などです。
 これは @samp{dsn_notify}/@samp{--dsn-notify} で設定できます。
-@ref{dsn_notify}/@ref{--dsn-notify} を参照してください。
+@xref{dsn_notify}/@ref{--dsn-notify}.
 
 次のパラメータは DSN メッセージに元のメールをどの程度含めるかということを制御するものです。
 ヘッダだけ、あるいは、メール全てとなります。
 これは @samp{dsn_return}/@samp{--dsn-return} で設定できます。
-@ref{dsn_return}/@ref{--dsn-return} を参照してください。
+@xref{dsn_return}/@ref{--dsn-return}.
 注意が必要ですが、このパラメータは、少なくとも一つの受信者に対して配送失敗を通知する DSN に対して適用されるものです。
 もし DSN が配送失敗の通知を含まないのであれば、メッセージのヘッダだけが返されます。
 
@@ -869,11 +888,11 @@ SMTP サーバは、メールそれぞれに送信者のメールアドレスが
 このアドレスは、(メールそのものではなくメールの@emph{エンベロープ}の一部ですので) From ヘッダとは依存関係はありませんが、ほとんどの場合両方とも同じアドレスになります。
 
 envelope-from アドレスは、(@samp{auto_from} が @samp{auto_from} コマンドや @samp{--auto-from} オプションで有効になっている場合) 自動的に生成することができますし、また、@samp{from} コマンドや @samp{--from} オプションで明示的に設定することもできます。
-@ref{auto_from}、@ref{from} を参照してください。
+@xref{auto_from}, and @ref{from}.
 
 @samp{auto_from} が有効であれば、user@@domain 形式の envelope-from アドレスを生成します。
 ローカル部分は @code{USER} に設定しますが、それに失敗すると @code{LOGNAME} に設定し、またそれに失敗すると現在のユーザのログイン名に設定します。
-ドメイン部分は、@samp{maildomain} コマンドや @samp{--maildomain} オプションで設定します (@ref{maildomain} を参照)。
+ドメイン部分は、@samp{maildomain} コマンドや @samp{--maildomain} オプションで設定します (@pxref{maildomain})。
 maildomain が空の場合、envelope-from アドレスはユーザ名だけとなり、ドメイン部分を持ちません。
 
 @node Logging
@@ -899,10 +918,10 @@ maildomain が空の場合、envelope-from アドレスはユーザ名だけと
 @end itemize
 
 ログファイルが @samp{logfile} コマンドや @samp{--logfile} オプションで指定されていれば、このログ出力行を、現在日時を前に付けて、指定ファイルの最後に追加して出力します。
-@ref{logfile}、@ref{--logfile} を参照してください。
+@xref{logfile}, and @ref{--logfile}.
 
 syslog によるロギングが @samp{syslog} コマンドや @samp{--syslog} オプションで有効にされている場合は、指定ファシリティで syslog のサービスにログ出力が引き渡されます。
-@ref{syslog}、@ref{--syslog} を参照してください。
+@xref{syslog}, and @ref{--syslog}.
 
 @node Bcc header
 @section Bcc ヘッダ
@@ -910,7 +929,7 @@ syslog によるロギングが @samp{syslog} コマンドや @samp{--syslog} 
 msmtp は SMTP サーバに無変更のままのメールを渡しますが、一つ例外があります:
 Bcc ヘッダが送信前に削除されます。
 この動作は @samp{keepbcc} コマンドと @samp{--keepbcc} オプションで変更することができます。
-@ref{keepbcc}/@ref{--keepbcc} を参照してください。
+@xref{keepbcc}/@ref{--keepbcc}.
 
 @node Server information mode
 @chapter サーバ情報モード
@@ -975,7 +994,7 @@ Remote Message Queue Starting (RMQS) は RFC 1985 で定義されています。
 msmtp はリクエストを送ることができるだけです (ETRN SMTP コマンドを使用)。
 クライアント側のメールサーバは、その時、メールを受け取るためリモートの SMTP サーバの接続を受け入れなければなりません。
 
-RMQS リクエストは、@samp{--rmqs} オプションを使って送信することができます (@ref{--rmqs} 参照)。
+RMQS リクエストは、@samp{--rmqs} オプションを使って送信することができます (@pxref{--rmqs})。
 RFC 1985 で定義されている配送先は次の通り:
 @itemize
 @item @var{host}@*
@@ -1078,7 +1097,7 @@ set sendmail="/path/to/msmtp -a my_account"
 @example
 set sendmail="/path/to/msmtp --host=mailhub -f me@@example.com --tls"
 @end example
-@xref{アカウントの選択}.
+@xref{Choosing an account}.
 
 msmtp の設定ファイルに複数のアカウントがあって、その一つを選択するために Mutt の @option{-f} オプションを使う場合、以下を Mutt の設定ファイルに加えることで Mutt のアカウントを簡単に切り替えることができます:
 @example