Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

email::thread(3pm) [debian man page]

Email::Thread(3pm)					User Contributed Perl Documentation					Email::Thread(3pm)

NAME

       Email::Thread - Use JWZ's mail threading algorithm with Email::Simple objects

SYNOPSIS

	   use Email::Thread;
	   my $threader = Email::Thread->new(@messages);

	   $threader->thread;

	   dump_em($_,0) for $threader->rootset;

	   sub dump_em {
	       my ($self, $level) = @_;
	       debug (' \-> ' x $level);
	       if ($self->message) {
		   print $self->message->header("Subject") , "
";
	       } else {
		   print "[ Message $self not available ]
";
	       }
	       dump_em($self->child, $level+1) if $self->child;
	       dump_em($self->next, $level) if $self->next;
	   }

DESCRIPTION

       Strictly speaking, this doesn't really need Email::Simple objects.  It just needs an object that responds to the same API. At the time of
       writing the list of classes with the Email::Simple API comprises just Email::Simple.

       Due to how it's implemented, its API is an exact clone of Mail::Thread.	Please see that module's documentation for API details. Just
       mentally substitute "Email::Thread" everywhere you see "Mail::Thread" and "Email::Thread::Container" where you see
       "Mail::Thread::Container".

PERL EMAIL PROJECT

       This module is maintained by the Perl Email Project.

       <http://emailproject.perl.org/wiki/Email::Thread>

SUPPORT

       Support for this module is provided via the CPAN RT system at <http://rt.cpan.org/>

LICENCE AND COPYRIGHT

       Copyright X Iain Truskett, 2003. All rights reserved.

       This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

THANKS

       Simon Cozens (SIMON) for encouraging me to release it, and for Email::Simple and Mail::Thread.

       Richard Clamp (RCLAMP) for the header patch.

AUTHORS

       Iain Truskett <spoon@cpan.org>

SEE ALSO

       perl, Mail::Thread, Email::Simple

perl v5.10.0							    2007-03-22							Email::Thread(3pm)

Check Out this Related Man Page

Email::Folder(3pm)					User Contributed Perl Documentation					Email::Folder(3pm)

NAME

       Email::Folder - read all the messages from a folder as Email::Simple objects.

SYNOPSIS

	use Email::Folder;

	my $folder = Email::Folder->new("some_file");

	print join "
", map { $_->header("Subject") } $folder->messages;

METHODS

   new($folder, %options)
       Takes the name of a folder, and a hash of options

       If a 'reader' option is passed in then that is used as the class to read in messages with.

   messages
       Returns a list containing all of the messages in the folder.  Can only be called once as it drains the iterator.

   next_message
       acts as an iterator.  reads the next message from a folder.  returns false at the end of the folder

   bless_message($message)
       Takes a raw RFC822 message and blesses it into a class.

       By default this is an Email::Simple object but can easily be overriden in a subclass.

       For example, this simple subclass just returns the raw rfc822 messages, and exposes the speed of the parser.

	package Email::RawFolder;
	use base 'Email::Folder';
	sub bless_message { $_[1] };
	1;

   reader
       read-only accessor to the underlying Email::Reader subclass instance

PERL EMAIL PROJECT

       This module is maintained by the Perl Email Project

       <http://emailproject.perl.org/wiki/Email::Folder>

AUTHORS

       Simon Wistow <simon@thegestalt.org>

       Richard Clamp <richardc@unixbeard.net>

COPYING

       Copyright 2006, Simon Wistow

       Distributed under the same terms as Perl itself.

       This software is under no warranty and will probably ruin your life, kill your friends, burn your house and bring about the doobie
       brothers.

SEE ALSO

       Email::LocalDelivery, Email::FolderType, Email::Simple

perl v5.10.0							    2009-07-27							Email::Folder(3pm)
Man Page