aboutsummaryrefslogtreecommitdiff
path: root/docs/libcurl
diff options
context:
space:
mode:
authorSteve Holme <steve_holme@hotmail.com>2013-03-07 11:51:40 +0000
committerSteve Holme <steve_holme@hotmail.com>2013-03-07 11:51:40 +0000
commit3df1e3583881af7714c6992cba4f8881a33265cf (patch)
tree3c26b8bb5128dcde08459c3fd303eceb9cf71cfb /docs/libcurl
parent7e6d2fe9ec4620d4f9254fbe7d3da30f1ea6dcc8 (diff)
DOCS: Added the list command to the IMAP URL section
Added examples of the list command and clarified existing example URLs following recent changes.
Diffstat (limited to 'docs/libcurl')
-rw-r--r--docs/libcurl/curl_easy_setopt.328
1 files changed, 14 insertions, 14 deletions
diff --git a/docs/libcurl/curl_easy_setopt.3 b/docs/libcurl/curl_easy_setopt.3
index cc419f687..d3d3c828e 100644
--- a/docs/libcurl/curl_easy_setopt.3
+++ b/docs/libcurl/curl_easy_setopt.3
@@ -738,25 +738,25 @@ the user
.B IMAP
-The path part of an IMAP request not only specifies the mailbox to select, but
-can also be used to check the UIDVALIDITY of the mailbox and to specify the
-UID and SECTION of the message to fetch (Added in 7.30.0).
+The path part of an IMAP request not only specifies the mailbox to list (Added
+in 7.30.0) or select, but can also be used to check the UIDVALIDITY of the
+mailbox and 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 - Performs a top level folder list
-imap://user:password@mail.example.com/INBOX/;UIDVALIDITY=50 - Selects the
-user's inbox, checks the UIDVALIDITY of the mailbox is 50 and fetches message
-1 if it is
+imap://user:password@mail.example.com/INBOX - Performs a folder list on the
+user's inbox
-imap://user:password@mail.example.com/OUTBOX - Selects the user's OUTBOX and
-fetches message 1
+imap://user:password@mail.example.com/INBOX/;UID=1 - Selects the user's inbox
+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/INBOX/;UID=2/;UIDVALIDITY=50 - Selects
+the user's inbox, checks the UIDVALIDITY of the mailbox is 50 and fetches
+message 2 if it is
-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
+imap://user:password@mail.example.com/INBOX/;UID=3/;SECTION=TEXT - Selects the
+user's inbox 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.