~ubuntu-branches/ubuntu/precise/libmime-tools-perl/precise

« back to all changes in this revision

Viewing changes to README-OR-DIE

  • Committer: Bazaar Package Importer
  • Author(s): Nicholas Bamber, gregor herrmann, Nicholas Bamber, Ansgar Burchardt
  • Date: 2011-01-08 13:33:03 UTC
  • mfrom: (1.1.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20110108133303-7jd1dibat2es7pve
Tags: 5.500-1
[ gregor herrmann ]
* Set Standards-Version to 3.9.1; replace Conflicts with Breaks.

[ Nicholas Bamber ]
* Added myself to Uploaders 
* New upstream release
* Updated dependencies
* Refreshed copyright
* Refreshed and forwarded patch

[ Ansgar Burchardt ]
* Make (build-)dep on perl unversioned.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
*IMPORTANT* *IMPORTANT* *IMPORTANT* *IMPORTANT* *IMPORTANT* 
2
 
 
3
 
READ THIS FILE BEFORE YOU DO A "make install", OR YOU MIGHT
4
 
END UP BEING EXTREMELY UNHAPPY!
5
 
 
6
 
------------------------------------------------------------
7
 
INSTALLING ON WIN32:
8
 
 
9
 
Because of unix/Win32 file differences, the test file fun.txt, used in
10
 
the t\Decoder.t test, is different when the distribution is unpacked
11
 
with the cygwin tar/gunzip tools compared to when Winzip is used
12
 
(using the default options). The one created with Winzip is the one to
13
 
use to pass the tests.
14
 
 
15
 
 
16
 
------------------------------------------------------------
17
 
MAJOR CHANGES FROM 3.0 TO 4.0:
18
 
 
19
 
   Temp files
20
 
        FileHandle::tmpfile is no longer emulated if you have Perl5.004,
21
 
        which has fixed the tmpfile() problem; you should (especially
22
 
        if running under Win32) get Perl5.004 ASAP.  Otherwise, the
23
 
        fairly-portable (if ugly) opendup() emulation is hardcoded.
24
 
 
25
 
   Module structure
26
 
        MIME::Latin1 is deprecated.
27
 
     
28
 
        MIME::IO is deprecated; its functionality has been replaced 
29
 
        by the IO::Scalar, IO::ScalarArray, and IO::Wrap modules.
30
 
        You will need these to run the toolkit.
31
 
 
32
 
        New encodings x-uuencode (x-uu) and x-gzip64 
33
 
        are now supported.
34
 
 
35
 
        MIME::Decoder has been split into a tree of modules.
36
 
   
37
 
   Encodings
38
 
        The '7bit' and '8bit' encoders now merely warn of transgressions;
39
 
        '7bit' no longer uses the deprecated MIME::Latin1.
40
 
        
41
 
        The 'quoted-printable' decoder now uses the newest MIME::QuotedPrint,
42
 
        and amends its output with guideline #8 from RFC2049 (From/.).
43
 
 
44
 
   Output
45
 
        Output format is slightly-different (but more sensible)
46
 
        if you use parse_nested_messages() or have singlepart entities
47
 
        with parts attached.  
48
 
        See MIME::Entity::print for details.
49
 
        
50
 
        As of 4.112, MIME::Entity::print_body recurses for multipart
51
 
        entities: this is more convenient and less surprising.
52
 
 
53
 
   Debugging
54
 
        All toolkit warnings may be turned off with config 'QUIET'.
55
 
        See MIME::ToolUtils for details.
56
 
 
57
 
------------------------------------------------------------
58
 
MAJOR CHANGES FROM 1.0 TO 2.0:
59
 
 
60
 
   Module structure
61
 
        As of MIME-tools 2.0...
62
 
 
63
 
                MIME::Head is a subclass of Mail::Header
64
 
                MIME::Entity is a subclass of Mail::Internet
65
 
 
66
 
        If you are upgrading from the MIME-parser 1.0 package, and you used 
67
 
        these module directly, you may notice some warnings about deprecated 
68
 
        constructs in your code... much your stuff should (hopefully) 
69
 
        still work... you'll just see a lot of warnings.  
70
 
 
71
 
        There are some true incompatibilities between MIME::Head 1.0 and 
72
 
        Mail::Header.  Please read the full documentation before proceeding!
73
 
 
74
 
 
75