@c %**start of header
@setfilename wget.info
@include version.texi
-@set UPDATED Apr 2005
+@set UPDATED Jun 2006
@settitle GNU Wget @value{VERSION} Manual
@c Disable the monstrous rectangles beside overfull hbox-es.
@finalout
data.
@c man begin COPYRIGHT
-Copyright @copyright{} 1996--2005 Free Software Foundation, Inc.
+Copyright @copyright{} 1996--2006 Free Software Foundation, Inc.
Permission is granted to make and distribute verbatim copies of
this manual provided the copyright notice and this permission notice
@end ignore
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.2 or
-any later version published by the Free Software Foundation; with the
-Invariant Sections being ``GNU General Public License'' and ``GNU Free
-Documentation License'', with no Front-Cover Texts, and with no
+any later version published by the Free Software Foundation; with no
+Invariant Sections, with no Front-Cover Texts, and with no
Back-Cover Texts. A copy of the license is included in the section
entitled ``GNU Free Documentation License''.
@c man end
@page
@vskip 0pt plus 1filll
-Copyright @copyright{} 1996--2005, Free Software Foundation, Inc.
+Copyright @copyright{} 1996--2006, Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.2 or
This manual documents version @value{VERSION} of GNU Wget, the freely
available utility for network downloads.
-Copyright @copyright{} 1996--2005 Free Software Foundation, Inc.
+Copyright @copyright{} 1996--2006 Free Software Foundation, Inc.
@menu
* Overview:: Features of Wget.
Specifying a large value for this option is useful if the network or the
destination host is down, so that Wget can wait long enough to
-reasonably expect the network error to be fixed before the retry.
+reasonably expect the network error to be fixed before the retry. The
+waiting interval specified by this function is influenced by
+@code{--random-wait}, which see.
@cindex retries, waiting between
@cindex waiting between retries
Some web sites may perform log analysis to identify retrieval programs
such as Wget by looking for statistically significant similarities in
the time between requests. This option causes the time between requests
-to vary between 0 and 2 * @var{wait} seconds, where @var{wait} was
+to vary between 0.5 and 1.5 * @var{wait} seconds, where @var{wait} was
specified using the @samp{--wait} option, in order to mask Wget's
presence from such analysis.
-A recent article in a publication devoted to development on a popular
+A 2001 article in a publication devoted to development on a popular
consumer platform provided code to perform this analysis on the fly.
Its author suggested blocking at the class C address level to ensure
automated retrieval programs were blocked despite changing DHCP-supplied
Neither options should be needed normally. By default, an IPv6-aware
Wget will use the address family specified by the host's DNS record.
-If the DNS responds with both IPv4 and IPv6 addresses, Wget will them
-in sequence until it finds one it can connect to. (Also see
+If the DNS responds with both IPv4 and IPv6 addresses, Wget will try
+them in sequence until it finds one it can connect to. (Also see
@code{--prefer-family} option described below.)
These options can be used to deliberately force the use of IPv4 or
Now the best bet for downloading a single page and its requisites is the
dedicated @samp{--page-requisites} option.
+@cindex case fold
+@cindex ignore case
+@item --ignore-case
+Ignore case when matching files and directories. This influences the
+behavior of -R, -A, -I, and -X options, as well as globbing
+implemented when downloading from FTP sites. For example, with this
+option, @samp{-A *.txt} will match @samp{file1.txt}, but also
+@samp{file2.TXT}, @samp{file3.TxT}, and so on.
+
@item -H
@itemx --span-hosts
Enable spanning across hosts when doing recursive retrieving
Set @sc{http} user to @var{string}, equivalent to
@samp{--http-user=@var{string}}.
+@item https_proxy = @var{string}
+Use @var{string} as @sc{https} proxy, instead of the one specified in
+environment.
+
+@item ignore_case = on/off
+When set to on, match files and directories case insensitively; the
+same as @samp{--ignore-case}.
+
@item ignore_length = on/off
When set to on, ignore @code{Content-Length} header; the same as
@samp{--ignore-length}.
Use @var{file} as a source of randomness on systems lacking
@file{/dev/random}.
+@item random_wait = on/off
+Turn random between-request wait times on or off. The same as
+@samp{--random-wait}.
+
@item read_timeout = @var{n}
Set the read (and write) timeout---the same as
@samp{--read-timeout=@var{n}}.
Wait up to @var{n} seconds between retries of failed retrievals
only---the same as @samp{--waitretry=@var{n}}. Note that this is
turned on by default in the global @file{wgetrc}.
-
-@item randomwait = on/off
-Turn random between-request wait times on or off. The same as
-@samp{--random-wait}.
@end table
@node Sample Wgetrc
@table @code
@item http_proxy
-This variable should contain the @sc{url} of the proxy for @sc{http}
-connections.
+@itemx https_proxy
+If set, the @code{http_proxy} and @code{https_proxy} variables should
+contain the @sc{url}s of the proxies for @sc{http} and @sc{https}
+connections respectively.
@item ftp_proxy
This variable should contain the @sc{url} of the proxy for @sc{ftp}
-connections. It is quite common that @sc{http_proxy} and @sc{ftp_proxy}
-are set to the same @sc{url}.
+connections. It is quite common that @code{http_proxy} and
+@code{ftp_proxy} are set to the same @sc{url}.
@item no_proxy
This variable should contain a comma-separated list of domain extensions
use of proxy, even if the appropriate environment variables are set.
@item http_proxy = @var{URL}
+@itemx https_proxy = @var{URL}
@itemx ftp_proxy = @var{URL}
@itemx no_proxy = @var{string}
These startup file variables allow you to override the proxy settings
@quotation
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.2 or
-any later version published by the Free Software Foundation; with the
-Invariant Sections being ``GNU General Public License'' and ``GNU Free
-Documentation License'', with no Front-Cover Texts, and with no
+any later version published by the Free Software Foundation; with no
+Invariant Sections, with no Front-Cover Texts, and with no
Back-Cover Texts. A copy of the license is included in the section
entitled ``GNU Free Documentation License''.
@end quotation
projects / wget / blobdiff