NAME
    Mail::Field::AddrList - object representation of e-mail address lists

DESCRIPTION
    *Don't use this class directly!* Instead ask Mail::Field for new
    instances based on the field name!

SYNOPSIS
      use Mail::Field::AddrList;

      $to = Mail::Field->new('To');
      $from = Mail::Field->new('From', 'poe@daimi.aau.dk (Peter Orbaek)');
  
      $from->create('foo@bar.com' => 'Mr. Foo', poe => 'Peter');
      $from->parse('foo@bar.com (Mr Foo), Peter Orbaek <poe>');

      # make a RFC822 header string
      print $from->stringify(),"\n";

      # extract e-mail addresses and names
      @addresses = $from->addresses();
      @names = $from->names();

      # adjoin a new address to the list
      $from->set_address('foo@bar.com', 'Mr. Foo');

NOTES
    Defines parsing and formatting according to RFC822, of the following
    fields: To, From, Cc, Reply-To and Sender.

AUTHOR
    Peter Orbaek <poe@cit.dk> 26-Feb-97 Modified by Graham Barr
    <gbarr@pobox.com> Maintained by Mark Overmeer <mailtools@overmeer.net>

