[svn] Document new option `--keep-session-cookies'.

This commit is contained in:
hniksic 2003-11-05 13:11:59 -08:00
parent c98125f4ba
commit 8a7dda95aa
3 changed files with 35 additions and 4 deletions

10
NEWS
View File

@ -5,6 +5,14 @@ See the end for copying conditions.
Please send GNU Wget bug reports to <bug-wget@gnu.org>.
* Changes in Wget 1.9+.
** The new option `--keep-session-cookies' causes `--save-cookies' to
save session cookies along with the permanent ones. This is useful on
sites that require you to log in before you can access some pages.
With this option, multiple Wget runs will be treated as a single
browser session.
* Changes in Wget 1.9.
** It is now possible to specify that POST method be used for HTTP
@ -436,7 +444,7 @@ geturl -vo log http://fly.cc.fer.hr/
----------------------------------------------------------------------
Copyright information:
Copyright (C) 1997, 1998, 2000, 2001 Free Software Foundation, Inc.
Copyright (C) 1997, 1998, 2000, 2001, 2003 Free Software Foundation, Inc.
Permission is granted to anyone to make or distribute verbatim
copies of this document as received, in any medium, provided that

View File

@ -1,3 +1,7 @@
2003-11-05 Hrvoje Niksic <hniksic@xemacs.org>
* wget.texi (HTTP Options): Document `--keep-session-cookies'.
2003-10-26 Hrvoje Niksic <hniksic@xemacs.org>
* wget.texi (Wgetrc Commands): Fixed typo.

View File

@ -1057,9 +1057,28 @@ wget --cookies=off --header "Cookie: @var{name}=@var{value}"
@cindex saving cookies
@cindex cookies, saving
@item --save-cookies @var{file}
Save cookies to @var{file} at the end of session. Cookies whose expiry
time is not specified, or those that have already expired, are not
saved.
Save cookies to @var{file} before exiting. This will not save cookies
that have expired or that have no expiry time (so-called ``session
cookies''), but also see @samp{--keep-session-cookies}.
@cindex cookies, session
@cindex session cookies
@item --keep-session-cookies
When specified, causes @samp{--save-cookies} to also save session
cookies. Session cookies are normally not save because they are
supposed to be forgotten when you exit the browser. Saving them is
useful on sites that require you to log in or to visit the home page
before you can access some pages. With this option, multiple Wget runs
are considered a single browser session as far as the site is concerned.
Since the cookie file format does not normally carry session cookies,
Wget marks them with an expiry timestamp of 0. Wget's
@samp{--load-cookies} recognizes those as session cookies, but it might
confuse other browsers. Also note that cookies so loaded will be
treated as other session cookies, which means that if you want
@samp{--save-cookies} to preserve them again, you must use
@samp{--keep-session-cookies} again.
@cindex Content-Length, ignore
@cindex ignore length