X-Git-Url: http://sjero.net/git/?a=blobdiff_plain;f=doc%2Fwget.texi;h=6d3ae4932fd8f844a5715e060f8a2e8b5f1e7b39;hb=a7958aa4c6f246369eacb34fc0022a9219d76aac;hp=b35e80b95fdb61d7cfd3e521f660887d4bc376f9;hpb=7824f7f133bb2eacf6afc8dd7ffa5bef4c13181a;p=wget diff --git a/doc/wget.texi b/doc/wget.texi index b35e80b9..6d3ae493 100644 --- a/doc/wget.texi +++ b/doc/wget.texi @@ -3,7 +3,7 @@ @c %**start of header @setfilename wget.info @include version.texi -@set UPDATED Jun 2006 +@set UPDATED Jul 2006 @settitle GNU Wget @value{VERSION} Manual @c Disable the monstrous rectangles beside overfull hbox-es. @finalout @@ -46,9 +46,9 @@ notice identical to this one except for the removal of this paragraph Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts, and with no -Back-Cover Texts. A copy of the license is included in the section -entitled ``GNU Free Documentation License''. +Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A +copy of the license is included in the section entitled ``GNU Free +Documentation License''. @c man end @end ifnottex @@ -61,6 +61,7 @@ entitled ``GNU Free Documentation License''. @ignore @c man begin AUTHOR Originally written by Hrvoje Niksic . +Currently maintained by Micah Cowan . @c man end @c man begin SEEALSO GNU Info entry for @file{wget}. @@ -73,11 +74,10 @@ Copyright @copyright{} 1996--2006, Free Software Foundation, Inc. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or -any later version published by the Free Software Foundation; with the -Invariant Sections being ``GNU General Public License'' and ``GNU Free -Documentation License'', with no Front-Cover Texts, and with no -Back-Cover Texts. A copy of the license is included in the section -entitled ``GNU Free Documentation License''. +any later version published by the Free Software Foundation; with no +Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A +copy of the license is included in the section entitled ``GNU Free +Documentation License''. @end titlepage @ifnottex @@ -99,7 +99,7 @@ Copyright @copyright{} 1996--2006 Free Software Foundation, Inc. * Examples:: Examples of usage. * Various:: The stuff that doesn't fit anywhere else. * Appendices:: Some useful references. -* Copying:: You may give out copies of Wget and of this manual. +* Copying this manual:: You may give out copies of Wget and of this manual. * Concept Index:: Topics covered by this manual. @end menu @end ifnottex @@ -212,8 +212,8 @@ User startup file. @item Finally, GNU Wget is free software. This means that everyone may use it, redistribute it and/or modify it under the terms of the GNU General -Public License, as published by the Free Software Foundation -(@pxref{Copying}). +Public License, as published by the Free Software Foundation (see the +file @file{COPYING} that came with GNU Wget, for details). @end itemize @node Invoking @@ -548,8 +548,16 @@ is used as @var{file}, documents will be printed to standard output, disabling link conversion. (Use @samp{./-} to print to a file literally named @samp{-}.) -Note that a combination with @samp{-k} is only well-defined for -downloading a single document. +Use of @samp{-O} is @emph{not} intended to mean simply ``use the name +@var{file} instead of the one in the URL;'' rather, it is +analogous to shell redirection: +@samp{wget -O file http://foo} is intended to work like +@samp{wget -O - http://foo > file}; @file{file} will be truncated +immediately, and @emph{all} downloaded content will be written there. + +Note that a combination with @samp{-k} is only permitted when +downloading a single document, and combination with any of @samp{-r}, +@samp{-p}, or @samp{-N} is not allowed. @cindex clobbering, file @cindex downloading multiple times @@ -831,7 +839,9 @@ actions of one. Don't use proxies, even if the appropriate @code{*_proxy} environment variable is defined. +@c man end For more information about the use of proxies with Wget, @xref{Proxies}. +@c man begin OPTIONS @cindex quota @item -Q @var{quota} @@ -1237,6 +1247,13 @@ wget --header="Host: foo.bar" http://localhost/ In versions of Wget prior to 1.10 such use of @samp{--header} caused sending of duplicate headers. +@cindex redirect +@item --max-redirect=@var{number} +Specifies the maximum number of redirections to follow for a resource. +The default is 20, which is usually far more than necessary. However, on +those occasions where you want to allow more (or fewer), this is the +option to use. + @cindex proxy user @cindex proxy password @cindex proxy authentication @@ -3515,21 +3532,20 @@ me). @cindex contributors @iftex -GNU Wget was written by Hrvoje Nik@v{s}i@'{c} @email{hniksic@@xemacs.org}. +GNU Wget was written by Hrvoje Nik@v{s}i@'{c} @email{hniksic@@xemacs.org}, @end iftex @ifnottex -GNU Wget was written by Hrvoje Niksic @email{hniksic@@xemacs.org}. +GNU Wget was written by Hrvoje Niksic @email{hniksic@@xemacs.org}, @end ifnottex -However, its development could never have gone as far as it has, were it -not for the help of many people, either with bug reports, feature -proposals, patches, or letters saying ``Thanks!''. +and it is currently maintained by Micah Cowan @email{micah@@cowan.name}. + +However, the development of Wget could never have gone as far as it has, were +it not for the help of many people, either with bug reports, feature proposals, +patches, or letters saying ``Thanks!''. Special thanks goes to the following people (no particular order): @itemize @bullet -@item Mauro Tortonesi---contributed high-quality IPv6 code and many -other fixes. - @item Dan Harkless---contributed a lot of code and documentation of extremely high quality, as well as the @code{--page-requisites} and related options. He was the principal maintainer for some time and @@ -3811,79 +3827,16 @@ Kristijan Zimmer. Apologies to all who I accidentally left out, and many thanks to all the subscribers of the Wget mailing list. -@node Copying -@chapter Copying -@cindex copying -@cindex GPL -@cindex GFDL -@cindex free software - -GNU Wget is licensed under the GNU General Public License (GNU GPL), -which makes it @dfn{free software}. Please note that ``free'' in ``free -software'' refers to liberty, not price. As some people like to point -out, it's the ``free'' of ``free speech'', not the ``free'' of ``free -beer''. - -The exact and legally binding distribution terms are spelled out below. -The GPL guarantees that you have the right (freedom) to run and change -GNU Wget and distribute it to others, and even---if you want---charge -money for doing any of those things. With these rights comes the -obligation to distribute the source code along with the software and to -grant your recipients the same rights and impose the same restrictions. - -This licensing model is also known as @dfn{open source} because it, -among other things, makes sure that all recipients will receive the -source code along with the program, and be able to improve it. The GNU -project prefers the term ``free software'' for reasons outlined at -@url{http://www.gnu.org/philosophy/free-software-for-freedom.html}. - -The exact license terms are defined by this paragraph and the GNU -General Public License it refers to: - -@quotation -GNU Wget is free software; you can redistribute it and/or modify it -under the terms of the GNU General Public License as published by the -Free Software Foundation; either version 2 of the License, or (at your -option) any later version. - -GNU Wget is distributed in the hope that it will be useful, but WITHOUT -ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or -FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License -for more details. - -A copy of the GNU General Public License is included as part of this -manual; if you did not receive it, write to the Free Software -Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. -@end quotation - -In addition to this, this manual is free in the same sense: - -@quotation -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.2 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts, and with no -Back-Cover Texts. A copy of the license is included in the section -entitled ``GNU Free Documentation License''. -@end quotation - -@c #### Maybe we should wrap these licenses in ifinfo? Stallman says -@c that the GFDL needs to be present in the manual, and to me it would -@c suck to include the license for the manual and not the license for -@c the program. - -The full texts of the GNU General Public License and of the GNU Free -Documentation License are available below. - +@node Copying this manual +@appendix Copying this manual + @menu -* GNU General Public License:: -* GNU Free Documentation License:: +* GNU Free Documentation License:: Licnse for copying this manual. @end menu -@include gpl.texi - @include fdl.texi + @node Concept Index @unnumbered Concept Index @printindex cp