[Python-doc-jp 1582] [ pythonjp-Bugs-4516 ] ライブラリリファレンス12.2.9 雑用ユーティリティ

[Sourceforge Tracker Monitor]

Bugs item #4516, was opened at 2004-06-23 16:04
You can respond by visiting: 
https://sourceforge.jp/tracker/?func=detail&atid=116&aid=4516&group_id=11

Category: None
Group: None
>Status: Closed
Resolution: Fixed
Priority: 5
Submitted By:  (None)
Assigned to: ymasuda (ymasuda)
Summary: ライブラリリファレンス12.2.9 雑用ユーティリティ

Initial Comment:
ver2.3のライブラリリファレンスで。

原文では
http://docs.python.org/lib/module-email.Utils.html
parseaddr(address)で
「 into its constituent realname and email address 
parts. 」
として
次のformataddr(pair)で
「 The inverse of parseaddr(), this takes a 2-tuple of 
the form (realname, email_address) 」
と、対になっているところが、

邦訳では
http://www.python.jp/pub/doc_jp/lib_2.3/module-
email.Utils.html
parseaddr(address)で
「構成部分の 実世界の名前 および 電子メールアドレス を取り出します。 」
として
次のformataddr(pair)で
「parseaddr() の逆で、これは (realname, email_address) という 
2要素のタプルを引数にとり」
のように、

realnameとemail_addressの表現がこの両メソッドの間で対応していませ
ん。

もしrealnameを日本語で表現するなら単に「名前」で十分ではないでしょうか。
その場合はformataddr()の引数も日本語で表現するのが適切ではないかと
おもいます。
または、realnameの部分は必ずしも人間の名前ではありませんので、
realnameをあまりみかけない訳である「実世界の名前」と訳すよりは、引数の
名前としてrealnameのままでも十分意味は通じるのではないでしょうか。

なお、RFC2822にはrealnameという用語はありません。その部分は
display-nameと表現されていて、email_addressではなくaddr-specと
表現されています。
(by khd)


----------------------------------------------------------------------

Comment By: ymasuda (ymasuda)
Date: 2004-06-28 13:05

Message:
Logged In: YES 
user_id=1454

librfc822.tex と対応して，realname に「実名」を当てました．
また，対応をとるため，双方の説明に \code{(realname, 
emailaddr)} を入れました．

ご指摘ありがとうございました．

Index: emailutil.tex
============================================================
=======
RCS file: /cvsroot/pythonjp/doc_jp/lib/emailutil.tex,v
retrieving revision 1.4
diff -r1.4 emailutil.tex
21,23c21,24
< \emph{実世界の名前} および \emph{電子メールアドレス} を取
り出します。
< パーズに成功した場合、これらの情報はタプルにして返されま
す。
< 失敗した場合は 2要素のタプル \code{('', '')} が返されま
す。
---
> \emph{実名} と \emph{電子メールアドレス} を取り出します。
> パーズに成功した場合、これらの情報をタプル
> \code{(realname, email_address)} にして返します。
> 失敗した場合は 2要素のタプル \code{('', '')} を返します。
27,30c28,32
< \method{parseaddr()} の逆で、これは \code{(realname, 
email_address)} という
< 2要素のタプルを引数にとり、\mailheader{To} あるいは 
\mailheader{Cc} ヘッダに
< 適した形式の文字列を返します。タプル \var{pair} の第1要素
が偽である場合、
< 第2要素の値がそのまま返されます。
---
> \method{parseaddr()} の逆で、実名と電子メールアドレスから
なる
> 2要素のタプル \code{(realname, email_address)} を引数にと
り、
> \mailheader{To} あるいは \mailheader{Cc} ヘッダに適した形
式の文字列を
> 返します。タプル \var{pair} の第1要素が偽である場合、第2要
素の値を
> そのまま返します。

----------------------------------------------------------------------

You can respond by visiting: 
https://sourceforge.jp/tracker/?func=detail&atid=116&aid=4516&group_id=11