1changes(3) User Contributed Perl Documentation changes(3)
2
6 Version 3.01 (2003/04/25)
7 Eryq has reappeared long enough to graciously hand over the main‐
8 taince of the module to me. Thanks.
9 Version 3.00 (2003/04/24)
11 Eryq has disappeared. His web site remains but he doesnt answer
12 emails.
13 I have taken it onto myself to take over maintenance until he
15 returns to reclaim his excellent work.
16 I don't intend to develop this in an serious way. I'll patch it if
18 people have a patch and generally keep it ticking over, but dont
19 expect new features.
20 This release has code that actually works with MIME::Lite now. As
22 well as a few other minor additions (like a test for this function‐
23 ailty)
24 For stuff that could be done, a first place would be to rewrite and
26 extend the test suite. It should use Test::More or Test::Builder at
27 the very least.
28 I also might rip out the preformatted doc pages. It makes the dis‐
30 tro way fatter than it needs to be. I reckon the package contains
31 the POD in at least three forms. A wee tad overkill I think. :-)
32 Version 2.117 (2001/08/20)
34 The terms-of-use have been placed in the distribution file "COPY‐
35 ING". Also, small documentation tweaks were made.
36 Version 2.116 (2001/08/17)
38 Added long-overdue patch which makes the instance method form of
39 send() do the right thing when given HOW... arguments. Thanks to
40 Casey West for the patch.
41 Version 2.114 (2001/08/16)
43 New special 'AUTO' content type in new()/build() tells MIME::Lite
44 to try and guess the type from file extension. To make use of
45 this, you'll want to install MIME::Types. The "AUTO" setting can
46 be made the default default (instead of "TEXT") if you set
47 "$AUTO_CONTENT_TYPE = 1, $PARANOID = 0". Thanks to Ville
48 SkyttE<#228> for these patches.
49 File::Basename is used if it is available. Thanks to Ville
51 SkyttE<#228> for this patch.
52 SMTP failures (in send_by_smtp) now add the $smtp->message to the
54 croak'ed exception, so if things go wrong, you get a better idea of
55 what and why. Thanks to Thomas R. Wyant III for the patch.
56 Made a subtle change to "as_string" which supposedly fixes a failed
58 MIME data.t test with Perl 5.004_04 on NT 4 sp6. The problem might
59 only exist in this old perl, but as the patch author says, not
60 everyone has climbed higher on the Perl ladder. Thanks to John
61 Gotts for the patch.
62 Added "contrib" directory, with MailTool.pm. Thanks to Tom Wyant
64 for this contribution.
65 Improved HTML documentation (notice the links to the individual
67 methods in the top menu).
68 Corrected some mis-docs.
70 Version 2.111 (2001/04/03)
72 Added long-overdue "parts()" and "parts_DFS()" methods.
73 No instance method
75 For accessing the subparts?
76 That can't be right. D'OH!
77 Added long-overdue auto-verify logic to "print()" method.
79 Added long-overdue "preamble()" method for getting/setting the pre‐
81 amble text. Thanks to Jim Daigle for inspiring this.
82 Version 2.108 (2001/03/30)
84 New "field_order()" allows you to set the header order, both on a
85 per-message basis, and package-wide. Thanks to Thomas Stromberg
86 for suggesting this.
87 Added code to try and divine "sendmail" path more intelligently.
89 Thanks to Slaven Rezic for the suggestion.
90 Version 2.107 (2001/03/27)
92 Fixed serious bug where tainted data with quoted-printable encoding
93 was causing infinite loops. The "fix" untaints the data in ques‐
94 tion, which is not optimal, but it's probably benign in this case.
95 Thanks to Stefan Sautter for tracking this nasty little beast down.
96 Thanks to Larry Geralds for a related patch.
97 "Doctor, O doctor:
99 it's painful when I do *this* --"
100 "Simple: don't *do* that."
101 Fixed bugs where a non-local $_ was being modified... again! Will
103 I never learn? Thanks to Maarten Koskamp for reporting this.
104 Dollar-underscore
106 can poison distant waters;
107 'local' must it be.
108 Fixed buglet in "add()" where all value references were being
110 treated as arrayrefs, instead of as possibly-self-stringifying
111 object refs. Now you can send in an object ref as the 2nd argu‐
112 ment. Thanks to dLux for the bug report.
113 That ref is a string?
115 Operator overload
116 has ruined my day.
117 Added "Approved" as an acceptable header field for "new()", as per
119 RFC1036. Thanks to Thomax for the suggestion regarding MIME-tools.
120 Small improvements to docs to make different uses of attach() and
122 various arguments clearer. Thanks to Sven Rassman and Roland Wal‐
123 ter for the suggestions.
124 Version 2.106 (2000/11/21)
126 Added Alpha version of scrub() to make it easy for people to sup‐
127 press the printing of unwanted MIME attributes (like Con‐
128 tent-length). Thanks to the many people who asked for this.
129 Headers with empty-strings for their values are no longer printed.
131 This seems sensible, and helps us implement scrub().
132 Version 2.105 (2000/10/14)
134 The regression-test failure was identified, and it was my fault.
135 Apparently some of the \-quoting in my "autoloaded" code was making
136 Perl 5.6 unhappy. For this nesting-related idiocy, a nesting
137 kaiku. Thanks to Scott Schwartz for identifying the problem.
138 In a pattern, my
140 backslash-s dwells peacefully,
141 unambiguous --
142 but I embed it
144 in a double-quoted string
145 doubling the backslash --
146 interpolating
148 that same double-quoted string
149 in other patterns --
150 and, worlds within worlds,
152 I single-quote the function
153 to autoload it --
154 changing the meaning
156 of the backslash and the 's';
157 and Five-Point-Six growls.
158 Version 2.104 (2000/09/28)
160 Now attempts to load and use Mail::Address for parsing email
161 addresses before falling back to our own method. Thanks to numer‐
162 ous people for suggesting this.
163 Parsing addresses
165 is too damn hard. One last hope:
166 Let Graham Barr do it!
167 For the curious, the version of Mail::Address appears as the "A"
169 number in the X-Mailer:
170 X-Mailer: MIME::Lite 2.104 (A1.15; B2.09; Q2.03)
172 Added FromSender option to send_by_sendmail(). Thanks to Bill
174 Moseley for suggesting this feature.
175 Version 2.101 (2000/06/06)
177 Major revision to print_body() and body_as_string() so that "body"
178 really means "the part after the header", which is what most people
179 would want in this context. This is not how it was used 1.x, where
180 "body" only meant "the body of a simple singlepart". Hopefully,
181 this change will solve many problems and create very few ones.
182 Added support for attaching a part to a "message/rfc822", treating
184 the "message" type as a multipart-like container.
185 Now takes care not to include "Bcc:" in header when using
187 send_by_smtp, as a safety precaution against qmail's behavior.
188 Thanks to Tatsuhiko Miyagawa for identifying this problem.
189 Improved efficiency of many stringifying operations by using
191 string-arrays which are joined, instead of doing multiple appends
192 to a scalar.
193 Cleaned up the "examples" directory.
195 Version 1.147 (2000/06/02)
197 Fixed buglet where lack of Cc:/Bcc: was causing extract_addrs to
198 emit "undefined variable" warnings. Also, lack of a "To:" field
199 now causes a croak. Thanks to David Mitchell for the bug report
200 and suggested patch.
201 Version 1.146 (2000/05/18)
203 Fixed bug in parsing of addresses; please read the WARNINGS section
204 which describes recommended address formats for "To:", "Cc:", etc.
205 Also added automatic inclusion of a UT "Date:" at top level unless
206 explicitly told not to. Thanks to Andy Jacobs for the bug report
207 and the suggestion.
208 Version 1.145 (2000/05/06)
210 Fixed bug in encode_7bit(): a lingering "/e" modifier was removed.
211 Thanks to Michael A. Chase for the patch.
212 Version 1.142 (2000/05/02)
214 Added new, taint-safe invocation of "sendmail", one which also sets
215 up the "-f" option. Unfortunately, I couldn't make this automatic:
216 the change could have broken a lot of code out there which used
217 send_by_sendmail() with unusual "sendmail" variants. So you'll
218 have to configure "send" to use the new mechanism:
219 MIME::Lite->send('sendmail'); ### no args!
221 Thanks to Jeremy Howard for suggesting these features.
223 Version 1.140 (2000/04/27)
225 Fixed bug in support for "To", "Cc", and "Bcc" in send_by_smtp():
226 multiple (comma-separated) addresses should now work fine. We try
227 real hard to extract addresses from the flat text strings. Thanks
228 to John Mason for motivating this change.
229 Added automatic verification that attached data files exist, done
231 immediately before the "send" action is invoked. To turn this off,
232 set $MIME::Lite::AUTO_VERIFY to false.
233 Version 1.137 (2000/03/22)
235 Added support for "Cc" and "Bcc" in send_by_smtp(). To turn this
236 off, set $MIME::Lite::AUTO_CC to false. Thanks to Lucas Maneos for
237 the patch, and tons of others for the suggestion.
238 Chooses a better default content-transfer-encoding if the content-
240 type is "image/*", "audio/*", etc. To turn this off, set
241 $MIME::Lite::AUTO_ENCODE to false. Thanks to many folks for the
242 suggestion.
243 Fixed bug in QP-encoding where a non-local $_ was being modified.
245 Thanks to Jochen Stenzel for finding this very obscure bug!
246 Removed references to $`, $', and $& (bad variables which slow
248 things down).
249 Added an example of how to send HTML files with enclosed in-line
251 images, per popular demand.
252 Version 1.133 (1999/04/17)
254 Fixed bug in "Data" handling: arrayrefs were not being handled
255 properly.
256 Version 1.130 (1998/12/14)
258 Added much larger and more-flexible send() facility. Thanks to
259 Andrew McRae (and Optimation New Zealand Ltd) for the Net::SMTP
260 interface. Additional thanks to the many folks who requested this
261 feature.
262 Added get() method for extracting basic attributes.
264 New... "t" tests!
266 Version 1.124 (1998/11/13)
268 Folded in filehandle (FH) support in build/attach. Thanks to Miko
269 O'Sullivan for the code.
270 Version 1.122 (1998/01/19)
272 MIME::Base64 and MIME::QuotedPrint are used if available.
273 The 7bit encoding no longer does "escapes"; it merely strips 8-bit
275 characters.
276 Version 1.121 (1997/04/08)
278 Filename attribute is now no longer ignored by build(). Thanks to
279 Ian Smith for finding and patching this bug.
280 Version 1.120 (1997/03/29)
282 Efficiency hack to speed up MIME::Lite::IO_Scalar. Thanks to David
283 Aspinwall for the patch.
284 Version 1.116 (1997/03/19)
286 Small bug in our private copy of encode_base64() was patched.
287 Thanks to Andreas Koenig for pointing this out.
288 New, prettier way of specifying mail message headers in "build()".
290 New quiet method to turn off warnings.
292 Changed "stringify" methods to more-standard "as_string" methods.
294 Version 1.112 (1997/03/06)
296 Added "read_now()", and "binmode()" method for our non-Unix-using
297 brethren: file data is now read using binmode() if appropriate.
298 Thanks to Xiangzhou Wang for pointing out this bug.
299 Version 1.110 (1997/03/06)
301 Fixed bug in opening the data filehandle.
302 Version 1.102 (1997/03/01)
304 Initial release.
305 Version 1.101 (1997/03/01)
307 Baseline code. Originally created: 11 December 1996. Ho ho ho.
308perl v5.8.8 2003-04-24 changes(3)