mail 2.7.1 → 2.9.1

data/lib/mail/fields/resent_from_field.rb

@@ -1,55 +1,33 @@
 # encoding: utf-8
 # frozen_string_literal: true
-# 
-# = Resent-From Field
-# 
-# The Resent-From field inherits resent-from StructuredField and handles the Resent-From: header
-# field in the email.
-# 
-# Sending resent_from to a mail message will instantiate a Mail::Field object that
-# has a ResentFromField as its field type.  This includes all Mail::CommonAddress
-# module instance metods.
-# 
-# Only one Resent-From field can appear in a header, though it can have multiple
-# addresses and groups of addresses.
-# 
-# == Examples:
-#
-#  mail = Mail.new
-#  mail.resent_from = 'Mikel Lindsaar <mikel@test.lindsaar.net>, ada@test.lindsaar.net'
-#  mail.resent_from    #=> ['mikel@test.lindsaar.net', 'ada@test.lindsaar.net']
-#  mail[:resent_from]  #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::ResentFromField:0x180e1c4
-#  mail['resent-from'] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::ResentFromField:0x180e1c4
-#  mail['Resent-From'] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::ResentFromField:0x180e1c4
-# 
-#  mail[:resent_from].encoded   #=> 'Resent-From: Mikel Lindsaar <mikel@test.lindsaar.net>, ada@test.lindsaar.net\r\n'
-#  mail[:resent_from].decoded   #=> 'Mikel Lindsaar <mikel@test.lindsaar.net>, ada@test.lindsaar.net'
-#  mail[:resent_from].addresses #=> ['mikel@test.lindsaar.net', 'ada@test.lindsaar.net']
-#  mail[:resent_from].formatted #=> ['Mikel Lindsaar <mikel@test.lindsaar.net>', 'ada@test.lindsaar.net']
-# 
-require 'mail/fields/common/common_address'
 
 module Mail
-  class ResentFromField < StructuredField
-    
-    include Mail::CommonAddress
-    
-    FIELD_NAME = 'resent-from'
-    CAPITALIZED_FIELD = 'Resent-From'
-    
-    def initialize(value = nil, charset = 'utf-8')
-      self.charset = charset
-      super(CAPITALIZED_FIELD, value, charset)
-      self
-    end
-    
-    def encoded
-      do_encode(CAPITALIZED_FIELD)
-    end
-    
-    def decoded
-      do_decode
-    end
-    
+  # = Resent-From Field
+  #
+  # The Resent-From field inherits resent-from StructuredField and handles the Resent-From: header
+  # field in the email.
+  #
+  # Sending resent_from to a mail message will instantiate a Mail::Field object that
+  # has a ResentFromField as its field type.  This includes all Mail::CommonAddress
+  # module instance metods.
+  #
+  # Only one Resent-From field can appear in a header, though it can have multiple
+  # addresses and groups of addresses.
+  #
+  # == Examples:
+  #
+  #  mail = Mail.new
+  #  mail.resent_from = 'Mikel Lindsaar <mikel@test.lindsaar.net>, ada@test.lindsaar.net'
+  #  mail.resent_from    #=> ['mikel@test.lindsaar.net', 'ada@test.lindsaar.net']
+  #  mail[:resent_from]  #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::ResentFromField:0x180e1c4
+  #  mail['resent-from'] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::ResentFromField:0x180e1c4
+  #  mail['Resent-From'] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::ResentFromField:0x180e1c4
+  #
+  #  mail[:resent_from].encoded   #=> 'Resent-From: Mikel Lindsaar <mikel@test.lindsaar.net>, ada@test.lindsaar.net\r\n'
+  #  mail[:resent_from].decoded   #=> 'Mikel Lindsaar <mikel@test.lindsaar.net>, ada@test.lindsaar.net'
+  #  mail[:resent_from].addresses #=> ['mikel@test.lindsaar.net', 'ada@test.lindsaar.net']
+  #  mail[:resent_from].formatted #=> ['Mikel Lindsaar <mikel@test.lindsaar.net>', 'ada@test.lindsaar.net']
+  class ResentFromField < CommonAddressField #:nodoc:
+    NAME = 'Resent-From'
   end
 end

data/lib/mail/fields/resent_message_id_field.rb

@@ -1,35 +1,10 @@
 # encoding: utf-8
 # frozen_string_literal: true
-# 
-# resent-msg-id   =       "Resent-Message-ID:" msg-id CRLF
-require 'mail/fields/common/common_message_id'
 
 module Mail
-  class ResentMessageIdField < StructuredField
-    
-    include CommonMessageId
-    
-    FIELD_NAME = 'resent-message-id'
-    CAPITALIZED_FIELD = 'Resent-Message-ID'
-    
-    def initialize(value = nil, charset = 'utf-8')
-      self.charset = charset
-      super(CAPITALIZED_FIELD, value, charset)
-      self.parse
-      self
-    end
-    
-    def name
-      'Resent-Message-ID'
-    end
-    
-    def encoded
-      do_encode(CAPITALIZED_FIELD)
-    end
-    
-    def decoded
-      do_decode
-    end
-    
+  #
+  # resent-msg-id   =       "Resent-Message-ID:" msg-id CRLF
+  class ResentMessageIdField < CommonMessageIdField #:nodoc:
+    NAME = 'Resent-Message-ID'
   end
 end

data/lib/mail/fields/resent_sender_field.rb

@@ -1,62 +1,32 @@
 # encoding: utf-8
 # frozen_string_literal: true
-# 
-# = Resent-Sender Field
-# 
-# The Resent-Sender field inherits resent-sender StructuredField and handles the Resent-Sender: header
-# field in the email.
-# 
-# Sending resent_sender to a mail message will instantiate a Mail::Field object that
-# has a ResentSenderField as its field type.  This includes all Mail::CommonAddress
-# module instance metods.
-# 
-# Only one Resent-Sender field can appear in a header, though it can have multiple
-# addresses and groups of addresses.
-# 
-# == Examples:
-# 
-#  mail = Mail.new
-#  mail.resent_sender = 'Mikel Lindsaar <mikel@test.lindsaar.net>, ada@test.lindsaar.net'
-#  mail.resent_sender    #=> ['mikel@test.lindsaar.net']
-#  mail[:resent_sender]  #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::ResentSenderField:0x180e1c4
-#  mail['resent-sender'] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::ResentSenderField:0x180e1c4
-#  mail['Resent-Sender'] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::ResentSenderField:0x180e1c4
-# 
-#  mail.resent_sender.to_s  #=> 'Mikel Lindsaar <mikel@test.lindsaar.net>, ada@test.lindsaar.net'
-#  mail.resent_sender.addresses #=> ['mikel@test.lindsaar.net', 'ada@test.lindsaar.net']
-#  mail.resent_sender.formatted #=> ['Mikel Lindsaar <mikel@test.lindsaar.net>', 'ada@test.lindsaar.net']
-# 
-require 'mail/fields/common/common_address'
 
 module Mail
-  class ResentSenderField < StructuredField
-    
-    include Mail::CommonAddress
-    
-    FIELD_NAME = 'resent-sender'
-    CAPITALIZED_FIELD = 'Resent-Sender'
-
-    def initialize(value = nil, charset = 'utf-8')
-      self.charset = charset
-      super(CAPITALIZED_FIELD, value, charset)
-      self
-    end
-
-    def addresses
-      [address.address]
-    end
-
-    def address
-      address_list.addresses.first
-    end
-    
-    def encoded
-      do_encode(CAPITALIZED_FIELD)
-    end
-    
-    def decoded
-      do_decode
-    end
-    
+  # = Resent-Sender Field
+  #
+  # The Resent-Sender field inherits resent-sender StructuredField and handles the Resent-Sender: header
+  # field in the email.
+  #
+  # Sending resent_sender to a mail message will instantiate a Mail::Field object that
+  # has a ResentSenderField as its field type.  This includes all Mail::CommonAddress
+  # module instance metods.
+  #
+  # Only one Resent-Sender field can appear in a header, though it can have multiple
+  # addresses and groups of addresses.
+  #
+  # == Examples:
+  #
+  #  mail = Mail.new
+  #  mail.resent_sender = 'Mikel Lindsaar <mikel@test.lindsaar.net>, ada@test.lindsaar.net'
+  #  mail.resent_sender    #=> ['mikel@test.lindsaar.net']
+  #  mail[:resent_sender]  #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::ResentSenderField:0x180e1c4
+  #  mail['resent-sender'] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::ResentSenderField:0x180e1c4
+  #  mail['Resent-Sender'] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::ResentSenderField:0x180e1c4
+  #
+  #  mail.resent_sender.to_s  #=> 'Mikel Lindsaar <mikel@test.lindsaar.net>, ada@test.lindsaar.net'
+  #  mail.resent_sender.addresses #=> ['mikel@test.lindsaar.net', 'ada@test.lindsaar.net']
+  #  mail.resent_sender.formatted #=> ['Mikel Lindsaar <mikel@test.lindsaar.net>', 'ada@test.lindsaar.net']
+  class ResentSenderField < CommonAddressField #:nodoc:
+    NAME = 'Resent-Sender'
   end
 end

data/lib/mail/fields/resent_to_field.rb

@@ -1,55 +1,33 @@
 # encoding: utf-8
 # frozen_string_literal: true
-# 
-# = Resent-To Field
-# 
-# The Resent-To field inherits resent-to StructuredField and handles the Resent-To: header
-# field in the email.
-# 
-# Sending resent_to to a mail message will instantiate a Mail::Field object that
-# has a ResentToField as its field type.  This includes all Mail::CommonAddress
-# module instance metods.
-# 
-# Only one Resent-To field can appear in a header, though it can have multiple
-# addresses and groups of addresses.
-# 
-# == Examples:
-# 
-#  mail = Mail.new
-#  mail.resent_to = 'Mikel Lindsaar <mikel@test.lindsaar.net>, ada@test.lindsaar.net'
-#  mail.resent_to    #=> ['mikel@test.lindsaar.net', 'ada@test.lindsaar.net']
-#  mail[:resent_to]  #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::ResentToField:0x180e1c4
-#  mail['resent-to'] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::ResentToField:0x180e1c4
-#  mail['Resent-To'] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::ResentToField:0x180e1c4
-# 
-#  mail[:resent_to].encoded   #=> 'Resent-To: Mikel Lindsaar <mikel@test.lindsaar.net>, ada@test.lindsaar.net\r\n'
-#  mail[:resent_to].decoded   #=> 'Mikel Lindsaar <mikel@test.lindsaar.net>, ada@test.lindsaar.net'
-#  mail[:resent_to].addresses #=> ['mikel@test.lindsaar.net', 'ada@test.lindsaar.net']
-#  mail[:resent_to].formatted #=> ['Mikel Lindsaar <mikel@test.lindsaar.net>', 'ada@test.lindsaar.net']
-# 
-require 'mail/fields/common/common_address'
 
 module Mail
-  class ResentToField < StructuredField
-    
-    include Mail::CommonAddress
-    
-    FIELD_NAME = 'resent-to'
-    CAPITALIZED_FIELD = 'Resent-To'
-    
-    def initialize(value = nil, charset = 'utf-8')
-      self.charset = charset
-      super(CAPITALIZED_FIELD, value, charset)
-      self
-    end
-    
-    def encoded
-      do_encode(CAPITALIZED_FIELD)
-    end
-    
-    def decoded
-      do_decode
-    end
-    
+  # = Resent-To Field
+  #
+  # The Resent-To field inherits resent-to StructuredField and handles the Resent-To: header
+  # field in the email.
+  #
+  # Sending resent_to to a mail message will instantiate a Mail::Field object that
+  # has a ResentToField as its field type.  This includes all Mail::CommonAddress
+  # module instance metods.
+  #
+  # Only one Resent-To field can appear in a header, though it can have multiple
+  # addresses and groups of addresses.
+  #
+  # == Examples:
+  #
+  #  mail = Mail.new
+  #  mail.resent_to = 'Mikel Lindsaar <mikel@test.lindsaar.net>, ada@test.lindsaar.net'
+  #  mail.resent_to    #=> ['mikel@test.lindsaar.net', 'ada@test.lindsaar.net']
+  #  mail[:resent_to]  #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::ResentToField:0x180e1c4
+  #  mail['resent-to'] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::ResentToField:0x180e1c4
+  #  mail['Resent-To'] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::ResentToField:0x180e1c4
+  #
+  #  mail[:resent_to].encoded   #=> 'Resent-To: Mikel Lindsaar <mikel@test.lindsaar.net>, ada@test.lindsaar.net\r\n'
+  #  mail[:resent_to].decoded   #=> 'Mikel Lindsaar <mikel@test.lindsaar.net>, ada@test.lindsaar.net'
+  #  mail[:resent_to].addresses #=> ['mikel@test.lindsaar.net', 'ada@test.lindsaar.net']
+  #  mail[:resent_to].formatted #=> ['Mikel Lindsaar <mikel@test.lindsaar.net>', 'ada@test.lindsaar.net']
+  class ResentToField < CommonAddressField #:nodoc:
+    NAME = 'Resent-To'
   end
 end

data/lib/mail/fields/return_path_field.rb

@@ -1,65 +1,60 @@
 # encoding: utf-8
 # frozen_string_literal: true
-# 
-# 4.4.3.  REPLY-TO / RESENT-REPLY-TO
-# 
-#    Note:  The "Return-Path" field is added by the mail  transport
-#           service,  at the time of final deliver.  It is intended
-#           to identify a path back to the orginator  of  the  mes-
-#           sage.   The  "Reply-To"  field  is added by the message
-#           originator and is intended to direct replies.
-# 
-# trace           =       [return]
-#                         1*received
-# 
-# return          =       "Return-Path:" path CRLF
-# 
-# path            =       ([CFWS] "<" ([CFWS] / addr-spec) ">" [CFWS]) /
-#                         obs-path
-# 
-# received        =       "Received:" name-val-list ";" date-time CRLF
-# 
-# name-val-list   =       [CFWS] [name-val-pair *(CFWS name-val-pair)]
-# 
-# name-val-pair   =       item-name CFWS item-value
-# 
-# item-name       =       ALPHA *(["-"] (ALPHA / DIGIT))
-# 
-# item-value      =       1*angle-addr / addr-spec /
-#                          atom / domain / msg-id
-# 
-require 'mail/fields/common/common_address'
 
 module Mail
-  class ReturnPathField < StructuredField
-    
-    include Mail::CommonAddress
-    
-    FIELD_NAME = 'return-path'
-    CAPITALIZED_FIELD = 'Return-Path'
-    
-    def initialize(value = nil, charset = 'utf-8')
-      value = nil if value == '<>'
-      self.charset = charset
-      super(CAPITALIZED_FIELD, value, charset)
-      self
-    end
-    
-    def encoded
-      "#{CAPITALIZED_FIELD}: <#{address}>\r\n"
-    end
-    
-    def decoded
-      do_decode
+  # 4.4.3.  REPLY-TO / RESENT-REPLY-TO
+  #
+  #    Note:  The "Return-Path" field is added by the mail  transport
+  #           service,  at the time of final deliver.  It is intended
+  #           to identify a path back to the orginator  of  the  mes-
+  #           sage.   The  "Reply-To"  field  is added by the message
+  #           originator and is intended to direct replies.
+  #
+  # trace           =       [return]
+  #                         1*received
+  #
+  # return          =       "Return-Path:" path CRLF
+  #
+  # path            =       ([CFWS] "<" ([CFWS] / addr-spec) ">" [CFWS]) /
+  #                         obs-path
+  #
+  # received        =       "Received:" name-val-list ";" date-time CRLF
+  #
+  # name-val-list   =       [CFWS] [name-val-pair *(CFWS name-val-pair)]
+  #
+  # name-val-pair   =       item-name CFWS item-value
+  #
+  # item-name       =       ALPHA *(["-"] (ALPHA / DIGIT))
+  #
+  # item-value      =       1*angle-addr / addr-spec /
+  #                          atom / domain / msg-id
+  #
+  class ReturnPathField < CommonAddressField #:nodoc:
+    NAME = 'Return-Path'
+
+    def self.singular?
+      true
     end
-    
-    def address
-      addresses.first
+
+    def initialize(value = nil, charset = nil)
+      if value == '<>'
+        super nil, charset
+      else
+        super
+      end
     end
-    
+
     def default
       address
     end
-    
+
+    private
+      def do_encode
+        "#{name}: <#{address}>\r\n"
+      end
+
+      def do_decode
+        address
+      end
   end
 end

data/lib/mail/fields/sender_field.rb

@@ -1,67 +1,45 @@
 # encoding: utf-8
 # frozen_string_literal: true
-# 
-# = Sender Field
-# 
-# The Sender field inherits sender StructuredField and handles the Sender: header
-# field in the email.
-# 
-# Sending sender to a mail message will instantiate a Mail::Field object that
-# has a SenderField as its field type.  This includes all Mail::CommonAddress
-# module instance metods.
-# 
-# Only one Sender field can appear in a header, though it can have multiple
-# addresses and groups of addresses.
-# 
-# == Examples:
-# 
-#  mail = Mail.new
-#  mail.sender = 'Mikel Lindsaar <mikel@test.lindsaar.net>'
-#  mail.sender    #=> 'mikel@test.lindsaar.net'
-#  mail[:sender]  #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::SenderField:0x180e1c4
-#  mail['sender'] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::SenderField:0x180e1c4
-#  mail['Sender'] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::SenderField:0x180e1c4
-# 
-#  mail[:sender].encoded   #=> "Sender: Mikel Lindsaar <mikel@test.lindsaar.net>\r\n"
-#  mail[:sender].decoded   #=> 'Mikel Lindsaar <mikel@test.lindsaar.net>'
-#  mail[:sender].addresses #=> ['mikel@test.lindsaar.net']
-#  mail[:sender].formatted #=> ['Mikel Lindsaar <mikel@test.lindsaar.net>']
-# 
-require 'mail/fields/common/common_address'
 
 module Mail
-  class SenderField < StructuredField
-    
-    include Mail::CommonAddress
-    
-    FIELD_NAME = 'sender'
-    CAPITALIZED_FIELD = 'Sender'
+  # = Sender Field
+  #
+  # The Sender field inherits sender StructuredField and handles the Sender: header
+  # field in the email.
+  #
+  # Sending sender to a mail message will instantiate a Mail::Field object that
+  # has a SenderField as its field type.  This includes all Mail::CommonAddress
+  # module instance metods.
+  #
+  # Only one Sender field can appear in a header, though it can have multiple
+  # addresses and groups of addresses.
+  #
+  # == Examples:
+  #
+  #  mail = Mail.new
+  #  mail.sender = 'Mikel Lindsaar <mikel@test.lindsaar.net>'
+  #  mail.sender    #=> 'mikel@test.lindsaar.net'
+  #  mail[:sender]  #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::SenderField:0x180e1c4
+  #  mail['sender'] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::SenderField:0x180e1c4
+  #  mail['Sender'] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::SenderField:0x180e1c4
+  #
+  #  mail[:sender].encoded   #=> "Sender: Mikel Lindsaar <mikel@test.lindsaar.net>\r\n"
+  #  mail[:sender].decoded   #=> 'Mikel Lindsaar <mikel@test.lindsaar.net>'
+  #  mail[:sender].addresses #=> ['mikel@test.lindsaar.net']
+  #  mail[:sender].formatted #=> ['Mikel Lindsaar <mikel@test.lindsaar.net>']
+  class SenderField < CommonAddressField #:nodoc:
+    NAME = 'Sender'
 
-    def initialize(value = nil, charset = 'utf-8')
-      self.charset = charset
-      super(CAPITALIZED_FIELD, value, charset)
-      self
+    def self.singular?
+      true
     end
 
-    def addresses
-      [address.address]
+    def default
+      address
     end
 
-    def address
-      address_list.addresses.first
-    end
-    
-    def encoded
-      do_encode(CAPITALIZED_FIELD)
-    end
-    
-    def decoded
-      do_decode
-    end
-    
-    def default
-      address.address
+    def addresses
+      Array(super.first)
     end
-    
   end
 end

data/lib/mail/fields/structured_field.rb

@@ -1,13 +1,12 @@
 # encoding: utf-8
 # frozen_string_literal: true
-require 'mail/fields/common/common_field'
 
 module Mail
   # Provides access to a structured header field
   #
   # ===Per RFC 2822:
   #  2.2.2. Structured Header Field Bodies
-  #  
+  #
   #     Some field bodies in this standard have specific syntactical
   #     structure more restrictive than the unstructured field bodies
   #     described above. These are referred to as "structured" field bodies.
@@ -20,33 +19,6 @@ module Mail
   #     characters are subject to header "folding" and "unfolding" as
   #     described in section 2.2.3.  Semantic analysis of structured field
   #     bodies is given along with their syntax.
-  class StructuredField
-    
-    include Mail::CommonField
-    include Mail::Utilities
-    
-    def initialize(name = nil, value = nil, charset = nil)
-      self.name    = name
-      self.value   = value
-      self.charset = charset
-      self
-    end
-    
-    def charset
-      @charset
-    end
-    
-    def charset=(val)
-      @charset = val
-    end
-    
-    def default
-      decoded
-    end
-    
-    def errors
-      []
-    end
-
+  class StructuredField < CommonField #:nodoc:
   end
 end

data/lib/mail/fields/subject_field.rb

@@ -1,17 +1,14 @@
 # encoding: utf-8
 # frozen_string_literal: true
-# 
-# subject         =       "Subject:" unstructured CRLF
+
 module Mail
-  class SubjectField < UnstructuredField
-    
-    FIELD_NAME = 'subject'
-    CAPITALIZED_FIELD = "Subject"
-    
-    def initialize(value = nil, charset = 'utf-8')
-      self.charset = charset
-      super(CAPITALIZED_FIELD, value, charset)
+  #
+  # subject         =       "Subject:" unstructured CRLF
+  class SubjectField < NamedUnstructuredField #:nodoc:
+    NAME = 'Subject'
+
+    def self.singular?
+      true
     end
-    
   end
 end

data/lib/mail/fields/to_field.rb

@@ -1,55 +1,33 @@
 # encoding: utf-8
 # frozen_string_literal: true
-# 
-# = To Field
-# 
-# The To field inherits to StructuredField and handles the To: header
-# field in the email.
-# 
-# Sending to to a mail message will instantiate a Mail::Field object that
-# has a ToField as its field type.  This includes all Mail::CommonAddress
-# module instance metods.
-# 
-# Only one To field can appear in a header, though it can have multiple
-# addresses and groups of addresses.
-# 
-# == Examples:
-# 
-#  mail = Mail.new
-#  mail.to = 'Mikel Lindsaar <mikel@test.lindsaar.net>, ada@test.lindsaar.net'
-#  mail.to    #=> ['mikel@test.lindsaar.net', 'ada@test.lindsaar.net']
-#  mail[:to]  #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::ToField:0x180e1c4
-#  mail['to'] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::ToField:0x180e1c4
-#  mail['To'] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::ToField:0x180e1c4
-# 
-#  mail[:to].encoded   #=> 'To: Mikel Lindsaar <mikel@test.lindsaar.net>, ada@test.lindsaar.net\r\n'
-#  mail[:to].decoded   #=> 'Mikel Lindsaar <mikel@test.lindsaar.net>, ada@test.lindsaar.net'
-#  mail[:to].addresses #=> ['mikel@test.lindsaar.net', 'ada@test.lindsaar.net']
-#  mail[:to].formatted #=> ['Mikel Lindsaar <mikel@test.lindsaar.net>', 'ada@test.lindsaar.net']
-# 
-require 'mail/fields/common/common_address'
 
 module Mail
-  class ToField < StructuredField
-    
-    include Mail::CommonAddress
-    
-    FIELD_NAME = 'to'
-    CAPITALIZED_FIELD = 'To'
-    
-    def initialize(value = nil, charset = 'utf-8')
-      self.charset = charset
-      super(CAPITALIZED_FIELD, value, charset)
-      self
-    end
-    
-    def encoded
-      do_encode(CAPITALIZED_FIELD)
-    end
-    
-    def decoded
-      do_decode
-    end
-    
+  # = To Field
+  #
+  # The To field inherits to StructuredField and handles the To: header
+  # field in the email.
+  #
+  # Sending to to a mail message will instantiate a Mail::Field object that
+  # has a ToField as its field type.  This includes all Mail::CommonAddress
+  # module instance metods.
+  #
+  # Only one To field can appear in a header, though it can have multiple
+  # addresses and groups of addresses.
+  #
+  # == Examples:
+  #
+  #  mail = Mail.new
+  #  mail.to = 'Mikel Lindsaar <mikel@test.lindsaar.net>, ada@test.lindsaar.net'
+  #  mail.to    #=> ['mikel@test.lindsaar.net', 'ada@test.lindsaar.net']
+  #  mail[:to]  #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::ToField:0x180e1c4
+  #  mail['to'] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::ToField:0x180e1c4
+  #  mail['To'] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::ToField:0x180e1c4
+  #
+  #  mail[:to].encoded   #=> 'To: Mikel Lindsaar <mikel@test.lindsaar.net>, ada@test.lindsaar.net\r\n'
+  #  mail[:to].decoded   #=> 'Mikel Lindsaar <mikel@test.lindsaar.net>, ada@test.lindsaar.net'
+  #  mail[:to].addresses #=> ['mikel@test.lindsaar.net', 'ada@test.lindsaar.net']
+  #  mail[:to].formatted #=> ['Mikel Lindsaar <mikel@test.lindsaar.net>', 'ada@test.lindsaar.net']
+  class ToField < CommonAddressField #:nodoc:
+    NAME = 'To'
   end
 end