← Back to branch summary

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

« back to all changes in this revision

Viewing changes to .pc/wget-doc-remove-usr-local-in-wget.texi/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:
.pc/wget-doc-remove-usr-local-in-wget.texi/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{/usr/local/etc/wgetrc} by default) for site settings.
 
193
(@file{/usr/local/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
1426
1445
Other than that, they work in exactly the same way. In particular,
1427
1446
they @emph{both} expect content of the form @code{key1=value1&key2=value2},
1428
1447
with percent-encoding for special characters; the only difference is
1429
 
that one expects its content as a command-line paramter and the other
 
1448
that one expects its content as a command-line parameter and the other
1430
1449
accepts its content from a file. In particular, @samp{--post-file} is
1431
1450
@emph{not} for transmitting files as form attachments: those must
1432
1451
appear as @code{key=value} data (with appropriate percent-coding) just
1487
1506
@code{Content-Disposition} headers to describe what the name of a
1488
1507
downloaded file should be.
1489
1508
 
 
1509
@cindex Trust server names
 
1510
@item --trust-server-names
 
1511
 
 
1512
If this is set to on, on a redirect the last component of the
 
1513
redirection URL will be used as the local file name.  By default it is
 
1514
used the last component in the original URL.
 
1515
 
1490
1516
@cindex authentication
1491
1517
@item --auth-no-challenge
1492
1518
 
1738
1764
@item -r
1739
1765
@itemx --recursive
1740
1766
Turn on recursive retrieving.  @xref{Recursive Download}, for more
1741
 
details.
 
1767
details.  The default maximum depth is 5.
1742
1768
 
1743
1769
@item -l @var{depth}
1744
1770
@itemx --level=@var{depth}
1745
1771
Specify recursion maximum depth level @var{depth} (@pxref{Recursive
1746
 
Download}).  The default maximum depth is 5.
 
1772
Download}).
1747
1773
 
1748
1774
@cindex proxy filling
1749
1775
@cindex delete after retrieval
1954
1980
of domains.  Note that it does @emph{not} turn on @samp{-H}.
1955
1981
 
1956
1982
@item --exclude-domains @var{domain-list}
1957
 
Specify the domains that are @emph{not} to be followed.
 
1983
Specify the domains that are @emph{not} to be followed
1958
1984
(@pxref{Spanning Hosts}).
1959
1985
 
1960
1986
@cindex follow FTP links
2799
2825
Turn on recognition of the (non-standard) @samp{Content-Disposition}
2800
2826
HTTP header---if set to @samp{on}, the same as @samp{--content-disposition}.
2801
2827
 
 
2828
@item trust_server_names = on/off
 
2829
If set to on, use the last component of a redirection URL for the local
 
2830
file name.
 
2831
 
2802
2832
@item continue = on/off
2803
2833
If set to on, force continuation of preexistent partially retrieved
2804
2834
files.  See @samp{-c} before setting it.
3141
3171
Choose whether or not to print the @sc{http} and @sc{ftp} server
3142
3172
responses---the same as @samp{-S}.
3143
3173
 
 
3174
@item show_all_dns_entries = on/off
 
3175
When a DNS name is resolved, show all the IP addresses, not just the first
 
3176
three.
 
3177
 
3144
3178
@item span_hosts = on/off
3145
3179
Same as @samp{-H}.
3146
3180
 
3157
3191
@item timestamping = on/off
3158
3192
Turn timestamping on/off.  The same as @samp{-N} (@pxref{Time-Stamping}).
3159
3193
 
 
3194
@item use_server_timestamps = on/off
 
3195
If set to @samp{off}, Wget won't set the local file's timestamp by the
 
3196
one on the server (same as @samp{--no-use-server-timestamps}).
 
3197
 
3160
3198
@item tries = @var{n}
3161
3199
Set number of retries per @sc{url}---the same as @samp{-t @var{n}}.
3162
3200
 
3879
3917
GNU Wget was written by Hrvoje Nik@v{s}i@'{c} @email{hniksic@@xemacs.org},
3880
3918
@end iftex
3881
3919
@ifnottex
3882
 
GNU Wget was written by Hrvoje Niksic @email{hniksic@@xemacs.org},
 
3920
GNU Wget was written by Hrvoje Niksic @email{hniksic@@xemacs.org}.
3883
3921
@end ifnottex
3884
 
and it is currently maintained by Micah Cowan @email{micah@@cowan.name}.
3885
3922
 
3886
3923
However, the development of Wget could never have gone as far as it has, were
3887
3924
it not for the help of many people, either with bug reports, feature proposals,