diff options
| author | Steve Holme <steve_holme@hotmail.com> | 2013-02-23 23:14:12 +0000 |
|---|---|---|
| committer | Steve Holme <steve_holme@hotmail.com> | 2013-02-23 23:14:12 +0000 |
| commit | cb3ae6894fb2b587669811992989cb98e62acc7a (patch) | |
| tree | 548da8313620a6572128964344938e1f1a0fe718 | |
| parent | e0cbfe825d7d08ae2cf4f6a9bfa02d43aa2184d1 (diff) | |
DOCS: Updated CURLOPT_URL section following recent POP3 and IMAP changes
Updated the POP3 sub-section to refer to message ID rather than mailbox.
Added an IMAP sub-section with example URLs depicting the specification
of mailbox, uid and section.
| -rw-r--r-- | docs/libcurl/curl_easy_setopt.3 | 31 |
1 files changed, 25 insertions, 6 deletions
diff --git a/docs/libcurl/curl_easy_setopt.3 b/docs/libcurl/curl_easy_setopt.3 index aa22a002a..a13e81016 100644 --- a/docs/libcurl/curl_easy_setopt.3 +++ b/docs/libcurl/curl_easy_setopt.3 @@ -727,12 +727,31 @@ the HELO / EHLO command to the mail server at example.com. .B POP3 -The path part of a POP3 request specifies the mailbox (message) to retrieve. -If the mailbox is not specified then a list of waiting messages is returned -instead. - -pop3://user:password@mail.example.com - This lists the available messages -pop3://user:password@mail.example.com/1 - This retrieves the first message +The path part of a POP3 request specifies the message ID to retrieve. If the +ID is not specified then a list of waiting messages is returned instead. + +pop3://user:password@mail.example.com - This lists the available messages for +the user +pop3://user:password@mail.example.com/1 - This retrieves the first message for +the user + +.B IMAP + +The path part of an IMAP request not only specifies the mailbox, but can also +be used to specify the UID and SECTION of the message to fetch (Added in +7.30.0). + +imap://user:password@mail.example.com - Selects the user's INBOX and fetches +message 1 +imap://user:password@mail.example.com/OUTBOX - Selects the user's OUTBOX and +fetches message 1. +imap://user:password@mail.example.com/OUTBOX;UID=2 - Selects the user's OUTBOX +mailbox and fetches message 2 +imap://user:password@mail.example.com/OUTBOX;UID=3/;SECTION=TEXT - Selects the +SENT mailbox and fetches message 3 with only the text portion of the message + +For more information about the individual components of an IMAP URL please +see RFC5092. .B SCP |