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

diff --git a/NEWS b/NEWS
index c64d04d5f8fae6802876a941f9c484a37332bc9b..0d8f2b7aef918e7f5ce97e0f22df579573f39591 100644 (file)
--- a/NEWS
+++ b/NEWS
@@ -5,6 +5,14 @@ See the end for copying conditions.
 
 Please send GNU Wget bug reports to <bug-wget@gnu.org>.
 \f
+* 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.
+\f
 * 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

diff --git a/doc/ChangeLog b/doc/ChangeLog
index 735b0b2216a6e3e7c66b3c9bf010d18b3abf29fe..0eea23cc15b15e8aa63642f09539f57e761e834c 100644 (file)
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -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.

diff --git a/doc/wget.texi b/doc/wget.texi
index 51773cb653cb750d49f2e1a4896734f3fa11ae8b..fcfa1fdcb0ddcc6f075ba9e668565f9dafde0a34 100644 (file)
--- a/doc/wget.texi
+++ b/doc/wget.texi
@@ -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