dependencies, and distclean cleanup of this new file.
* sample.wgetrc: Uncommented waitretry and set it to 10, clarified some wording,
and re-wrapped some text to 71 columns due to @sample indentation in
wget.texi.
* wget.texi: Herold further expounded on the behavior of waitretry -- reworded
docs again. Changed note saying _all_ lines in sample.wgetrc are commented
out. Don't have an entire hand- cut-and-pasted copy of sample.wgetrc in this
file -- use @include.
+2000-04-13 Dan Harkless <dan-wget@dilvish.speed.net>
+
+ * Makefile.in (sample.wgetrc.munged_for_texi_inclusion): Added
+ build, dependencies, and distclean cleanup of this new file.
+
+ * sample.wgetrc: Uncommented waitretry and set it to 10, clarified
+ some wording, and re-wrapped some text to 71 columns due to
+ @sample indentation in wget.texi.
+
+ * wget.texi: Herold further expounded on the behavior of waitretry
+ -- reworded docs again. Changed note saying _all_ lines in
+ sample.wgetrc are commented out. Don't have an entire hand-
+ cut-and-pasted copy of sample.wgetrc in this file -- use @include.
+
2000-04-12 Dan Harkless <dan-wget@dilvish.speed.net>
- * Makefile (install.wgetrc): I completely missed the message that
- the new wgetrc wasn't being installed the first couple of times I
- ran `make install' after changing sample.wgetrc. Added blank
- lines around the message and a "<Hit RETURN to acknowledge>", and
- reworded the message to be a bit more clear.
+ * Makefile.in (install.wgetrc): I completely missed the message
+ that the new wgetrc wasn't being installed the first couple of
+ times I ran `make install' after changing sample.wgetrc. Added
+ blank lines around the message and a "<Hit RETURN to
+ acknowledge>", and reworded the message to be a bit more clear.
* sample.wgetrc: Added entries for backup_converted and waitretry.
everything: all wget_us.ps wget_a4.ps wget_toc.html
-wget.info: wget.texi
+sample.wgetrc.munged_for_texi_inclusion: sample.wgetrc
+ sed s/@/@@/g sample.wgetrc > sample.wgetrc.munged_for_texi_inclusion
+
+wget.info: sample.wgetrc.munged_for_texi_inclusion wget.texi
-$(MAKEINFO)
#wget.cat: $(MAN)
$(RM) *.dvi *.aux *.cp *.cps *.fn *.toc *.tp *.vr *.ps *.ky *.pg *.log
distclean: clean
- $(RM) Makefile
+ $(RM) Makefile sample.wgetrc.munged_for_texi_inclusion
realclean: distclean
$(RM) wget.info*
## 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").
##
# 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
+# The "wait" command above makes Wget wait between every connection.
+# If, instead, you want Wget to wait only between retries of failed
+# downloads, set this variable to maximum number of seconds to wait
+# (Wget will use "linear backoff", waiting 1 second after the first
+# failure on a file, up to this max).
+waitretry = 10
# You can force creating directory structure, even if a single is being
# retrieved, by setting this to on.
# 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
\1f
Indirect:
wget.info-1: 961
-wget.info-2: 50731
-wget.info-3: 90713
+wget.info-2: 50943
+wget.info-3: 91700
\1f
Tag Table:
(Indirect)
Node: Basic Startup Options\7f9587
Node: Logging and Input File Options\7f10287
Node: Download Options\7f12681
-Node: Directory Options\7f18831
-Node: HTTP Options\7f21309
-Node: FTP Options\7f24905
-Node: Recursive Retrieval Options\7f26098
-Node: Recursive Accept/Reject Options\7f28062
-Node: Recursive Retrieval\7f30925
-Node: Following Links\7f33223
-Node: Relative Links\7f34251
-Node: Host Checking\7f34765
-Node: Domain Acceptance\7f36790
-Node: All Hosts\7f38460
-Node: Types of Files\7f38887
-Node: Directory-Based Limits\7f41337
-Node: FTP Links\7f43977
-Node: Time-Stamping\7f44847
-Node: Time-Stamping Usage\7f46484
-Node: HTTP Time-Stamping Internals\7f48053
-Node: FTP Time-Stamping Internals\7f49523
-Node: Startup File\7f50731
-Node: Wgetrc Location\7f51604
-Node: Wgetrc Syntax\7f52419
-Node: Wgetrc Commands\7f53134
-Node: Sample Wgetrc\7f60331
-Node: Examples\7f64623
-Node: Simple Usage\7f65230
-Node: Advanced Usage\7f67624
-Node: Guru Usage\7f70375
-Node: Various\7f72037
-Node: Proxies\7f72561
-Node: Distribution\7f75326
-Node: Mailing List\7f75677
-Node: Reporting Bugs\7f76376
-Node: Portability\7f78161
-Node: Signals\7f79536
-Node: Appendices\7f80190
-Node: Robots\7f80605
-Node: Introduction to RES\7f81752
-Node: RES Format\7f83645
-Node: User-Agent Field\7f84749
-Node: Disallow Field\7f85513
-Node: Norobots Examples\7f86124
-Node: Security Considerations\7f87078
-Node: Contributors\7f88074
-Node: Copying\7f90713
-Node: Concept Index\7f109876
+Node: Directory Options\7f19043
+Node: HTTP Options\7f21521
+Node: FTP Options\7f25117
+Node: Recursive Retrieval Options\7f26310
+Node: Recursive Accept/Reject Options\7f28274
+Node: Recursive Retrieval\7f31137
+Node: Following Links\7f33435
+Node: Relative Links\7f34463
+Node: Host Checking\7f34977
+Node: Domain Acceptance\7f37002
+Node: All Hosts\7f38672
+Node: Types of Files\7f39099
+Node: Directory-Based Limits\7f41549
+Node: FTP Links\7f44189
+Node: Time-Stamping\7f45059
+Node: Time-Stamping Usage\7f46696
+Node: HTTP Time-Stamping Internals\7f48265
+Node: FTP Time-Stamping Internals\7f49735
+Node: Startup File\7f50943
+Node: Wgetrc Location\7f51816
+Node: Wgetrc Syntax\7f52631
+Node: Wgetrc Commands\7f53346
+Node: Sample Wgetrc\7f60628
+Node: Examples\7f65610
+Node: Simple Usage\7f66217
+Node: Advanced Usage\7f68611
+Node: Guru Usage\7f71362
+Node: Various\7f73024
+Node: Proxies\7f73548
+Node: Distribution\7f76313
+Node: Mailing List\7f76664
+Node: Reporting Bugs\7f77363
+Node: Portability\7f79148
+Node: Signals\7f80523
+Node: Appendices\7f81177
+Node: Robots\7f81592
+Node: Introduction to RES\7f82739
+Node: RES Format\7f84632
+Node: User-Agent Field\7f85736
+Node: Disallow Field\7f86500
+Node: Norobots Examples\7f87111
+Node: Security Considerations\7f88065
+Node: Contributors\7f89061
+Node: Copying\7f91700
+Node: Concept Index\7f110863
\1f
End Tag Table
`--waitretry=SECONDS'
If you don't want Wget to wait between *every* retrieval, but only
- between retries of failed downloads, you can use this option. If
- you want to make sure you never "hammer" remote sites with rapid
- retries, you can leave it set all the time to some non-zero value
- using the waitretry variable in your `.wgetrc' file.
+ between retries of failed downloads, you can use this option.
+ Wget will use "linear backoff", waiting 1 second after the first
+ failure on a given file, then waiting 2 seconds after the second
+ failure on that file, up to the maximum number of SECONDS you
+ specify. Therefore, a value of 10 will actually make Wget wait up
+ to (1 + 2 + ... + 10) = 55 seconds per file.
+
+ Note that this option is turned on by default in the global
+ `wgetrc' file.
`-Y on/off'
`--proxy=on/off'
Quiet mode, the same as `-q'.
quota = QUOTA
- Specify the download quota, which is useful to put in global
- wgetrc. When download quota is specified, Wget will stop retrieving
- after the download sum has become greater than quota. The quota
- can be specified in bytes (default), kbytes `k' appended) or mbytes
- (`m' appended). Thus `quota = 5m' will set the quota to 5 mbytes.
- Note that the user's startup file overrides system settings.
+ Specify the download quota, which is useful to put in the global
+ `wgetrc'. When download quota is specified, Wget will stop
+ retrieving after the download sum has become greater than quota.
+ The quota can be specified in bytes (default), kbytes `k'
+ appended) or mbytes (`m' appended). Thus `quota = 5m' will set
+ the quota to 5 mbytes. Note that the user's startup file overrides
+ system settings.
reclevel = N
Recursion level, the same as `-l'.
Wait N seconds between retrievals, the same as `-w'.
waitretry = N
- Wait N seconds between retries of failed retrievals only - the
- same as `--waitretry'.
+ Wait up to N seconds between retries of failed retrievals only -
+ the same as `--waitretry'. Note that this is turned on by default
+ in the global `wgetrc'.
\1f
File: wget.info, Node: Sample Wgetrc, Prev: Wgetrc Commands, Up: Startup File
startup file), and one for local usage (suitable for `$HOME/.wgetrc').
Be careful about the things you change.
- Note that all the lines are commented out. For any line to have
-effect, you must remove the `#' prefix at the beginning of line.
+ Note that almost all the lines are commented out. For a command to
+have any effect, you must remove the `#' character at the beginning of
+its line.
###
### Sample Wget initialization file .wgetrc
## 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").
##
# the number of seconds you want Wget to wait.
#wait = 0
+ # The "wait" command above makes Wget wait between every connection.
+ # If, instead, you want Wget to wait only between retries of failed
+ # downloads, set this variable to maximum number of seconds to wait
+ # (Wget will use "linear backoff", waiting 1 second after the first
+ # failure on a file, up to this max).
+ waitretry = 10
+
# You can force creating directory structure, even if a single is being
# retrieved, by setting this to on.
#dirstruct = off
# 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 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
@cindex waiting between retries
@item --waitretry=@var{seconds}
If you don't want Wget to wait between @emph{every} retrieval, but only
-between retries of failed downloads, you can use this option. If you
-want to make sure you never "hammer" remote sites with rapid retries,
-you can leave it set all the time to some non-zero value using the
-waitretry variable in your @file{.wgetrc} file.
+between retries of failed downloads, you can use this option. Wget will
+use "linear backoff", waiting 1 second after the first failure on a
+given file, then waiting 2 seconds after the second failure on that
+file, up to the maximum number of @var{seconds} you specify. Therefore,
+a value of 10 will actually make Wget wait up to (1 + 2 + ... + 10) = 55
+seconds per file.
+
+Note that this option is turned on by default in the global
+@file{wgetrc} file.
@cindex proxy
@item -Y on/off
Quiet mode, the same as @samp{-q}.
@item quota = @var{quota}
-Specify the download quota, which is useful to put in global
-wgetrc. When download quota is specified, Wget will stop retrieving
+Specify the download quota, which is useful to put in the global
+@file{wgetrc}. When download quota is specified, Wget will stop retrieving
after the download sum has become greater than quota. The quota can be
specified in bytes (default), kbytes @samp{k} appended) or mbytes
(@samp{m} appended). Thus @samp{quota = 5m} will set the quota to 5
Wait @var{n} seconds between retrievals, the same as @samp{-w}.
@item waitretry = @var{n}
-Wait @var{n} seconds between retries of failed retrievals only -- the same as
-@samp{--waitretry}.
+Wait up to @var{n} seconds between retries of failed retrievals only --
+the same as @samp{--waitretry}. Note that this is turned on by default
+in the global @file{wgetrc}.
@end table
@node Sample Wgetrc, , Wgetrc Commands, Startup File
startup file), and one for local usage (suitable for
@file{$HOME/.wgetrc}). Be careful about the things you change.
-Note that all the lines are commented out. For any line to have effect,
-you must remove the @samp{#} prefix at the beginning of line.
+Note that almost all the lines are commented out. For a command to have
+any effect, you must remove the @samp{#} character at the beginning of
+its line.
@example
-###
-### Sample Wget initialization file .wgetrc
-###
-
-## You can use this file to change the default behaviour of wget or to
-## avoid having to type many many command-line options. This file does
-## not contain a comprehensive list of commands -- look at the manual
-## to find out what you can put into this file.
-##
-## 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).
-
-
-##
-## Global settings (useful for setting up in /usr/local/etc/wgetrc).
-## Think well before you change them, since they may reduce wget's
-## functionality, and make it behave contrary to the documentation:
-##
-
-# You can set retrieve quota for beginners by specifying a value
-# optionally followed by 'K' (kilobytes) or 'M' (megabytes). The
-# default quota is unlimited.
-#quota = inf
-
-# You can lower (or raise) the default number of retries when
-# downloading a file (default is 20).
-#tries = 20
-
-# Lowering the maximum depth of the recursive retrieval is handy to
-# prevent newbies from going too "deep" when they unwittingly start
-# 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.
-#passive_ftp = off
-
-
-##
-## Local settings (for a user to set in his $HOME/.wgetrc). It is
-## *highly* undesirable to put these settings in the global file, since
-## they are potentially dangerous to "normal" users.
-##
-## Even when setting up your own ~/.wgetrc, you should know what you
-## are doing before doing so.
-##
-
-# Set this to on to use timestamping by default:
-#timestamping = off
-
-# It is a good idea to make Wget send your email address in a `From:'
-# header with your request (so that server administrators can contact
-# you in case of errors). Wget does *not* send `From:' by default.
-#header = From: Your Name <username@@site.domain>
-
-# You can set up other headers, like Accept-Language. Accept-Language
-# 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.
-#http_proxy = http://proxy.yoyodyne.com:18023/
-
-# If you do not want to use proxy at all, set this to off.
-#use_proxy = on
-
-# You can customize the retrieval outlook. Valid options are default,
-# binary, mega and micro.
-#dot_style = default
-
-# Setting this to off makes Wget not download /robots.txt. Be sure to
-# know *exactly* what /robots.txt is and how it is used before changing
-# the default!
-#robots = on
-
-# It can be useful to make Wget wait between connections. Set this to
-# the number of seconds you want Wget to wait.
-#wait = 0
-
-# You can force creating directory structure, even if a single is being
-# retrieved, by setting this to on.
-#dirstruct = off
-
-# You can turn on recursive retrieving by default (don't do this if
-# you are not sure you know what it means) by setting this to on.
-#recursive = off
-
-# To have Wget follow FTP links from HTML files by default, set this
-# to on:
-#follow_ftp = off
+@include sample.wgetrc.munged_for_texi_inclusion
@end example
@node Examples, Various, Startup File, Top