Well,
it seems 3.01_01 failed tests on Win32 due to me accidentally changing the line ending format to DOSish.
Also the way that email extraction for SMTP with or without Mail::Address was different (from 2.117 even).
So ive fixed that.

Anybody depending on the undocumented extract_addrs() is in for a suprise.
I suggest you look at using Mail::Address.

(This version is a test release,
if its ok then I'll re-release it as 3.02)

Patched the pod to use correct entities Thanks to Ed Avis for the patch.
Added better support for funky names in the from field when sending via SMTP,
thanks to prodding by Darren Hemphill and Ollie Gallardo.
(Actually I kind of messed this up orginally and no doubt Darren wasn't impressed.
I ended up using something pretty close to his solution.
My bad for not paying more attention.
Sorry mate.)

08/21: Apparently I never uploaded my changes for this version to CPAN.
Sigh.

*** Win32 CHANGES ***

Up until this release the default send() method for all OS'es has been to invoke sendmail and pipe the mail to it.
This behaviour has now changed on Win32 to default to using SMTP.
This means that if your /site/lib/Net/libnet.cfg file is properly configured then you can use SMTP without specifying a send method explicitly.
This seemed a rational decision as most Win32 users who send mails are using an SMTP server and not a tool like sendmail.

*** SMTP CHANGES ***

Jonathan Eunice <jeunice at illuminata dot com> pointed out an interesting bug in the interaction between MIME::Lite and Net::SMTP/Net::CMD.
This was that sending a mail ending in "\n\n" without additional encoding would cause Net::CMD to send an incorrect end of mail signal to the SMTP server which would result in A) The mail failing to be sent due to a timeout,
and B) MIME::Lite to report that all was well.

This has been fixed by checking to make sure that if the last character sent was \n,
but the last two chars were not \r\n then the \n is turned into an \r,
which Net::CMD then adds an \n to and then sends the normal ".\r\n" to terminate the message.
Weird error,
that im not entirely sure has been resolved properly.
Please inform me if this screws anything up that it shouldn't.

As stated earlier send_by_smtp wasnt extracting the _real_ email address from the overall fancy once specified in the From: field.
This is resolved now,
fancy display names are now possible while using SMTP.

*** Content-Id ***

It was pointed out by alex via CPAN RT that Content-Id needs to have angle brackets around it or HTML mails dont show up properly in many mail clients,
furthermore the RFC mandates it (to be honest im taking his word on this,
please feel free to yell at me if this causes trouble),
so as he suggested I am automatically adding them in they arent provided.

*** sendmail path ***

Dom pointed out via CPAN RT that despite some effort going in to trying to discover the correct location of sendmail,
that it was still using a bad default.
Fixed.

*** Date Stamping ***

Kurt reported via RT that datestamps were not being correctly formatted.
His patch has been incorporated with only one change,
a comment where Perl was spelled PERL :-)

New special 'AUTO' content type in new()/build() tells MIME::Lite to try and guess the type from file extension.
To make use of this,
you'll want to install MIME::Types.
The "AUTO" setting can be made the default default (instead of "TEXT") if you set $AUTO_CONTENT_TYPE = 1,
$PARANOID = 0.
Thanks to Ville Skyttä for these patches.

File::Basename is used if it is available.
Thanks to Ville Skyttä for this patch.

SMTP failures (in send_by_smtp) now add the $smtp->message to the croak'ed exception,
so if things go wrong,
you get a better idea of what and why.
Thanks to Thomas R.
Wyant III for the patch.

Made a subtle change to as_string which supposedly fixes a failed MIME data.t test with Perl 5.004_04 on NT 4 sp6.
The problem might only exist in this old perl,
but as the patch author says,
not everyone has climbed higher on the Perl ladder.
Thanks to John Gotts for the patch.

Added contrib directory,
with MailTool.pm.
Thanks to Tom Wyant for this contribution.

Improved HTML documentation (notice the links to the individual methods in the top menu).

Fixed serious bug where tainted data with quoted-printable encoding was causing infinite loops. The "fix" untaints the data in question, which is not optimal, but it's probably benign in this case. Thanks to Stefan Sautter for tracking this nasty little beast down.Thanks to Larry Geralds for a related patch.

Fixed bugs where a non-local $_ was being modified... again! Will I never learn? Thanks to Maarten Koskamp for reporting this.

Dollar-underscore
can poison distant waters;
'local' must it be.

Fixed buglet in add() where all value references were being treated as arrayrefs, instead of as possibly-self-stringifying object refs. Now you can send in an object ref as the 2nd argument. Thanks to dLux for the bug report.

That ref is a string?
Operator overload
has ruined my day.

Added "Approved" as an acceptable header field for new(), as per RFC1036. Thanks to Thomax for the suggestion regarding MIME-tools.

Small improvements to docs to make different uses of attach() and various arguments clearer. Thanks to Sven Rassman and Roland Walter for the suggestions.

The regression-test failure was identified, and it was my fault. Apparently some of the \-quoting in my "autoloaded" code was making Perl 5.6 unhappy. For this nesting-related idiocy, a nesting kaiku. Thanks to Scott Schwartz for identifying the problem.

In a pattern, my
backslash-s dwells peacefully,
unambiguous --
but I embed it
in a double-quoted string
doubling the backslash --
interpolating
that same double-quoted string
in other patterns --
and, worlds within worlds,
I single-quote the function
to autoload it --
changing the meaning
of the backslash and the 's';
and Five-Point-Six growls.

Major revision to print_body() and body_as_string() so that "body" really means "the part after the header", which is what most people would want in this context. This is not how it was used 1.x, where "body" only meant "the body of a simple singlepart". Hopefully, this change will solve many problems and create very few ones.

Added support for attaching a part to a "message/rfc822", treating the "message" type as a multipart-like container.

Now takes care not to include "Bcc:" in header when using send_by_smtp, as a safety precaution against qmail's behavior. Thanks to Tatsuhiko Miyagawa for identifying this problem.

Improved efficiency of many stringifying operations by using string-arrays which are joined, instead of doing multiple appends to a scalar.

Fixed buglet where lack of Cc:/Bcc: was causing extract_addrs to emit "undefined variable" warnings. Also, lack of a "To:" field now causes a croak. Thanks to David Mitchell for the bug report and suggested patch.

Fixed bug in parsing of addresses; please read the WARNINGS section which describes recommended address formats for "To:", "Cc:", etc. Also added automatic inclusion of a UT "Date:" at top level unless explicitly told not to. Thanks to Andy Jacobs for the bug report and the suggestion.

Added new, taint-safe invocation of "sendmail", one which also sets up the -f option. Unfortunately, I couldn't make this automatic: the change could have broken a lot of code out there which used send_by_sendmail() with unusual "sendmail" variants. So you'll have to configure "send" to use the new mechanism:

Fixed bug in support for "To", "Cc", and "Bcc" in send_by_smtp(): multiple (comma-separated) addresses should now work fine. We try real hard to extract addresses from the flat text strings. Thanks to John Mason for motivating this change.

Added automatic verification that attached data files exist, done immediately before the "send" action is invoked. To turn this off, set $MIME::Lite::AUTO_VERIFY to false.

Added much larger and more-flexible send() facility. Thanks to Andrew McRae (and Optimation New Zealand Ltd) for the Net::SMTP interface. Additional thanks to the many folks who requested this feature.