curl.1: expand on how multiple uses of -o looks

Suggested-by: Dan Jacobson
Issue: https://github.com/curl/curl/issues/1097

diff --git a/docs/curl.1 b/docs/curl.1
index 5843500ba3f6da597fcf87acbe1a09fa6d99f520..b798d6f9e883d7f3ad9421ded5d601999cd74b0d 100644 (file)
--- a/docs/curl.1
+++ b/docs/curl.1
@@ -1239,7 +1239,17 @@ or use several variables like:
 
   curl http://{site,host}.host[1-5].com -o "#1_#2"
 
-You may use this option as many times as the number of URLs you have.
+You may use this option as many times as the number of URLs you have. For
+example, if you specify two URLs on the same command line, you can use it like
+this:
+
+  curl -o aa example.com -o bb example.net
+
+and the order of the -o options and the URLs doesn't matter, just that the
+first -o is for the fir URL and so on, so the above command line can also be
+written as
+
+  curl example.com example.net -o aa -o bb
 
 See also the \fI--create-dirs\fP option to create the local directories
 dynamically. Specifying the output as '-' (a single dash) will force the