[svn] Don't advertise --no-dns-cache as necessary for dyndns downloads.

diff --git a/doc/ChangeLog b/doc/ChangeLog
index e7fabbf6161212b48c5f43337a7e35bf889e90ed..b53bf42179fda118933629c8a95883d4de1af802 100644 (file)
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,8 @@
+2005-04-18  Hrvoje Niksic  <hniksic@xemacs.org>
+
+       * wget.texi (Download Options): Don't claim that --no-dns-cache is
+       necessary for dyndns servers -- it's not.
+
 2005-04-08  Larry Jones  <lawrence.jones@ugsplm.com>
 
        * Makefile.in (wget.info): Don't use $< in an explicit rule.

diff --git a/doc/wget.texi b/doc/wget.texi
index 6719991b01102ca64307f6e9d3c2a5d646e22b31..e959effd9d2e8c39db5b6188ede646c9b2ea8d8a 100644 (file)
--- a/doc/wget.texi
+++ b/doc/wget.texi
@@ -813,26 +813,24 @@ Setting quota to 0 or to @samp{inf} unlimits the download quota.
 
 @cindex DNS cache
 @cindex caching of DNS lookups
-@item --dns-cache=off
-Turn off caching of DNS lookups.  Normally, Wget remembers the addresses
-it looked up from DNS so it doesn't have to repeatedly contact the DNS
-server for the same (typically small) set of addresses it retrieves
-from.  This cache exists in memory only; a new Wget run will contact DNS
-again.
-
-However, in some cases it is not desirable to cache host names, even for
-the duration of a short-running application like Wget.  For example,
-some HTTP servers are hosted on machines with dynamically allocated IP
-addresses that change from time to time.  Their DNS entries are updated
-along with each change.  When Wget's download from such a host gets
-interrupted by IP address change, Wget retries the download, but (due to
-DNS caching) it contacts the old address.  With the DNS cache turned
-off, Wget will repeat the DNS lookup for every connect and will thus get
-the correct dynamic address every time---at the cost of additional DNS
-lookups where they're probably not needed.
-
-If you don't understand the above description, you probably won't need
-this option.
+@item --no-dns-cache
+Turn off caching of DNS lookups.  Normally, Wget remembers the IP
+addresses it looked up from DNS so it doesn't have to repeatedly
+contact the DNS server for the same (typically small) set of hosts it
+retrieves from.  This cache exists in memory only; a new Wget run will
+contact DNS again.
+
+However, it has been reported that in some situations it is not
+desirable to cache host names, even for the duration of a
+short-running application like Wget.  With this option Wget issues a
+new DNS lookup (more precisely, a new call to @code{gethostbyname} or
+@code{getaddrinfo}) each time it makes a new connection.  Please note
+that this option will @emph{not} affect caching that might be
+performed by the resolving library or by an external caching layer,
+such as NSCD.
+
+If you don't understand exactly what this option does, you probably
+won't need it.
 
 @cindex file names, restrict
 @cindex Windows file names
@@ -1065,7 +1063,7 @@ Write down the name and value of the cookie, and manually instruct Wget
 to send those cookies, bypassing the ``official'' cookie support:
 
 @example
-wget --cookies=off --header "Cookie: @var{name}=@var{value}"
+wget --no-cookies --header "Cookie: @var{name}=@var{value}"
 @end example
 
 @cindex saving cookies