Changeset 37607 for lang/perl/Email-Address-JP-Mobile

Timestamp:

05/18/10 11:42:21 (3 years ago)

Author:

tomi-ru

Message:

Checking in changes prior to tagging of version 0.04. Changelog diff is:

Index: Changes
===================================================================
--- Changes (リビジョン 37606)
+++ Changes (作業コピー)
@@ -1,6 +1,7 @@

Revision history for Perl extension Email::Address::JP::Mobile

-0.03 Mon May 17 18:33:39 JST 2010
+0.04 Tue May 18 11:19:27 JST 2010
+ - add mime_encoding(), send_encoding(), perse_encoding()

• requires Test::More 0.94 for subtest()
  http://www.cpantesters.org/cpan/report/7141684
  

Location:

lang/perl/Email-Address-JP-Mobile/trunk

Files:

• Changes (modified) (1 diff)
• Makefile.PL (modified) (1 diff)
• lib/Email/Address/JP/Mobile.pm (modified) (10 diffs)

lang/perl/Email-Address-JP-Mobile/trunk/Changes

@@ -1 +1 @@
 Revision history for Perl extension Email::Address::JP::Mobile
 
-0.03  Mon May 17 18:33:39 JST 2010
+0.04  Tue May 18 11:19:27 JST 2010
+        - add mime_encoding(), send_encoding(), perse_encoding()
         - requires Test::More 0.94 for subtest()
           http://www.cpantesters.org/cpan/report/7141684

lang/perl/Email-Address-JP-Mobile/trunk/Makefile.PL

@@ -7 +7 @@
 requires 'Email::Address::Loose';
 requires 'Encode';
-requires 'Encode::JP::Mobile' => 0.27;
+requires 'Encode::JP::Mobile' => 0.27; # mime encodings
 
 test_requires 'Test::More' => 0.94; # subtest

lang/perl/Email-Address-JP-Mobile/trunk/lib/Email/Address/JP/Mobile.pm

@@ -3 +3 @@
 use warnings;
 use 5.008000;
-our $VERSION = '0.03';
+our $VERSION = '0.04';
 use Email::Address::Loose;
 
@@ -59 +59 @@
   $subject = $carrier->mime_encoding->encode($subject);
 
-or
+or, via Email::Address object
 
   use Email::Address::Loose;
@@ -65 +65 @@
   
   my ($email) = Email::Address::Loose->parse('docomo.taro.@docomo.ne.jp');
+  # $email is a Email::Address object
   $email->carrier->is_mobile; # => true
 
@@ -78 +79 @@
 インターフェースである点が違います。
 
-=head1 METHODS
+=head1 USAGE
 
 =over 4
@@ -92 +93 @@
   $carrier->carrier_letter; # => "I"
 
-携帯メアドではない場合は Email::Address::JP::Mobile::NonMobile クラスを返します。
+携帯のメールアドレスではないと判断した場合は Email::Address::JP::Mobile::NonMobile クラスを返します。
 
 =item $carrier = $email->carrier()
+
+Email::Address::JP::Mobile は L<Email::Address> オブジェクトに、対応したクラスを返す
+C<carrier()> というメソッドを拡張します。
 
   use Email::Address;
@@ -100 +104 @@
   my ($email) = Email::Address->parse('docomo.taro@docomo.ne.jp');
   $email->carrier->carrier_letter; # "I"
-
-Email::Address::JP::Mobile は L<Email::Address> オブジェクトに、対応したクラスを返す
-C<carrier()> というメソッドを拡張します。
 
 ご存知のように日本の携帯は変なアドレスが許可されている期間が長かったので、
@@ -110 +111 @@
 =back
 
-=head1 EMAIL CLASS METHODS
+=head1 CARRIER CLASS METHODS
 
 =over 4
@@ -135 +136 @@
   $subject = $carrier->mime_encoding->decode($subject);
 
-そのキャリア向けにメールを送信する際、絵文字を含んだ Subject などを MIME encode するためのエンコーディングを返します。
+そのキャリア向けにメールを送信する際、絵文字を含んだ Subject を MIME encode するためのエンコーディングを返します。何を返すかは下記の表を参照してください。
 
-そのキャリアから受け取ったメールの Subject などを MIME decode するためにも利用できます。ただし DoCoMo や SoftBank からの場合絵文字は最初からゲタになり取れないため通常の C<MIME-Header-ISO_2022_JP> 扱いとなります。
+そのキャリアの端末から受信したメールの Subject を MIME decode するためにも利用できます。ただし DoCoMo や SoftBank からの場合絵文字は最初からゲタになり取れないため通常の C<MIME-Header-ISO_2022_JP> 扱いとなります。
 
 =item $carrier->send_encoding()
@@ -149 +150 @@
   $body = $carrier->parse_encoding->decode($body);
 
-そのキャリアから受け取ったメールの絵文字を含んだメール本文を decode するためのオススメなエンコーディングを返します。これはメール本文の C<Content-Type> をチェックしているわけではなく、そのキャリアの場合このエンコーディングで送ってくるだろうというものを返しているだけである点に留意してください。また、DoCoMo や SoftBank からの場合絵文字は最初からゲタになり取れないため普通の C<iso-2022-jp> を返します。
+そのキャリアから受信したメールの絵文字を含んだメール本文を decode するためのオススメなエンコーディングを返します。これはメール本文の C<Content-Type> をチェックしているわけではなく、そのキャリアの場合このエンコーディングで送ってくるだろうというものを返しているだけである点に留意してください。また、DoCoMo や SoftBank からの場合絵文字は最初からゲタになり取れないため普通の C<iso-2022-jp> を返します。
 
-各メソッドが返すエンコーディングは以下のとおりです。（返すのは文字列ではなく L<Encode::Encoding> です）
+上記の各メソッドが返すエンコーディングは以下のとおりです。（返すのは文字列ではなく L<Encode::Encoding> です）
 
              mime_encoding                   send_encoding     parse_encoding
@@ -161 +162 @@
   NonMobile  MIME-Header-ISO_2022_JP         iso-2022-jp       iso-2022-jp
 
-MIME-Header-JP-Mobile-* や x-* のエンコーディングは L<Encode::JP::Mobile> が提供するエンコーディングです。
+MIME-Header-JP-Mobile-* や x-* のエンコーディングは L<Encode::JP::Mobile> （0.27以降）が提供するエンコーディングです。
 
 =back