===== ChangeLog of Mail::Box version 2.*

Limitations to be fixed:

• when lines are over 997 chars, then the transfer-encoding should automatically change from 'none' into 'quoted-printable' or 'base64'

version 2.098: Thu Mar 17 09:01:36 CET 2011

Fixes

• accept mbox message separators from the 60's, because mozilla uses 1-1-1965 as default separator when importing mail. rt.cpan.org#65572 [Willi Mann]
• accept mbox message separators from the upcoming 20's
• Mail::Transport::POP3 has use_ssl setting too late [Mark Delany]
• Mail::Transport::IMAP4 folder create produced "use of undefined". rt.cpan.org#66001 [Willi Mann]
• Error message when stringifying a studied empty field. rt.cpan.org#66381 [Florian]
• do not split headers for encoded components which contain blanks (which is illegal) reported by [Florian]

Improvements

• maildir: do not remove :2, from the filename if there are no flags. [Mikolaj Kucharski]

version 2.097: Wed Jan 26 16:11:41 CET 2011

Fixes

• override Mail::Transport::Sendmail destinations included original destinations. rt.cpan.org#64266 [Andrew Beverley]

Improvements

• added examples/strip-spam-markup.pl by [Gary Funck]
• do not hardcode perl version in test.pl, hopefully resolving many cpantesters complaints.
• randomize boundary string to avoid (undemonstrated) security risks with boundary guessing.
• manual pages produced with new version of OODoc, producing more condensed output.

version 2.096: Tue Nov 9 10:04:25 CET 2010

Fixes

• allow dot in username for pop/imap (probably used by someone) [Jim Cromie]

Improvements

• spelling fixes rt.cpan.org#59061 [Salvatore Bonaccorso]
• implement Mail::Box::POP3s [Jim Cromie]
• do not run test-scripts with -T, because modern TAP::Harness uses PERL5LIB which is disabled by the flag.

version 2.095: Fri Jul 2 11:17:35 CEST 2010

Fixes

• permit additional colons in maildir filenames. rt.cpan.org #58534 [Stefan Kangas]
• maildir messages in the 'new' queue will not get ":2,", as in mutt. rt.cpan.org#58550 [Stefan Kangas]
• fix handling of messages with empty bodys. Had mild consequences to multipart preamble and prelude processing. rt.cpan.org#58544 [Stefan Kangas]

Improvements

• spelling fixes rt.cpan.org#56678 [Salvatore Bonaccorso]

version 2.094: Tue Apr 6 11:17:15 CEST 2010

Fixes

• parse address phrase with line fold in ::Full:Addresses rt.cpan.org#55309 [Diomidis Spinellis]
• handle empty preambles and postludes in multiparts even very strict, because the may be signed. rt.cpan.org#54529 [John Gardiner Myers]

Improvements

• fix documentation on use of Mail::Message::Head::build() and a few more minor documentation errors. [Kiss Gabor]
• $msg->reply fallback to From address, not only Reply-To
• add example/unpack.pl
• added install configuration choice "none". Also control via environment variables.
• spelling fixes. rt.cpan.org#53127 [Salvatore Bonaccorso]

version 2.093: Thu Dec 24 17:02:06 CET 2009

Fixes

• rewrite of Mail::Message::Full:decode(), because original trick for blank removal kept on biting me. Now implemented without trick. rt.cpan.org#52600 [Dmitry Bigunyak]
• make text/plain default when a body is created, as promised by the documentation. rt.cpan.org#52278 [Dmitry Bigunyak]
• add toplevel() to ::Body::Multipart and ::Body::Nested to support reply() called on message parts.
• fix tests-script to make MIME::Entity cleanup the msg-* files in the tests/ directory.

Improvements

• rewrite of SYNOPSIS for Mail::Message::Field::Addresses rt.cpan.org#43703 [Dmitry Bigunyak]
• added Mail::Box::Locker::FcntlLock, contributed by Jim In Aus rt.cpan.org#48568 [Jim in Aus]
• support additional headers to a reply message.
• added explanation of character-set "PERL" for a ::Body (suggested by [Dmitry Bigunyak])

version 2.092: Fri Nov 20 16:13:46 CET 2009

Fixes

• do not set all signal handlers to "exit(0)" rt.cpan.org#50433 [Slaven Rezic]
• do not enforce the use of /usr/bin/perl in the test-scripts, but use the perl which is selected via the path.

version 2.091: Sun Sep 6 23:54:17 CEST 2009

Fixes

• Another fix to thread detection start where first message is not found. rt.cpan.org#40347 [Florian]
• translate '_' to blank when charset not known. rt.cpan.org#41661 [Florian]
• no "undef" for field Content-Length with empty message bodies. [Daniel Richard G.]
• Mail::Message::Body::eol() with parameter sometimes did not return a body but a character. rt.cpan.org#49334 [Brian McCauley]
• Mail::Message::Body::eol() should add \n to last texts line if it is missing. rt.cpan.org#49362 [Brian McCauley]

Improvements

• better "From " message separator line generated when converting messages for Mbox storage. Written by [Daniel Richard G.]

version 2.090: Tue Jun 2 11:56:28 CEST 2009

Fixes

• second attempt to use Encode to do base64/qp encoding in Mail::Message::Field::Full, This time with test script. [Alexander Averyanov]
• Mail::Box::Locker::POSIX lock did always succeed. rt.cpan.org#46003 [Rainer Schöpf] via Debian#528364
• Maildir accept lower-case flags rt.cpan.org#42182 [Hardaker]
• Message parser needlessly required read access to folders. rt.cpan.org #46388 [Mike Ekberg]

version 2.089: Mon Apr 20 21:00:34 CEST 2009

Fixes

• do not restart parser after folder write, which could end-up in empy folders if mode=='w' [Reinier Post]
• fix takemail script for Mbox. rt.cpan.org#44439 [Reinier Post]
• alternative option names for 'file' in various lockers, needed to be able to use them in the multi-locker. Needed by [Mark Hedges]
• use Encode to do base64/qp encoding in Mail::Message::Field::Full, which handles multibyte characters correctly. Patch by [Alexander Averyanov]

version 2.088: Thu Mar 19 08:54:31 CET 2009

Fixes

• ::Parser::Perl should call binmode() as method on the filehandle to work. [Ashwini Singh]
• pre-created locker object cannot be passed to Mail::Box::open() because its creation requires a Mail::Box object. [Mark Hedges]
• recover from illegal phrases in email addresses, for studied fields in Mail::Message::Field::Addresses [Robert Bruccole]
• require Date::Format, introduced in 2.082 [cpantesters]

Improvements

• specify encoding type of character-set (q or b) with Mail::Message::Field::Address objects. Requested by [Alexander Averyanov]
• default mail box locker object should use the same logging settings as the mail box itself. Spotted by [Mark Hedges]
• the existence of Mail/Makefile.PL was an accident.

version 2.087: Tue Feb 3 12:41:10 CET 2009

Fixes

• more character-decoding errors in field study. rt.cpan.org#41661 [Florian]
• username in folder URL must get decoded as well, to allow '@' signs and colons in the usernames. rt.cpan.org#41976 [Matt S Trout]
• accept unknown flags for Maildir. rt.cpan.org#42182 [Wes Hardaker]

Improvements

• add DIGEST-MD5 and LOGIN to the AUTO search list of IMAP4. Triggered by rt.cpan.org#42136 [Alexander Thoukydides]
• add warnings on two spots that message labels may get lost when moving them to an other folder type.
• use external file for body after 100kB, not 10kB. Should improve on performance.

version 2.086: Thu Dec 11 11:55:32 CET 2008

Changes

• require Encode 2.26 (there are so many distributions which older versions of Encode which contain serious flaws)

Improvements

• sort optional module names in Makefile.PL

version 2.085: Thu Dec 11 11:25:52 CET 2008

Fixes

• message disappeared when ::Manager::moveMessages() had to move messages to the folder it already was in. rt.cpan.org#40198 [Florian]
• leave encodings in unknown charsets untouched, in stead of croacking in studied header fields (M::M::Field::Full). rt.cpan.org#40353 [Florian]
• thread detection with missing messages croaks in multiple ways:. rt.cpan.org#40347 [Florian]
• if character-set is unknown, then still returned un-decoded body for decoding(). [IIM1468]
• encoding into binary transfer-encoding failed. [IIM1473]

Improvements

• updated README, as suggested by [Anton Berezin]
• understand unicode-1-1-utf-[78] charset
• documention improvements on study() [Florian]

version 2.084: Fri Sep 26 16:44:51 CEST 2008

Changes

• no questions asked about Mail::Box::Parser::C; it is not really maintained as it should... but probably still works in most cases.

Fixes

• change in TAP::Harness shows missing TAP::Parser::Aggregator in test.pl rt.cpan.org#39264 [Jerrad Pierce]
• removed (@) prototype on Mail::Internet::new replacement, because it produces a warning on 5.10

version 2.083: Tue Sep 2 09:41:19 CEST 2008

Changes

• FIX CHARACTER-SET HANDLING. When a new body is created, it will get charset 'PERL', which means: Perl internal representation. Also the decoded() body is of that. As part of a message, the body with be translated into real utf-8.

  This change will make Mail::Box slower, but correct! Check your applications! Use $msg->decoded when you process the content.

• removed $msg->decoded option 'keep', because decoded object depends on temporary decoding parameters.

Fixes

• use File::Temp, not POSIX::tmpnam, to work around Windows bug. rt.cpan.org#35747 [Ron Murray]
• Mail::Message::contentType could produce "use of undefined" error message [Patrick Heesom]
• Fix listing IMAP folders. rt.cpan.org#36458 [Jonathan Kamens]
• do not set charset on non-text parts.
• no complaints for IMAP4 object without explicit folder name. rt.cpan.org#37801 [Slaven Rezic]
• remove SpamAssassion question from installation: SAv2 is the only supported, but most people will not install that.

Improvements

• doc-patch, where "my Type @array" is not permitted anymore [Mike Andrews]
• do not coerce parts via messages into parts.

version 2.082: Mon Apr 28 09:30:33 CEST 2008

Fixes

• fix work-around for Mail::Message::Field::toDate() on Windows. Reported by rt.cpan.org#35155 [Kemal Ates]
• use Data::Format::strftime to replace POSIX's version, for weird Windows timezone. rt.cpan.org#35155 [Ron Murray]

version 2.081: Mon Feb 25 22:21:30 CET 2008

Fixes

• another fix for the case of two "Content-Type" lines, hit by a recent, now frequently appearing, spam message.

version 2.080: Tue Jan 15 09:03:21 CET 2008

Fixes

• write() bodies raw, not converting LF to CRLF on Windows [Daniel Schättgen]
• Mail::Message::Field::Full "study()" header fields, hang on parsing an attribute with '[]', rt.cpan.org#31912 [Jason HE]
• various IMAP4 improvements by [David Golden]
• Windows does not like to move files when they are still opened by a process, as MBOX mode 'replace' does. Simple work-around after suggestion by [Jonathan Kamens]
• Double "Content-Type" in message headers caused confusion. [Anne van Bemmelen]

version 2.079: Wed Nov 28 10:46:06 CET 2007

Changes

• requires Mail::IMAPClient 3.00
• requires MailTools 2.01

Fixes

• Mail::Message::Field::Full "study()" header fields, hang on parsing an attribute with missing trailing quote. rt.cpan.org#31017 [Jason HE]

Improvements

• Without a '1' message in an MH folder, Mbox thought it was his, during auto-detection. Now, the check is more thorough. [Gregor Herrmann] and [Celejar], Debian ticket #442912

version 2.078: Fri Nov 9 15:13:06 CET 2007

Fixes

• mis-spelled NTLM a few times as NTML [Zsolt Kecskemeti]
• TAP::Harness 3.00 changed interface a little. Patch by [Andy Armstrong]

version 2.076: Wed Oct 24 16:55:10 CEST 2007

Fixes

• stop when message coersion is called but not possible.
• fix test, to work with MIME::Entity changes.

Improvements

• new Mail::Message::contentType()
• avoid use of '-r $filename; -f ' in Mail::Box::Mbox, where "filetest 'access'" is active: it has a bug, not setting ''

version 2.075: Tue Sep 25 11:31:40 CEST 2007

Changes

• Replace Test::Harness by TAP::Harness to run tests, which is cleaner and faster.

Fixes

• recursively opening folders with manager involved, retriggers autodetect each time, sometimes coming up with an unexpected folder type. [Celejar] http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=442912
• Mail::Box::Locker::POSIX should not include POSIX.pm, but requires Errno.pm [cpan-testers, perl 5.10]

version 2.074: Fri Sep 21 10:21:12 CEST 2007

Fixes

• two errors in Mail::Message::Field::Full when the fields are empty. Reported by [bas@debian.org]
• manuals produced with new OODoc.
• Mail::Message::Construct::Rebuild::recursiveRebuildPart() contained superfluous for(1) loop.
• a rebuilt message will still be a message, not returned as undef.
• Message with two Content-Type conflicting definitions could confuse the parser [Tim Chan]

version 2.073: Thu Jul 19 09:43:57 CEST 2007

Fixes

• field attributes which contained a '\' where considered empty. Reported by [Ricardo Signes]
• remove escape from field attributes, instead of adding it.
• Mail::Box::Manager should put protocol information in the generated unique folder-name in case of IMAP4. Was already done for POP3. Reported by [Jonathan Kamens ]

Improvements

• remove old notes about "being beta code" from Mail::Box-Overview [Ricardo Signes]
• Conversions between Mail::Message objects and Email::Simple/ Email::Abstract implemented by [Ricardo Signes] tests/80msgconv/30emsimp.t tests/80msgconv/40emabs.t

version 2.072: Thu Jun 14 11:53:31 CEST 2007

Fixes

• since release 2.070, the pure pod manual pages like Mail::Box-Cookbook where empty because of a flaw in oodist.

Improvements

• add tests/02dist/10pod.t to test PODs
• added MailTools man-pages to HTML
• MailTools is now under control of OODoc, which means that the VERSION is not in the "raw" coding files. Which on its turn means that MIME::Entity is complaining about missing version numbers in those files. Only applicable to the development situation on the authors disk. Work-around in Makefile.PL

version 2.071: Fri May 25 16:00:06 CEST 2007

Fixes

• CSS should be named 'oodoc.css' [Michael Bolien]
• Makefile.PL did not user UNIVERSAL::VERSION to compare version numbers of installed packages. [Andreas Koenig]
• Mail::Message::Body overloaded == and != should use refaddr.

version 2.070: Sun Mar 25 17:11:29 CEST 2007

Improvements

• test rebuild() not to add text alternative for html if it already exists.
• converted pod/html generation to use OODoc 0.99 Reordered the published packages on the website.
• added missing "markers" file to html-package [Michael Bolien]
• removed mkdist, mkdoc, README.oodoc

version 2.069: Wed Dec 13 14:43:55 CET 2006

Fixes

• Message rebuild with nested message failed. Fixed by [Mat Johns]
• $head->clone with specific fields was broken, once solved showed bug in $head->grepNames without names. Both fixed thanks to [jih].
• 2 fixes in IMAP4 authentication, by [Max Campos].

Improvements

• Example strip-attachtment did not use dispositionFilename() available since 2.049 [Richard Eichhor]
• Installation procedure does not need to check for Term::ReadKey

version 2.068: Tue Sep 26 13:21:54 CEST 2006

Fixes

• Mail::Box::Parser overruled global trace-level default Problem discovered by [Uwe Menges]
• own transporter provided for Mail::Box::IMAP4 was not stored. Problem discovered by [Bill Martin]

Improvements

• Docs produced with newest version of OODoc.

version 2.067: Mon Sep 18 10:36:23 CEST 2006

Fixes

• Mail::Message::TransfEnc::QuotedPrint must pass the whole message body at once, not line by line, because "=\r\n" is otherwise not detected.
• Produce manuals with new OODoc version, which fixes the layout of option-tables by exploiting a fix in the just released podlators 2.0.5.
• Update copyright date in POD.

version 2.066: Sat Jul 29 13:28:09 CEST 2006

Fixes

• Empty header field crashed Mail::Message::Field::Fast.
• block usage of foreachLine on multiparts and nested with useful explanation. Problem reported by [Claus Jeppesen]
• Test::Harness published private function which we need to group tests into new public name. [Marek Rouchal]
• SpamAssassin versions >= 3.0 are not supported by the wrapper. Discovered by [David Saulnier]
• Mail::Box::Thread::Manager thumbled over empty message-ids. Now, message-ids are only accepted if they resemble valid ids... [Yuval Kogman]
• Mail::Message::Field::attribute should use non-backtracking match to avoid crashes of Perl at extremely long fields. [John Gardiner Myers]
• Mail::Message::Field::attribute fix \\ escaping mistakes [John Gardiner Myers]

        IMAP4 Fixes and improvements by [Scott Bronson].
        Patches reworked by MarkOv

        - Mail::Transport::IMAP4 unpack of remote capabilities wrong
          Reported by [Scott Bronson]

        - IMAP4 top folder name '=' should be '/'.

        - IMAP4 create folder

        - Reworked IMAP4 folder selection

        - Do not list folder as one of its subfolders

        - IMAP4 message head not read correctly

        - avoid query unselectable folders for the number of messages.

        Improvements:

        - Improved OODoc improves quality of POD output w.r.t. option lists

version 2.065: Mon Mar 27 15:03:21 CEST 2006

Fixes

• CPANTs found missing 'use strict' in Mail/Message/Field/URIs.pm [domm]
• produce warnings when the folder gets locked twice.
• A few error messages didn't start with a capital.
• translated some carp/confess uses in ::Construct:: to use $self->log() i.s.o. carp/croak.
• Added Mail::Box::Locker::Mutt. and t/55lockers/50mutt.t
• Depends on HTML::FormatText, not HTML::Format.
• Problem with mbox test, since the empty line definition changed. Reported by the maintainers of 2 linux distributions and FreeBSD.
• Fixed tests/Tools.pm unpacking mbox into maildir and mh, both to leave-out the trailing blank line.

version 2.064: Tue Feb 28 12:39:57 CET 2006

Fixes

• redesigned everything what has to do with Content-Length and Lines.
  • now only added for Mbox folders
  • only for the whole message, not for each part in multipart
• corrected behavior of boundaries in multiparts to be compliant with the RFCs. Parts without trailing newline are now correctly supported. Thanks to [John Gardiner Myers] for the initial patch.
• $msg->moveTo called wrong copyTo. Fixed by [Ken Guyton]
• use pragma "filetest 'access'", to support ACL environments. Reported via Debian by Rainer Schöpf.
• MH index files didn't work. Multiple fixes, including some around append() to MH folders. Reported by [Simon von Janowsky]
• Fixed infinit loop encoding lines in Mail::Message::Field::Full [Tuomas Salo]
• Mail::Message::Field::Full::encode lines could become 2 chars too long: RFC says 76 max.

version 2.063: Tue Nov 1 09:13:14 CET 2005

Fixes

• Some problems with new releases of Test::Builder
• installation option 'a' (all) did not work since 2.058
• installation option 'skiptests' did not work

Improvements

• Mail::Message->rebuild option extraRules renamed to extra_rules for consistency.
• $body->description field.
• installation option control via environment variables MAILBOX_INSTALL_OPTIONALS and MAILBOX_RUN_TESTS

version 2.062: Thu Aug 25 14:07:13 CEST 2005

Fixes

• New Test::Builder (not delivered with perl yet) changed implementation which made tests fail.

Improvements

• Mail::Message::Head->build() skips undefs.

version 2.061: Wed Jun 22 19:39:09 CEST 2005

Fixes

• Finally, after many hours hunting, I was able to figure-out that a bug in Perl's "require" caused the "foundIn() not implemented in Mail::Box::IMAP4" problem (for instance when running the tests). Reported by [many people, nice work-around by Niko Tyni]
• Mail::Message::Construct::Read added missing Message-ID without angle brackets. Patch by [gjmyers]
• Mail::Transport::Sendmail options to trySend() were ignored. [Andriy Gapon]
• Mail::Message::timestamp() didn't trigger load of lazy message. [found by Eric Dorland]
• Many IMAP4 fixes and bug-reports by [Raul Dias]
• Mail::Message::Field::Full translated '0' content into 'undef' [found by Eugene L Schulman]
• test.pl didn't return <false> on a critical failure. Patched by [Tiko Tyni] Now installation attempt should stop on a sincere problem.
• test fixes, where newer Test::Harness passes around 'lib' differently. Patched by [Tiko Tyni]
• On request of [rt.cpan.org@plan9.de], Mail::Box::File::appendMessage explicitly states that it by default doesn't lock the folder. The writing is unsafe!
• [Tiko Tyni] provided different solutions to fix the taint warnings with the tests, which appeasr with perl 5.8.7. IO::File changed its behavior, which is now circumvented in the tests..

version 2.060: Tue Mar 15 22:02:34 CET 2005

Fixes

• Mail::Transport::IMAP4 crash on getFlags(). Reported by [Tom Allison]
• Mail::Transport::IMAP4 authenticate now uses server's reported capabilities. On the path paved by [Tom Allison]
• Fixes installation issue with IMAP4 (I hope) Reported by various people.
• Mail::Message::Field::toDate() now works around %z interpretation as textual time-zones when there are blanks in the name. [aa26@mail.ru]
• Pod updage for Mail::Box::Dbx [Ralf Valerien]
• open('|-') does a fork, so a failure should result in an exit, not a return. Found a few times in Mail::Transport::*, and discovered by [Slaven Rezic]
• $msg->send didn't pass the options correctly to the sending object. Reported by [Franck Richard].
• Mail::Transport::POP3 did only try APOP in AUTO mode. Found by [Markus Spann].
• $msg->send didn't pass the options correctly to the sending object. Reported by [Franck Richard].
• Mail::Transport::POP3 did only try APOP in AUTO mode. Found by [Markus Spann].
• scripts/mailbox2html used setLabel(), which got replaced by label() a long time ago. Reported by [Alain Veylit]
• Mail::Message::Field::Attribute used Mail::Reporter without having it as base class. Rewritten to have it that way. Reported by [Russell Mosemann]
• Removed the two uses of $& in reg-exps, which slows-down all regexp matches in older Perl versions. Patch supplied by [jgmyers]

Improvements

• Documented Mail::Box::Manager::open(authenticate) as suggested by [Tom Allison]
• $msg->bounce() without arguments now croaks. [Slaven Rezic]

version 2.059: Tue Nov 30 19:50:42 CET 2004

Interface changes:

• Mail::Transport::IMAP4::flagsToLabels expects new first argument 'REPLACE', 'SET', or 'CLEAR'.

  Fixes

• Installer didn't ask for optional Time::Hires
• [Anthony D. Urso] fixed an endless loop in study() for fields ending on blanks.
• [Russell Mosemann] found a different problem, in about the same line as the previous fix.
• Fixed memory leak in administration of messages in folder.

  Improvements

• $msg->printStructure is less strict on the format of the indentation: any white-space in it is sufficient.
• $msg->printStructure(undef) will return the structure as string.
• new method Mail::Server::IMAP4::Fetch::printStructure() for debugging purposes.

version 2.058: Wed Sep 22 14:44:32 CEST 2004

Interface changes:

• [Andy Maas] rewrote Mail::Box::FastScalar, to boost performance. various bodyAsList() methods now prduce ref-arrays. Shouldn't affect user programs. Requires Mail::Box::Parser::C v3.006

  Fixes

• [Jason Woodward ] had to wait much too long to get his twin-POP open problem solved. Now, only one POP connection will be opened. This may speed-up other programs as well.
• [Mike Mimic] foudn that the new INIT block in Mail::Reporter did not work well with his web-application. Changed it into BEGIN.
• [Mail Minic] Mail::Transport::Exim did not handle strings as from address correctly.
• [Anonymous via RT] Use ExtUtils::MakeMaker::prompt() instead of own ask() in Makefile.PL, so MailBox can be installed with CPANPLUS.
• [aa29] $head->isMultipart did not return boolean in list context.
• [DH] removed INIT block from Mail::Reporter, which complains in Apache.
• [aa29] Mail::Box::MH->new failed because of initiation order
• pop3 folders do not need (have) a name, but Mail::Box::Manager::open required one. Accidentally, sometimes that worked, because $ENV{MAIL} was used as default, however, that could cause various problems.
• {Tom Allison] found-out that imap was not autoloaded my the Mail::Box::Manager.

  Improvements

• warning message "Folder does not exist, ..." avoided when folder is opened for deletion.
• added Mail::Box::Identity::open()
• added Mail::Box::nrMessages() for simplification
• [Alessandro Zummo] showed me that docs about

  "why $head->delete($field) doesn't aways work" were needed. It's a nasty reference counting problem.

version 2.057: Thu Aug 26 14:31:34 CEST 2004

Interface change:

• Moved the new Mail::Box::IMAP4::Fetch to Mail::Server::IMAP4::Fetch, which is a more logical name: part of a full server implementation.
• Moved the unusable module Mail::Box::Search::IMAP4 over to Mail::Server::IMAP4::Search... but still not implemented ;-)
• You have to add (share => 0) to $msg->moveTo if the source message can get undeleted in your program (for instance in a user application).
• Mail::Reporter->report(...) will return strings without \n. Sporadic locations where log() was called with trailing \n are removed.
• Opening a folder which is already open is considered an error (was warning) by the manager.

  Fixes

• [Jan Martin Mathiassen] add IO::File to Mail::Box::Dir::Message
• [Torsten Luettgert] found that field labels like '-' where not beautified correctly with wellformedName.
• Changed '.' from most preferred folder directory for the manager into the least preferred.
• $field->setWrapLength only worked for "fast" fields. Tests in tests/11field/40wrap.t
• [Mike Mimic] showed that constructing unstructured "full" fields was broken.
• Mail::Box::POP3::delete() will not take any action. Deleting all contained messages was not consequent.

  Improvements

• [David A Golden] demonstrated the need for $head->wrap(<size>)
• $folder->coerce($message) will only call MSGTYPE->coerce($message) when not a MSGTYPE yet.
• Mail::Box::Message::coerce() could be removed: no-op.
• Reimplemented folder->delete(), which is not reading the messages before deletion, but bluntly removes the folder in the most Efficient way. You probably want the new option 'recursive'.
• Mail::Box::new(access) now has mode 'd', which speeds up removal of folders. Used by $folder->delete().
• Mail::Box::IMAP4 now supports deletion of a folder (untested)
• $folder->copyTo/moveTo and $msg->copyTo can have option 'share' which tries to use hardlinks i.s.o. clone() to put a message in a different folder. Only available for some M<Mail::Box::Dir> folders.
• Mail::Message::clone() now accepts shallow_head and shallow_body arguments which avoid deep-cloning.
• Added references to the Netzwert folder type, which got implemented, but not released as GPL (yet?)
• Increased the status of the IMAP folder client from alpha to beta.
• New methods

  Mail::Box::Manager::folderdir() Mail::Box::Manager::defaultFolderType()

• New methods

  Mail::Box::topFolderWithMessages()

• Moved tests/44imap/40fetch.t to tests/60imap/10fetch.t
• Mail::Box::nameOfSubFolder() now can be used as class method.
• New, specialized folder manager

  Mail::Box::Manage::User manager with user knowledge tests in tests/52manager/20user.t explanation added to Mail::Box::Manager, about the two kinds of managers.

• New classes to administer folders, even when not opened

  Mail::Box::Identity info about (possibly unopened) folder Mail::Box::Collection info about groups of folders tests in tests/52manager/30collect.t

• New classes to implement parts of an IMAP4 server

  Mail::Server place-holder Mail::Server::IMAP4 place-holder Mail::Server::IMAP4::List tests in tests/60imap/20list.t

• Split tests/10report/10errors.t into tests/10reporter/10errors.t and tests/10reporter/20reports.t
• Mail::Reporter::defaultTrace can now set a callback to catch each log/trace message. Tests in tests/10reporter/30callback.t
• [chris] Mail::Message::Field::wellformedName() will upper-case *-ID as part in the fieldname.
• [M M] tried to user MBMbox->create and expected it to open the folder at the same time. Documentation problem: moved the method from "constructors" to "internal". Did the same for "foundIn".
• Produce an error if people try to build Mail::Box::* messages directly.
• Many improvements on User::Identity module. MailBox requires version UI 0.90 now.

version 2.056: Sat Jul 31 13:28:29 CEST 2004

Interface change:

• [Wiggins d Anconia] explained that combining MailBox with forks may cause non-unique message-ids to be created. To solve this, the $head->messageIdPrefix() had to be rewritten. MessageIDs will look differently now. [No problems expected for existing programs]

  Fixes

• [Jeff Squyres] silenced warnings by guessTimestamp() and recvstamp() when no Date nor Received fields are present.
• [August] Mail::Box->new(lock_wait) option not correctly passed to Locker object.
• [Mime Mimic] noticed that a message reply used "sender", not "From" addresses when no "Reply-To" field is present. This is not according RFC2822. Sender should never be used.
• [Jason Woodward] found a $_ localization error in POP3, which could result in "Can't call method "xxx" without a package or object reference" errors.
• [Carlos Perez] SpamAssasin's message wrapper method get_header() should return all field bodies with a certain name in list context.
• [Jason Woodward] $msg->shortString was broken.
• [Todd Richmond] discovered that un-quoted attribute values consumed the semi-colon separator in Mail::Message::Field.
• Content-Transfer-Encoding and Content-Disposition fields were ignored when specified with Mail::Message->build(). Now they will be applied to the create body AFTER the body is constructed based on default rules.
• [Todd Richmond] discovered that Base64 decoding should not be done on per line basis, because some lines may not have mod4 number of characters (especially in virusses). The RFC is not clear about it, so... Mail::Message::TransferEnc::Base64 is changed (again)

  Improvements

• [Rich Caller] suggested to change blanks in ill-formated message-ids into blanks. Apparently, some applications are doing that.
• Mail::Message::Field::Unstructured now supportss character-set encodings, by request of [Mike Mimic]
• [Mike Mimic] made an unexpected abuse of $head->build(). It is now supported that ready field objects can be passed. A warning is produced when you accidentally pass field_name => $field_object (which should be: field_name => field_content or simply $field_object.
• [Mike Mimic] Some link errors in the front HTML documentation page.
• Added $head->printSelected(FILE, patterns) as simple way to produce field subsets.
• Added support for label 'passed', which means that the message was used for forward/bounce/resend.
• Added Maildir message flag P='passed' (uncommon)
• Changed flag handling implementation in Mail::Transport::IMAP4. Tests are in tests/44imap/30flags.t
• $body->dispositionFilename can be used without directory name.
• Attachments auto-discompose as 'inline' for texts and `attachement' for binaries.
• Added Mail::Box::IMAP4::Fetch with tests in tests/44imap/40fetch.t which provides body/bodystructure/envelope syntax conversions.
• New $field->attributes (to list fields of all attributes) for Mail::Message::Field.
• Added description of differences between MIME::Entity::build() and Mail::Message::build().
• Mail::Message::Field::Structured can now be used for general structured fields with attributes, like Content-Type and Content-Description.

version 2.055: Sun May 16 15:41:59 CEST 2004

Fixes

• [Simon Sozens] reported that IMAPClient was always installed, although claiming that it was optional. Now it is really optional.
• [Josh Miller] showed Mail::Message::Construct::Reply::replyPrelude failed the default situation of no explictly stated destination.
• [Yuval Kogman] suggested to use $CRLF from Socket.pm in Mail:: Transport::POP3, because it correctly set the content for many platforms.
• [Timur I. Bakeyev] spam-flag tested for "yes", but should be "^yes\b", by reason of a possible "bayes" name in the same line.
• [Timur I. Bakeyev] ::FieldGroup->attach was broken since 2.051.
• [Timur I. Bakeyev] ::FieldGroup doc improvements.
• [Daniel P. Berrange] found a circular reference which kept folders to stay open too long in some circumstances.
• [Roderick A. Anderson] saw complaints about fileLocation() being called on message parts. Something is fixed, which may be the cause.
• [Miah Gregory] destruct()ing messages in Maildir should not delete the message. No message will be automatically flagged for deleting when destructed.
• [Paul Makepeace] $msg->send(via) always used sendmail, without looking at the value passed with via.
• [Roderick A. Anderson] hit a bug in ::Body::Nested::fileLocation
• [Kees Dekker] Mail::Box::update logged number of new messages, although it did not receive that info from updateMessages. Log message removed.
• [Kees Dekker] discovered a race-condition when writing a replacement folder in Mail::Box::File.
• The probably hundredth attempt to get $msg->send to work smoothly.
• [Gilles] discovered that the charset setting of a body did not survive encode(). Content-type fields with text/* mime-types will not get charset=us-ascii added automatically.
• [Blair Zajac] typo in Makefile.PL text, and removal of stutters in the documentation.

Improvements

• [Trond Michelsen] needed a way to specify the body type for messages which where read with Mail::Message->read.
• You now can add your own spam-fighter fields to the detector of Mail::Message::Head::SpamGroup. See method 'fighter'.
• [Roderick A. Anderson] showed that the result value of $msg->timestamp needed some more explanation.
• [Kees Dekker] Doc improvements in Mail::Box::Locker
• Easier to start multi-lockers with selection when opening a folder:

  $f = $mgr->open($name, lock_type => ['DOTLOCK','FLOCK'])

• [David A Golden] suggested to remove $msg->date, in favor of $msg->head->date, which is consistent. When the need arises, maybe a new method $msg->date will appear returning some nice date object (like a DateTime). But probably that is never needed, since there is a $msg->timestamp.

version 2.054: Fri Feb 6 21:52:54 CET 2004

Fixes

• Reverted the change made in 2.049, which automatically added a new-line to a body... a Mail::Message::Body object may contain binary data!
• [Phil Hagen] found a typo in Mail::Transport::Qmail, causing the display of undisclosed fields (Bcc) when using qmail.
• [Brett Dikeman] showed that $mgr->open sometimes complained with a warning when no folderdir was specified.
• [Erik A Johnson] patched Mail::Box->coerce(message) to work better with foreign messages.
• [Erik A Johnson] found that Mail::Internet objects where converted by the MIME::Entity converter and vice-versa. This does usually not cause too many problems because MIME::Entity extends Mail::Internet.
• [David Phillips] got an undef warning in POP3 after delete(). Fixed
• [Mike J. Vincelette] reported error in $folder->messages(0, 20) The bounds were not checked correctly and slicing with 1..20 behaves unexpectedly in subroutine scalar context.

Improvements

• $msg->size returns a value which may be a few percent off the real value (depends on the action which follows). The warning in the documentation about this has been strengthened after some discussion with [Mike Mimic]
• Mail::Transport::Exim takes exim4 binary with preference over usual exim MTA, on request by [Mike Mimic]
• [Mitar] Mail::Transport::Sendmail starts sendmail with -ti, not -it, which helps exim... either the default sendmail as the specialized Mail::Transport::Exim module will work now with exim.

version 2.053: Thu Dec 4 00:13:50 CET 2003

Fixes

• Installation problem with Mail::IMAPClient.

version 2.052: Wed Dec 3 21:04:45 CET 2003

Fixes

• Mail::Transport::Send did not pass the options to the various trySend() methods. Now $msg->send(to => ...) will be respected.
• [Tim Sellar] fixed the message type default where the Content-Type field is empty.
• Corrected some typos in Mail::Box-index, and added reference to HTML::FromMail
• 'use' line reshuffling in all test scripts, because Test::Harness changed behavior.
• [Matthew Darwin] found double 'Content-Type' fields after build() From now on, you can overrule the content-type of the constructed message, for instance to 'multipart/alternative' without problems.
• A list of sorted threads could not handle threads starting at the same time: only one was listed.
• Reply on a message which lists multiple reply-to addresses confused replyPrelude(). Spotted by [Nick Ing-Simmons]
• Mail::Transport::SMTP could not handle illegal sender address. Discovered by [Matthew Darwin]
• Mail::Message->build with data => '' failed: contains no lines at all, which was not correctly handled. Reported by [Matthew Darwin].
• $msg->coerce() does not clear the deleted flag anymore.

Improvements

• Basic IMAP4 implementation. Included for testing purpose only.
• 'delete' is changed into a full-class label, not a special case. This simplified the code on many places. The delete(), isDeleted(), and deleted() methods on a message are now simply short-cuts for $msg->label(deleted)
• Removed most use of File::Spec from Mail::Box::MH and Mail::Box::Maildir, because it consumed considerable time: [Anthony D. Urso] reported 20%) doing things not required to perform correctly on Unix or Windows.
• Ignore sending messages with SMTP when no addresses are specified to send the message to.
• Warnings about lacking optional modules is nicer in Makefile.PL
• Added large warning to Makefile.PL when people have the perl version (not the XS version) of Scalar::Util installed on their system. That breaks everything! The correct version can not automatically be reinstalled because the version numbers are the same.
• Recent changes (bugs) in Test::Harness required an update of the test process.
• test.pl reports the version of some installed modules, to help responding to error reports.
• [Anthony D. Urso] supplied a patch to use the Received headers to provide a message time-stamp. Mail::Message::Head::Complete now contains a ::timestamp() to get the user supplied date (which is untrustable in case of spam) and ::recvstamp() which uses other means. The Mail::Message::timestamp() will, from now on, prefer the date provided by ::recvstamp and use ::timestamp as fallback.

  There are other sources to get a good stamp from, for instance the MBOX "From " line, but that is not implemented (yet)

• [asta] used $msg->parts, but the doc of the method was ignoring the facts that the message/rfc822 and multipart "wrappers" of the parts are not returned.
• $folder->current made lazy, so only calculated when used. When no message is labeled 'current', then the first not seen is returned.
• New method $folder->findFirstLabeled.
• New option Mail::Box::Manager->new(autodetect) limits the set of default folder-types in the folder type autodetection attempt. Requested by [Nick Ing-Simmons]
• The HTML manual now also indexes NOTICE log messages. Not all NOTICE messages are described yet.

version 2.051: Mon Nov 3 16:16:09 CET 2003

Fixes

• [Tim Sellar] example/build.pl omission: ::Body->new(type => should be ::Body->new(mime_type =>
• [Lutz Gehlen] bumped into a mistake in the (not finished) ::Field::Full code: the class of unstructured fields was composed improperly.
• study()ing multi-line fields produced an improper field names.

Improvements

• [Matthew Walker] added the distiction between CommuniGatePro and CommunGate software to the Mail::Message::Head::ListGroup mailinglist detector.
• [Tim Sellar] suggested to ignore undef values in build(), which will simplify the code of the user.
• Added detector for MailScanner spam groups.
• new Mail::Message::Head::SpamGroup::spamDetected() and

  Mail::Message::Head::Complete::spamDetected()

• Mail::Message::Replace::MailInternet::read() distinguishes between Mail::Message->read() and $mailinternet_object->read

version 2.050: Tue Sep 30 18:27:11 CEST 2003

Fixes

• An (unintended) change of behaviour in Text::MagicTemplate (which is used to produce the POD and HTML) made all produced manuals exactly the same.

Improvements

• [Matthew Walker] contributed various improvements to the ListGroup detection and documentation. Detection for Listserv software was added, and rfc2918 should have been rfc2919.
• [Matthew Walker] made test/Tools::copy_dir() skip directories.
• Implementation of Mail::Message::Replace::MailInternet and ::MailHeader, as drop-in replacements for Mail::Internet and Mail::Header. Very alpha! not tested yet!

version 2.049: Mon Sep 29 13:32:47 CEST 2003

Fixes

• [Liz Mattijsen] Makefile.PL requires IO::Handle in some environments.
• [Terrence Brennon] found a doc and a code mistake in example/strip-attachement.pl
• [Ron Savage] showed that the Text::Autoformat module produces different output on different machines, caused by breaking words. Breaking now disabled the for the tests, so test should result in the same everywhere.
• Some Mail::Transport::* senders did not pass-on the Bcc field to their application. Reported by [Phil Hagen].
• [Stefan Wolfsheimer] and [Mark Scarton] report a missing $ in ::ResentGroup, which broke the "delivered-to" field in resent groups.
• [Jason Woodward] reported that there were still some problems with $msg->forward(). Hope to have fixed them, this time.
• $msg->send now really has a default which will be loaded automatically as well.
• When you try to open the same folder twice, using the manager (as you should), the second time will fail. This is needed, because there are too many complications, like locking.

Improvements

• Mail::Box::Parser::Perl used $sep =~ m/^From / to recognize the MBOX separator. Now it uses $sep eq 'From ', which is faster.
• Mail::Message::Body::new(data) now corrects scalars values which do not end on a "\n". Convinced by [Mike Mimic]
• Object::Realize::Later v0.14 required
• Mail::Box::File::updateMessages() implemented, for instance for $mbox->update calls. Test in tests/40mbox/80update.t
• Maildir subfolder names can start with a dot, as reported by [Paul Simons].
• Ability to add options to the command-line of sendmail when started as MTU. Saw this need in a script of [Adam Augustine]
• Test-script of MIME::Entity conversion purges the M::E objects after being used, otherwise trashing files are left in the tests directory.
• Added Mail::Message::Body(::Encode)::dispositionFilename and Mail::Message::Body::write() which will help to export data found in a message(-part) to the file-system.

version 2.048: Tue Aug 26 19:50:06 CEST 2003

Fixes

• [Jason Woodward] reported that reply on multiparts (with only one part) failed. For this release, forward() has been rewritten. reply() may be the victim for the next release.
• [Joe Junkin] reported a problem to send messages where the body is not in a temporary file via SMTP.
• Added required Mail::Message::Wrapper::SpamAssassin method get_pristine_header()
• [Simon Cozens] demonstrated that converting MIME::Entity objects into Mail::Message's lost content related headers. This required a small redesign on when data is copied from header to body and vice versa.
• Mail::Message::Body::Multipart;;stripSignature stripped all but signatures :(
• requires Test::Harness which defines runtest_scripts, so increased the required VERSION. [Liz Mattijsen]
• [Steven Benson] found-out that manager objects where kept alive too long.
• [Rob Holland] reports that a '=' is valid in a Maildir filename, and supplied a patch.
• [Joe Junkin] found another spot where <$body> was used on a non-GLOB. In Mail::Transport::SMTP, this time.

Improvements

• Added Mail::Message::Head::FieldGroup as base class for Mail::Message::Head::(List|Spam|Resent)Group.
• Reimplemented Mail::Message::Head::ResentGroup to be based on a MMH::FieldGroup.
• Added Mail::Message::Head::SpamGroup to detect/produce/remove sets of header fields which relate to spam detection software. Tests in tests/31fgroups/30spam.t
• Moved detection of mailinglist type in Mail::Message::Head::Listgroup from method type() to from().
• Added Mail::Report::addReport, to merge reports from one object into an other, require by [Matthew Lockner]
• [Matthew Lockner] wished to able to get parser errors back on Mail::Message->read. These errors are now copied from the parser object into the message.
• Added Habeas-SWE (Sender Warranted E-mail) as abbreviation in field names which is always in caps, on request by [Ronnie Paskin]
• Moved 20resent.t and 40list.t from tests/12head to tests/31fgroups.
• New methods Mail::Message::Head::Complete::removeContentInfo(), Mail::Message::Body::contentInfoFrom(head) and ...To(head)
• As result of an extended discussion with [Simon Cozens], it seems that object-by-object conversion between MIME::Entity and Mail::Message objects will keep on producing problems. Therefore a stringify-reparse strategy is used from now on. Mail::Message::Convert::MimeEntity is very straight-forward now, but a less efficient.
• [Jason Woodward] convinced me to implement Mail::Message::forward(include => 'ENCAPSULATE'), which adds the source message as message/rfc822. The whole forward implementation has been re-implemented and re-documented.
• [Kees Dekker] was (understandably) confused by the explanation of $folder->isModified() This has been improved.

version 2.047: Thu Aug 7 23:59:53 CEST 2003

Fixes

• For MBOX and POP3, delayed header will be read before labels() or label() return the values, because only reading will cause the [X-]Status fields to be parsed into labels.
• Tests are now suitable for perl5.8.1
• [Kees Dekker] with Solaris and perl5.8.1 showed me that Mail::Box::Locker::POSIX was so broken that its tests worked on other versions :(

Improvements

• Moved all questions about optional modules from test.pl to Makefile.PL. Hope for a cleaner installation.
• On request by [Jason Woodward], POP3 received messages will get their Status and X-Status fields processed. POP3 has no other means to pass-on status information, although not all servers support these fields.
• The library should now be taint-safe: all test-scripts now run in taint mode!
• The POP3 test-scripts now share common code in Tools.pm
• New release for Mail::Box::Parser::C (as separate package) which ignores message lines starting with 'From ' as separators in broken MBOX folders (like mutt produces).
• Added Mail::box::Parser::C to the list of optional modules.
• Refolding and Mail::Message::Field::AddrGroup will produce the address strings in alphabetic order, to get a reproduceable result (required for 5.8.1)
• Disabled detection of folder "changed during access", until all folder types support 'update()'.

version 2.046: Thu Jul 31 12:25:47 CEST 2003

Fixes

• [Kees Dekker] found that HPUX mangles %z int textual timezone, so Mail::Message::Field::toDate() has changed again. Quite complex now.
• [Kees Dekker] fixed a missed test for undef in Mail::Message::Head::ListGroup::display().
• [Kees Dekker] reported a problem in tests/42maildir/20write which was caused by a missing $folder->close;
• [Blair Zajac] & [Kees Dekker] signalled that User::Identity and URI are prerequisits now.
• [Kingpin] Wrong quotes in warnings and a typo, in Mail/Message/Body/Encoding.pm
• $msg->send was showing lines not to be disclosed by default, which is wrong.
• [Jan Stapel] reported prints of "GLOB()"s where text was expected. This was a new bug in Mail::Message::Body::File

Improvements

• [David Coppit] has a short list of improvements in handling blank lines at the end of messages and message parts, which will decrease the differences between a message read and then printed.

version 2.045: Tue Jul 29 20:23:30 CEST 2003

Fixes

• A lot of files were missing from the distribution because OODoc had a bug.

Improvements

• Object::Realize::Later documentation is now part of MailBox's html output too. Join the club!

version 2.044: Tue Jul 29 13:52:32 CEST 2003

Interface changes!!

• Mail::Message::rebuild() tags where inconsequently named. Now remove_html_alternative_to_text => removeHtmlAlternativeToText text_alternative_for_html => textAlternativeForHtml
• [Anthony D. Urso] hinted that opening a Maildir folder should not automatically move messages from 'new' to 'cur'. Added a label 'accepted' to control this. See Maildir::new(accept_new) which must be set to get the same behavior as before.
• Mail::Box::Maildir::updateMessages was incorrect: inconsistent behavior with other updateMessages(). Removed for now.

  Fixes

• Some print()s did not distriguish between GLOBs and IO::Files
• [Martin Thurn] detected a problem with the call of Mail::Box::FastScalar in Mail::Box::POP3
• [Yuval Kojman] fixed Field::toDate() on systems without glibc.

  Improvements

• Mail::Message::new(labels) did not work, but was not described either.
• Moved all modules to lib/, which removes the need for a nested Makefile.PL, improperly handled by new gnu-make/ExtUtils::MakeMaker combinations.
• added UserIdentity to the HTML documentation tree.
• added list detector Mail::Message::Head::ListGroup based on information collected in Mail::ListDetector. Tests in 12head/40list.t
• added Mail::Messsage::Head::Complete::listGroup()

  Mail::Messsage::Head::Complete::addListGroup() Mail::Messsage::Head::Complete::removeListGroup() Mail::Messsage::Head::Partial::removeListGroup()

• added example 'smaller.pl' to demonstrate how to get rit of selected headers (and how much you gain by it)
• added description how to reduce the size of headers by removing groups of fields.
• added method $folder->size which estimated a folder size, but may be slow.
• debugged and tested Mail::Message::Field::Addresses, Mail::Message::Field::Address, and Mail::Message::Field::AddrGroup, with tests in tests/14fieldu/51addr.t
• Added Mail::Message::Field::URIs with tests in tests/14fieldu/52uris.
• MailBox now depends on the URI distribution
• Move Mail::Box::Message::shortString and ::shortSize to Mail::Message.
• Simplified Mail::Message::sender().
• Rewrote Mail::Message::Head::createReceived to work on headers which are not inside a message.
• "make test" will produce some more text, and permits skipping all tests for fast installation.

version 2.043: Thu Jul 10 10:18:51 CEST 2003

Fixes

• [Greg Matheson] small doc-fix for Mail::Message::Body::Construct foreachLine().
• [Wiggins d'Anconia] time generated by strftime left %z on non-gnu systems. On those systems, a work-around is made using Date::Format.
• appendMessage in Mail::Box::File coerces message into the correct sub-class.
• Mail::Message::Head::Delayed is not empty.
• Mail::Message->read will strip the status fields from the header by default, for security considerations.
• Mail::Message->bounce will not interpret status fields.

Improvements

• labelsToStatus and statusToLabels are now only implemented for file based folder types, like mbox.
• Implemented Mail::Box::Message::Destructed with a Mail::Box::Message::destruct(), Mail::Message::destruct(), and Mail::Message::Part::destruct(), tests/50mesage/60destruct.t to forcefully free-up most memory used by a message.
• Added Mail::Box-Index, the documentation index.
• Extended documentation about . various ways to access header field data . message labels (flags) . various class relations
• Now requires Object::Realize::Later version 0.12
• [Todd Richmond] contributed Mail::Box::FastScalar, which is a replacement of IO::Scalar... but faster. It should be a separate module, but for now it has a place. FastScalar is faster and does not leak, as its brother.
• Removed last uses of IO::ScalarArray, because it seeks awfully slow.
• Added Mail::Message::study()

  Mail::Message::Head::study() but it is not usuable yet.

version 2.042: Tue May 20 14:32:05 CEST 2003

Fixes

• Added message-id to the wrong side of the Reference field in reply() and forward(). Fix by [Mike Mimic]
• [Tassilo v Parseval] reported an error when HTML::FormatText was not installed.
• [Alex Liberman] found that searching nested messages failed, because they were treated as multiparts.
• [Todd Richmond] demonstrated that multiparts contained circular references, which increased memory consumption. Not hard too fix.

Improvements

• Implemented Mail::Box::Dbx to read Outlook Express files. Tests in tests/45dbx/*
• Implemented Mail::Message::Head::Partial, which will contain a subset of headers without knowing where to find the rest of it. ::Subset knows where to get the rest. Tests in tests/12head/30partial.t
• $head->removeFields(), $head->removeFieldsExcept() and $head->removeResentGroups to free up memory. This "upgrades" a complete header into a partial header.

version 2.041: Thu May 8 14:05:32 CEST 2003

Fixes

• [Supriya Jagadeesh] showed that reply(include => NO) did not work. Apparently, no-one used it before.
• [Shagren] showed a patch to avoid an locale based date field to be produced, where rfc2822 requires an English format. As change, the locale based parts of strftime are avoided.
• sendmail and started with extra -i flag, to avoid stop at lines in message which only contain a dot. Spotted by [Tim Sellar]
• [Bill Moseley] detected that examples/reply.pl called an non-existing quotePrelude(), which should have been replyPrelude().
• [Dimitris Glynos] Mail::Message::Field::Full:_decoder() should decode, not encode :(
• [Dimitris Glynos] Mail::Message::Construct::reply() did not use the subject of the sender to create a new answer.

Improvements

• Translated all docs to use OODoc. Many small fixes in the docs were the result.
• Removed $folder->clone, because it implemented the same as $folder->openRelatedFolder, which has a much better name to describe the action performed.
• Rewrote documentation for Mail::Box::scanFromMessages(). It now also accepts a timespan as value.
• Documented all available overloading (which is quite important).
• Mail::Message::Construct has been taken apart in multiple Mail::Message::Construct::* packages because it grew too large and it simplifies including examples.
• Added Mail::Message::Construct::Rebuild, which can modify existing messages. Very slick!
• Mail::Message::Part's get an empty header by default.

version 2.040: Mon Apr 14 15:48:54 CEST 2003

Fixes

• Mail::Transport::Exim could not find destinations(). Move that method from MT::SMTP to MT::Send. Thanks to [Greg Matheson].
• [Dimitris Glynos] fixed one more place where a failed login for POP3 caused Mail::Box to hick-up.
• [Dimitris Glynos] made Mail::Box care about succesfull reading of messages.
• [Shagren] reported that the CRLF changes on POP3 did break POP3 under Windows. The problem is that the IO::* modules (like IO::Socket) do not implement BINMODE: you can not set them in 'raw' mode. Implemented a work-around.
• [Steve Lewis] explained why information about a body was not preserved over a clone(). He provided a patch.
• [Todd Richmond] found-out that Content-Type lines sometimes doubled. The reason behind this was that header and body shared the same field structures, which blocked the autodestruction of header lines which were obsoleted: the old Content-Type line in the header was kept alive by the body.
• [Michael D Richards] reported another corruption in construction of binary attachments. Fixed that as well.

Improvements

• [Alexander Bauer] reported a very slow Mail::Message->read for large messages. This was due to IO::ScalarArray (being extremely slow in seeks), which now is replaced by IO::Scalar.
• Do not use eval{binmode $fh}, but carefully check whether the $fh can handle binmode before calling it in the parser.
• Remove newlines from header field data which is passed as objects. When they stringify with newlines included, this disturbes folding.
• Added comments on how (not) to change the body of a bounced message. Do never do it, but if you have to then...
• Mail::Message::Construct::reply handles nested messages and binary files better to construct an answer.

version 2.039: Sun Mar 30 17:34:43 CEST 2003

Fixes

• [Phil Holden] supplied a patch to Mail::Transport::POP3 to send CRLF line terminations, and improvements on handling the welcome message.
• [Mike Cudmore] found a bug which caused a call to parts() on lazy nested messages.
• [delepine@u-picardie.fr] patched conversion of Mail::Message to Mail::Header in Mail::Message::Convert::MailInternet.
• [Sebastian Willert] showed that multipart/anythings were always changed into multipart/mixed things after an operation on them, like attach.
• [Dimitris Glynos] found that a log-in failure for POP3 tried to establish the connection twice.
• [Michael D Richards] reported corruption in construction of binary attachments, which was caused by buildFromBody always converting CRLF -> LF (on Unix). Removed this.
• [Christoph Dahl] reported that header field attributes with blanks around the '=' where not detected. Some flexibility added.
• [Eugene Eric Kim] reported the problem where incorrect in-reply-to or References fields could cause thread cycles which where not usuable. Cycles will be ignored.

Improvements

• [Marty Pauley] supplied a patch to use MIME::QuotedPrint for Mail::Message::TransferEnc::QuotedPrint. Originally, the module implemented en/decoding by itself in Perl, however since MIME::QP is a code module, the advantages disappeared.
• Mail::Message::Body::Multipart's preamble and epilogue now accepts strings, so you so not have to create a body for them explicitly.

version 2.038: Wed Feb 26 16:20:03 CET 2003

Fixes

• It was not possible to remove POP3 messages with $msg->delete noticed [Jason Woodward]
• An empty header field could still be a cause of problems. They were removed from the header, with a warning. Now changed the warning into a notice message, and the fields are kept. A fix and test by [Marty Pauley]
• POP3 messages where not readible when the server does not support UIDLs. Silly bug, solved by [Andreas Fitzner].

version 2.037: Sun Feb 23 14:53:50 CET 2003

Fixes

• MBOX write policy INPLACE contained serious bugs. Upgrade adviced if you use it (not the default) reported by [Michael Reece], but by [Greg Matheson] before.
• Mail::Box::Manager::decodeFolderURL() return ref hash instead of hash values. Patched by [Benjamin Pineau]
• MB::Mbox::Message::print() did not encapsulate 'From ' lines. Behavior has changed: print() will only simply print head and body, and write() will encapsulate a message as required for the folder. Problem detected by [Nik Clayton]
• For retreival of addresses, the whole field contents of an address field is used, not only till the first semi-colon.
• [Melvyn Sopacua] reported an accidental call to 'confess', which was a left-over of the debugging process. It triggered for an MH index, when a field was requested which was not defined.

Improvements

• Many warning and error message have changed a little to be more consistent or (in most cases) much clearer about the meaning.
• added isModified() methods as alternative to modified(), which is more consistent with other method names.
• added isDeleted() methods as alternative to deleted(), which is more consistent with other method names.
• [Benjamin Pineau] found the cause of an enormous slow-down while parsing large messages: tell() and seek() in IO::ScalarArray objects. With a small patch, everything goes smooth and fast: use getpos() and setpos()....
• Translated Mail::Message:TransferEnc::Base64 to use MIME::Base64, now MIME::Base64 is a core module for 5.8.0. The old algorithm was not able to handle too long encoded lines, as [Chris Kungfoohampster] discovered.
• Testfile 40mbox/30delete.t should renamed to 40mbox/30delay.t Testfile 40mbox/70inline.t should renamed to 40mbox/70inplace.t

version 2.036: Thu Feb 13 18:18:29 CET 2003

Fixes

• More attempts to protect $_ against eval's which apparently change it in ./test.pl. Hope the installation is smooth now.
• CPAN::install can come back to a different file-system location when installation is completed. Try to restore that in test.pl.
• [Tom Allison] discovered that a folder opened for 'a' does not work with addMessage(): the messages where not read.
• [Simon Cozens] found two problems in $msg->parts($coderef) and $msg->parts('ACTIVE'|'DELETED') on non-folder messages.
• [James Sanford] found that conversion to MIME::Entity did not work for nested multiparts. Mail::Message::Construct::lines() was not context sensitive (now returns ref-array in scalar context), and detection of multipart was wrong in case of nested multiparts.
• [Karen Craven], [Tom Allison] and [Michael D Richards] where right with their explanation why message-ids were created incorrectly.

Improvements

• Mail::Transport now also supports 'postfix' as alias for 'sendmail', thanks to a question by [Tom Allison].
• Tests for unicode fields are moved to their own directory, tests/14fieldu, which is not considered critical on failure.
• Copyright set to 2001-2003
• [Todd Richmond] requested to keep the folding of fields when they are added to a header. Field::setWrapLength() has been changed not to re-fold already folded fields.
• As explained by [Eric Wheeler], spam and virus filters do not like the message parser to stop on broken headers. Therefore, a new option Mail::Box::new(fix_headers) is created. This option progresses into a few other classes, and should be usable with all folder types.

version 2.035: Fri Jan 24 20:41:23 CET 2003

Fixes

• Mail::Reporter::defaultTrace() now accepts names as well. Recieved a fix by [David A Golden]
• Mail::Message::Field::attribute() now returns (undef) when the attribute is not defined. Patched by [Marty Pauley]
• [Jost Krieger] found that getline() in ::Base64 does catch the read line in $_, which could be expected reading its doc.
• message/rfc822 within delayed multiparts are now triggered correctly.
• [Beirne Konarski] found out that eval{} in test.pl sometimes modified $_, which broke installations.
• Headers from body where lost in multipart. Reported by [Nik Clayton].

Improvements

• {Greg Matheson] contributed Mail::Transport::Exim, to send email using an external exim client.
• Added Mail::Transport::new(executable) which offers you a way to explicitly specify where the transfer agent is located.
• Changed Mail::Transport::SMTP::init(debug) option into smtp_debug, to show that it is not Mail::Box which is being traced, but the low level SMTP drivers only.
• Added some example options to examples/send.pl, which showed some inconveniences of Mail::Message::send(), which have been solved.
• [David A Golden] wrote Mail::Classification based on Mail::Box, which is a learning spam filter. References added to README.FAQ
• Doc-fix in Mail::Message::from/to/cc/bcc() by [Greg Matheson].
• Renamed Mail::Message::Field*::folded_body() and ::unfolded_body() to ::foldedBody() and ::unfoldedBody(), to be consequent with the method naming of Mail::Box.
• Mail::Message::TransferEnc::Base64::decodefrom_lines() does not warn anymore in case of a line which only contains padding. Found by [David A Golden]
• Mail::Messsage::Field::stripCFWS() now understands escaped quotes and parenthesis. Parenthesis within quotes are not seen as comment anymore.
• Implemented Mail::Message::Field::Full with many tests in tests/11field/40full.t. Implements RFC2047.
• Implemented Mail::Message::Field::Attribute with many tests in tests/11field/41attr.t It implements field attribute understanding as defined in RFC2822 and RFC2045, with the extensions about parameter encoding and continuations as defined in RFC2231.
• Implemented Mail::Message::Field::Unstructured, as first category of fields. Tests in test/11field/42unstr.t
• Added Maildir quotas to the long wishlist. Suggested by [Brian Grossman]
• On request by [David A Golden], Mail::Reporter now returns Scalar::Util::dualvar values where the use may wish to know the numeric value as well as the string representation of an error level. Tests added in tests/10report/10errors.
• Modified examples/grep.pl you unix-grep syntax
• Mail::Box::Search now takes nested messages under the flag of multiparts (search or not to search, that's the question)
• Mail::Message->build and buildFromBody now accept a pre-filled header.
• Mail::Message->build accepts a new option 'files', which is an abbreviation for multiple 'file' options.
• Mail::Message::TransferEnc::decode() now als decodes chars above 127 and tab. Escape characters are still not decoded for safety reasons. On request by [Marty Pauley]

version 2.034: Thu Jan 2 15:08:56 CET 2003

Fixes

• When a message is added to a folder, it shall be flagged as modified, otherwise the message is not written when the folder closes. Problem discovered by [Greg Matheson].
• Mail::Message->read() did not inspect the status fields. Spotted by [Simon von Janowsky]
• When an empty field is folded, at least a new-line must be produced.
• Mail::Box::File::appendMessage() doesn't need to open the folder locked: appending should be a safe action. Reported by [Greg Matheson].
• multipart->lines accidentally did not include the headers of the parts. Spotted by [Constantin Khatsckevich]

Enhancements

• Resent Groups in the header now also support Delivered-To.
• Renamed some toString() methods to the more consistent name string(), without breaking backwards compatibility.

version 2.033: Thu Dec 12 11:23:42 CET 2002

Fixes

• [Greg Matheson] found a truncate() difference between Windows and UNIX: fewer errors for the Windows test.
• [Greg Matheson] solved problem with mbox write-replace related to \n -> CRLF translations vice versa. The number of problems for Mail::Box on Windows decreased even furter.
• Some improvements of the tests.pl scripts, related to the installation of optional modules when Term::ReadKey is not installed.
• Mail::Message::Part::parent() 4th try to solve... on some places, the body was returned, in other places the surrounding message. This was partially caused by the confusion created by the name of the method. Therefore, the method is renamed to "container" which returns a Mail::Message::Body::Multipart or ::Nested.
• appendMessage requires access => 'a' to the folder. [Greg Matheson]
• Parts of multiparts which do not contain any header lines were stopping the parser to look for more parts: all the rest was put in the epilogue of the multipart. Detected by [Melvyn Sopacua]
• Mail::Message::Part's can contain empty bodies. Spotted by [Melvyn Sopacua]
• Hopefully, the installation of option modules has smoothened a little.
• Mail::Box::File::appendMessage() didn't check success for opening a folder. Reported by [Melvyn Sopacua]
• default for $mgr->appendMessage was to create an MH, not an mbox folder.

Improvements

• tests/55locking/20flock excluded for Windows: no flock implemented.
• Added examples/strip-attachments.pl by [Pjotr Prins]
• Mail::Reporter::AUTOLOAD will produce a class name in the error message if a class method failed... The blank is not very informative.
• "create" is now a valid option for Mail::Box::(Mbox|MH|Maildir)::new, which required some changes in the Mail::Box::Manager as well.

version 2.032: Fri Nov 29 19:59:47 CET 2002

Fixes

• Enforce Text::FormatPS version 2.01, because the output format has changed. Scripts adapted to the new layout. [Blair Zajac]
• Required Term::ReadKey for installation. [Greg Matheson]
• Silly problem with lock-filenames... detected by [Blair Zajac]
• $part->toplevel did not return a message, but a body. Detected by [Pjotr Prins]
• $part->delete did not seem to have an effect... silly bug caused this problem, which was spotted by [Pjotr Prins].

Improvements

• Removed dependency from Term::ReadKey.
• $msg->printStructure shows parts which are flagged to be deleted.

version 2.031: Mon Nov 25 14:50:23 CET 2002

Fixes

• Mail::Box::Locker::new(file) has now comparible meaning for DotLock and flock locking methods.
• Removed Mail::Box::Locker::POSIX from Windows options: not all fcntls present.

Improvements

• MBOX handling of the parser much simplified.
• [Blair Zajac] is still nitpicking about close()...
• $Mail::Message::crlf_platform added as central resource for all modules which have to know.
• Mail::Message::Body::File::size() compensates for "superfluous" CRs in the file's line-endings.
• Messages in test-scripts are compared by a special function which permits differences in Content-Length for platforms with CRLF (Windows)
• Message sizes in thread-dumps within test-scripts are ignored by a special function, but only on CRLF platforms like Windows.
• Some code has moved from Mail::Box::Parser::Perl into Mail::Box::Parser Cannot break existing code.
• Quite some code has moved from Mail::Box::File to Mail::Box::Mbox. Cannot break existing code.
• Added Mail::Box::Search::IMAP as place-holder for a dedicated (remote) search implementation using the IMAP protocol features.
• Added Mail::Transport::IMAP, Mail::Box::IMAP, and Mail::Box::IMAP::Message with some pseudo-code how IMAP folders could be handled.
• Improved the docs on ::POP3
• Mail::Box::POP3 now refuses addMessage() and addMessages() with nice errors. When someone implements the writing extensions to POP3, this may change. update() still has to be implemented
• Multipart message will also have a Content-Length in the header.
• Mail::Message::Convert::MailInternet requires Mail::Message [Adam Byrtek 'alpha']
• New version of tests/POP3/server, which can be used to test the POP3 client against some weird POP3 servers. [Liz Mattijsen]
• Upgraded Mail::Box::write() to allow mid-life writes of files.
• Removed option Mail::Box::write(keep_deleted), because it is unsafe.
• Replaced all uses of FileHandle by IO::File.
• test scripts ask for optional packages to be installed. The user will be asked per package... more info about it has been added, for instance the option Mail::SpamAssassin.

version 2.029: Mon Nov 4 21:06:30 CET 2002

Fixes

• Empty header lines where printed without trailing new-line. This was spotted by [Blair Zajac] soon after the release which broke it: do not use 2.028
• Some extra checks for the return-code of close(), added as wished for by [Blair Zajac]

version 2.028: Mon Nov 4 15:08:57 CET 2002

Fixes

• [Greg Matheson] decovered a small bug in the 10field test-script. After being corrected, it showed a mistake in MM::Field with folding very long words in field bodies. This bug was corrected.
• Fixed a parser bug in MBOX, which showed an error when closing a folder without explicit write before it. Reported by [David A Golden]
• [Blair Zajac] reported that the multipart boundary was not added to the Content-Type field.
• [Sebastian Krahmer] adviced me to put a very strong warning against the use of mailx (Mail::Transport::Mailx), which is accepted because the funarability has been proven: mailx is exploitable insecure.
• [Shagren] hit a POP3 server which does not add a blank at the end of each message. The last line of his message body was removed because Mail::Transport::POP3 did not anticipate that.

Improvements

• In joint forces with [Greg Matheson], some small improvements have been made in the mailbox parser for Windows... But it is still far from perfect.

version 2.027: Sat Oct 26 08:52:32 CEST 2002

Fixes

• Lazy Mail::Box::Dir::Message::print() (mbox and mh messages) used File::Copy's copy(), which cannot handle IO::Lines file objects as destination. Replaced by own implementation. [Tony Bowden] reported this problem, and fix my patch as well.
• Mail::Box::find() was not able to get the id of the first lazy-loaded message.
• The empty line which preceeds a separator in mbox folders was accidenitally included in the body of the message before it (this was quite hard to fix) [Albert Schueller]
• Mail::Message::Body::Multipart::foreachComponent(), used by many multipart methods, created Mail::Message i.s.o. Mail::Message::Part objects. This is not right: especially encode() and decode() where frustrated by it. Same for nested messages. Signalled by [Mike Cudmore]

Improvement

• Mail::Transfer::POP3 implemented by [Liz Mattijsen].
• [Shagren] found the first reason to modify Mail::Transfer::POP3 a little.
• Mail::Box::POP3 and Mail::Box::POP3::Message should be working now. Mo Tests are included.
• Reorganized the tests. This is needed, because the number of testscripts grew too long for Windows! Besides, I need more control over installation of optional packages.
• All folder-types now have a type() method.
• All folder-types now have a url() method, which result van be used to specify a complex folder name to the Mail::Box::Manager.
• [David Favor] asked to show the filename when an illegal header is detected by the parser.
• Rewrote Mail::Box::scanForMessage() in search of a bug reported by [Shagren] concerning Mail::Box::find() But it was not the cause. Still, the method has improved.
• Changed split /(?<=\n)/ into split /^/ everywhere.

version 2.026: Mon Oct 7 23:39:07 CEST 2002

Fixes

• Default package for $msg->send was broken. Reported by [Jeremy Banks]

Improvements

• Mail::Message::Field::wellformedName() produces better results, thanks to [Emmet Cailfield]
• Many more tests are succeeding under Windows, since [Greg Matheson] sent me the output of the tests based on Test::More. Thanks Greg!
• Mail::Transport::SMTP warns when send(To => $to) is used where send(to => $to) is needed. [Jeremy Banks]
• Mail::Message::Head::ResentGroup::set(field) added Mail::Message::Head::ResentGroup::createReceived() added Mail::Message::Head::ResentGroup::destinations() added
• Mail::Message::Construct::bounce() now adds Resent-* lines to the first Received line, if available.
• Mail::Message::Head::ResentGroup::new() creates a received field if not defined.
• Mail::Message::Head::Clone uses $head->addNoRealize i.s.o add(), and thereby does not re-fold the headers anymore.
• Deleting or resetting a non-existing field in the header will not flag the message to be 'modified'.
• Implemented Mail::Box::Search::SpamAssassin, a spam filter
• Implemented Mail::Message::Wrapper::SpamAssassin, a wrapper used in the new spam filter.
• Implemented authorization for SMTP, based in work by [Michael de Beer]
• X-Spam-* headers are not disclosed for transmission.

version 2.025: Mon Sep 23 13:11:57 CEST 2002

Fixes

• Accidentally left debug-printstatements in Mail::Transport::SMTP
• Fixed "from" address used in Mail::Transport::SMTP.

Improvements

• MIME-Version header line automatically added to constructed messages (rfc 2045). [Matthew Darwin]

version 2.024: Sun Sep 22 23:06:55 CEST 2002

Fixes

• SMTP sending accidentally only included the headers not to be disclosed :( The check has the correct negation in Mail::Message::Field::toDisclose() now. Reported by [Matthew Darwin]
• Generated messages without message-id must get one assigned. Reported by [Matthew Darwin]

Improvements

• All tests converted to use Test::More, which produces better feedback on failures. Hopefully, failures on Windows will start disappearing now.
• Mail::Box::Dir::Message's take their size from the real file (unless they are modified)
• Mail::Box::Mbox now derived from new Mail::Box::File
• Mail::Box::Mbox::Message now derived from new Mail::Box::File::Message.
• Set the shape of the message-id with Mail::Message::Head::messageIdPrefix()
• A message constructed without data will be an empty text message, not an empty multipart :(
• Mail::Message::Construct::build() now calls buildFromBody() to prepare the whole message, instead of doing it itself. You can also specify field objects to buld() now.
• From and To fields are no longer required to construct a message. They may be filled-in later.
• Mail::Message::Construct::bounce() now uses the MM::Head::ResentGroup object, which much improved outcome.
• Made a start with Mail::Box::Search::SpamAssassin.

version 2.023: Sat Sep 14 11:11:03 CEST 2002

Fixes

• t/65search.t failed for some Perl versions, dependent on the hash implementation. Mail::Box::Search::Grep::inHead did not use MM::Head::orderedFields() yet. Discovered by [Blair & Liz & Greg & Conrad Heiney]
• Mail::Box::Mbox includes IO::File with () to avoid colission between constant definitions in IO::File and POSIX. Fixed by [Marcel Gruenauer]

version 2.022: Mon Sep 9 18:55:01 CEST 2002

        Detailed checks against RFC2822 is in progress, which means that
        some changes have to be made.  The API had to be changed on some
        places, but on most places could be kept unchanged.

        Application breakers:

        - $msg->from now returns a list fo addresses!  Mind the context!
          required by the RFC.

        - stringified $body->type returns whole Content-Type body.  Use
          $body->mimeType!  Example:
             if($msg->type eq 'text/html')     # breaks now
             if($msg->mimeType eq 'text/html') # works as always

        - a header field stringifies to "body; comment", not only
          the body.

        Fixes:

        - Messages which of unknown Content-Type (unknown by MIME::Types)
          could cause segmentation violates.  Solved by [Darrell Fuhriman]

        - In Mail::Box::Manager, the method foldertypes() was called, which
          should have been folderTypes(). [Swapnil Khabiya]

        - Mail::Message::Construct::replyPrelude produced warning when
          from address of originating message dit not defined a user's
          name.  Now it has a fallback. Reported by [Jon Thomason]

        Improvements:

        - new method Mail::Box::Message::moveTo()

        - new method Mail::Message::sender()

        - Mail::Message::Convert::selectedFields() retuns fields now
          (in the right order), not field names.

        - Mail::Reporter::log() now also as class method.

        - Mail::Reporter::defaultTrace() to set program global defaults
          for logging and tracing.

        - New class Mail::Message::Head::ResentGroup with tests in
          t/12head1r.t

        - Mali::Message::Construct::printStructure now accepts a filehandle.

        - reply() takes return address from: Reply-To || Sender || From
          (Sender added)

        I have re-read specification rfc2822, and reimplemented the three
        Mail::Message::Field* objects.  The next changes are made to
        these objects:

        - field data is only stored in folded form to improve performance
          during parsing and reduce memory consumption (which is quite
          high for headers) but also to be able to handle structured fields
          better.  This introduced two new methods:
            folded_body()
            unfolded_body()
          The body(), comment(), and content() are quite different now,
          although return the same results.

        - toDate() without argument returns an rfc2822 valid date
           representing the current local time.

        - new() accepts attributes.  The OPTIONS are only available
           for ::Flex fields.                                    

        - attributes handle escapes of quotes in quoted strings.

        - new method length() which returns the total field length.

        - new method toDisclose() which tells
          Mail::Message::Head::printUndisclosed whether the header should
          be visible for extenal receivers.

        - new method stripCFWS() removes comments and folding white space from
          header lines.  This should only be used on structured header
          fields.  Tests in t/11cfws.t

        - new method dateToTimestamp converts a date in RFC2822 spec into
          a timestamp.

        Also Mail::Message::Head got revisited.  The order of the fields
        is protected stronger.

        - new method orderedFields()

        - new method addResentGroup()

        - new method resentGroups()

        - new method removeField($field)

version 2.021: Tue Aug 20 17:42:24 CEST 2002

Fixes

• Requires HTML::TreeBuilder release 3.13 or newer, if you want to use Mail::Message::Convert::HtmlFormat*.pm, because 3.12 contains a serious bug. Resolved by [Blair Zajac]
• A mistake in the previous release could cause that parts of multiparts where lazy. This is not correct: all parts must be extracted at once. Detected by [Jost Krieger]
• Another bug introduced with the previous release was the removal of automatic body-to-messagepart coercion.
• When a nested body was checked on encoding, it accidentally returned its nested content, in stead of itself. Detected by [Blair Zajac]
• Mail::Message::isMultipart triggered the body, which is not needed because the info is in the header as well.
• pod2html translators are terrible. Put more sofistication in my html-polisher.

Improvements

• Carp is stringifying objects, which is terrible in combination with overloading stringification on message headers and bodies. Therefore, a special exception for stringification is added to return a different result to Carp.
• The Mail::Box::determineBodyType is simplified.
• Multiparts and Nested (rcf822) message are now also delayed when their size is not known (often the case) or too large.
• Implemented Mail::Message::Part::buildFromBody() to assist the improved Mail::Message::Part::coerce()
• Testing cloning of complex messages in t/58clone.t

version 2.019: Thu Aug 15 09:46:42 CEST 2002

Fixes

• Parsing messages could destroy $_ and IN/OUT file-handles from the user's program. Found a few places in Mail/Message/Body/*.pm Problem spotted by [Jerrad Pierce]
• Mail::Message::Head::Delayed extends a Mail::Message::Head, not a Mail::Reporter.
• Using an Index with MH folders caused each message header to be triggered: a considerable slowdown.

Improvements

• [Blair Zajac] donated a large set of documentation fixes. Even some hidden bugs got fixed this way.
• Implemented Mail::Message::Body::Multipart::file(), because it is required for Mail::Transport::SMTP. Spotted by [Marty J. Riley]
• Mail::Box::Tie::ARRAY and ::HASH simulate real arrays and hashes better with respect to deleted items.
• Mail::Box::Message::Dummy is renamed into Mail::Message::Dummy, which inherit from Mail::Message, not Mail::Box::Message.
• Mail::Message::Dummy's now follow the standard pattern of Mail::Message.
• The Mail::Box::Thread::Manager is now also an extension of a Mail::Reporter.
• The Mail::Box::Thread::Node is now also extends Mail::Reporter.
• Added extra doc to MH::Message to avoid confusion between seqnr and filename (which is a number as well). Needed by [Jerrad Pierce]
• Mail::Message::Part::clone is not a special case of clone at all. Removed.
• Mail::Message::Part::coerce() was much too complicated: most work is already done in Mail::Message::coerce()
• The documentation and sometimes also the location of code in Mail::Message::Head* packages has been improved.
• Improvements in text of Mail::Box-Overview.

version 2.018: Wed Jul 10 23:03:08 CEST 2002

Fixes

• Parser will immediately study multipart en nested messages, because otherwise it will get stuck in nasty multi-level situations. Discovered by [Francois Petillon]
• More picky with quotes in header field attributes... Continuing story with weird multipart boundary strings. This time, [Blair Zajac] forced some improvements.
• Empty headers were not properly skipped. Usually this went undetected... however not in a very rare case [Blair Zajac]
• For read-only folders, the manager always complained about "closing changed folders". Reported by [Blair Zajac] and fixed.
• [Greg Matheson] tries to get Mail::Box running on the Cygwin platform, which will benefit everyone, because it is stricter than UNIX in some cases.... for instance, the Perl parser objects left the file-handle open....
• [Blair Zajac] detected that double messages in a read-only folder cause "Changes not written to read-only folder" messages. Not anymore: the doubles will not be flagged for deletion.

Improvements

• Filenames sometime contained double /'s between folderdir and foldername. Removed.
• Foldernames can be specified like this:

  pop3://username:password@host:port/folder which is broken into separate arguments in a very early stage. This is especially useful when the name is passed in $ENV{MAIL}

• Start of implementation for Mail::Transport::POP3.
• To make space for ::POP3, which is a message receiver, the message senders are now derived from Mail::Transport::Send. New options are added which certainly improve the interface. New packages:

  Mail::Transport::Send Mail::Transport::Receive Mail::Transport::POP3

• Foldernames via $mgr->open() may be specified as URL, for instance

  $mgr->open('mbox:/tmp/inbox') $mgr->open('pop3://me:secret@pop3.server.com:120')

• $mgr->close($folder) and ->closeAllFolders() accept the normal options for $folder->close(OPTIONS).
• $folder->appendMessage($msg) now returns the coerced message.
• Mail::Box::Dir::messageId() should not trigger headers to find unparsed headers with the id: that's the task of Mail::Box::find(). The code was not consistent with the docs.
• Removed Mail::Box::Dir::readAllHeaders()... it contained a bug, so was apperently never used. And that's a good thing.
• Small set of additions to Mail::Box::Net and Mail::Box::POP3 Still in the early stages of development.
• The parser will complain about files which were modified while it was working with it. Some cases where the parser accidentally stayed open were closed to resolve the complaints for the tests.

version 2.017: Fri Jul 5 17:06:08 CEST 2002

Fixes

• Thanks to [Liz Mattijsen] for the detection of some flaws in the QuotedPrintable encoding. Fixed it.
• Nested (rfc822) message clone() did not work. Detected by [Blair Zajac]
• [Greg Matheson] is fixing the test suite for Windows. Very good work. Changes made in t/65search.t

Improvements

• Deleted parts will not be returned in $multipart_body->lines
• Deleted parts will not be counted in $multipart_body->nrLines and ->size
• Deleted parts will not be cloned.
• For efficiency reasons, $multipart_body->foreachComponent will skip deleted parts as well.
• Mail::Box::messages() accepts

  range: $folder->messages(3, 100) non-deleted: $folder->messages('ACTIVE') deleted: $folder->messages('DELETED') labeled: $folder->messages('seen') labeled: $folder->messages('!seen') code: $folder->messages( sub {$_[0]->size > 10000} ) limiting the default result being all messages.

• Mail::Message::parts() accepts

  non-deleted: $msg->parts('ACTIVE') deleted: $msg->parts('DELETED') nested: $msg->parts('RECURSE'); code: $msg->parts( sub {$_[0]->size > 10000)} )

• Mail::Message::Body::Multipart::parts accepts

  non-deleted: $body->parts('ACTIVE') deleted: $body->parts('DELETED') nested: $body->parts('RECURSE'); code: $body->parts( sub {$_[0]->size > 10000)} )

• Mail::Box::allMessageIds() renamed to messageIds(), but old name still available.
• Add suggestion to close() without writing changes.
• Avoid testing of maildir folders for Windows. They are not supported, because maildir uses characters in filenames which are not acceptabled for the Windows file-systyem. [Greg Matheson]
• Added Mail::Box::POP3, Mail::Box::POP3::Message Mail::Box::Net, and Mail::Box::Net::Message as first steps to a POP3 implementation.

version 2.016: Tue Jun 25 16:24:54 CEST 2002

Fixes

• [Edward Wildgoose] was very persist in pushing me to test return codes in Mail::Transport::SMTP. Late transport failures are reported back now.
• [Jeff Squyres] attributes in header fields must be matched case-insensitive.
• $folder->writeable --> $folder->writable, but old method kept for backwards compatibility.
• [Andreas Piper] AIX also requires r+ on a file to get locking via FLOCK to work. I made the detection 'compile-time'.
• The folder to be locked was optional, but used in error messages. Now if is not optional anymore, thanks to [Andreas Piper]
• Simulated sub-folders in Mbox were not correctly automagically created.

Improvements

• Document fixes in Mail/Transport/SMTP.pm by [Liz Mattijsen]
• Recursive copying of whole folders, which may include conversions with Mail::Box::copyTo() with tests in t/66copyto.t
• Interface change: $mgr->addMessages, $folder->addMessage, $mgr->appendMessage, $folder->appendMessage, $mgr->moveMessage, $folder->copyMessage, $message->copyTo now all return the coerced message(s), because that is much more useful than the message which are passed into the method call, the folder, or the class.
• Mail::Box::Manager::open() is rewritten, and a such much improved.
• Much stricter handling of folder closing and folder deletion: when a manager is used, folders are removed before global cleamup commences.
• Mail::Box::Manager::registerType is not requiring all known folder types anymore. This means that adding folder types is without cost now: they are compiled only when used.

version 2.015: Tue Jun 18 19:41:45 CEST 2002

Fixes

• Duplicated messages without subject or to fields will not produce errors anymore.
• Duplicated messages produce NOTICE now, not WARNINGS. Same for empty fields and other minor things the parser detects.
• Multiparts where not correctly processed when read from STDIN: the body type was '::Lines' only. Bug reported by [Evan Borgstrom]
• Bogus message-IDs <> caused problems, but these situations are avoided now. Problem found by [Jost Krieger]

Improvements

• message/rfc822 messages are handled now via a Mail::Message::Body::Nested.pm, Tests in t/21p9rfc.t This all because [Max Poduhoroff] asked for it ;-)
• Removed all tests for Inline::C parser....
• Mail::Message::Body::AUTOLOAD handles errors better, which should provide nicer error-messages.
• Updates on MH/Maildir messages will first be created in an 'invisible' name, to avoid accidental access to partially written messages Mail::Box::Dir::Message::create()
• Mail::Message::Parts can be deleted (ignored for printing and sending). $part->deleted, $part->deleted(0), if($part->deleted)
• timestamp() prefers time from last Received field over first [Jost Krieger]
• Mail::Transport::SMTP: contactServer() --> contactAnyServer() new method tryConnectTo($host, @options);
• $msg->printStructure for debugging purposes (see Mail::Message::Construct)
• Now requires MIME::Types v1.001
• Mail::Message $msg implemented $msg->string, ->lines, ->file

version 2.014: Tue Jun 11 16:26:13 CEST 2002

Fixes

• Forgot to implement the 'delete' method for a header field. The 'reset' method was available to achieve it, but harder to discover for unexperienced programmers. Now 'delete' simply calls 'reset'. Spotted by [Mark Weiler]
• A coerce() from Mail::Message to Mail::Box::Message has to clear the deleted flag (to avoid errors). At the same time, the modified flag is cleared. Detected by [Max Maischein]
• create option to Maildir's works now.
• Signature separator '--' ==> '-- '
• [Gilles Darold] found that m!(['"]?)([^\1])\1! doesn't work. apparently, [^\1] is not working. Temporarily fixed with [^'"] in Mail::Message::Field.

Improvements

• Mail::Transport::SMTP is working now.
• The 'clone' operation on a message will return a Mail::Message object, which avoids complications with copying message between different kinds of folders.
• Maildir messages are moved from 'new' to 'cur' with the new method 'accept'.
• Mbox, MH, pure Perl parser, and modules status "Released" (was "beta")
• Maildir status "Alpha" (was "under development")
• Added some docs to Mail::Transport about receiving messages via POP3. This code may appear in the near future.
• Implemented Mail::Message::Convert::TextAutoformat, t/90textaf.t
• Implemented Mail::Message::Convert::HtmlFormatText, t/90htmlft.t
• Implemented Mail::Message::Convert::HtmlFormatPS, t/90htmlfps.t
• Initial coding of Mail::Message::Convert::Html, t/90html.t
• Mail::Message::Head::grepNames() now accepts regexes as well.
• Mail::Message::Field::wellformedName method added which returns preferred capitization of a field's name. The name() method returns the lower-cased name. Tests in t/11field1.t
• Mail::Message::Field::content returns both body and comment part of the message header line.
• added Mail::Message::Body::charset() to simplify code.
• removed useless Mail::Message::printUndisclosed().

version 2.013: Thu May 23 11:30:35 CEST 2002

Fixes

• Create MH directories when asked to. [Greg Matheson] reported the problem.
• Mail::Box::Locker::new "timeout" and "wait" options where too confusing to be implemented correctly. So they didn't work as described. Now, they are called "expire" and "timeout". Thanks to [John B Batzel] for pointing-out the problems.
• Messages with empty bodies where not accepted at all. This combined with a mistake in treating these errors in Mbox folders gave <undef>s when asked for a body.

Improvements

• Maildir implementation runs all its tests. Still there are some support functions lacking. Reports are that sub-folders are to be implemented differently.

version 2.012: Mon Apr 22 15:53:05 CEST 2002

Fixes

• [alex] found-out that remove_when_empty and save_on_exit could not be set to false for Mail::Box'es.
• [Cory Johns] examples/reply.pl closed the folder but later still used one of its messages. This is not permitted, but may be allowed later.
• [Robin Berjon] multiple improvements to the Maildir implementation. Not finalized yet.
• Mail::Message::Construct->build called Body->new(filename => which must be Body->new(file =>
• Two fixes in Base64 encoding.... Problem reported by [Bernd Patolla]
• Forgot to use File::Copy in Mail::Message::Body::File. reported by [Andre Schultze]

Improvements

• Creation of new message-files for Mail::Box::Dir::Message extensions implemented by a create($filename) method which tries to be very smart.
• [Mark Ethan Trostler] Mail::Message::Field::attribute with value of <undef> gave complaints. For now, these calls with <undef> will be ingnored. In the close future they will remove the attribute.
• Removed references to HTML.pm from all files...

version 2.011: Sun Mar 3 23:51:41 CET 2002

Improvements: -- one day of rapid development ;)

• Mail::Message::read was confusing many users. Therefore, it has been renamed to readFromParser.
• Now read() became unused, it is used to implement my $msg = Mail::Message->read(\*STDIN); Please use it sparsely.
• Implemented Mail::Box::Maildir->writeMessages and Mail::Box::Maildir->appendMessages. Tests in t/44mdir*.t Still small things to fix.
• Mail::Message::clone() includes labels now.

version 2.010: Sun Mar 3 16:05:16 CET 2002

Fixes

• Fixed serious mis-calculation for delayed bodies in MH folders. The 'fail-safe' approach did safe the programs till now, but it is much better now: correct 'Content-Length' headers will safe you time now.
• Improved quite some doc-issues in Mail::Box::MH::(Label|Index).pm
• Prototype of Mail::Message::Body::datafrom_lines was @_, which is a silly typo checked by bleadperl... [Marcel Gruenauer]
• Mail::Box::Parser::Perl line 87, binmode without filehandle... reported by [Marcel Gruenauer] But now it is causing problems with perlio in 5.7.2 ...
• Minor changes to scripts/takemail by [Tassilo v Parseval]
• Mistakes in the docs of Mail::Box::Search::Grep, found by [Tassilo v Parseval]
• Accidentally took only non-delayed messages in Grep: wrong default. Detected by [Tassilo v Parseval]
• The METHOD INDEXes ended with a list of links to related manual-pages which where not expanded correctly by pod. Therefor is was changed: now the INDEX starts with the man-pages which will have correct links this time.

Improvements

• Changed encoders/decoders status from ALPHA to BETA.
• Removed organization option to new() for Mail::Boxes: it is not modifyable. The method which shows whether the folder is DIRECTORY or FILE organized will stay.
• PARTIAL implementation of Maildir folders, which did have large implications for the MH implementation. The maildir implementation is NOT READY yet.

  New class structure:

            Mail::Box::MH
            is a Mail::Box::Dir            <-- new
            is a Mail::Box

            Mail::Box::MH::Message
            is a Mail::Box::Dir::Message   <-- new
            is a Mail::Box::Message
            is a Mail::Message

            Mail::Box::Maildir             <-- new
            is a Mail::Box::Dir            <-- new
            is a Mail::Box

            Mail::Box::Maildir::Message    <-- new
            is a Mail::Box::Dir::Message   <-- new
            is a Mail::Box::Message

        - Massive changes in label management, required to facilitate
          Maildir labels which are in the filename.

        - Added /usr/lib to the safe_directories are searched by
          Mail::Transport for binaries [Slaven Rezic]

        - Any Mail::Box type may implement an 'updateMessages'.  When
          $mailbox->update is called and 'updateMessages' exists, the
          folder tries to figure-out changes in the folder which were
          made by external programs.  External programs may add messages
          to the end of the folder without applying a lock, which is
          dangerous.

version 2.009: Wed Feb 20 09:03:56 CET 2002

Fixes

• Forgot to update METHOD INDEX
• t/65search1g.t tests Mail::Box::Search::Grep, which found some problems in the implementation which are fixed now.

Improvements

• Mail::Box::Manager::threads() now also works when the folders are not used as named parameter:

  $mgr->threads(folders => [$inbox, $outbox]); # was $mgr->threads($inbox, $outbox); # added

• Default output file-handle changed from STDOUT to the selected file-handle (see perldoc -f select)... usually this will return STDOUT.

version 2.008: Mon Feb 18 16:11:52 CET 2002

Fixes

• [Alan Kelm] proved me that the other perl modules are wrong, wrapping the header-lines more often than the RFC permits. So, wrapping on ';' and '.' is removed. Wrapped headers are always accepted, so there is no difference when reading a folder.
• Added 'use Mail::Address' to Mail::Message::Field [Walery Studennikov]
• [Andreas Marcel Riechert] Added -I flag for {net|open}bsd with mailx in Mail::Transport::Mailx
• The parent of a Multipart body after reading accidentally was a body, not a message. Fixed in Mail::Message::Body::Multipart.

Improvements

• New modules Mail::Box::Search and Mail::Box::Search::Grep, however they still need testing. De docs have to be updated too. Mail::Box::Search::Spam must be a piece of cake now. Example in examples/grep.pl
• Replaced -w flag in test-scripts by 'use warnings'
• Centralized definition of folder-files in t/Tools.pm to simplify implementation on Windows.
• t/00windows.t to convert t/mbox.src to t/mbox.win with CRLF line-terminations.
• moved Mail::Message::Body::Encode::eol to Mail::Message::Body::eol because is always needed and hence triggered the parsing of Encode..
• Mail::Message::Body::eol option NATIVE will be translated into LF, CR or CRLF.
• Mail::Message::Body::*::size will return the size of the message as stored in the file, so taking care of \n which becomes CRLF on some systems.
• Croak when $mgr->copyTo/moveTo is used with a message which is not part of a folder yet: appendMessage should be used instead.
• Mail::Box::Thread::Node::threadMessages() collects all messages which are in a thread.

version 2.007: Mon Jan 14 10:07:09 CET 2002

Fixes

• [Alan Kelm] found a mistake in Mail::Box::Locker::DotLock::trylock
• [Alan Kelm] updated some docs about locking.
• [Alan Kelm] folder->new keep_dups option.
• [Alan Kelm] fixed a stupid bug: messages printed to MBOX folders did not get an empty line after them (before the from-line). changed print('') into print("\n") in Mail::Box::Mbox::Messages.pm Mail::Box doesn't need that line, but other mail-agents might.

Improvements

• Avoid colissions between two messages which falsily share messageID. One will get a new number.
• Start implementing understanding of CRLF / CR and foreign line-endings
• Implemented stricter checks. When a body is created, it is not trusted until the data is checked. This is lazy again ;) Specify the checked option for the body is you are sure the data is correct. Also for the folders: when they are `trusted', all bodies will be created `checked', which boosts performance when used with the Perl parser.

version 2.006: Wed Jan 2 08:27:21 CET 2002

Fixes

• Accidentally typed (@_) as prototype of some methods. Found by [Jeffrey Friedl]

version 2.005: Sun Dec 30 14:25:22 CET 2001

Fixes

• Because of a bug related to weak references in the 5.6.0 Perl core, 5.6.1 is required now...

Improvements

• Rewrote Mail::Box::Parser::Perl, to avoid use of unget_line. At the same time, the detection of the folder's line mode is simplified. However, not seek is sparsely used... maybe as next improvement this could be avoided as well.
• The performance is improved considerably when the folder is trusted. However, a little slowdown can be experienced for untrusted folders, because better CRLF handling.
• $mboxmsg->fileLocation returns only begin message in scalar context.
• readHeader returns ref-array for each field i.s.o. four elements in a list.
• Mail::Box::Parser::inDosmode is now called Mail::Box::Parser::lineSeparator. Although a start has been made to support Windows and non-native folders, it is not fully implemented yet.
• Updated the Mail::Box::Parser manual-page.

version 2.004: Sun Dec 16 22:53:06 CET 2001

Fixes

• I didn't know yet, but you can do things like: $reply->head->add(To => $orig->head->get('From')); because of stringification ;)
• $message->from also may return the content of the Sender header.
• Mail::Message::Construct::quotePrelude renamed to ::replyPrelude, which is more consequent.

New

• Added Mail::Message::Construct::forward() and ::forwardSubject. With tests in t/57*
• Replies are even more flexible now.

version 2.003: Sat Dec 15 00:47:50 CET 2001

Fixes

• Moved stuff from Mail::Message::Head::read to Mail::Box::Parser::readHeader to improve parser indepency and speed.
• [Marcel de Boer] showed me that labels were not treated right in Mail::Box v2. Moved from Mail::Box::Message to Mail::Message and Mail::Message::Head.
• [Marcel de Boer] also found a problem with cloning of multiparts which got solved: a Mail::Message::Part is cloned to be a Mail::Message!
• Quite a speed improvement too.
• Changed version policy

version 2.002: Fri Dec 13 17:46:01 CET 2001

Fixes

• Better (less complaining) recovery of bad header parsing.
• Removed a back-reference from a locker object to the folder, by which the folders where kept alive although out of scope. "circular reference". According the errors I got when removing this one, there should be no strong refs left.
• replaced many "warn"s by "$self->log(WARNING =>"s in Mail::Box::Manager.
• Improved handling and creating folders in the Mail::Box::Manager.
• A header may be empty, but then it will be 'false'. This is needed to correctly recover corrupted mbox folders.

New

• Mail::Message::Field::Fast implements a fast but dirty way to store the header information. Tested in t/11field1.t It saves about 10% memory and 7% performance.
• Mail::Message::Field::Flex implements an extendible but slower way to manage the data. Tested in t/11field2.t

version 2.00_19: Wed Dec 12 22:13:56 CET 2001

        Most work about sending messages.  Slight extension of the
        interface for some other packages.

        Fixes:

        - Removed Tassilo's header parser optimization in favor of
          split again, because it breaks on empty fields.

        - [Tassilo v Parseval] added some 'binmode OUT' lines to
          make 98% of the tests succeed on Windows!!  But I am not
          sure that is the right answer.  More on that later.

        New:

        - Added to/from/cc/bcc/subject methods to Mail::Message, to
          hide Resent- header lines which overrule these fields in the
          header.  Required for correct rfc822 support.

        - Added destinations() to Mail::Message.

        - Added isResent() to Mail::Message::Field.

        - Added addresses() to Mail::Message::Field, which returns a list
          of addresses as specified by the header line.

        - Added pod reference to Mail::Message's service methods on header
          lines.

        - Added Mail::Message::Head::Complete::printUndisclosed() and
          Mail::Message::printUndisclosed() which is the same as print()
          but leaving the Cc and Bcc headers out.

        - Added Mail::Transport::putContent($message)

        - Added Mail::Transport::SMTP shaped after Net/SMTP, but much more
          facilities and real Perl 5 code!  Not ready yet.

version 2.00_18: Mon Dec 10 22:19:44 CET 2001

• Added some requires for package FileHandle.
• Added Mail::Transport::Qmail (cannot test it, but expect it to work)
• Reorganized (and improved the docs) on all Transport modules.
• Added POSIX fcntl locking.
• [Tassilo v Parseval] demonstrated the fastest way to split a header, determined by benchmarking 6 variations on the theme. Used in Mail::Box::Parser::Perl.pm

version 2.00_17: Sat Dec 8 23:10:06 CET 2001

• Moved scripts/web/* to scripts/
• Header line options in Mail::Message::Construct::reply start with capitals too.
• Added Mail::Message::Body::Multipart::stripSignature
• Simplified Mail::Message::Construct::reply a little
• Fixed problem with the resulting body-types where delayed bodies where used to be encoded and decoded.
• Extra checks for From-line in mbox folders, to help incorrectly formatted folders.
• [Tassilo v Parseval] discovered the problematic recovery for erroneous headers. Some recovery is tried.

version 2.00_16: Sat Dec 8 16:56:53 CET 2001

First beta of Mail::Box version 2

Most import changes:

• Replaced all use of MIME::Parser, Mail::Internet, and MIME::Entity, althought the foreign message types are still useable in some places.
• All code has been changed. Simple things, like opening a folder, reading messages and such are the same. However handling of messages is really different from the MIME::Entity/Mail::Internet implementation. Your message handling must be body-oriented ;) tranforming a body into a new body, into a new body, and finally create a new message from it. See Mail::Box-Cookbook.
• Moved code to use 5.6.0 features, so no support for 5.005 anymore. This is required for Inline::C and Unicode support. Mail::Box releases below 2 will be supported for some time for people with `old' perl.
• Parsing in Inline::C or plain Perl
• folder->open(take_headers) removed folder->open(extract) replaces folder->open(lazy_extract) to avoid double negation in your program. listFolders became listSubFolders allMessages became messages(); so $folder->messages always returns all.
• Unfolding of headers considered stupid: headers which are structured (check Mail::Message::Field::isStructured) may always be multi-lined. Just specify the right options when you scan through the line with regular expressions.
• All packages is separate files.
• Many more test, a few example files, Mail::Box-Overview and Mail::Box-Cookbook.