#93: Add a config directive to let Privoxy explicitly request either IPv4 (or IPv6...
[privoxy.git] / doc / source / user-manual.sgml
index 7c262be..5df5080 100644 (file)
@@ -34,7 +34,7 @@
                 This file belongs into
                 ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/
 
- $Id: user-manual.sgml,v 2.126 2010/11/06 12:55:48 fabiankeil Exp $
+ $Id: user-manual.sgml,v 2.130 2010/12/01 19:28:28 fabiankeil Exp $
 
  Copyright (C) 2001-2010 Privoxy Developers http://www.privoxy.org/
  See LICENSE.
@@ -60,7 +60,7 @@
  </subscript>
 </pubdate>
 
-<pubdate>$Id: user-manual.sgml,v 2.126 2010/11/06 12:55:48 fabiankeil Exp $</pubdate>
+<pubdate>$Id: user-manual.sgml,v 2.130 2010/12/01 19:28:28 fabiankeil Exp $</pubdate>
 
 <!--
 
@@ -437,29 +437,29 @@ How to install the binary packages depends on your operating system:
 <sect1 id="whatsnew">
 <title>What's New in this Release</title>
 <para>
- <application>Privoxy 3.0.16</application> is a stable release.
- The changes since 3.0.15 beta are:
+ <application>Privoxy 3.0.17</application> is a stable release.
+ The changes since 3.0.16 stable are:
 </para>
 
 <para>
  <itemizedlist>
-    <listitem>
+  <listitem>
    <para>
     Fixed last-chunk-detection for responses where the content was small
     enough to be read with the body, causing Privoxy to wait for the
-    end of the content until the server closed the connection.
-    Reported by "Karsten" in #3028326.
+    end of the content until the server closed the connection or the
+    request timed out. Reported by "Karsten" in #3028326.
    </para>
   </listitem>
   <listitem>
    <para>
     Responses with status code 204 weren't properly detected as body-less
-    like RFC2616 mandates. Like the previous bug, this caused Privoxy
-    to wait for the end of the content until the server closed the connection.
-    Fixes #3022042 and #3025553, reported by a user with no visible name.
-    Most likely also fixes a bunch of other AJAX-related problem reports
-    that got closed in the past due to insufficient information and lack
-    of feedback.
+    like RFC2616 mandates. Like the previous bug, this caused Privoxy to
+    wait for the end of the content until the server closed the connection
+    or the request timed out. Fixes #3022042 and #3025553, reported by a
+    user with no visible name. Most likely also fixes a bunch of other
+    AJAX-related problem reports that got closed in the past due to
+    insufficient information and lack of feedback.
    </para>
   </listitem>
   <listitem>
@@ -549,8 +549,8 @@ How to install the binary packages depends on your operating system:
     </listitem>
     <listitem>
      <para>
-      In cgi_show_url_info(), don't forget to prefix URLs that only contain http:// or https:// in the path.
-      Fixes #2975765 reported by Adam Piggott.
+      In cgi_show_url_info(), don't forget to prefix URLs that only contain
+      http:// or https:// in the path. Fixes #2975765 reported by Adam Piggott.
      </para>
     </listitem>
     <listitem>
@@ -558,7 +558,8 @@ How to install the binary packages depends on your operating system:
       Show the 404 CGI page if cgi_send_user_manual() is called while
       local user manual delivery is disabled.
      </para>
-    </itemizedlist>
+    </listitem>
+   </itemizedlist>
    </para>
   </listitem>
   <listitem>
@@ -640,9 +641,8 @@ How to install the binary packages depends on your operating system:
      <para>
       javascript needs to be blocked with +handle-as-empty-document to
       work around Firefox bug 492459.  So move .js blockers from
-      +block{Might be a web-bug.} -handle-as-empty-document
-      to
-      +block{Might be a web-bug.} +handle-as-empty-document
+      +block{Might be a web-bug.} -handle-as-empty-document to
+      +block{Might be a web-bug.} +handle-as-empty-document.
      </para>
     </listitem>
     <listitem>
@@ -652,7 +652,7 @@ How to install the binary packages depends on your operating system:
     </listitem>
     <listitem>
      <para>
-      Block another omniture tracking domain
+      Block another omniture tracking domain.
      </para>
     </listitem>
     <listitem>
@@ -665,8 +665,9 @@ How to install the binary packages depends on your operating system:
       Added two sections to get Flickr's Ajax interface working with
       default pre-settings. If you change the configuration to block
       cookies by default, you'll need additional exceptions.
-      Reported by Mathias Homann in #3101419 and by Patrick on ijbswa-users@
+      Reported by Mathias Homann in #3101419 and by Patrick on ijbswa-users@.
      </para>
+    </listitem>
     </itemizedlist>
    </para>
   </listitem>
@@ -695,6 +696,29 @@ How to install the binary packages depends on your operating system:
      <para>
       Grammar fixes for the ACL section.
      </para>
+    </listitem>
+    <listitem>
+     <para>
+      Fixed a link to the 'intercepting' entry and add another one.
+     </para>
+    </listitem>
+    <listitem>
+     <para>
+      Rename the 'Other' section to 'Mailing Lists' and reword it
+      to make it clear that nobody is forced to use the trackers
+     </para>
+    </listitem>
+    <listitem>
+     <para>
+      Note that 'anonymously' posting on the trackers may not always
+      be possible.
+     </para>
+    </listitem>
+    <listitem>
+     <para>
+      Suggest to enable debug 32768 when suspecting parsing problems.
+     </para>
+    </listitem>
     </itemizedlist>
    </para>
   </listitem>
@@ -704,23 +728,23 @@ How to install the binary packages depends on your operating system:
     <itemizedlist>
     <listitem>
      <para>
-      Also gather statistics for blocked and redirected requests.
+      Gather statistics for ressources, methods, and HTTP versions
+      used by the client.
      </para>
     </listitem>
     <listitem>
      <para>
-      Provide the percentage of keep-alive offers the client accepted.
+      Also gather statistics for blocked and redirected requests.
      </para>
     </listitem>
     <listitem>
      <para>
-      Add a --url-statistics-threshold option.
+      Provide the percentage of keep-alive offers the client accepted.
      </para>
     </listitem>
     <listitem>
      <para>
-      Also gather statistics for ressources, methods, and HTTP versions
-      used by the client.
+      Add a --url-statistics-threshold option.
      </para>
     </listitem>
     <listitem>
@@ -782,6 +806,7 @@ How to install the binary packages depends on your operating system:
      <para>
       Accept: Merged multiple header lines to: 'X-FORWARDED-PROTO: http X-HOST: 127.0.0.1'
      </para>
+    </listitem>
     </itemizedlist>
    </para>
   </listitem>
@@ -864,7 +889,7 @@ How to install the binary packages depends on your operating system:
     <listitem>
      <para>
       Remove an incorrect cgi_error_unknown() call in a
-      cannnot-happen-situation in send_crunch_response().
+      cannot-happen-situation in send_crunch_response().
      </para>
     </listitem>
     <listitem>
@@ -883,6 +908,14 @@ How to install the binary packages depends on your operating system:
      <para>
       Silence a 'gcc (Debian 4.3.2-1.1) 4.3.2' warning on i686 GNU/Linux.
      </para>
+    </listitem>
+    <listitem>
+     <para>
+      Fix white-space in a log message in remove_chunked_transfer_coding().
+      While at it, add a note that the message doesn't seem to
+      be entirely correct and should be improved later on.
+     </para>
+    </listitem>
     </itemizedlist>
    </para>
   </listitem>
@@ -912,6 +945,7 @@ How to install the binary packages depends on your operating system:
       Removed GNUisms in the webserver and webactions targets so they
       work with standard tar.
      </para>
+    </listitem>
     </itemizedlist>
    </para>
   </listitem>
@@ -8883,6 +8917,20 @@ In file: user.action <guibutton>[ View ]</guibutton> <guibutton>[ Edit ]</guibut
  USA
 
  $Log: user-manual.sgml,v $
+ Revision 2.130  2010/12/01 19:28:28  fabiankeil
+ Hopefully unbreak the dok target when using some kind of jade.
+
+ Reported by Lee.
+
+ Revision 2.129  2010/11/13 20:17:11  fabiankeil
+ Merge ChangeLog updates
+
+ Revision 2.128  2010/11/10 22:00:13  fabiankeil
+ Update the first paragraph of the 'What's New' section.
+
+ Revision 2.127  2010/11/10 21:48:54  fabiankeil
+ Update the "What's New" section.
+
  Revision 2.126  2010/11/06 12:55:48  fabiankeil
  Set p-version to 3.0.17