From: hniksic <devnull@localhost>
Date: Wed, 5 Nov 2003 21:11:59 +0000 (-0800)
Subject: [svn] Document new option `--keep-session-cookies'.
X-Git-Tag: v1.13~1475
X-Git-Url: http://sjero.net/git/?p=wget;a=commitdiff_plain;h=8a7dda95aa4cd7d76811d5b58dec5cc0ac005d48

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

diff --git a/NEWS b/NEWS
index c64d04d5..0d8f2b7a 100644
--- 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>.
 
+* 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
diff --git a/doc/ChangeLog b/doc/ChangeLog
index 735b0b22..0eea23cc 100644
--- 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 51773cb6..fcfa1fdc 100644
--- 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