= Incompatibilities from version 0.9 to 0.10

The biggest change is that return value of some
TMail::Mail methods have been changed. In TMail 0.10,
ALL "<headername>" methods return an array of address
spec strings, and ALL "<HeaderName>_addrs" methods
return an array of TMail::Address objects.
For example:

    # mail header
    To: Minero Aoki <aamine@loveruby.net>

    # from ruby
    TMail::Mail#to        ==  ["aamine@loveruby.net"]
    TMail::Mail#to_addrs  ==  [#<TMail::Address>]

In 0.9, this rule has not been thoroughed.

== Change List

* TMail::Mail#from (return value)
    0.9    first friendly-from or address spec string
    0.10   an array of address spec string for From:.
           (use friendly_from for 0.9 action)

* TMail::Mail#to (return value) 
    0.9    first Address object for To:
    0.10   an array of address spec string for To:

* TMail::Mail#fetch (argument number)
    0.9    fetch(header_name, init_string, &block)
    0.10   fetch(header_name)

* TMail's mail parser raises TMail::SyntaxError
  instead of ::ParseError in ALL situations.

== Obsolete Methods

These methods will be removed in the next version, 1.0.

* TMail::Mail#from_addr
* TMail::Mail#from_address
* TMail::Mail#from_address=
* TMail::Mail#from_phrase        (is #friendly_from)
* TMail::Mail#msgid              (is #message_id)
* TMail::Mail#msgid=             (is #message_id)
* TMail::Mail#each_dest          (is #each_destination)
* TMail::Mail#has_key?           (is #key?)
* TMail::Mail#include?           (is #key?)
* TMail::Mail#value?
* TMail::Mail#has_value?
* TMail::Mail#values
* TMail::Loader#new_mail         (is #new_port)
* TMail::Loader#each_mail        (is #each_port)
* TMail::Loader#each_newmail     (is #each_new_port)
* TMail.boundary                 (is .new_boundary)
* TMail.msgid                    (is .new_message_id)
* TMail.new_msgid                (is .new_message_id)
* TMail::Mail.boundary           (is .new_boundary)
* TMail::Mail.msgid              (is .new_message_id)
* TMail::Mail.new_msgid          (is .new_message_id)
* TMail.loadfrom                 (is .load)
* TMail.load_from                (is .load)
* TMail::Address#route           (is #routes)
