README.md in mail_address-1.1.2 vs README.md in mail_address-1.2.0

- old
+ new

@@ -1,23 +1,23 @@ # MailAddress [![Build Status](https://travis-ci.org/kizashi1122/mail_address.svg)](https://travis-ci.org/kizashi1122/mail_address) [![Coverage Status](https://coveralls.io/repos/kizashi1122/mail_address/badge.png)](https://coveralls.io/r/kizashi1122/mail_address) -MailAddress is a simple email address parser. -This library is implemented based on Perl Module Mail::Address and added some improvements. +MailAddress is a port of Mail::Address from Perl. -[mail](https://github.com/mikel/mail) is a great gem library. But some email addresses (mostly are violated RFC) are unparsable with mail gem which is strictly RFC compliant. In perl, [Mail::Address](http://search.cpan.org/~markov/MailTools-2.14/lib/Mail/Address.pod) is a very common library to parse email address. Mail::Address conviniently can parse even RFC-violated email addresses such as: +[mail](https://github.com/mikel/mail) is a great gem library. But some email addresses are unparsable with it. In perl, [Mail::Address](http://search.cpan.org/~markov/MailTools-2.14/lib/Mail/Address.pod) is a very common library to parse an email address. Mail::Address conviniently can parse even NOT RFC-compliant email addresses such as: ```rb # mail gem cannot parse the following addresses Ello [Do Not Reply] <do-not-reply@ello.co> # [, ] are not permitted according to RFC5322 -大阪 太郎<osaka@example.com> # no whitespace just before < +大阪 太郎<osaka@example.com> # no whitespace just before `<` ``` +But Mail::Address has some bad points (below). These are fixed in MailAddress. -So I straightforwardly converted Perl module Mail::Address to Ruby gem. Then I reviced it because original Mail::Address also has some bad points. For example: - - if no ending parenthesis in name part, cannot parse correctly. - Modifications of name part are too much. +However, MailAddress module cannnot parse whitespace-separated addresses. +Many people could paste email addresses from Excel or the other spreadsheets. To accomplish this, also ported from a parser part of [Google Closure Library](https://github.com/google/closure-library/blob/master/closure/goog/format/emailaddress.js). ## Installation Add this line to your application's Gemfile: @@ -58,10 +58,10 @@ p addrs[1].phrase # "大阪 太郎" p addrs[1].host # "example.jp" p addrs[1].user # "osaka" p addrs[1].original # "大阪 太郎 <osaka@example.jp>" ``` -`address.name` and `address.phrase` are almost same. +`address.name` and `address.phrase` are almost same. `address.phrase` keeps outermost double quotes or parentheses. ## Contributing 1. Fork it ( https://github.com/[my-github-username]/mail_address/fork )