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