X-Git-Url: http://sjero.net/git/?p=wget;a=blobdiff_plain;f=doc%2Fsample.wgetrc;h=1ce90dea24ca576f507ead9834ab6027b39a69fa;hp=4ef63a7c0930c82b30dffba4235c0dd81ab7eaec;hb=bc7ea11d8eac6f2378731b98172d9f9facab3e78;hpb=63fecba71754271508d52da0c89bcea57954f3a6

diff --git a/doc/sample.wgetrc b/doc/sample.wgetrc
index 4ef63a7c..1ce90dea 100644
--- a/doc/sample.wgetrc
+++ b/doc/sample.wgetrc
@@ -10,8 +10,9 @@
 ## Wget initialization file can reside in /usr/local/etc/wgetrc
 ## (global, for all users) or $HOME/.wgetrc (for a single user).
 ##
-## To use any of the settings in this file, you will have to uncomment
-## them (and probably change them).
+## To use the settings in this file, you will have to uncomment them,
+## as well as change them, in most cases, as the values on the
+## commented-out lines are the default values (e.g. "off").
 
 
 ##
@@ -34,12 +35,22 @@
 # the recursive retrieval.  The default is 5.
 #reclevel = 5
 
-# Many sites are behind firewalls that do not allow initiation of
-# connections from the outside.  On these sites you have to use the
-# `passive' feature of FTP.  If you are behind such a firewall, you
-# can turn this on to make Wget use passive FTP by default.
+# By default Wget uses "passive FTP" transfer where the client
+# initiates the data connection to the server rather than the other
+# way around.  That is required on systems behind NAT where the client
+# computer cannot be easily reached from the Internet.  However, some
+# firewalls software explicitly supports active FTP and in fact has
+# problems supporting passive transfer.  If you are in such
+# environment, use "passive_ftp = off" to revert to active FTP.
 #passive_ftp = off
 
+# The "wait" command below makes Wget wait between every connection.
+# If, instead, you want Wget to wait only between retries of failed
+# downloads, set waitretry to maximum number of seconds to wait (Wget
+# will use "linear backoff", waiting 1 second after the first failure
+# on a file, 2 seconds after the second failure, etc. up to this max).
+#waitretry = 10
+
 
 ##
 ## Local settings (for a user to set in his $HOME/.wgetrc).  It is
@@ -62,9 +73,11 @@
 # is *not* sent by default.
 #header = Accept-Language: en
 
-# You can set the default proxy for Wget to use.  It will override the
-# value in the environment.
+# You can set the default proxies for Wget to use for http, https, and ftp.
+# They will override the value in the environment.
+#https_proxy = http://proxy.yoyodyne.com:18023/
 #http_proxy = http://proxy.yoyodyne.com:18023/
+#ftp_proxy = http://proxy.yoyodyne.com:18023/
 
 # If you do not want to use proxy at all, set this to off.
 #use_proxy = on
@@ -82,10 +95,6 @@
 # the number of seconds you want Wget to wait.
 #wait = 0
 
-# If you don't want Wget to wait between every connection, but only between
-# retries of failed downloads, set this to the number of seconds to wait:
-#waitretry = 0
-
 # You can force creating directory structure, even if a single is being
 # retrieved, by setting this to on.
 #dirstruct = off
@@ -94,10 +103,23 @@
 # you are not sure you know what it means) by setting this to on.
 #recursive = off
 
-# To always back up file X as X.orig before converting its links (due to -k /
-# --convert-links / convert_links = on), set this variable to on:
+# To always back up file X as X.orig before converting its links (due
+# to -k / --convert-links / convert_links = on having been specified),
+# set this variable to on:
 #backup_converted = off
 
 # To have Wget follow FTP links from HTML files by default, set this
 # to on:
 #follow_ftp = off
+
+# To try ipv6 addresses first:
+#prefer-family = IPv6
+
+# Set default IRI support state
+#iri = off
+
+# Force the default system encoding
+#locale = UTF-8
+
+# Force the default remote server encoding
+#remoteencoding = UTF-8