From 77983e9d7b068ddbb59104c01438f3a67f84f238 Mon Sep 17 00:00:00 2001
From: hal9 <hal9@users.sourceforge.net>
Date: Thu, 10 Oct 2002 03:49:21 +0000
Subject: [PATCH] Add notes to session-cookies-only and Quickstart about
 pre-existing cookies. Also, note content-cookies work differently.

---
 doc/source/user-manual.sgml | 38 +++++++++++++++++++++++++++----------
 1 file changed, 28 insertions(+), 10 deletions(-)

diff --git a/doc/source/user-manual.sgml b/doc/source/user-manual.sgml
index 093d1d30..06e39c0f 100644
--- a/doc/source/user-manual.sgml
+++ b/doc/source/user-manual.sgml
@@ -11,11 +11,11 @@
 <!entity license SYSTEM "license.sgml">
 <!entity p-authors SYSTEM "p-authors.sgml">
 <!entity config SYSTEM "p-config.sgml">
-<!entity p-version "3.0.0">
-<!entity p-status "stable">
+<!entity p-version "0.0.0">
+<!entity p-status "UNRELEASED">
 <!entity % p-authors-formal "INCLUDE"> <!-- include additional text, etc  -->
-<!entity % p-not-stable "IGNORE">
-<!entity % p-stable "INCLUDE">
+<!entity % p-not-stable "INCLUDE">
+<!entity % p-stable "IGNORE">
 <!entity % p-text "IGNORE">        <!-- define we are not a text only doc -->
 <!entity % p-doc "INCLUDE">        <!-- and we are a formal doc           -->
 <!entity % p-readme "IGNORE">
@@ -32,7 +32,7 @@
                 This file belongs into
                 ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/
 
- $Id: user-manual.sgml,v 1.123.2.18 2002/08/22 23:47:58 hal9 Exp $
+ $Id: user-manual.sgml,v 1.123.2.19 2002/09/26 01:25:36 hal9 Exp $
 
  Copyright (C) 2001, 2002 Privoxy Developers <developers@privoxy.org>
  See LICENSE.
@@ -58,7 +58,7 @@
  </subscript>
 </pubdate>
 
-<pubdate>$Id: user-manual.sgml,v 1.123.2.18 2002/08/22 23:47:58 hal9 Exp $</pubdate>
+<pubdate>$Id: user-manual.sgml,v 1.123.2.19 2002/09/26 01:25:36 hal9 Exp $</pubdate>
 
 <!--
 
@@ -519,7 +519,7 @@ automatically start Privoxy in the boot process.
  <listitem>
   <para>
    Set your browser to use <application>Privoxy</application> as HTTP and
-   HTTPS proxy by setting the proxy configuration for address of
+   HTTPS (SSL) proxy by setting the proxy configuration for address of
    <literal>127.0.0.1</literal> and port <literal>8118</literal>.
    (<application>Junkbuster</application> and earlier versions of
    <application>Privoxy</application> used port 8000.) See the section <link
@@ -531,6 +531,8 @@ automatically start Privoxy in the boot process.
  <listitem>
   <para>
     Flush your browser's disk and memory caches, to remove any cached ad images.
+    If using <application>Privoxy</application> to manage cookies, you should 
+    remove any currently stored cookies too.
   </para>
  </listitem> 
 
@@ -3384,7 +3386,8 @@ my-internal-testing-server.void</screen>
   <term>Typical use:</term>
   <listitem>
    <para>
-    Allow only temporary <quote>session</quote> cookies (for the current browser session <emphasis>only</emphasis>).
+    Allow only temporary <quote>session</quote> cookies (for the current
+    browser session <emphasis>only</emphasis>). 
    </para>
   </listitem>
  </varlistentry>
@@ -3393,8 +3396,9 @@ my-internal-testing-server.void</screen>
   <term>Effect:</term>
   <listitem>
    <para>
-    Deletes the <quote>expires</quote> field from <quote>Set-Cookie:</quote> server headers.
-    Most browsers will not store such cookies permanently and forget them in between sessions.
+    Deletes the <quote>expires</quote> field from <quote>Set-Cookie:</quote>
+    server headers. Most browsers will not store such cookies permanently and
+    forget them in between sessions.
    </para>
   </listitem>
  </varlistentry>
@@ -3441,6 +3445,17 @@ my-internal-testing-server.void</screen>
     Note that it is up to the browser how it handles such cookies without an <quote>expires</quote>
     field. If you use an exotic browser, you might want to try it out to be sure.
    </para>
+   <para>
+    This setting also has no effect on cookies that may have been stored
+    previously by the browser before starting <application>Privoxy</application>.
+    These would have to be removed manually.
+   </para>
+   <para>
+     <application>Privoxy</application> also uses  
+     the <link linkend="filter-content-cookies">content-cookies filter</link> 
+     to block some types of cookies. Content cookies are not effected by 
+     <literal>session-cookies-only</literal>.
+   </para>
   </listitem>
  </varlistentry>
 
@@ -5671,6 +5686,9 @@ In file: user.action <guibutton>[ View ]</guibutton> <guibutton>[ Edit ]</guibut
  Temple Place - Suite 330, Boston, MA  02111-1307, USA.
 
  $Log: user-manual.sgml,v $
+ Revision 1.123.2.19  2002/09/26 01:25:36  hal9
+ More explanation on Privoxy patterns, more on content-cookies and SSL.
+
  Revision 1.123.2.18  2002/08/22 23:47:58  hal9
  Add 'Documentation' to Privoxy Menu shot in Configuration section to match
  CGIs.
-- 
2.39.2