1changes(3) User Contributed Perl Documentation changes(3)
2
6 Version 3.027
7 Add send_to_testfile method (Thanks, AlexanderBecker)
8 Version 3.026
10 Fix tests to pass with MIME::Types 1.28
11 Version 3.025
13 Added back support for providing a non-default SMTP port (#21156,
14 #48783, thanks John Bokma!).
15 Version 3.024
17 add git repo link to metadata
18 Version 3.023
20 Correct erroneous changelog entry
21 Fix typo in perldoc: utf-8, not utf8
23 Version 3.022
25 Behave on Cygwin as on Win32 with regard to defaulting to SMTP
26 sending.
27 Respect crazy people who put multiple Cc or Bcc headers in message
29 (#30574, thanks Pavel V. Rochnyack!)
30 We no longer rewrite array and hash refs in the send_by_sendmail
32 args so aggressively.
33 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 Fix weird unicode-in-$1 bug (thanks SREZIC!)
39 Other minor bug fixes.
41 Version 3.021
43 Replace Email::Date with Email::Date::Format to limit prereqs
44 (Email::Date::Format produced just for this!)
45 Begin the process of removing use of ExtUtils::TBone for testing
47 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 Removed the "advanced features", ie auto-fallback delivery, from
54 send_by_smtp. They didn't belong there in the first place.
55 Version 3.01_06 (2007/07/29)
57 First release from Perl Email Project. Updated packaging.
58 Version 3.01_04 (2004/05/05)
60 Reworked the new send_by_smtp stuff. Documentation modifications.
61 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 Anybody depending on the undocumented extract_addrs() is in for a
69 suprise. I suggest you look at using Mail::Address.
70 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 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 08/21: Apparently I never uploaded my changes for this version to
83 CPAN. Sigh.
84 *** Win32 CHANGES ***
86 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 *** SMTP CHANGES ***
96 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 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 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 *** Content-Id ***
118 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 *** sendmail path ***
127 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 *** Date Stamping ***
133 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 *** Quoted printable fix ***
139 Klaus Rusch noted a bug in how quoted-printable handled weird \r\n
141 combinations. Fixed now.
142 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 Version 3.00 (2003/04/24)
148 Eryq has disappeared. His web site remains but he doesnt answer
149 emails.
150 I have taken it onto myself to take over maintenance until he
152 returns to reclaim his excellent work.
153 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 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 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 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 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 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 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 File::Basename is used if it is available. Thanks to Ville Skyttae
189 for this patch.
190 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 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 Added "contrib" directory, with MailTool.pm. Thanks to Tom Wyant
202 for this contribution.
203 Improved HTML documentation (notice the links to the individual
205 methods in the top menu).
206 Corrected some mis-docs.
208 Version 2.111 (2001/04/03)
210 Added long-overdue "parts()" and "parts_DFS()" methods.
211 No instance method
213 For accessing the subparts?
214 That can't be right. D'OH!
215 Added long-overdue auto-verify logic to "print()" method.
217 Added long-overdue "preamble()" method for getting/setting the
219 preamble text. Thanks to Jim Daigle for inspiring this.
220 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 Added code to try and divine "sendmail" path more intelligently.
227 Thanks to Slaven Rezic for the suggestion.
228 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 "Doctor, O doctor:
237 it's painful when I do *this* --"
238 "Simple: don't *do* that."
239 Fixed bugs where a non-local $_ was being modified... again! Will
241 I never learn? Thanks to Maarten Koskamp for reporting this.
242 Dollar-underscore
244 can poison distant waters;
245 'local' must it be.
246 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 That ref is a string?
253 Operator overload
254 has ruined my day.
255 Added "Approved" as an acceptable header field for "new()", as per
257 RFC1036. Thanks to Thomax for the suggestion regarding MIME-tools.
258 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 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 Headers with empty-strings for their values are no longer printed.
269 This seems sensible, and helps us implement scrub().
270 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 In a pattern, my
278 backslash-s dwells peacefully,
279 unambiguous --
280 but I embed it
282 in a double-quoted string
283 doubling the backslash --
284 interpolating
286 that same double-quoted string
287 in other patterns --
288 and, worlds within worlds,
290 I single-quote the function
291 to autoload it --
292 changing the meaning
294 of the backslash and the 's';
295 and Five-Point-Six growls.
296 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 Parsing addresses
303 is too damn hard. One last hope:
304 Let Graham Barr do it!
305 For the curious, the version of Mail::Address appears as the "A"
307 number in the X-Mailer:
308 X-Mailer: MIME::Lite 2.104 (A1.15; B2.09; Q2.03)
310 Added FromSender option to send_by_sendmail(). Thanks to Bill
312 Moseley for suggesting this feature.
313 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 Added support for attaching a part to a "message/rfc822", treating
322 the "message" type as a multipart-like container.
323 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 Improved efficiency of many stringifying operations by using
329 string-arrays which are joined, instead of doing multiple appends
330 to a scalar.
331 Cleaned up the "examples" directory.
333 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 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 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 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 MIME::Lite->send('sendmail'); ### no args!
359 Thanks to Jeremy Howard for suggesting these features.
361 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 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 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 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 Fixed bug in QP-encoding where a non-local $_ was being modified.
383 Thanks to Jochen Stenzel for finding this very obscure bug!
384 Removed references to "$`", "$'", and $& (bad variables which slow
386 things down).
387 Added an example of how to send HTML files with enclosed in-line
389 images, per popular demand.
390 Version 1.133 (1999/04/17)
392 Fixed bug in "Data" handling: arrayrefs were not being handled
393 properly.
394 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 Added get() method for extracting basic attributes.
402 New... "t" tests!
404 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 Version 1.122 (1998/01/19)
410 MIME::Base64 and MIME::QuotedPrint are used if available.
411 The 7bit encoding no longer does "escapes"; it merely strips 8-bit
413 characters.
414 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 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 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 New, prettier way of specifying mail message headers in "build()".
428 New quiet method to turn off warnings.
430 Changed "stringify" methods to more-standard "as_string" methods.
432 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 Version 1.110 (1997/03/06)
439 Fixed bug in opening the data filehandle.
440 Version 1.102 (1997/03/01)
442 Initial release.
443 Version 1.101 (1997/03/01)
445 Baseline code. Originally created: 11 December 1996. Ho ho ho.
446perl v5.10.1 2009-10-10 changes(3)