mirror/curl
2
0
Fork 0
mirror of https://github.com/curl/curl.git synced 2024-11-27 05:50:21 +08:00
Code Issues Packages Projects Releases Wiki Activity

DOCS: Updated CURLOPT_URL section following recent POP3 and IMAP changes

Browse Source 
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.
This commit is contained in:
Steve Holme 2013-02-23 23:14:12 +00:00
parent e0cbfe825d
commit cb3ae6894f
1 changed files with 24 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

29
docs/libcurl/curl_easy_setopt.3
View File

@ -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.
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
pop3://user:password@mail.example.com/1 - This retrieves the first message
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