From 2581e3426612050c42c64152c176cbeff77fdc83 Mon Sep 17 00:00:00 2001
From: Fabian Keil <fk@fabiankeil.de>
Date: Sat, 13 Feb 2010 16:40:25 +0000
Subject: [PATCH] Rebuilt with updated 'What's new?' section.
---
doc/webserver/user-manual/actions-file.html | 23 +-
doc/webserver/user-manual/appendix.html | 20 +-
doc/webserver/user-manual/config.html | 24 +-
doc/webserver/user-manual/configuration.html | 6 +-
doc/webserver/user-manual/copyright.html | 6 +-
doc/webserver/user-manual/filter-file.html | 4 +-
doc/webserver/user-manual/index.html | 30 +--
doc/webserver/user-manual/quickstart.html | 4 +-
doc/webserver/user-manual/startup.html | 6 +-
doc/webserver/user-manual/whatsnew.html | 220 +++++++++++++++----
10 files changed, 247 insertions(+), 96 deletions(-)
diff --git a/doc/webserver/user-manual/actions-file.html b/doc/webserver/user-manual/actions-file.html
index 9bb9fb7f..8fb15122 100644
--- a/doc/webserver/user-manual/actions-file.html
+++ b/doc/webserver/user-manual/actions-file.html
@@ -233,7 +233,7 @@ CLASS="FILENAME"
> <DIV
CLASS="TABLE"
><A
-NAME="AEN2450"
+NAME="AEN2491"
></A
><P
><B
@@ -501,7 +501,7 @@ CLASS="SECT2"
><H2
CLASS="SECT2"
><A
-NAME="AEN2549"
+NAME="AEN2590"
>8.1. Finding the Right Mix</A
></H2
><P
@@ -536,7 +536,7 @@ CLASS="SECT2"
><H2
CLASS="SECT2"
><A
-NAME="AEN2556"
+NAME="AEN2597"
>8.2. How to Edit</A
></H2
><P
@@ -907,7 +907,7 @@ CLASS="SECT3"
><H3
CLASS="SECT3"
><A
-NAME="AEN2663"
+NAME="AEN2704"
>8.4.1. The Domain Pattern</A
></H3
><P
@@ -1147,7 +1147,7 @@ CLASS="SECT3"
><H3
CLASS="SECT3"
><A
-NAME="AEN2739"
+NAME="AEN2780"
>8.4.2. The Path Pattern</A
></H3
><P
@@ -1810,6 +1810,9 @@ CLASS="QUOTE"
> are, you definitely don't need to worry about this
one.
</P
+><P
+> Headers added by this action are not modified by other actions.
+ </P
></DD
><DT
>Example usage:</DT
@@ -6715,7 +6718,7 @@ CLASS="SECT3"
><H3
CLASS="SECT3"
><A
-NAME="AEN4370"
+NAME="AEN4412"
>8.5.34. Summary</A
></H3
><P
@@ -7017,7 +7020,7 @@ CLASS="SECT3"
><H3
CLASS="SECT3"
><A
-NAME="AEN4434"
+NAME="AEN4476"
>8.7.1. match-all.action</A
></H3
><P
@@ -7115,7 +7118,7 @@ CLASS="SECT3"
><H3
CLASS="SECT3"
><A
-NAME="AEN4456"
+NAME="AEN4498"
>8.7.2. default.action</A
></H3
><P
@@ -7716,7 +7719,7 @@ CLASS="SECT3"
><H3
CLASS="SECT3"
><A
-NAME="AEN4569"
+NAME="AEN4611"
>8.7.3. user.action</A
></H3
><P
@@ -8252,4 +8255,4 @@ VALIGN="top"
></DIV
></BODY
></HTML
->
+>
\ No newline at end of file
diff --git a/doc/webserver/user-manual/appendix.html b/doc/webserver/user-manual/appendix.html
index f9579cac..a3617620 100644
--- a/doc/webserver/user-manual/appendix.html
+++ b/doc/webserver/user-manual/appendix.html
@@ -748,7 +748,7 @@ CLASS="SECT2"
><H2
CLASS="SECT2"
><A
-NAME="AEN5455"
+NAME="AEN5497"
>14.2. Privoxy's Internal Pages</A
></H2
><P
@@ -794,7 +794,7 @@ CLASS="APPLICATION"
Privoxy main page:
</P
><A
-NAME="AEN5469"
+NAME="AEN5511"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
@@ -827,7 +827,7 @@ CLASS="APPLICATION"
editing of actions files:
</P
><A
-NAME="AEN5477"
+NAME="AEN5519"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
@@ -847,7 +847,7 @@ TARGET="_top"
Show the source code version numbers:
</P
><A
-NAME="AEN5482"
+NAME="AEN5524"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
@@ -867,7 +867,7 @@ TARGET="_top"
Show the browser's request headers:
</P
><A
-NAME="AEN5487"
+NAME="AEN5529"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
@@ -887,7 +887,7 @@ TARGET="_top"
Show which actions apply to a URL and why:
</P
><A
-NAME="AEN5492"
+NAME="AEN5534"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
@@ -919,7 +919,7 @@ CLASS="QUOTE"
place:
</P
><A
-NAME="AEN5500"
+NAME="AEN5542"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
@@ -936,7 +936,7 @@ TARGET="_top"
> Short cuts. Turn off, then on:
</P
><A
-NAME="AEN5504"
+NAME="AEN5546"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
@@ -950,7 +950,7 @@ TARGET="_top"
</P
></BLOCKQUOTE
><A
-NAME="AEN5507"
+NAME="AEN5549"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
@@ -2184,4 +2184,4 @@ VALIGN="top"
></DIV
></BODY
></HTML
->
+>
\ No newline at end of file
diff --git a/doc/webserver/user-manual/config.html b/doc/webserver/user-manual/config.html
index edfc224f..a79b329a 100644
--- a/doc/webserver/user-manual/config.html
+++ b/doc/webserver/user-manual/config.html
@@ -3933,6 +3933,26 @@ CLASS="APPLICATION"
>
has been compiled without keep-alive support.
</P
+><P
+> Note that a timeout of five seconds as used in the default
+ configuration file significantly decreases the number of
+ connections that will be reused. The value is used because
+ some browsers limit the number of connections they open to
+ a single host and apply the same limit to proxies. This can
+ result in a single website <SPAN
+CLASS="QUOTE"
+>"grabbing"</SPAN
+> all the
+ connections the browser allows, which means connections to
+ other websites can't be opened until the connections currently
+ in use time out.
+ </P
+><P
+> Several users have reported this as a Privoxy bug, so the
+ default value has been reduced. Consider increasing it to
+ 300 seconds or even more if you think your browser can handle
+ it. If your browser appears to be hanging it can't.
+ </P
></DD
><DT
>Examples:</DT
@@ -4391,10 +4411,12 @@ TARGET="_top"
><DD
><P
> The status code Privoxy returns for pages blocked with
+
<TT
CLASS="LITERAL"
><A
HREF="actions-file.html#HANDLE-AS-EMPTY-DOCUMENT"
+TARGET="_top"
>+handle-as-empty-document</A
></TT
>.
@@ -4795,4 +4817,4 @@ VALIGN="top"
></DIV
></BODY
></HTML
->
\ No newline at end of file
+>
diff --git a/doc/webserver/user-manual/configuration.html b/doc/webserver/user-manual/configuration.html
index 73feaf03..5aaffa9a 100644
--- a/doc/webserver/user-manual/configuration.html
+++ b/doc/webserver/user-manual/configuration.html
@@ -98,7 +98,7 @@ CLASS="SECT2"
><H2
CLASS="SECT2"
><A
-NAME="AEN839"
+NAME="AEN877"
>6.1. Controlling Privoxy with Your Web Browser</A
></H2
><P
@@ -129,7 +129,7 @@ CLASS="SCREEN"
> <H2
CLASS="BRIDGEHEAD"
><A
-NAME="AEN847"
+NAME="AEN885"
></A
> Privoxy Menu</H2
><P
@@ -521,4 +521,4 @@ VALIGN="top"
></DIV
></BODY
></HTML
->
\ No newline at end of file
+>
diff --git a/doc/webserver/user-manual/copyright.html b/doc/webserver/user-manual/copyright.html
index c372df49..e50fc734 100644
--- a/doc/webserver/user-manual/copyright.html
+++ b/doc/webserver/user-manual/copyright.html
@@ -83,7 +83,7 @@ NAME="COPYRIGHT"
>12. Privoxy Copyright, License and History</A
></H1
><P
-> Copyright © 2001-2009 by Privoxy Developers <CODE
+> Copyright © 2001-2010 by Privoxy Developers <CODE
CLASS="EMAIL"
><<A
HREF="mailto:ijbswa-developers@lists.sourceforge.net"
@@ -102,7 +102,7 @@ CLASS="SECT2"
><H2
CLASS="SECT2"
><A
-NAME="AEN5202"
+NAME="AEN5244"
>12.1. License</A
></H2
><P
@@ -427,4 +427,4 @@ VALIGN="top"
></DIV
></BODY
></HTML
->
+>
\ No newline at end of file
diff --git a/doc/webserver/user-manual/filter-file.html b/doc/webserver/user-manual/filter-file.html
index d12c714e..4852842e 100644
--- a/doc/webserver/user-manual/filter-file.html
+++ b/doc/webserver/user-manual/filter-file.html
@@ -366,7 +366,7 @@ CLASS="SECT2"
><H2
CLASS="SECT2"
><A
-NAME="AEN4724"
+NAME="AEN4766"
>9.1. Filter File Tutorial</A
></H2
><P
@@ -1649,4 +1649,4 @@ VALIGN="top"
></DIV
></BODY
></HTML
->
+>
\ No newline at end of file
diff --git a/doc/webserver/user-manual/index.html b/doc/webserver/user-manual/index.html
index 8e08af92..73720269 100644
--- a/doc/webserver/user-manual/index.html
+++ b/doc/webserver/user-manual/index.html
@@ -40,7 +40,7 @@ CLASS="PUBDATE"
> <A
HREF="copyright.html"
>Copyright</A
-> © 2001-2009 by
+> © 2001-2010 by
<A
HREF="http://www.privoxy.org/"
TARGET="_top"
@@ -50,7 +50,7 @@ TARGET="_top"
><BR></P
><P
CLASS="PUBDATE"
->$Id: user-manual.sgml,v 2.116 2009/11/15 14:24:12 fabiankeil Exp $<BR></P
+>$Id: user-manual.sgml,v 2.118 2010/02/11 13:59:48 fabiankeil Exp $<BR></P
><DIV
><DIV
CLASS="ABSTRACT"
@@ -290,7 +290,7 @@ HREF="configuration.html"
><DL
><DT
>6.1. <A
-HREF="configuration.html#AEN839"
+HREF="configuration.html#AEN877"
>Controlling Privoxy with Your Web Browser</A
></DT
><DT
@@ -552,12 +552,12 @@ HREF="actions-file.html"
><DL
><DT
>8.1. <A
-HREF="actions-file.html#AEN2549"
+HREF="actions-file.html#AEN2590"
>Finding the Right Mix</A
></DT
><DT
>8.2. <A
-HREF="actions-file.html#AEN2556"
+HREF="actions-file.html#AEN2597"
>How to Edit</A
></DT
><DT
@@ -574,12 +574,12 @@ HREF="actions-file.html#AF-PATTERNS"
><DL
><DT
>8.4.1. <A
-HREF="actions-file.html#AEN2663"
+HREF="actions-file.html#AEN2704"
>The Domain Pattern</A
></DT
><DT
>8.4.2. <A
-HREF="actions-file.html#AEN2739"
+HREF="actions-file.html#AEN2780"
>The Path Pattern</A
></DT
><DT
@@ -763,7 +763,7 @@ HREF="actions-file.html#SET-IMAGE-BLOCKER"
></DT
><DT
>8.5.34. <A
-HREF="actions-file.html#AEN4370"
+HREF="actions-file.html#AEN4412"
>Summary</A
></DT
></DL
@@ -782,17 +782,17 @@ HREF="actions-file.html#ACT-EXAMPLES"
><DL
><DT
>8.7.1. <A
-HREF="actions-file.html#AEN4434"
+HREF="actions-file.html#AEN4476"
>match-all.action</A
></DT
><DT
>8.7.2. <A
-HREF="actions-file.html#AEN4456"
+HREF="actions-file.html#AEN4498"
>default.action</A
></DT
><DT
>8.7.3. <A
-HREF="actions-file.html#AEN4569"
+HREF="actions-file.html#AEN4611"
>user.action</A
></DT
></DL
@@ -808,7 +808,7 @@ HREF="filter-file.html"
><DL
><DT
>9.1. <A
-HREF="filter-file.html#AEN4724"
+HREF="filter-file.html#AEN4766"
>Filter File Tutorial</A
></DT
><DT
@@ -876,7 +876,7 @@ HREF="copyright.html"
><DL
><DT
>12.1. <A
-HREF="copyright.html#AEN5202"
+HREF="copyright.html#AEN5244"
>License</A
></DT
><DT
@@ -910,7 +910,7 @@ HREF="appendix.html#REGEX"
></DT
><DT
>14.2. <A
-HREF="appendix.html#AEN5455"
+HREF="appendix.html#AEN5497"
>Privoxy's Internal Pages</A
></DT
><DD
@@ -989,4 +989,4 @@ VALIGN="top"
></DIV
></BODY
></HTML
->
+>
\ No newline at end of file
diff --git a/doc/webserver/user-manual/quickstart.html b/doc/webserver/user-manual/quickstart.html
index 8b9b36cd..0ea4ca70 100644
--- a/doc/webserver/user-manual/quickstart.html
+++ b/doc/webserver/user-manual/quickstart.html
@@ -727,7 +727,7 @@ CLASS="GUIBUTTON"
> <DIV
CLASS="FIGURE"
><A
-NAME="AEN593"
+NAME="AEN631"
></A
><P
><B
@@ -940,4 +940,4 @@ VALIGN="top"
></DIV
></BODY
></HTML
->
\ No newline at end of file
+>
diff --git a/doc/webserver/user-manual/startup.html b/doc/webserver/user-manual/startup.html
index 3af75b45..c3c369c8 100644
--- a/doc/webserver/user-manual/startup.html
+++ b/doc/webserver/user-manual/startup.html
@@ -114,7 +114,7 @@ CLASS="APPLICATION"
> <DIV
CLASS="FIGURE"
><A
-NAME="AEN648"
+NAME="AEN686"
></A
><P
><B
@@ -251,7 +251,7 @@ CLASS="EMPHASIS"
> <DIV
CLASS="FIGURE"
><A
-NAME="AEN693"
+NAME="AEN731"
></A
><P
><B
@@ -899,4 +899,4 @@ VALIGN="top"
></DIV
></BODY
></HTML
->
\ No newline at end of file
+>
diff --git a/doc/webserver/user-manual/whatsnew.html b/doc/webserver/user-manual/whatsnew.html
index e8cd3d52..2da4ebec 100644
--- a/doc/webserver/user-manual/whatsnew.html
+++ b/doc/webserver/user-manual/whatsnew.html
@@ -84,122 +84,137 @@ NAME="WHATSNEW"
><P
> <SPAN
CLASS="APPLICATION"
->Privoxy 3.0.15 beta</SPAN
-> is a bug-fix release
- for the previous beta. The changes since 3.0.14 are:</P
+>Privoxy 3.0.16</SPAN
+> is a stable release.
+ The changes since 3.0.15 beta are:</P
><P
> <P
></P
><UL
><LI
><P
-> In case of missing server data, no error message is send to the
- client if the request arrived on a reused connection. The client
- is then supposed to silently retry the request without bothering
- the user. This should significantly reduce the frequency of the
- "No server or forwarder data received" error message many users
- reported.
+> Added the config file option handle-as-empty-doc-returns-ok to
+ work around Firefox bug #492459, which causes Firefox to hang
+ if JavaScripts are blocked in certain situations. The option is
+ enabled in the default config file.
</P
></LI
><LI
><P
-> More reliable detection of prematurely closed client sockets
- with keep-alive enabled.
+> Added the config option default-server-timeout to control the
+ assumed default server timeout. Since Privoxy no longer returns
+ an error message for connection resets on reused client connections,
+ assuming larger server timeout values appears to actually work
+ pretty well as long as connections aren't shared.
</P
></LI
><LI
><P
-> FEATURE_CONNECTION_KEEP_ALIVE is decoupled from
- FEATURE_CONNECTION_SHARING and now available on
- all platforms.
+> Added optional support for FreeBSD's accf_http(9). Use the
+ configure option --enable-accept-filter to enable it.
</P
></LI
><LI
><P
-> Improved handling of POST requests on reused connections.
- Should fix problems with stalled connections after submitting
- form data with some browser configurations.
+> Added fancier Privoxy icons for win32. Contributed by Jeff H.
</P
></LI
><LI
><P
-> Fixed various latency calculation issues.
+> In daemon mode, fd 0, 1 and 2 are bound to /dev/null.
</P
></LI
><LI
><P
-> Allows the client to pass NTLM authentication requests to a
- forwarding proxy. This was already assumed and hinted to work
- in 3.0.13 beta but actually didn't. Now it's confirmed to work
- with IE, Firefox and Chrome.
- Thanks to Francois Botha and Wan-Teh Chang
+> Resolve localhost using whatever address family the operating
+ system feels like. Previous betas would try to use IPv4 as this
+ is what most users expect, but this didn't work reliable on
+ GNU/Linux systems.
</P
></LI
><LI
><P
-> Fixed a calculation problem if receiving the server headers
- takes more than two reads, that could cause Privoxy to terminate
- the connection prematurely. Reported by Oliver.
+> In the action lists on CGI pages, actions and their parameters are
+ no longer separated with a space. The action file parser doesn't
+ actually allow this and will throw an invalid syntax error if actions
+ and parameters in the action files are separated. Not adding the
+ spaces means copy and pasting CGI output into the action files works.
</P
></LI
><LI
><P
-> Compiles again on platforms such as OpenBSD and systems
- using earlier glibc version that don't support AI_ADDRCONFIG.
- Anonymously submitted in #2872591.
+> The default keep-alive timeout has been reduced to 5 seconds to work
+ around hangs in clients that treat the proxy like any other host and
+ stop allowing any new connections if the "maximum number of
+ connections per host" is reached.
</P
></LI
><LI
><P
-> A bunch of MS VC project files and Suse and Redhat RPM spec
- files have been removed as they were no longer maintained for
- quite some time.
+> Several webbug URLs that look like they are leading to images are now
+ blocked as image instead of empty documents. Doing the latter causes
+ WebKit-based clients to show a "missing image" icon which may mess up
+ the layout.
</P
></LI
><LI
><P
-> Overly long action lines are properly rejected with a proper
- error message. Previously they would be either rejected as
- invalid or cause a core dump through abort().
+> Accepts quoted expiration dates even though RFC 2109 10.1.2
+ doesn't seem to allow them. Reported anonymously.
</P
></LI
><LI
><P
-> Already timed-out connections are no longer temporarily remembered.
- They weren't reused anyway, but wasted a socket slot.
+> Don't try to forget connections if connection sharing is disabled.
+ This wasn't a real problem but caused an unnecessary log message.
</P
></LI
><LI
><P
-> len refers to the number of bytes actually read which might
- differ from the ones received. Adjust log messages accordingly.
+> The still undocumented --enable-extended-host-patterns configure
+ option has a better description.
</P
></LI
><LI
><P
-> The optional JavaScript on the CGI page uses encodeURIComponent()
- instead of escape() which doesn't encode all characters that matter.
- Anonymously reported in #2832722.
+> Fixed an error message that would claim a write to the server
+ failed when actually writing to the client failed.
</P
></LI
><LI
><P
-> Fix gcc45 warnings in decompress_iob().
+> Log the crunch reason before trying to write to the client.
+ The log is easier to read that way.
</P
></LI
><LI
><P
-> Various log message improvements.
+> Several log messages about client connections also mention
+ the socket number.
</P
></LI
><LI
><P
-> Privoxy-Regression-Test supports redirect tests.
+> handle-as-empty-document no longer depends on the image blocking
+ code being enabled.
</P
></LI
><LI
><P
-> Privoxy-Log-Parser can gather some connection statistics.
+> Privoxy-Log-Parser is roughly 40% faster in highlighting mode.
+ </P
+></LI
+><LI
+><P
+> uagen, a Firefox User-Agent generator for Privoxy and Mozilla
+ browsers has been imported and is available in the tarballs
+ tools directory.
+ </P
+></LI
+><LI
+><P
+> The scripts in the tools directory treat unknown parameters
+ as fatal errors.
</P
></LI
></UL
@@ -379,6 +394,117 @@ CLASS="APPLICATION"
are still welcome too: http://www.privoxy.org/faq/general.html#DONATE
</P
></LI
+><LI
+><P
+> In case of missing server data, no error message is send to the
+ client if the request arrived on a reused connection. The client
+ is then supposed to silently retry the request without bothering
+ the user. This should significantly reduce the frequency of the
+ "No server or forwarder data received" error message many users
+ reported.
+ </P
+></LI
+><LI
+><P
+> More reliable detection of prematurely closed client sockets
+ with keep-alive enabled.
+ </P
+></LI
+><LI
+><P
+> FEATURE_CONNECTION_KEEP_ALIVE is decoupled from
+ FEATURE_CONNECTION_SHARING and now available on
+ all platforms.
+ </P
+></LI
+><LI
+><P
+> Improved handling of POST requests on reused connections.
+ Should fix problems with stalled connections after submitting
+ form data with some browser configurations.
+ </P
+></LI
+><LI
+><P
+> Fixed various latency calculation issues.
+ </P
+></LI
+><LI
+><P
+> Allows the client to pass NTLM authentication requests to a
+ forwarding proxy. This was already assumed and hinted to work
+ in 3.0.13 beta but actually didn't. Now it's confirmed to work
+ with IE, Firefox and Chrome.
+ Thanks to Francois Botha and Wan-Teh Chang
+ </P
+></LI
+><LI
+><P
+> Fixed a calculation problem if receiving the server headers
+ takes more than two reads, that could cause Privoxy to terminate
+ the connection prematurely. Reported by Oliver.
+ </P
+></LI
+><LI
+><P
+> Compiles again on platforms such as OpenBSD and systems
+ using earlier glibc version that don't support AI_ADDRCONFIG.
+ Anonymously submitted in #2872591.
+ </P
+></LI
+><LI
+><P
+> A bunch of MS VC project files and Suse and Redhat RPM spec
+ files have been removed as they were no longer maintained for
+ quite some time.
+ </P
+></LI
+><LI
+><P
+> Overly long action lines are properly rejected with a proper
+ error message. Previously they would be either rejected as
+ invalid or cause a core dump through abort().
+ </P
+></LI
+><LI
+><P
+> Already timed-out connections are no longer temporarily remembered.
+ They weren't reused anyway, but wasted a socket slot.
+ </P
+></LI
+><LI
+><P
+> len refers to the number of bytes actually read which might
+ differ from the ones received. Adjust log messages accordingly.
+ </P
+></LI
+><LI
+><P
+> The optional JavaScript on the CGI page uses encodeURIComponent()
+ instead of escape() which doesn't encode all characters that matter.
+ Anonymously reported in #2832722.
+ </P
+></LI
+><LI
+><P
+> Fix gcc45 warnings in decompress_iob().
+ </P
+></LI
+><LI
+><P
+> Various log message improvements.
+ </P
+></LI
+><LI
+><P
+> Privoxy-Regression-Test supports redirect tests.
+ </P
+></LI
+><LI
+><P
+> Privoxy-Log-Parser can gather some connection statistics.
+ </P
+></LI
></UL
></P
><DIV
@@ -558,4 +684,4 @@ VALIGN="top"
></DIV
></BODY
></HTML
->
\ No newline at end of file
+>
--
2.49.0