diff --git a/docs/cmdline-opts/write-out.md b/docs/cmdline-opts/write-out.md
index 68f424ff02..caf493cf85 100644
--- a/docs/cmdline-opts/write-out.md
+++ b/docs/cmdline-opts/write-out.md
@@ -195,7 +195,8 @@ The URL scheme (sometimes called protocol) that was effectively used. (Added in
 
 ## `size_delivered`
 The total amount of data that were saved or written to stdout. When
---compressed is used, this is likely different than `size_download`.
+--compressed is used, this is likely different than `size_download`. Includes
+the headers in the count if --include is used.
 
 ## `size_download`
 The total amount of bytes that were downloaded. This is the size of the
diff --git a/docs/libcurl/opts/CURLINFO_SIZE_DELIVERED.md b/docs/libcurl/opts/CURLINFO_SIZE_DELIVERED.md
index df7ffef62b..db699c98a5 100644
--- a/docs/libcurl/opts/CURLINFO_SIZE_DELIVERED.md
+++ b/docs/libcurl/opts/CURLINFO_SIZE_DELIVERED.md
@@ -34,7 +34,7 @@ Pass a pointer to a *curl_off_t* to receive the total amount of bytes that
 were passed on to the write callback in the download. The amount is only for
 the latest transfer and gets reset again for each new transfer. This counts
 actual payload data, what's also commonly called body. All meta and header
-data is excluded from this amount.
+data is excluded from this amount (unless CURLOPT_HEADER(3) is set).
 
 The delivered size may differ from the size retrieved with
 CURLINFO_SIZE_DOWNLOAD_T(3) when CURLOPT_ACCEPT_ENCODING(3) is used for