File: README

package info (click to toggle)
libmail-mboxparser-perl 0.51-1
  • links: PTS
  • area: main
  • in suites: sarge
  • size: 260 kB
  • ctags: 78
  • sloc: perl: 1,415; makefile: 51
file content (77 lines) | stat: -rw-r--r-- 2,383 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
There are now packages for PPM available as well! See below the bits on 
installation to learn how to install those.

--------------------------------------------------------------------------------

Mail::MboxParser is a module for working with UNIX-flavoured mailboxes.
This document describes version 0.51.

Its purpose is to _easily_ extract messages from a mailbox with _simple_ 
access to header fields, body and MIME-parts. It is for those people who 
find the above two module-sets too confusing and heavy-weighted. See the 
list of provided methods below.
It is particularly easy to deal with any kind of attached files. See the 
supplied store_att.pl script for an example. 

Prerequisites:
--------------

    + MIME::Tools (probably >= 5.0)
    + MIME::QuotedPrint (don't know which version)
    
    optional:
    + Mail::Mbox::MessageParser (highly recommended but not necessary)
    + URI::Find if you want to use Mail::MboxParser::Mail::Body->extract_urls
    + Encode (standard module for >= perl5.8.0)

Installation:
-------------

    'make'-enabled systems:
    -----------------------
    Un'tar xfz' the module and 'cd' into the new directory 
    Mail-MboxParser-$VERSION.

    Then install:
        perl Makefile.PL
        make
        make test
        make install

    Win-users having an 'nmake' installed can also do the above, given the
    fact they replace 'make' with 'nmake' in the above list.

    Win-systems:
    ------------
    There should be ppm distributions for ActivePerl under Windows. 
    
    For ActivePerl 5.6.x:

    ppm install 
        http://www-users.rwth-aachen.de/tassilo.parseval/ppm/mail-mboxparser/0.47/5.6/Mail-MboxParser.ppd

    For ActivePerl 5.8.x:

    ppm install 
        http://www-users.rwth-aachen.de/tassilo.parseval/ppm/mail-mboxparser/0.47/5.8/Mail-MboxParser.ppd
    
    If the appropriate package cannot be found, please bug the author.
    
Autoloader:
-----------
Read the Mail::MboxParser::Mail docs for invoking external methods.
The autoloading-mechanism will take care that the below and other things
will work:

	$mail->effective_type; # from MIME::Entity

Have a look into the eg-directory of the package for some (or one) example(s).

Contact:
--------
Bugs, feature requests, questions, comments etc. should be directly 
mailed to me.

Tassilo v. Parseval
<tassilo.von.parseval@rwth-aachen.de>