← Back to branch summary

~ubuntu-branches/ubuntu/precise/wget/precise-proposed

« back to all changes in this revision

Viewing changes to doc/wget.texi

  • Committer: Bazaar Package Importer
  • Author(s): Steve Langasek
  • Date: 2011-10-19 00:00:09 UTC
  • mfrom: (2.1.13 sid)
  • Revision ID: james.westby@ubuntu.com-20111019000009-8p33w3wz4b1rdri0
Tags: 1.13-1ubuntu1
https://launchpad.net/bugs/503339
* Merge from Debian unstable, remaining changes:
  - Add wget-udeb to ship wget.gnu as alternative to busybox wget
    implementation.
  - Depend on libssl-dev 0.9.8k-7ubuntu4 (LP: #503339)
* Dropped changes, superseded in Debian:
  - Keep build dependencies in main:
    + debian/control: remove info2man build-dep
    + debian/patches/series: disable wget-infopod_generated_manpage
  - Mark wget Multi-Arch: foreign, so packages that aren't of the same arch
    can depend on it.
* Pass --with-ssl=openssl; we don't want to use gnutls, there's no udeb for
  it.
* Add a second build pass for the udeb, so we can build without libidn.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/wget.texi
31
31
 
32
32
@c man begin COPYRIGHT
33
33
Copyright @copyright{} 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003,
34
 
2004, 2005, 2006, 2007, 2008, 2009 Free Software Foundation, Inc.
 
34
2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011 Free Software Foundation,
 
35
Inc.
35
36
 
36
37
@iftex
37
38
Permission is granted to make and distribute verbatim copies of
63
64
@ignore
64
65
@c man begin AUTHOR
65
66
Originally written by Hrvoje Niksic <hniksic@xemacs.org>.
66
 
Currently maintained by Micah Cowan <micah@cowan.name>.
67
67
@c man end
68
68
@c man begin SEEALSO
69
69
This is @strong{not} the complete manual for GNU Wget.
190
190
Most of the features are fully configurable, either through command line
191
191
options, or via the initialization file @file{.wgetrc} (@pxref{Startup
192
192
File}).  Wget allows you to define @dfn{global} startup files
193
 
(@file{/etc/wgetrc} by default) for site settings.
 
193
(@file{/etc/wgetrc} by default) for site settings. You can also
 
194
specify the location of a startup file with the --config option.
 
195
 
194
196
 
195
197
@ignore
196
198
@c man begin FILES
524
526
For instance, if you specify @samp{http://foo/bar/a.html} for
525
527
@var{URL}, and Wget reads @samp{../baz/b.html} from the input file, it
526
528
would be resolved to @samp{http://foo/baz/b.html}.
 
529
 
 
530
@cindex specify config 
 
531
@item --config=@var{FILE}
 
532
Specify the location of a startup file you wish to use.
527
533
@end table
528
534
 
529
535
@node Download Options, Directory Options, Logging and Input File Options, Invoking
579
585
Note that a combination with @samp{-k} is only permitted when
580
586
downloading a single document, as in that case it will just convert
581
587
all relative URIs to external ones; @samp{-k} makes no sense for
582
 
multiple URIs when they're all being downloaded to a single file.
 
588
multiple URIs when they're all being downloaded to a single file;
 
589
@samp{-k} can be used only when the output is a regular file.
583
590
 
584
591
@cindex clobbering, file
585
592
@cindex downloading multiple times
719
726
@itemx --timestamping
720
727
Turn on time-stamping.  @xref{Time-Stamping}, for details.
721
728
 
 
729
@item --no-use-server-timestamps
 
730
Don't set the local file's timestamp by the one on the server.
 
731
 
 
732
By default, when a file is downloaded, it's timestamps are set to
 
733
match those from the remote file. This allows the use of
 
734
@samp{--timestamping} on subsequent invocations of wget. However, it
 
735
is sometimes useful to base the local file's timestamp on when it was
 
736
actually downloaded; for that purpose, the
 
737
@samp{--no-use-server-timestamps} option has been provided.
 
738
 
722
739
@cindex server response, print
723
740
@item -S
724
741
@itemx --server-response
830
847
between retries of failed downloads, you can use this option.  Wget will
831
848
use @dfn{linear backoff}, waiting 1 second after the first failure on a
832
849
given file, then waiting 2 seconds after the second failure on that
833
 
file, up to the maximum number of @var{seconds} you specify.  Therefore,
834
 
a value of 10 will actually make Wget wait up to (1 + 2 + ... + 10) = 55
835
 
seconds per file. 
 
850
file, up to the maximum number of @var{seconds} you specify.
836
851
 
837
852
By default, Wget will assume a value of 10 seconds.
838
853
 
1064
1079
You can set the default encoding using the @code{remoteencoding}
1065
1080
command in @file{.wgetrc}. That setting may be overridden from the
1066
1081
command line.
 
1082
 
 
1083
@cindex unlink
 
1084
@item --unlink
 
1085
 
 
1086
Force Wget to unlink file instead of clobbering existing file. This
 
1087
option is useful for downloading to the directory with hardlinks.
 
1088
 
1067
1089
@end table
1068
1090
 
1069
1091
@node Directory Options, HTTP Options, Download Options, Invoking
1166
1188
you re-mirror a site, because Wget can't tell that the local
1167
1189
@file{@var{X}.html} file corresponds to remote URL @samp{@var{X}} (since
1168
1190
it doesn't yet know that the URL produces output of type
1169
 
@samp{text/html} or @samp{application/xhtml+xml}.  To prevent this 
1170
 
re-downloading, you must use @samp{-k} and @samp{-K} so that the original 
1171
 
version of the file will be saved as @file{@var{X}.orig} (@pxref{Recursive 
1172
 
Retrieval Options}).
 
1191
@samp{text/html} or @samp{application/xhtml+xml}.
1173
1192
 
1174
1193
As of version 1.12, Wget will also ensure that any downloaded files of
1175
1194
type @samp{text/css} end in the suffix @samp{.css}, and the option was
1531
1550
choose the correct protocol version.  Fortunately, such servers are
1532
1551
quite rare.
1533
1552
 
1534
 
Note that SSLv2 may not be available in your version of Wget,
1535
 
because it has been deprecated since 1996.
1536
 
 
1537
1553
@cindex SSL certificate, check
1538
1554
@item --no-check-certificate
1539
1555
Don't check the server certificate against the available certificate
1748
1764
@item -r
1749
1765
@itemx --recursive
1750
1766
Turn on recursive retrieving.  @xref{Recursive Download}, for more
1751
 
details.
 
1767
details.  The default maximum depth is 5.
1752
1768
 
1753
1769
@item -l @var{depth}
1754
1770
@itemx --level=@var{depth}
1755
1771
Specify recursion maximum depth level @var{depth} (@pxref{Recursive
1756
 
Download}).  The default maximum depth is 5.
 
1772
Download}).
1757
1773
 
1758
1774
@cindex proxy filling
1759
1775
@cindex delete after retrieval
1964
1980
of domains.  Note that it does @emph{not} turn on @samp{-H}.
1965
1981
 
1966
1982
@item --exclude-domains @var{domain-list}
1967
 
Specify the domains that are @emph{not} to be followed.
 
1983
Specify the domains that are @emph{not} to be followed
1968
1984
(@pxref{Spanning Hosts}).
1969
1985
 
1970
1986
@cindex follow FTP links
2690
2706
 
2691
2707
The fact that user's settings are loaded after the system-wide ones
2692
2708
means that in case of collision user's wgetrc @emph{overrides} the
2693
 
system-wide wgetrc (in @file{/etc/wgetrc} by default).
 
2709
system-wide wgetrc (in @file{//etc/wgetrc} by default).
2694
2710
Fascist admins, away!
2695
2711
 
2696
2712
@node Wgetrc Syntax, Wgetrc Commands, Wgetrc Location, Startup File
3153
3169
Choose whether or not to print the @sc{http} and @sc{ftp} server
3154
3170
responses---the same as @samp{-S}.
3155
3171
 
 
3172
@item show_all_dns_entries = on/off
 
3173
When a DNS name is resolved, show all the IP addresses, not just the first
 
3174
three.
 
3175
 
3156
3176
@item span_hosts = on/off
3157
3177
Same as @samp{-H}.
3158
3178
 
3169
3189
@item timestamping = on/off
3170
3190
Turn timestamping on/off.  The same as @samp{-N} (@pxref{Time-Stamping}).
3171
3191
 
 
3192
@item use_server_timestamps = on/off
 
3193
If set to @samp{off}, Wget won't set the local file's timestamp by the
 
3194
one on the server (same as @samp{--no-use-server-timestamps}).
 
3195
 
3172
3196
@item tries = @var{n}
3173
3197
Set number of retries per @sc{url}---the same as @samp{-t @var{n}}.
3174
3198
 
3891
3915
GNU Wget was written by Hrvoje Nik@v{s}i@'{c} @email{hniksic@@xemacs.org},
3892
3916
@end iftex
3893
3917
@ifnottex
3894
 
GNU Wget was written by Hrvoje Niksic @email{hniksic@@xemacs.org},
 
3918
GNU Wget was written by Hrvoje Niksic @email{hniksic@@xemacs.org}.
3895
3919
@end ifnottex
3896
 
and it is currently maintained by Micah Cowan @email{micah@@cowan.name}.
3897
3920
 
3898
3921
However, the development of Wget could never have gone as far as it has, were
3899
3922
it not for the help of many people, either with bug reports, feature proposals,