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

CHANGE LOG

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