1changes(3) User Contributed Perl Documentation changes(3)
2
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 Document some tips on using non-ASCII content with MIME::Lite
11 (thanks, traveljury.com and Tom Hukins)
12 Version 3.030
14 Make send_by_sendmail set sender like documentation says it does
15 (thanks, Michael Schout!)
16 Version 3.029
18 Allow the MIME-Version header to be replaced (thanks, Florian!)
19 Version 3.028
21 Various documentation fixes
22 Version 3.027
24 Add send_to_testfile method (Thanks, AlexanderBecker)
25 Version 3.026
27 Fix tests to pass with MIME::Types 1.28
28 Version 3.025
30 Added back support for providing a non-default SMTP port (#21156,
31 #48783, thanks John Bokma!).
32 Version 3.024
34 add git repo link to metadata
35 Version 3.023
37 Correct erroneous changelog entry
38 Fix typo in perldoc: utf-8, not utf8
40 Version 3.022
42 Behave on Cygwin as on Win32 with regard to defaulting to SMTP
43 sending.
44 Respect crazy people who put multiple Cc or Bcc headers in message
46 (#30574, thanks Pavel V. Rochnyack!)
47 We no longer rewrite array and hash refs in the send_by_sendmail
49 args so aggressively.
50 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 Fix weird unicode-in-$1 bug (thanks SREZIC!)
56 Other minor bug fixes.
58 Version 3.021
60 Replace Email::Date with Email::Date::Format to limit prereqs
61 (Email::Date::Format produced just for this!)
62 Begin the process of removing use of ExtUtils::TBone for testing
64 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 Removed the "advanced features", ie auto-fallback delivery, from
71 send_by_smtp. They didn't belong there in the first place.
72 Version 3.01_06 (2007/07/29)
74 First release from Perl Email Project. Updated packaging.
75 Version 3.01_04 (2004/05/05)
77 Reworked the new send_by_smtp stuff. Documentation modifications.
78 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 Anybody depending on the undocumented extract_addrs() is in for a
86 suprise. I suggest you look at using Mail::Address.
87 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 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 08/21: Apparently I never uploaded my changes for this version to
100 CPAN. Sigh.
101 *** Win32 CHANGES ***
103 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 *** SMTP CHANGES ***
113 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 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 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 *** Content-Id ***
135 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 *** sendmail path ***
144 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 *** Date Stamping ***
150 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 *** Quoted printable fix ***
156 Klaus Rusch noted a bug in how quoted-printable handled weird \r\n
158 combinations. Fixed now.
159 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 Version 3.00 (2003/04/24)
165 Eryq has disappeared. His web site remains but he doesnt answer
166 emails.
167 I have taken it onto myself to take over maintenance until he
169 returns to reclaim his excellent work.
170 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 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 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 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 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 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 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 File::Basename is used if it is available. Thanks to Ville Skyttä
206 for this patch.
207 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 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 Added "contrib" directory, with MailTool.pm. Thanks to Tom Wyant
219 for this contribution.
220 Improved HTML documentation (notice the links to the individual
222 methods in the top menu).
223 Corrected some mis-docs.
225 Version 2.111 (2001/04/03)
227 Added long-overdue "parts()" and "parts_DFS()" methods.
228 No instance method
230 For accessing the subparts?
231 That can't be right. D'OH!
232 Added long-overdue auto-verify logic to "print()" method.
234 Added long-overdue "preamble()" method for getting/setting the
236 preamble text. Thanks to Jim Daigle for inspiring this.
237 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 Added code to try and divine "sendmail" path more intelligently.
244 Thanks to Slaven Rezic for the suggestion.
245 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 "Doctor, O doctor:
254 it's painful when I do *this* --"
255 "Simple: don't *do* that."
256 Fixed bugs where a non-local $_ was being modified... again! Will
258 I never learn? Thanks to Maarten Koskamp for reporting this.
259 Dollar-underscore
261 can poison distant waters;
262 'local' must it be.
263 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 That ref is a string?
270 Operator overload
271 has ruined my day.
272 Added "Approved" as an acceptable header field for "new()", as per
274 RFC1036. Thanks to Thomax for the suggestion regarding MIME-tools.
275 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 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 Headers with empty-strings for their values are no longer printed.
286 This seems sensible, and helps us implement scrub().
287 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 In a pattern, my
295 backslash-s dwells peacefully,
296 unambiguous --
297 but I embed it
299 in a double-quoted string
300 doubling the backslash --
301 interpolating
303 that same double-quoted string
304 in other patterns --
305 and, worlds within worlds,
307 I single-quote the function
308 to autoload it --
309 changing the meaning
311 of the backslash and the 's';
312 and Five-Point-Six growls.
313 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 Parsing addresses
320 is too damn hard. One last hope:
321 Let Graham Barr do it!
322 For the curious, the version of Mail::Address appears as the "A"
324 number in the X-Mailer:
325 X-Mailer: MIME::Lite 2.104 (A1.15; B2.09; Q2.03)
327 Added FromSender option to send_by_sendmail(). Thanks to Bill
329 Moseley for suggesting this feature.
330 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 Added support for attaching a part to a "message/rfc822", treating
339 the "message" type as a multipart-like container.
340 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 Improved efficiency of many stringifying operations by using
346 string-arrays which are joined, instead of doing multiple appends
347 to a scalar.
348 Cleaned up the "examples" directory.
350 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 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 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 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 MIME::Lite->send('sendmail'); ### no args!
376 Thanks to Jeremy Howard for suggesting these features.
378 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 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 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 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 Fixed bug in QP-encoding where a non-local $_ was being modified.
400 Thanks to Jochen Stenzel for finding this very obscure bug!
401 Removed references to "$`", "$'", and $& (bad variables which slow
403 things down).
404 Added an example of how to send HTML files with enclosed in-line
406 images, per popular demand.
407 Version 1.133 (1999/04/17)
409 Fixed bug in "Data" handling: arrayrefs were not being handled
410 properly.
411 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 Added get() method for extracting basic attributes.
419 New... "t" tests!
421 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 Version 1.122 (1998/01/19)
427 MIME::Base64 and MIME::QuotedPrint are used if available.
428 The 7bit encoding no longer does "escapes"; it merely strips 8-bit
430 characters.
431 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 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 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 New, prettier way of specifying mail message headers in "build()".
445 New quiet method to turn off warnings.
447 Changed "stringify" methods to more-standard "as_string" methods.
449 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 Version 1.110 (1997/03/06)
456 Fixed bug in opening the data filehandle.
457 Version 1.102 (1997/03/01)
459 Initial release.
460 Version 1.101 (1997/03/01)
462 Baseline code. Originally created: 11 December 1996. Ho ho ho.
463perl v5.32.0 2020-07-28 changes(3)