File: Incompatibilities

package info (click to toggle)
libtmail-ruby 0.10.8-2
  • links: PTS
  • area: main
  • in suites: etch, etch-m68k
  • size: 860 kB
  • ctags: 1,458
  • sloc: ruby: 8,406; ansic: 678; objc: 584; yacc: 305; makefile: 142
file content (89 lines) | stat: -rw-r--r-- 3,017 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
= 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.

== Incompatible Changes

* 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  (number of argument)
    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.

* TMail::StringPort.new  (number of argument)
    0.9    new(str, eol, unifyeol)
    0.10   new(str='')

* TMail::HeaderField#*
    Any methods of HeaderField (and its subclasses) are
    subject to change without notice. Simply do not use them,
    use TMail::Mail interface methods instead.

== Compatible Changes

These methods are compatible NOW, but is not in 1.0.

* TMail::Mail.new  (argument semantic)
    0.9    new(port, strict=false)
    0.10   new(port, configuration=TMail::DEFAULT_CONFIG)
           (use TMail::DEFAULT_CONFIG.strict_parse=true instead)

* TMail::MhLoader -> TMail::MhMailbox
* TMail::MboxLoader -> TMail::UNIXMbox
* TMail::MaildirLoader -> TMail::Maildir
    You can use old names as alias.


== Obsolete Methods

These methods are defined in tmail/obsolete.rb.
Currently TMail requires it by default, but in 1.0, it does not.

* 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 TMail.new_boundary)
* TMail::Mail.msgid              (is TMail.new_message_id)
* TMail::Mail.new_msgid          (is TMail.new_message_id)
* TMail.loadfrom                 (is .load)
* TMail.load_from                (is .load)
* TMail::Address#route           (is #routes)