diff --git a/docs/curl.1 b/docs/curl.1
index 2a597c7502..9c36c99719 100644
--- a/docs/curl.1
+++ b/docs/curl.1
@@ -1062,6 +1062,9 @@ Consequentially, the file will be saved in the current working directory. If
 you want the file saved in a different directory, make sure you change current
 working directory before you invoke curl with the \fB-O, --remote-name\fP flag!
 
+There is no URL decoding done on the file name. If it has %20 or other URL
+encoded parts of the name, they will end up as-is as file name.
+
 You may use this option as many times as the number of URLs you have.
 .IP "--oauth2-bearer"
 (IMAP, POP3, SMTP)