X-Git-Url: http://sjero.net/git/?a=blobdiff_plain;f=doc%2Fwget.texi;h=950c1eaac8a0266b9f379cc8fe5aa7ba61326520;hb=b5c9573ad6396acf3e4e33d0ae0db65b413b0d66;hp=af211e354d96a85fea93d31bc0c51fec1925af96;hpb=1489612dd1e604b8ccf4b4d7326ebcc93ca56923;p=wget diff --git a/doc/wget.texi b/doc/wget.texi index af211e35..950c1eaa 100644 --- a/doc/wget.texi +++ b/doc/wget.texi @@ -31,7 +31,7 @@ data. @c man begin COPYRIGHT Copyright @copyright{} 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, -2004, 2005, 2006, 2007, 2008, 2009 Free Software Foundation, Inc. +2004, 2005, 2006, 2007, 2008, 2009, 2010 Free Software Foundation, Inc. @iftex Permission is granted to make and distribute verbatim copies of @@ -579,7 +579,8 @@ some cases where this behavior can actually have some use. Note that a combination with @samp{-k} is only permitted when downloading a single document, as in that case it will just convert all relative URIs to external ones; @samp{-k} makes no sense for -multiple URIs when they're all being downloaded to a single file. +multiple URIs when they're all being downloaded to a single file; +@samp{-k} can be used only when the output is a regular file. @cindex clobbering, file @cindex downloading multiple times @@ -719,6 +720,16 @@ use @samp{--progress=bar:force}. @itemx --timestamping Turn on time-stamping. @xref{Time-Stamping}, for details. +@item --no-use-server-timestamps +Don't set the local file's timestamp by the one on the server. + +By default, when a file is downloaded, it's timestamps are set to +match those from the remote file. This allows the use of +@samp{--timestamping} on subsequent invocations of wget. However, it +is sometimes useful to base the local file's timestamp on when it was +actually downloaded; for that purpose, the +@samp{--no-use-server-timestamps} option has been provided. + @cindex server response, print @item -S @itemx --server-response @@ -1064,6 +1075,13 @@ header and in HTML @code{Content-Type http-equiv} meta tag. You can set the default encoding using the @code{remoteencoding} command in @file{.wgetrc}. That setting may be overridden from the command line. + +@cindex unlink +@item --unlink + +Force Wget to unlink file instead of clobbering existing file. This +option is useful for downloading to the directory with hardlinks. + @end table @node Directory Options, HTTP Options, Download Options, Invoking @@ -1487,6 +1505,13 @@ This option is useful for some file-downloading CGI programs that use @code{Content-Disposition} headers to describe what the name of a downloaded file should be. +@cindex Trust server names +@item --trust-server-names + +If this is set to on, on a redirect the last component of the +redirection URL will be used as the local file name. By default it is +used the last component in the original URL. + @cindex authentication @item --auth-no-challenge @@ -1954,7 +1979,7 @@ Set domains to be followed. @var{domain-list} is a comma-separated list of domains. Note that it does @emph{not} turn on @samp{-H}. @item --exclude-domains @var{domain-list} -Specify the domains that are @emph{not} to be followed. +Specify the domains that are @emph{not} to be followed (@pxref{Spanning Hosts}). @cindex follow FTP links @@ -2799,6 +2824,10 @@ Set the connect timeout---the same as @samp{--connect-timeout}. Turn on recognition of the (non-standard) @samp{Content-Disposition} HTTP header---if set to @samp{on}, the same as @samp{--content-disposition}. +@item trust_server_names = on/off +If set to on, use the last component of a redirection URL for the local +file name. + @item continue = on/off If set to on, force continuation of preexistent partially retrieved files. See @samp{-c} before setting it. @@ -3157,6 +3186,10 @@ Set all applicable timeout values to @var{n}, the same as @samp{-T @item timestamping = on/off Turn timestamping on/off. The same as @samp{-N} (@pxref{Time-Stamping}). +@item use_server_timestamps = on/off +If set to @samp{off}, Wget won't set the local file's timestamp by the +one on the server (same as @samp{--no-use-server-timestamps}). + @item tries = @var{n} Set number of retries per @sc{url}---the same as @samp{-t @var{n}}.