diff options
Diffstat (limited to 'mail/p5-Mail-IMAPTalk/pkg-descr')
| -rw-r--r-- | mail/p5-Mail-IMAPTalk/pkg-descr | 46 |
1 files changed, 20 insertions, 26 deletions
diff --git a/mail/p5-Mail-IMAPTalk/pkg-descr b/mail/p5-Mail-IMAPTalk/pkg-descr index 79e70a42f057..0d56d6d84fea 100644 --- a/mail/p5-Mail-IMAPTalk/pkg-descr +++ b/mail/p5-Mail-IMAPTalk/pkg-descr @@ -1,29 +1,23 @@ -This module communicates with an IMAP server. Each IMAP server command is -mapped to a method of this object. +This module communicates with an IMAP server. Each IMAP server command is mapped +to a method of this object. Although other IMAP modules exist on CPAN, this has +several advantages over other modules: +- It parses the more complex IMAP structures like envelopes and body structures + into nice Perl data structures. +- It correctly supports atoms, quoted strings and literals at any point. Some + parsers in other modules aren't fully IMAP compatiable and may break at odd + times with certain messages on some servers. +- It allows large return values (eg. attachments on a message) to be read + directly into a file, rather than into memory. +- It includes some helper functions to find the actual text/plain or text/html + part of a message out of a complex MIME structure. It also can find a list of + attachements, and CID links for HTML messages with attached images. +- It supports decoding of MIME headers to Perl utf-8 strings automatically, so + you don't have to deal with MIME encoded headers (enabled optionally). -Although other IMAP modules exist on CPAN, this has several advantages -over other modules. +While the IMAP protocol does allow for asynchronous running of commands, this +module is designed to be used in a synchronous manner. That is, you issue a +command by calling a method, and the command will block until the appropriate +response is returned. The method will then return the parsed results from the +given command. - * It parses the more complex IMAP structures like envelopes and body -structures into nice Perl data structures. - * It correctly supports atoms, quoted strings and literals at any -point. Some parsers in other modules aren't fully IMAP compatiable and may -break at odd times with certain messages on some servers. - * It allows large return values (eg. attachments on a message) to be -read directly into a file, rather than into memory. - * It includes some helper functions to find the actual text/plain or -text/html part of a message out of a complex MIME structure. It also can -find a list of attachements, and CID links for HTML messages with attached -images. - * It supports decoding of MIME headers to Perl utf-8 strings -automatically, so you don't have to deal with MIME encoded headers -(enabled optionally). - -While the IMAP protocol does allow for asynchronous running of commands, -this module is designed to be used in a synchronous manner. That is, you -issue a command by calling a method, and the command will block until the -appropriate response is returned. The method will then return the parsed -results from the given command. - -Author: Rob Mueller <cpan@robm.fastmail.fm> WWW: http://search.cpan.org/dist/Mail-IMAPTalk/ |