1changes(3)            User Contributed Perl Documentation           changes(3)
2
3
4

CHANGE LOG

6       Version 3.031
7           Add an SSL option to connect to the SMTP relay via SSL on port 465.
8           (thanks, Max Maischein)
9
10           Document some tips on using non-ASCII content with MIME::Lite
11           (thanks, traveljury.com and Tom Hukins)
12
13       Version 3.030
14           Make send_by_sendmail set sender like documentation says it does
15           (thanks, Michael Schout!)
16
17       Version 3.029
18           Allow the MIME-Version header to be replaced (thanks, Florian!)
19
20       Version 3.028
21           Various documentation fixes
22
23       Version 3.027
24           Add send_to_testfile method (Thanks, AlexanderBecker)
25
26       Version 3.026
27           Fix tests to pass with MIME::Types 1.28
28
29       Version 3.025
30           Added back support for providing a non-default SMTP port (#21156,
31           #48783, thanks John Bokma!).
32
33       Version 3.024
34           add git repo link to metadata
35
36       Version 3.023
37           Correct erroneous changelog entry
38
39           Fix typo in perldoc: utf-8, not utf8
40
41       Version 3.022
42           Behave on Cygwin as on Win32 with regard to defaulting to SMTP
43           sending.
44
45           Respect crazy people who put multiple Cc or Bcc headers in message
46           (#30574, thanks Pavel V. Rochnyack!)
47
48           We no longer rewrite array and hash refs in the send_by_sendmail
49           args so aggressively.
50
51           Cope with missing local sendmail (thanks to Debian for patching for
52           this, and for putting up with me (rjbs) being an insufferable
53           jerk!)
54
55           Fix weird unicode-in-$1 bug (thanks SREZIC!)
56
57           Other minor bug fixes.
58
59       Version 3.021
60           Replace Email::Date with Email::Date::Format to limit prereqs
61           (Email::Date::Format produced just for this!)
62
63           Begin the process of removing use of ExtUtils::TBone for testing
64
65       Version 3.020
66           Optimized code for speedup of creation of two-part messages. The
67           internal structure of the object has changes, but that won't matter
68           if you were using the published interface.  (Sam Tregar)
69
70           Removed the "advanced features", ie auto-fallback delivery, from
71           send_by_smtp. They didn't belong there in the first place.
72
73       Version 3.01_06 (2007/07/29)
74           First release from Perl Email Project.  Updated packaging.
75
76       Version 3.01_04 (2004/05/05)
77           Reworked the new send_by_smtp stuff. Documentation modifications.
78
79       Version 3.01_02 (2003/08/28)
80           Well, it seems 3.01_01 failed tests on Win32 due to me accidentally
81           changing the line ending format to DOSish. Also the way that email
82           extraction for SMTP with or without Mail::Address was different
83           (from 2.117 even).  So ive fixed that.
84
85           Anybody depending on the undocumented extract_addrs() is in for a
86           suprise.  I suggest you look at using Mail::Address.
87
88       Version 3.01_01 (2003/04/25 - 2003/08/21)
89           (This version is a test release, if its ok then I'll re-release it
90           as 3.02)
91
92           Patched the pod to use correct entities Thanks to Ed Avis  for the
93           patch.  Added better support for funky names in the from field when
94           sending via SMTP, thanks to prodding by Darren Hemphill and Ollie
95           Gallardo. (Actually I kind of messed this up orginally and no doubt
96           Darren wasn't impressed. I ended up using something pretty close to
97           his solution.  My bad for not paying more attention. Sorry mate.)
98
99           08/21: Apparently I never uploaded my changes for this version to
100           CPAN. Sigh.
101
102           *** Win32 CHANGES ***
103
104           Up until this release the default send() method for all OS'es has
105           been to invoke sendmail and pipe the mail to it. This behaviour has
106           now changed on Win32 to default to using SMTP.  This means that if
107           your /site/lib/Net/libnet.cfg file is properly configured then you
108           can use SMTP without specifying a send method explicitly.  This
109           seemed a rational decision as most Win32 users who send mails are
110           using an SMTP server and not a tool like sendmail.
111
112           *** SMTP CHANGES ***
113
114           Jonathan Eunice <jeunice at illuminata dot com> pointed out an
115           interesting bug in the interaction between MIME::Lite and
116           Net::SMTP/Net::CMD.  This was that sending a mail ending in "\n\n"
117           without additional encoding would cause Net::CMD to send an
118           incorrect end of mail signal to the SMTP server which would result
119           in A) The mail failing to be sent due to a timeout, and B)
120           MIME::Lite to report that all was well.
121
122           This has been fixed by checking to make sure that if the last
123           character sent was \n, but the last two chars were not \r\n then
124           the \n is turned into an \r, which Net::CMD then adds an \n to and
125           then sends the normal ".\r\n" to terminate the message.  Weird
126           error, that im not entirely sure has been resolved properly. Please
127           inform me if this screws anything up that it shouldn't.
128
129           As stated earlier send_by_smtp wasnt extracting the _real_ email
130           address from the overall fancy once specified in the From: field.
131           This is resolved now, fancy display names are now possible while
132           using SMTP.
133
134           *** Content-Id ***
135
136           It was pointed out by alex via CPAN RT that Content-Id needs to
137           have angle brackets around it or HTML mails dont show up properly
138           in many mail clients, furthermore the RFC mandates it (to be honest
139           im taking his word on this, please feel free to yell at me if this
140           causes trouble), so as he suggested I am automatically adding them
141           in they arent provided.
142
143           *** sendmail path ***
144
145           Dom pointed out via CPAN RT that despite some effort going in to
146           trying to discover the correct location of sendmail, that it was
147           still using a bad default. Fixed.
148
149           *** Date Stamping ***
150
151           Kurt reported via RT that datestamps were not being correctly
152           formatted. His patch has been incorporated with only one change, a
153           comment where Perl was spelled PERL :-)
154
155           *** Quoted printable fix ***
156
157           Klaus Rusch noted a bug in how quoted-printable handled weird \r\n
158           combinations. Fixed now.
159
160       Version 3.01 (2003/04/25)
161           Eryq has reappeared long enough to graciously hand over the
162           maintaince of the module to me. Thanks.
163
164       Version 3.00 (2003/04/24)
165           Eryq has disappeared. His web site remains but he doesnt answer
166           emails.
167
168           I have taken it onto myself to take over maintenance until he
169           returns to reclaim his excellent work.
170
171           I don't intend to develop this in an serious way. I'll patch it if
172           people have a patch and generally keep it ticking over, but dont
173           expect new features.
174
175           This release has code that actually works with MIME::Lite now. As
176           well as a few other minor additions (like a test for this
177           functionailty)
178
179           For stuff that could be done, a first place would be to rewrite and
180           extend the test suite. It should use Test::More or Test::Builder at
181           the very least.
182
183           I also might rip out the preformatted doc pages. It makes the
184           distro way fatter than it needs to be. I reckon the package
185           contains the POD in at least three forms.  A wee tad overkill I
186           think. :-)
187
188       Version 2.117   (2001/08/20)
189           The terms-of-use have been placed in the distribution file
190           "COPYING".  Also, small documentation tweaks were made.
191
192       Version 2.116   (2001/08/17)
193           Added long-overdue patch which makes the instance method form of
194           send() do the right thing when given HOW... arguments.  Thanks to
195           Casey West for the patch.
196
197       Version 2.114   (2001/08/16)
198           New special 'AUTO' content type in new()/build() tells MIME::Lite
199           to try and guess the type from file extension.  To make use of
200           this, you'll want to install MIME::Types.  The "AUTO" setting can
201           be made the default default (instead of "TEXT") if you set
202           "$AUTO_CONTENT_TYPE = 1, $PARANOID = 0".  Thanks to Ville Skyttä
203           for these patches.
204
205           File::Basename is used if it is available.  Thanks to Ville Skyttä
206           for this patch.
207
208           SMTP failures (in send_by_smtp) now add the $smtp->message to the
209           croak'ed exception, so if things go wrong, you get a better idea of
210           what and why.  Thanks to Thomas R. Wyant III for the patch.
211
212           Made a subtle change to "as_string" which supposedly fixes a failed
213           MIME data.t test with Perl 5.004_04 on NT 4 sp6.  The problem might
214           only exist in this old perl, but as the patch author says, not
215           everyone has climbed higher on the Perl ladder.  Thanks to John
216           Gotts for the patch.
217
218           Added "contrib" directory, with MailTool.pm.  Thanks to Tom Wyant
219           for this contribution.
220
221           Improved HTML documentation (notice the links to the individual
222           methods in the top menu).
223
224           Corrected some mis-docs.
225
226       Version 2.111   (2001/04/03)
227           Added long-overdue "parts()" and "parts_DFS()" methods.
228
229               No instance method
230                  For accessing the subparts?
231               That can't be right.  D'OH!
232
233           Added long-overdue auto-verify logic to "print()" method.
234
235           Added long-overdue "preamble()" method for getting/setting the
236           preamble text.  Thanks to Jim Daigle for inspiring this.
237
238       Version 2.108   (2001/03/30)
239           New "field_order()" allows you to set the header order, both on a
240           per-message basis, and package-wide.  Thanks to Thomas Stromberg
241           for suggesting this.
242
243           Added code to try and divine "sendmail" path more intelligently.
244           Thanks to Slaven Rezic for the suggestion.
245
246       Version 2.107   (2001/03/27)
247           Fixed serious bug where tainted data with quoted-printable encoding
248           was causing infinite loops.  The "fix" untaints the data in
249           question, which is not optimal, but it's probably benign in this
250           case.  Thanks to Stefan Sautter for tracking this nasty little
251           beast down.  Thanks to Larry Geralds for a related patch.
252
253               "Doctor, O doctor:
254                  it's painful when I do *this* --"
255               "Simple: don't *do* that."
256
257           Fixed bugs where a non-local $_ was being modified... again!  Will
258           I never learn?  Thanks to Maarten Koskamp for reporting this.
259
260               Dollar-underscore
261                  can poison distant waters;
262              'local' must it be.
263
264           Fixed buglet in "add()" where all value references were being
265           treated as arrayrefs, instead of as possibly-self-stringifying
266           object refs.  Now you can send in an object ref as the 2nd
267           argument.  Thanks to dLux for the bug report.
268
269               That ref is a string?
270                  Operator overload
271               has ruined my day.
272
273           Added "Approved" as an acceptable header field for "new()", as per
274           RFC1036.  Thanks to Thomax for the suggestion regarding MIME-tools.
275
276           Small improvements to docs to make different uses of attach() and
277           various arguments clearer.  Thanks to Sven Rassman and Roland
278           Walter for the suggestions.
279
280       Version 2.106   (2000/11/21)
281           Added Alpha version of scrub() to make it easy for people to
282           suppress the printing of unwanted MIME attributes (like Content-
283           length).  Thanks to the many people who asked for this.
284
285           Headers with empty-strings for their values are no longer printed.
286           This seems sensible, and helps us implement scrub().
287
288       Version 2.105   (2000/10/14)
289           The regression-test failure was identified, and it was my fault.
290           Apparently some of the \-quoting in my "autoloaded" code was making
291           Perl 5.6 unhappy.  For this nesting-related idiocy, a nesting
292           kaiku.  Thanks to Scott Schwartz for identifying the problem.
293
294               In a pattern, my
295                  backslash-s dwells peacefully,
296               unambiguous --
297
298                  but I embed it
299                     in a double-quoted string
300                  doubling the backslash --
301
302                     interpolating
303                        that same double-quoted string
304                     in other patterns --
305
306                        and, worlds within worlds,
307                           I single-quote the function
308                        to autoload it --
309
310                     changing the meaning
311                  of the backslash and the 's';
312               and Five-Point-Six growls.
313
314       Version 2.104   (2000/09/28)
315           Now attempts to load and use Mail::Address for parsing email
316           addresses before falling back to our own method.  Thanks to
317           numerous people for suggesting this.
318
319               Parsing addresses
320                  is too damn hard. One last hope:
321               Let Graham Barr do it!
322
323           For the curious, the version of Mail::Address appears as the "A"
324           number in the X-Mailer:
325
326               X-Mailer: MIME::Lite 2.104  (A1.15; B2.09; Q2.03)
327
328           Added FromSender option to send_by_sendmail().  Thanks to Bill
329           Moseley for suggesting this feature.
330
331       Version 2.101   (2000/06/06)
332           Major revision to print_body() and body_as_string() so that "body"
333           really means "the part after the header", which is what most people
334           would want in this context.  This is not how it was used 1.x, where
335           "body" only meant "the body of a simple singlepart".  Hopefully,
336           this change will solve many problems and create very few ones.
337
338           Added support for attaching a part to a "message/rfc822", treating
339           the "message" type as a multipart-like container.
340
341           Now takes care not to include "Bcc:" in header when using
342           send_by_smtp, as a safety precaution against qmail's behavior.
343           Thanks to Tatsuhiko Miyagawa for identifying this problem.
344
345           Improved efficiency of many stringifying operations by using
346           string-arrays which are joined, instead of doing multiple appends
347           to a scalar.
348
349           Cleaned up the "examples" directory.
350
351       Version 1.147   (2000/06/02)
352           Fixed buglet where lack of Cc:/Bcc: was causing extract_addrs to
353           emit "undefined variable" warnings.  Also, lack of a "To:" field
354           now causes a croak.  Thanks to David Mitchell for the bug report
355           and suggested patch.
356
357       Version 1.146   (2000/05/18)
358           Fixed bug in parsing of addresses; please read the WARNINGS section
359           which describes recommended address formats for "To:", "Cc:", etc.
360           Also added automatic inclusion of a UT "Date:" at top level unless
361           explicitly told not to.  Thanks to Andy Jacobs for the bug report
362           and the suggestion.
363
364       Version 1.145   (2000/05/06)
365           Fixed bug in encode_7bit(): a lingering "/e" modifier was removed.
366           Thanks to Michael A. Chase for the patch.
367
368       Version 1.142   (2000/05/02)
369           Added new, taint-safe invocation of "sendmail", one which also sets
370           up the "-f" option.  Unfortunately, I couldn't make this automatic:
371           the change could have broken a lot of code out there which used
372           send_by_sendmail() with unusual "sendmail" variants.  So you'll
373           have to configure "send" to use the new mechanism:
374
375               MIME::Lite->send('sendmail');       ### no args!
376
377           Thanks to Jeremy Howard for suggesting these features.
378
379       Version 1.140   (2000/04/27)
380           Fixed bug in support for "To", "Cc", and "Bcc" in send_by_smtp():
381           multiple (comma-separated) addresses should now work fine.  We try
382           real hard to extract addresses from the flat text strings.  Thanks
383           to John Mason for motivating this change.
384
385           Added automatic verification that attached data files exist, done
386           immediately before the "send" action is invoked.  To turn this off,
387           set $MIME::Lite::AUTO_VERIFY to false.
388
389       Version 1.137   (2000/03/22)
390           Added support for "Cc" and "Bcc" in send_by_smtp().  To turn this
391           off, set $MIME::Lite::AUTO_CC to false.  Thanks to Lucas Maneos for
392           the patch, and tons of others for the suggestion.
393
394           Chooses a better default content-transfer-encoding if the content-
395           type is "image/*", "audio/*", etc.  To turn this off, set
396           $MIME::Lite::AUTO_ENCODE to false.  Thanks to many folks for the
397           suggestion.
398
399           Fixed bug in QP-encoding where a non-local $_ was being modified.
400           Thanks to Jochen Stenzel for finding this very obscure bug!
401
402           Removed references to "$`", "$'", and $& (bad variables which slow
403           things down).
404
405           Added an example of how to send HTML files with enclosed in-line
406           images, per popular demand.
407
408       Version 1.133   (1999/04/17)
409           Fixed bug in "Data" handling: arrayrefs were not being handled
410           properly.
411
412       Version 1.130   (1998/12/14)
413           Added much larger and more-flexible send() facility.  Thanks to
414           Andrew McRae (and Optimation New Zealand Ltd) for the Net::SMTP
415           interface.  Additional thanks to the many folks who requested this
416           feature.
417
418           Added get() method for extracting basic attributes.
419
420           New... "t" tests!
421
422       Version 1.124   (1998/11/13)
423           Folded in filehandle (FH) support in build/attach.  Thanks to Miko
424           O'Sullivan for the code.
425
426       Version 1.122   (1998/01/19)
427           MIME::Base64 and MIME::QuotedPrint are used if available.
428
429           The 7bit encoding no longer does "escapes"; it merely strips 8-bit
430           characters.
431
432       Version 1.121   (1997/04/08)
433           Filename attribute is now no longer ignored by build().  Thanks to
434           Ian Smith for finding and patching this bug.
435
436       Version 1.120   (1997/03/29)
437           Efficiency hack to speed up MIME::Lite::IO_Scalar.  Thanks to David
438           Aspinwall for the patch.
439
440       Version 1.116   (1997/03/19)
441           Small bug in our private copy of encode_base64() was patched.
442           Thanks to Andreas Koenig for pointing this out.
443
444           New, prettier way of specifying mail message headers in "build()".
445
446           New quiet method to turn off warnings.
447
448           Changed "stringify" methods to more-standard "as_string" methods.
449
450       Version 1.112   (1997/03/06)
451           Added "read_now()", and "binmode()" method for our non-Unix-using
452           brethren: file data is now read using binmode() if appropriate.
453           Thanks to Xiangzhou Wang for pointing out this bug.
454
455       Version 1.110   (1997/03/06)
456           Fixed bug in opening the data filehandle.
457
458       Version 1.102   (1997/03/01)
459           Initial release.
460
461       Version 1.101   (1997/03/01)
462           Baseline code.  Originally created: 11 December 1996.  Ho ho ho.
463
464
465
466perl v5.32.1                      2021-01-27                        changes(3)
Impressum