improved the description of the -L/--location option
authorDaniel Stenberg <daniel@haxx.se>
Mon, 16 Jan 2006 00:00:28 +0000 (00:00 +0000)
committerDaniel Stenberg <daniel@haxx.se>
Mon, 16 Jan 2006 00:00:28 +0000 (00:00 +0000)
docs/curl.1

index a6d0ef1..af2e817 100644 (file)
@@ -570,14 +570,15 @@ subdirectories and symbolic links.
 
 If this option is used twice, the second will again disable list only.
 .IP "-L/--location"
-(HTTP/HTTPS) If the server reports that the requested page has a different
-location (indicated with the header line Location:) this flag will let curl
-attempt to reattempt the get on the new place. If used together with
-\fI-i/--include\fP or \fI-I/--head\fP, headers from all requested pages will
-be shown. If authentication is used, curl will only send its credentials to
-the initial host, so if a redirect takes curl to a different host, it won't
-intercept the user+password. See also \fI--location-trusted\fP on how to
-change this.
+(HTTP/HTTPS) If the server reports that the requested page has moved to a
+different location (indicated with a Location: header and a 3XX response code)
+this option will make curl redo the request on the new place. If used together
+with \fI-i/--include\fP or \fI-I/--head\fP, headers from all requested pages
+will be shown. When authentication is used, curl only sends its credentials to
+the initial host. If a redirect takes curl to a different host, it won't be
+able to intercept the user+password. See also \fI--location-trusted\fP on how
+to change this. You can limit the amount of redirects to follow by using the
+\fI--max-redirs\fP option.
 
 If this option is used twice, the second will again disable location following.
 .IP "--location-trusted"