Debian Codegraph @

README

raw
1 WHAT IS IT?
2
3 This is a POP3 client module for perl5. It provides an
4 object-oriented interface to a POP3 server. It can be used to write
5 perl-based biff clients, mail readers, or whatever. See the inline
6 POD doco for more details. (perldoc Mail::POP3Client)
7
8
9 HOW DO I INSTALL/TEST IT?
10
11 To install Mail::POP3Client:
12
13 % perl Makefile.PL
14 % make
15 % make test
16 % make install
17
18 NOTE: if you want to test against a real mailbox, set the environment
19 variable POPTESTACCOUNT to some POP3 account in the following format:
20 user:password:host.
21
22 % export POPTESTACCOUNT=jsmith:secret:pop3.my.do.main
23 % make test
24
25 On Win32 ActiveState perl, you can install it using the Perl Package
26 Manager (ppm).
27
28
29 HOW DO I USE THIS WHEN MY ISP WON'T INSTALL IT FOR ME?
30
31 You have 2 choices. You can go through the installation process using
32 a prefix option to the make command like this:
33
34 % perl Makefile.PL prefix=/some/other/directory
35
36 then just make; make install as above.
37
38 Or you can create a directory called Mail somewhere and just put
39 POP3Client.pm in there. You will then have to put this directory into
40 your include path (@INC) either on the command line or in your code
41 (i.e. use lib '/path/to/directory'; ). You need to include the
42 directory above Mail and case does matter.
43
44 Choice 1 is better because you can track what modules you have
45 installed but if you don't have command line access you'll have to go
46 with choice 2.
47
48
49 WHERE IS THE DOCUMENTATION?
50
51 The documentation is in the code in POD format. To read it, use
52 'perldoc Mail::POP3Client' or you can extract it to html using
53 pod2html.
54
55
56 I'M SURE MY USERNAME AND PASSWORD ARE CORRECT BUT IT WON'T CONNECT.
57 WHAT'S WRONG?
58
59 Most likely, the server is claiming to support APOP, but for some
60 reason, doesn't. Try adding 'AUTH_MODE=>PASS' to the constructor.
61
62
63 Written by Sean Dowd <[email protected]>
64
65