moparisthebest/wget
1
0
Fork 0
mirror of https://github.com/moparisthebest/wget synced 2024-07-03 16:38:41 -04:00
Code Issues Releases Wiki Activity

[svn] Update the documentation regarding the removal of -s/-C/-g/-G.

Browse Source
This commit is contained in:
hniksic 2003-11-08 15:48:36 -08:00
parent 8cfaba536a
commit dcc561a107
2 changed files with 41 additions and 39 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
doc/ChangeLog
View File

@ -1,3 +1,8 @@
2003-11-09 Hrvoje Niksic <hniksic@xemacs.org>
* wget.texi: No longer document options -s, -C, -g, and -G.
(Contributors): Update my email address.
2003-11-05 Hrvoje Niksic <hniksic@xemacs.org> 2003-11-05 Hrvoje Niksic <hniksic@xemacs.org>
* wget.texi (HTTP Options): Document `--keep-session-cookies'. * wget.texi (HTTP Options): Document `--keep-session-cookies'.

75
doc/wget.texi
View File

@ -62,7 +62,7 @@ entitled ``GNU Free Documentation License''.
@ignore @ignore
@c man begin AUTHOR @c man begin AUTHOR
Originally written by Hrvoje Niksic <hniksic@arsdigita.com>. Originally written by Hrvoje Niksic <hniksic@xemacs.org>.
@c man end @c man end
@c man begin SEEALSO @c man begin SEEALSO
GNU Info entry for @file{wget}. GNU Info entry for @file{wget}.
@ -555,8 +555,8 @@ on the local and remote timestamp and size of the file
time as @samp{-N}. time as @samp{-N}.
Note that when @samp{-nc} is specified, files with the suffixes Note that when @samp{-nc} is specified, files with the suffixes
@samp{.html} or (yuck) @samp{.htm} will be loaded from the local disk @samp{.html} or @samp{.htm} will be loaded from the local disk and
and parsed as if they had been retrieved from the Web. parsed as if they had been retrieved from the Web.
@cindex continue retrieval @cindex continue retrieval
@cindex incomplete downloads @cindex incomplete downloads
@ -982,25 +982,24 @@ Considerations}.
@cindex proxy @cindex proxy
@cindex cache @cindex cache
@item -C on/off @item --no-cache
@itemx --cache=on/off Disable server-side cache. In this case, Wget will send the remote
When set to off, disable server-side cache. In this case, Wget will server an appropriate directive (@samp{Pragma: no-cache}) to get the
send the remote server an appropriate directive (@samp{Pragma: file from the remote service, rather than returning the cached version.
no-cache}) to get the file from the remote service, rather than This is especially useful for retrieving and flushing out-of-date
returning the cached version. This is especially useful for retrieving documents on proxy servers.
and flushing out-of-date documents on proxy servers.
Caching is allowed by default. Caching is allowed by default.
@cindex cookies @cindex cookies
@item --cookies=on/off @item --no-cookies
When set to off, disable the use of cookies. Cookies are a mechanism Disable the use of cookies. Cookies are a mechanism for maintaining
for maintaining server-side state. The server sends the client a cookie server-side state. The server sends the client a cookie using the
using the @code{Set-Cookie} header, and the client responds with the @code{Set-Cookie} header, and the client responds with the same cookie
same cookie upon further requests. Since cookies allow the server upon further requests. Since cookies allow the server owners to keep
owners to keep track of visitors and for sites to exchange this track of visitors and for sites to exchange this information, some
information, some consider them a breach of privacy. The default is to consider them a breach of privacy. The default is to use cookies;
use cookies; however, @emph{storing} cookies is not on by default. however, @emph{storing} cookies is not on by default.
@cindex loading cookies @cindex loading cookies
@cindex cookies, loading @cindex cookies, loading
@ -1134,8 +1133,7 @@ always being retrieved by interactive web browsers and only come out
properly when Referer is set to one of the pages that point to them. properly when Referer is set to one of the pages that point to them.
@cindex server response, save @cindex server response, save
@item -s @item --save-headers
@itemx --save-headers
Save the headers sent by the @sc{http} server to the file, preceding the Save the headers sent by the @sc{http} server to the file, preceding the
actual contents, with an empty line as the separator. actual contents, with an empty line as the separator.
@ -1233,12 +1231,11 @@ and asking @code{root} to run Wget with @samp{-N} or @samp{-r} so the file
will be overwritten. will be overwritten.
@cindex globbing, toggle @cindex globbing, toggle
@item -g on/off @item --no-glob
@itemx --glob=on/off Turn off @sc{ftp} globbing. Globbing refers to the use of shell-like
Turn @sc{ftp} globbing on or off. Globbing means you may use the special characters (@dfn{wildcards}), like @samp{*}, @samp{?}, @samp{[}
shell-like special characters (@dfn{wildcards}), like @samp{*}, and @samp{]} to retrieve more than one file from the same directory at
@samp{?}, @samp{[} and @samp{]} to retrieve more than one file from the once, like:
same directory at once, like:
@example @example
wget ftp://gnjilux.srk.fer.hr/*.msg wget ftp://gnjilux.srk.fer.hr/*.msg
@ -1515,24 +1512,23 @@ retrieval. If a user wants only a subset of those tags to be
considered, however, he or she should be specify such tags in a considered, however, he or she should be specify such tags in a
comma-separated @var{list} with this option. comma-separated @var{list} with this option.
@item -G @var{list} @item --ignore-tags=@var{list}
@itemx --ignore-tags=@var{list}
This is the opposite of the @samp{--follow-tags} option. To skip This is the opposite of the @samp{--follow-tags} option. To skip
certain @sc{html} tags when recursively looking for documents to download, certain @sc{html} tags when recursively looking for documents to download,
specify them in a comma-separated @var{list}. specify them in a comma-separated @var{list}.
In the past, the @samp{-G} option was the best bet for downloading a In the past, this option was the best bet for downloading a single page
single page and its requisites, using a command-line like: and its requisites, using a command-line like:
@example @example
wget -Ga,area -H -k -K -r http://@var{site}/@var{document} wget --ignore-tags=a,area -H -k -K -r http://@var{site}/@var{document}
@end example @end example
However, the author of this option came across a page with tags like However, the author of this option came across a page with tags like
@code{<LINK REL="home" HREF="/">} and came to the realization that @code{<LINK REL="home" HREF="/">} and came to the realization that
@samp{-G} was not enough. One can't just tell Wget to ignore specifying tags to ignore was not enough. One can't just tell Wget to
@code{<LINK>}, because then stylesheets will not be downloaded. Now the ignore @code{<LINK>}, because then stylesheets will not be downloaded.
best bet for downloading a single page and its requisites is the Now the best bet for downloading a single page and its requisites is the
dedicated @samp{--page-requisites} option. dedicated @samp{--page-requisites} option.
@item -H @item -H
@ -2200,7 +2196,8 @@ interpreted as @sc{html} as being relative to @var{string}---the same as
Bind to @var{address}, like the @samp{--bind-address} option. Bind to @var{address}, like the @samp{--bind-address} option.
@item cache = on/off @item cache = on/off
When set to off, disallow server-caching. See the @samp{-C} option. When set to off, disallow server-caching. See the @samp{--no-cache}
option.
@item convert_links = on/off @item convert_links = on/off
Convert non-relative links locally. The same as @samp{-k}. Convert non-relative links locally. The same as @samp{-k}.
@ -2282,7 +2279,7 @@ Use @var{string} as @sc{ftp} proxy, instead of the one specified in
environment. environment.
@item glob = on/off @item glob = on/off
Turn globbing on/off---the same as @samp{-g}. Turn globbing on/off---the same as @samp{--glob} and @samp{--no-glob}.
@item header = @var{string} @item header = @var{string}
Define an additional header, like @samp{--header}. Define an additional header, like @samp{--header}.
@ -2308,7 +2305,7 @@ When set to on, ignore @code{Content-Length} header; the same as
@item ignore_tags = @var{string} @item ignore_tags = @var{string}
Ignore certain @sc{html} tags when doing a recursive retrieval, just like Ignore certain @sc{html} tags when doing a recursive retrieval, just like
@samp{-G} / @samp{--ignore-tags}. @samp{--ignore-tags}.
@item include_directories = @var{string} @item include_directories = @var{string}
Specify a comma-separated list of directories you wish to follow when Specify a comma-separated list of directories you wish to follow when
@ -3083,10 +3080,10 @@ me).
@cindex contributors @cindex contributors
@iftex @iftex
GNU Wget was written by Hrvoje Nik@v{s}i@'{c} @email{hniksic@@arsdigita.com}. GNU Wget was written by Hrvoje Nik@v{s}i@'{c} @email{hniksic@@xemacs.org}.
@end iftex @end iftex
@ifnottex @ifnottex
GNU Wget was written by Hrvoje Niksic @email{hniksic@@arsdigita.com}. GNU Wget was written by Hrvoje Niksic @email{hniksic@@xemacs.org}.
@end ifnottex @end ifnottex
However, its development could never have gone as far as it has, were it 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 not for the help of many people, either with bug reports, feature