CURLOPT_UPLOAD_FLAGS.md: expand

And list each supported flag in a nicer way

Closes #21218

diff --git a/docs/libcurl/opts/CURLOPT_UPLOAD_FLAGS.md b/docs/libcurl/opts/CURLOPT_UPLOAD_FLAGS.md
index 973af24b803251d6eec9be40ae3b0b1e3d9b2cef..0faf3a9944573085721fcdf3bf8f2f612ef9fd26 100644 (file)
--- a/docs/libcurl/opts/CURLOPT_UPLOAD_FLAGS.md
+++ b/docs/libcurl/opts/CURLOPT_UPLOAD_FLAGS.md
@@ -27,12 +27,34 @@ CURLcode curl_easy_setopt(CURL *handle, CURLOPT_UPLOAD_FLAGS, long bitmask);
 # DESCRIPTION
 
 Pass a long as parameter, which is set to a bitmask, to tell libcurl which
-flags to send the server relating to uploaded files. The current supported
-flags are **CURLULFLAG_ANSWERED**, which sets the **Answered** flag for IMAP
-uploads, **CURLULFLAG_DELETED**, which sets the **Deleted** flag for IMAP
-uploads, **CURLULFLAG_DRAFT**, which sets the **Draft** flag for IMAP uploads,
-**CURLULFLAG_FLAGGED**, which sets the **Flagged** flag for IMAP uploads, and
-**CURLULFLAG_SEEN**, which sets the **Seen** flag for IMAP uploads.
+flags to send the server relating to uploaded files. The currently supported
+flags are:
+
+## `CURLULFLAG_ANSWERED`
+
+Sets the **Answered** flag for IMAP uploads. Indicates that the message has
+been replied to.
+
+## `CURLULFLAG_DELETED`
+
+Sets the **Deleted** flag for IMAP uploads. Marks the message for deletion
+rather than immediately removing it.
+
+## `CURLULFLAG_DRAFT`
+
+Sets the **Draft** flag for IMAP uploads. Marks the message as an uncompleted
+composition.
+
+## `CURLULFLAG_FLAGGED`
+
+Sets the **Flagged** flag for IMAP uploads. Marks the message for special
+attention.
+
+## `CURLULFLAG_SEEN`
+
+Sets the **Seen** flag for IMAP uploads. Marks the message as read.
+
+##
 
 # DEFAULT