Last minute ChangeLog changes that didn't make it into the tarball
[privoxy.git] / doc / webserver / user-manual / whatsnew.html
index a051594..a3af452 100644 (file)
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
-<HTML
-><HEAD
-><TITLE
->What's New in this Release</TITLE
-><META
-NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
-REL="HOME"
-TITLE="Privoxy 3.0.16 User Manual"
-HREF="index.html"><LINK
-REL="PREVIOUS"
-TITLE="Installation"
-HREF="installation.html"><LINK
-REL="NEXT"
-TITLE="Quickstart to Using Privoxy"
-HREF="quickstart.html"><LINK
-REL="STYLESHEET"
-TYPE="text/css"
-HREF="../p_doc.css"><META
-HTTP-EQUIV="Content-Type"
-CONTENT="text/html;
-charset=ISO-8859-1">
-<LINK REL="STYLESHEET" TYPE="text/css" HREF="p_doc.css">
-</head
-><BODY
-CLASS="SECT1"
-BGCOLOR="#EEEEEE"
-TEXT="#000000"
-LINK="#0000FF"
-VLINK="#840084"
-ALINK="#0000FF"
-><DIV
-CLASS="NAVHEADER"
-><TABLE
-SUMMARY="Header navigation table"
-WIDTH="100%"
-BORDER="0"
-CELLPADDING="0"
-CELLSPACING="0"
-><TR
-><TH
-COLSPAN="3"
-ALIGN="center"
->Privoxy 3.0.16 User Manual</TH
-></TR
-><TR
-><TD
-WIDTH="10%"
-ALIGN="left"
-VALIGN="bottom"
-><A
-HREF="installation.html"
-ACCESSKEY="P"
->Prev</A
-></TD
-><TD
-WIDTH="80%"
-ALIGN="center"
-VALIGN="bottom"
-></TD
-><TD
-WIDTH="10%"
-ALIGN="right"
-VALIGN="bottom"
-><A
-HREF="quickstart.html"
-ACCESSKEY="N"
->Next</A
-></TD
-></TR
-></TABLE
-><HR
-ALIGN="LEFT"
-WIDTH="100%"></DIV
-><DIV
-CLASS="SECT1"
-><H1
-CLASS="SECT1"
-><A
-NAME="WHATSNEW"
->3. What's New in this Release</A
-></H1
-><P
-> <SPAN
-CLASS="APPLICATION"
->Privoxy 3.0.16</SPAN
-> is a stable release.
- The changes since 3.0.15 beta are:</P
-><P
-> <P
-></P
-><UL
-><LI
-><P
->    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
->    Added the config file 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
->    Added optional support for FreeBSD's accf_http(9). Use the
-    configure option --enable-accept-filter to enable it.
-   </P
-></LI
-><LI
-><P
->    Added fancier Privoxy icons for win32. Contributed by Jeff H.
-   </P
-></LI
-><LI
-><P
->    In daemon mode, fd 0, 1 and 2 are bound to /dev/null.
-   </P
-></LI
-><LI
-><P
->    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 reliably on
-    GNU/Linux systems.
-   </P
-></LI
-><LI
-><P
->    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
->    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
->    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
->    The no-such-domain template is used for DNS resolution
-    problems with FEATURE_IPV6_SUPPORT enabled. Previously the
-    connect-failed template was used. Reported by 'zebul666'.
-   </P
-></LI
-><LI
-><P
->    Accepts quoted expiration dates even though RFC 2109 10.1.2
-    doesn't seem to allow them. Reported anonymously.
-   </P
-></LI
-><LI
-><P
->    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
->    The still undocumented --enable-extended-host-patterns configure
-    option has a better description.
-   </P
-></LI
-><LI
-><P
->    Fixed an error message that would claim a write to the server
-    failed when actually writing to the client failed.
-   </P
-></LI
-><LI
-><P
->    Log the crunch reason before trying to write to the client.
-    The log is easier to read that way.
-   </P
-></LI
-><LI
-><P
->    Several log messages about client connections also mention
-    the socket number.
-   </P
-></LI
-><LI
-><P
->    handle-as-empty-document no longer depends on the image blocking
-    code being enabled.
-   </P
-></LI
-><LI
-><P
->    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 tarball's
-    tools directory.
-   </P
-></LI
-><LI
-><P
->    The scripts in the tools directory treat unknown parameters
-    as fatal errors.
-   </P
-></LI
-></UL
-></P
-><P
-> If you missed the previous three beta versions, you may also be
- interested in the additional changes since 3.0.12, the
- last stable release:</P
-><P
-> <P
-></P
-><UL
-><LI
-><P
->    Added IPv6 support. Thanks to Petr Pisar who not only provided
-    the initial patch but also helped a lot with the integration.
-   </P
-></LI
-><LI
-><P
->    Added client-side keep-alive support.
-   </P
-></LI
-><LI
-><P
->    The connection sharing code is only used if the connection-sharing
-    option is enabled.
-   </P
-></LI
-><LI
-><P
->    The latency is taken into account when evaluating whether or not to
-    reuse a connection. This should significantly reduce the number of
-    connections problems several users reported.
-   </P
-></LI
-><LI
-><P
->    The max-client-connections option has been added to restrict
-    the number of client connections below a value enforced by
-    the operating system.
-   </P
-></LI
-><LI
-><P
->    If the server doesn't specify how long the connection stays alive,
-    Privoxy errs on the safe side of caution and assumes it's only a second.
-   </P
-></LI
-><LI
-><P
->    Setting keep-alive-timeout to 0 disables keep-alive support. Previously
-    Privoxy would claim to allow persistence but not reuse the connection.
-   </P
-></LI
-><LI
-><P
->    Pipelined requests are less likely to be mistaken for the request
-    body of the previous request. Note that Privoxy still has no real
-    pipeline support and will either serialize pipelined requests or
-    drop them in which case the client has to resent them.
-   </P
-></LI
-><LI
-><P
->    Fixed a crash on some Windows versions when header randomization
-    is enabled and the date couldn't be parsed.
-   </P
-></LI
-><LI
-><P
->    Privoxy's keep-alive timeout for the current connection is reduced
-    to the one specified in the client's Keep-Alive header.
-   </P
-></LI
-><LI
-><P
->    For HTTP/1.1 requests, Privoxy implies keep-alive support by not
-    setting any Connection header instead of using 'Connection: keep-alive'.
-   </P
-></LI
-><LI
-><P
->    If the socket isn't reusable, Privoxy doesn't temporarily waste
-    a socket slot to remember the connection.
-   </P
-></LI
-><LI
-><P
->    If keep-alive support is disabled but compiled in, the client's
-    Keep-Alive header is removed.
-   </P
-></LI
-><LI
-><P
->    Fixed a bug on mingw32 where downloading large files failed if
-    keep-alive support was enabled.
-   </P
-></LI
-><LI
-><P
->    Fixed a bug that (at least theoretically) could cause log
-    timestamps to be occasionally off by about a second.
-   </P
-></LI
-><LI
-><P
->    The configure script respects the $PATH variable when searching
-    for groups and id.
-   </P
-></LI
-><LI
-><P
->    Compressed content with extra fields couldn't be decompressed
-    and would get passed to the client unfiltered. This problem
-    has only be detected through statical analysis with clang as
-    nobody seems to be using extra fields anyway.
-   </P
-></LI
-><LI
-><P
->    If the server resets the Connection after sending only the headers
-    Privoxy forwards what it got to the client. Previously Privoxy
-    would deliver an error message instead.
-   </P
-></LI
-><LI
-><P
->    Error messages in case of connection timeouts use the right
-    HTTP status code.
-   </P
-></LI
-><LI
-><P
->    If spawning a child to handle a request fails, the client
-    gets an error message and Privoxy continues to listen for
-    new requests right away.
-   </P
-></LI
-><LI
-><P
->    The error messages in case of server-connection timeouts or
-    prematurely closed server connections are now template-based.
-   </P
-></LI
-><LI
-><P
->    If zlib support isn't compiled in, Privoxy no longer tries to
-    filter compressed content unless explicitly asked to do so.
-   </P
-></LI
-><LI
-><P
->    In case of connections that are denied based on ACL directives,
-    the memory used for the client IP is no longer leaked.
-   </P
-></LI
-><LI
-><P
->    Fixed another small memory leak if the client request times out
-    while waiting for client headers other than the request line.
-   </P
-></LI
-><LI
-><P
->    The client socket is kept open until the server socket has
-    been marked as unused. This should increase the chances that
-    the still-open connection will be reused for the client's next
-    request to the same destination. Note that this only matters
-    if connection-sharing is enabled.
-   </P
-></LI
-><LI
-><P
->    A TODO list has been added to the source tarball to give potential
-    volunteers a better idea of what the current goals are. Donations
-    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
-CLASS="SECT2"
-><H2
-CLASS="SECT2"
-><A
-NAME="UPGRADERSNOTE"
->3.1. Note to Upgraders</A
-></H2
-><P
-> A quick list of things to be aware of before upgrading from earlier 
- versions of <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
->:</P
-><P
-> <P
-></P
-><UL
-><LI
-><P
->   The recommended way to upgrade <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
-> is to backup your old 
-   configuration files, install the new ones, verify that <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
->
-   is working correctly and finally merge back your changes using
-   <SPAN
-CLASS="APPLICATION"
->diff</SPAN
-> and maybe <SPAN
-CLASS="APPLICATION"
->patch</SPAN
->.
-  </P
-><P
->   There are a number of new features in each <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
-> release and
-   most of them have to be explicitly enabled in the configuration
-   files. Old configuration files obviously don't do that and due
-   to syntax changes using old configuration files with a new
-   <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
-> isn't always possible anyway.
-  </P
-></LI
-><LI
-><P
->  
-    Note that some installers remove earlier versions completely,
-    including configuration files, therefore you should really save
-    any important configuration files!
-  </P
-></LI
-><LI
-><P
->  
-   On the other hand, other installers don't overwrite existing configuration 
-   files, thinking you will want to do that yourself.
-  </P
-></LI
-><LI
-><P
->  
-   <TT
-CLASS="FILENAME"
->standard.action</TT
-> has been merged into
-   the <TT
-CLASS="FILENAME"
->default.action</TT
-> file.
-  </P
-></LI
-><LI
-><P
->   In the default configuration only fatal errors are logged now.
-   You can change that in the <A
-HREF="config.html#DEBUG"
->debug section</A
->
-   of the configuration file. You may also want to enable more verbose
-   logging until you verified that the new <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
-> version is working
-   as expected.
-  </P
-></LI
-><LI
-><P
->     Three other config file settings are now off by default: 
-     <A
-HREF="config.html#ENABLE-REMOTE-TOGGLE"
->enable-remote-toggle</A
->,
-     <A
-HREF="config.html#ENABLE-REMOTE-HTTP-TOGGLE"
->enable-remote-http-toggle</A
->,
-     and  <A
-HREF="config.html#ENABLE-EDIT-ACTIONS"
->enable-edit-actions</A
->. 
-     If you use or want these, you will need to explicitly enable them, and
-     be aware of the security issues involved. 
-    </P
-></LI
-></UL
-></P
-></DIV
-></DIV
-><DIV
-CLASS="NAVFOOTER"
-><HR
-ALIGN="LEFT"
-WIDTH="100%"><TABLE
-SUMMARY="Footer navigation table"
-WIDTH="100%"
-BORDER="0"
-CELLPADDING="0"
-CELLSPACING="0"
-><TR
-><TD
-WIDTH="33%"
-ALIGN="left"
-VALIGN="top"
-><A
-HREF="installation.html"
-ACCESSKEY="P"
->Prev</A
-></TD
-><TD
-WIDTH="34%"
-ALIGN="center"
-VALIGN="top"
-><A
-HREF="index.html"
-ACCESSKEY="H"
->Home</A
-></TD
-><TD
-WIDTH="33%"
-ALIGN="right"
-VALIGN="top"
-><A
-HREF="quickstart.html"
-ACCESSKEY="N"
->Next</A
-></TD
-></TR
-><TR
-><TD
-WIDTH="33%"
-ALIGN="left"
-VALIGN="top"
->Installation</TD
-><TD
-WIDTH="34%"
-ALIGN="center"
-VALIGN="top"
->&nbsp;</TD
-><TD
-WIDTH="33%"
-ALIGN="right"
-VALIGN="top"
->Quickstart to Using Privoxy</TD
-></TR
-></TABLE
-></DIV
-></BODY
-></HTML
->
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
+"http://www.w3.org/TR/html4/loose.dtd">
+
+<html>
+<head>
+  <meta name="generator" content=
+  "HTML Tidy for Linux/x86 (vers 7 December 2008), see www.w3.org">
+
+  <title>What's New in this Release</title>
+  <meta name="GENERATOR" content=
+  "Modular DocBook HTML Stylesheet Version 1.79">
+  <link rel="HOME" title="Privoxy 3.0.18 User Manual" href="index.html">
+  <link rel="PREVIOUS" title="Installation" href="installation.html">
+  <link rel="NEXT" title="Quickstart to Using Privoxy" href=
+  "quickstart.html">
+  <link rel="STYLESHEET" type="text/css" href="../p_doc.css">
+  <meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
+  <link rel="STYLESHEET" type="text/css" href="p_doc.css">
+  <style type="text/css">
+body {
+  background-color: #EEEEEE;
+  color: #000000;
+  }
+  :link { color: #0000FF }
+  :visited { color: #840084 }
+  :active { color: #0000FF }
+  hr.c1 {text-align: left}
+  </style>
+</head>
+
+<body class="SECT1">
+  <div class="NAVHEADER">
+    <table summary="Header navigation table" width="100%" border="0"
+    cellpadding="0" cellspacing="0">
+      <tr>
+        <th colspan="3" align="center">Privoxy 3.0.18 User Manual</th>
+      </tr>
+
+      <tr>
+        <td width="10%" align="left" valign="bottom"><a href=
+        "installation.html" accesskey="P">Prev</a></td>
+
+        <td width="80%" align="center" valign="bottom"></td>
+
+        <td width="10%" align="right" valign="bottom"><a href=
+        "quickstart.html" accesskey="N">Next</a></td>
+      </tr>
+    </table>
+    <hr class="c1" width="100%">
+  </div>
+
+  <div class="SECT1">
+    <h1 class="SECT1"><a name="WHATSNEW" id="WHATSNEW">3. What's New in this
+    Release</a></h1>
+
+    <p><span class="APPLICATION">Privoxy 3.0.18</span> is a stable release.
+    The changes since 3.0.17 stable are:</p>
+
+    <ul>
+      <li>
+        <p>Bug fixes:</p>
+
+        <ul>
+          <li>
+            <p>If a generated redirect URL contains characters RFC 3986
+            doesn't permit, they are (re)encoded. Not doing this makes
+            Privoxy versions from 3.0.5 to 3.0.17 susceptible to HTTP
+            response splitting (CWE-113) attacks if the
+            +fast-redirects{check-decoded-url} action is used.</p>
+          </li>
+
+          <li>
+            <p>Fix a logic bug that could cause Privoxy to reuse a server
+            socket after it got tainted by a server-header-tagger-induced
+            block that was triggered before the whole server response had
+            been read. If keep-alive was enabled and the request following
+            the blocked one was to the same host and using the same
+            forwarding settings, Privoxy would send it on the tainted server
+            socket. While the server would simply treat it as a pipelined
+            request, Privoxy would later on fail to properly parse the
+            server's response as it would try to parse the unread data from
+            the first response as server headers for the second one.
+            Regression introduced in 3.0.17.</p>
+          </li>
+
+          <li>
+            <p>When implying keep-alive in client_connection(), remember that
+            the client didn't. Fixes a regression introduced in 3.0.13 that
+            would cause Privoxy to wait for additional client requests after
+            receiving a HTTP/1.1 request with "Connection: close" set and
+            connection sharing enabled. With clients which terminates the
+            client connection after detecting that the whole body has been
+            received it doesn't really matter, but with clients that don't
+            the connection would be kept open until it timed out.</p>
+          </li>
+
+          <li>
+            <p>Fix a subtle race condition between
+            prepare_csp_for_next_request() and sweep(). A thread preparing
+            itself for the next client request could briefly appear to be
+            inactive. If all other threads were already using more recent
+            files, the thread could get its files swept away under its feet.
+            So far this has only been reproduced while stress testing in
+            valgrind while touching action files in a loop. It's unlikely to
+            have caused any actual problems in the real world.</p>
+          </li>
+
+          <li>
+            <p>Disable filters if SDCH compression is used unless filtering
+            is forced. If SDCH was combined with a supported compression
+            algorithm, Privoxy previously could try to decompress it and
+            ditch the Content-Encoding header even though the SDCH
+            compression wasn't dealt with. Reported by zebul666 in
+            #3225863.</p>
+          </li>
+
+          <li>
+            <p>Make a copy of the --user value and only mess with that when
+            splitting user and group. On some operating systems modifying the
+            value directly is reflected in the output of ps and friends and
+            can be misleading. Reported by zepard in #3292710.</p>
+          </li>
+
+          <li>
+            <p>If forwarded-connect-retries is set, only retry if Privoxy is
+            actually forwarding the request. Previously direct connections
+            would be retried as well.</p>
+          </li>
+
+          <li>
+            <p>Fixed a small memory leak when retrying connections with IPv6
+            support enabled.</p>
+          </li>
+
+          <li>
+            <p>Remove an incorrect assertion in
+            compile_dynamic_pcrs_job_list() It could be triggered by a pcrs
+            job with an invalid pcre pattern (for example one that contains a
+            lone quantifier).</p>
+          </li>
+
+          <li>
+            <p>If the --user argument user[.group] contains a dot, always
+            bail out if no group has been specified. Previously the intended,
+            but undocumented (and apparently untested), behaviour was to try
+            interpreting the whole argument as user name, but the detection
+            was flawed and checked for '0' instead of '\0', thus merely
+            preventing group names beginning with a zero.</p>
+          </li>
+
+          <li>
+            <p>In html_code_map[], use a numeric character reference instead
+            of ' which wasn't standardized before XHTML 1.0.</p>
+          </li>
+
+          <li>
+            <p>Fix an invalid free when compiled with
+            FEATURE_GRACEFUL_TERMINATION and shut down through
+            http://config.privoxy.org/die</p>
+          </li>
+
+          <li>
+            <p>In get_actions(), fix the "temporary" backwards compatibility
+            hack to accept block actions without reason. It also covered
+            other actions that should be rejected as invalid. Reported by
+            Billy Crook.</p>
+          </li>
+        </ul>
+      </li>
+
+      <li>
+        <p>General improvements:</p>
+
+        <ul>
+          <li>
+            <p>Privoxy can (re)compress buffered content before delivering it
+            to the client. Disabled by default as most users wouldn't benefit
+            from it.</p>
+          </li>
+
+          <li>
+            <p>The +fast-redirects{check-decoded-url} action checks URL
+            segments separately. If there are other parameters behind the
+            redirect URL, this makes it unnecessary to cut them off by
+            additionally using a +redirect{} pcrs command. Initial patch
+            submitted by Jamie Zawinski in #3429848.</p>
+          </li>
+
+          <li>
+            <p>When loading action sections, verify that the referenced
+            filters exist. Currently missing filters only result in an error
+            message, but eventually the severity will be upgraded to
+            fatal.</p>
+          </li>
+
+          <li>
+            <p>Allow to bind to multiple separate addresses. Patch set
+            submitted by Petr Pisar in #3354485.</p>
+          </li>
+
+          <li>
+            <p>Set socket_error to errno if connecting fails in
+            rfc2553_connect_to(). Previously rejected direct connections
+            could be incorrectly reported as DNS issues if Privoxy was
+            compiled with IPv6 support.</p>
+          </li>
+
+          <li>
+            <p>Adjust url_code_map[] so spaces are replaced with %20 instead
+            of '+' While '+' can be used by client's submitting form data,
+            this is not actually what Privoxy is using the lookups for. This
+            is more of a cosmetic issue and doesn't fix any known
+            problems.</p>
+          </li>
+
+          <li>
+            <p>When compiled without FEATURE_FAST_REDIRECTS, do not silently
+            ignore +fast-redirect{} directives</p>
+          </li>
+
+          <li>
+            <p>Added a workaround for GNU libc's strptime() reporting
+            negative year values when the parsed year is only specified with
+            two digits. On affected systems cookies with such a date would
+            not be turned into session cookies by the +session-cookies-only
+            action. Reported by Vaeinoe in #3403560</p>
+          </li>
+
+          <li>
+            <p>Fixed bind failures with certain GNU libc versions if no
+            non-loopback IP address has been configured on the system. This
+            is mainly an issue if the system is using DHCP and Privoxy is
+            started before the network is completely configured. Reported by
+            Raphael Marichez in #3349356. Additional insight from Petr
+            Pisar.</p>
+          </li>
+
+          <li>
+            <p>Privoxy log messages now use the ISO 8601 date format
+            %Y-%m-%d. It's only slightly longer than the old format, but
+            contains the full date including the year and allows sorting by
+            date (when grepping in multiple log files) without hassle.</p>
+          </li>
+
+          <li>
+            <p>In get_last_url(), do not bother trying to decode URLs that do
+            not contain at least one '%' sign. It reduces the log noise and a
+            number of unnecessary memory allocations.</p>
+          </li>
+
+          <li>
+            <p>In case of SOCKS5 failures, dump the socks response in the log
+            message.</p>
+          </li>
+
+          <li>
+            <p>Simplify the signal setup in main().</p>
+          </li>
+
+          <li>
+            <p>Streamline socks5_connect() slightly.</p>
+          </li>
+
+          <li>
+            <p>In socks5_connect(), require a complete socks response from
+            the server. Previously Privoxy didn't care how much data the
+            server response contained as long as the first two bytes
+            contained the expected values. While at it, shrink the buffer
+            size so Privoxy can't read more than a whole socks response.</p>
+          </li>
+
+          <li>
+            <p>In chat(), do not bother to generate a client request in case
+            of direct CONNECT requests. It will not be used anyway.</p>
+          </li>
+
+          <li>
+            <p>Reduce server_last_modified()'s stack size.</p>
+          </li>
+
+          <li>
+            <p>Shorten get_http_time() by using strftime().</p>
+          </li>
+
+          <li>
+            <p>Constify the known_http_methods pointers in
+            unknown_method().</p>
+          </li>
+
+          <li>
+            <p>Constify the time_formats pointers in parse_header_time().</p>
+          </li>
+
+          <li>
+            <p>Constify the formerly_valid_actions pointers in
+            action_used_to_be_valid().</p>
+          </li>
+
+          <li>
+            <p>Introduce a GNUMakefile MAN_PAGE variable that defaults to
+            privoxy.1. The Debian package uses section 8 for the man page and
+            this should simplify the patch.</p>
+          </li>
+
+          <li>
+            <p>Deduplicate the INADDR_NONE definition for Solaris by moving
+            it to jbsockets.h</p>
+          </li>
+
+          <li>
+            <p>In block_url(), ditch the obsolete workaround for ancient
+            Netscape versions that supposedly couldn't properly deal with
+            status code 403.</p>
+          </li>
+
+          <li>
+            <p>Remove a useless NULL pointer check in load_trustfile().</p>
+          </li>
+
+          <li>
+            <p>Remove two useless NULL pointer checks in
+            load_one_re_filterfile().</p>
+          </li>
+
+          <li>
+            <p>Change url_code_map[] from an array of pointers to an array of
+            arrays It removes an unnecessary layer of indirection and on
+            64bit system reduces the size of the binary a bit.</p>
+          </li>
+
+          <li>
+            <p>Fix various typos. Fixes taken from Debian's 29_typos.dpatch
+            by Roland Rosenfeld.</p>
+          </li>
+
+          <li>
+            <p>Add a dok-tidy GNUMakefile target to clean up the messy HTML
+            generated by the other dok targets.</p>
+          </li>
+
+          <li>
+            <p>GNUisms in the GNUMakefile have been removed.</p>
+          </li>
+
+          <li>
+            <p>Change the HTTP version in static responses to 1.1</p>
+          </li>
+
+          <li>
+            <p>Synced config.sub and config.guess with upstream
+            2011-11-11/386c7218162c145f5f9e1ff7f558a3fbb66c37c5.</p>
+          </li>
+
+          <li>
+            <p>Add a dedicated function to parse the values of toggles.
+            Reduces duplicated code in load_config() and provides better
+            error handling. Invalid or missing toggle values are now a fatal
+            error instead of being silently ignored.</p>
+          </li>
+
+          <li>
+            <p>Terminate HTML lines in static error messages with \n instead
+            of \r\n.</p>
+          </li>
+
+          <li>
+            <p>Simplify cgi_error_unknown() a bit.</p>
+          </li>
+
+          <li>
+            <p>In LogPutString(), don't bother looking at pszText when not
+            actually logging anything.</p>
+          </li>
+
+          <li>
+            <p>Change ssplit()'s fourth parameter from int to size_t. Fixes a
+            clang complaint.</p>
+          </li>
+
+          <li>
+            <p>Add a warning that the statistics currently can't be trusted.
+            Mention Privoxy-Log-Parser's --statistics option as an
+            alternative for the time being.</p>
+          </li>
+
+          <li>
+            <p>In rfc2553_connect_to(), start setting cgi-&gt;error_message
+            on error.</p>
+          </li>
+
+          <li>
+            <p>Change the expected status code returned for http://p.p/die
+            depending on whether or not FEATURE_GRACEFUL_TERMINATION is
+            available.</p>
+          </li>
+
+          <li>
+            <p>In cgi_die(), mark the client connection for closing. If the
+            client will fetch the style sheet through another connection it
+            gets the main thread out of the accept() state and should thus
+            trigger the actual shutdown.</p>
+          </li>
+
+          <li>
+            <p>Add a proper CGI message for cgi_die().</p>
+          </li>
+
+          <li>
+            <p>Don't enforce a logical line length limit in
+            read_config_line().</p>
+          </li>
+
+          <li>
+            <p>Slightly refactor server_last_modified() to remove useless
+            gmtime*() calls.</p>
+          </li>
+
+          <li>
+            <p>In get_content_type(), also recognize '.jpeg' as JPEG
+            extension.</p>
+          </li>
+
+          <li>
+            <p>Add '.png' to the list of recognized file extensions in
+            get_content_type().</p>
+          </li>
+
+          <li>
+            <p>In block_url(), consistently use the block reason "Request
+            blocked by Privoxy" In two places the reason was "Request for
+            blocked URL" which hides the fact that the request got blocked by
+            Privoxy and isn't necessarily correct as the block may be due to
+            tags.</p>
+          </li>
+
+          <li>
+            <p>In listen_loop(), reload the configuration files after
+            accepting a new connection instead of before. Previously the
+            first connection that arrived after a configuration change would
+            still be handled with the old configuration.</p>
+          </li>
+
+          <li>
+            <p>In chat()'s receive-data loop, skip a client socket check if
+            the socket will be written to right away anyway. This can
+            increase the transfer speed for unfiltered content on fast
+            network connections.</p>
+          </li>
+
+          <li>
+            <p>The socket timeout is used for SOCKS negotiations as well
+            which previously couldn't timeout.</p>
+          </li>
+
+          <li>
+            <p>Don't keep the client connection alive if any configuration
+            file changed since the time the connection came in. This is
+            closer to Privoxy's behaviour before keep-alive support for
+            client connection has been added and also less confusing in
+            general.</p>
+          </li>
+
+          <li>
+            <p>Treat all Content-Type header values containing the pattern
+            'script' as a sign of text. Reported by pribog in #3134970.</p>
+          </li>
+        </ul>
+      </li>
+
+      <li>
+        <p>Action file improvements:</p>
+
+        <ul>
+          <li>
+            <p>Moved the site-specific block pattern section below the one
+            for the generic patterns so for requests that are matched in
+            both, the block reason for the domain is shown which is usually
+            more useful than showing the one for the generic pattern.</p>
+          </li>
+
+          <li>
+            <p>Remove -prevent-compression from the fragile alias. It's no
+            longer used anywhere by default and isn't known to break stuff
+            anyway.</p>
+          </li>
+
+          <li>
+            <p>Add a (disabled) section to block various Facebook tracking
+            URLs. Reported by Dan Stahlke in #3421764.</p>
+          </li>
+
+          <li>
+            <p>Add a (disabled) section to rewrite and redirect
+            click-tracking URLs used on news.google.com. Reported by Dan
+            Stahlke in #3421755.</p>
+          </li>
+
+          <li>
+            <p>Unblock linuxcounter.net/. Reported by Dan Stahlke in
+            #3422612.</p>
+          </li>
+
+          <li>
+            <p>Block 'www91.intel.com/' which is used by Omniture. Reported
+            by Adam Piggott in #3167370.</p>
+          </li>
+
+          <li>
+            <p>Disable the handle-as-empty-doc-returns-ok option and mark it
+            as deprecated. Reminded by tceverling in #2790091.</p>
+          </li>
+
+          <li>
+            <p>Add ".ivwbox.de/" to the "Cross-site user tracking" section.
+            Reported by Nettozahler in #3172525.</p>
+          </li>
+
+          <li>
+            <p>Unblock and fast-redirect ".awin1.com/.*=http://". Reported by
+            Adam Piggott in #3170921.</p>
+          </li>
+
+          <li>
+            <p>Block "b.collective-media.net/".</p>
+          </li>
+
+          <li>
+            <p>Widen the Debian popcon exception to "qa.debian.org/popcon".
+            Seen in Debian's 05_default_action.dpatch by Roland
+            Rosenfeld.</p>
+          </li>
+
+          <li>
+            <p>Block ".gemius.pl/" which only seems to be used for user
+            tracking. Reported by johnd16 in #3002731. Additional input from
+            Lee and movax.</p>
+          </li>
+
+          <li>
+            <p>Disable banners-by-size filters for '.thinkgeek.com/'. The
+            filter only seems to catch pictures of the inventory.</p>
+          </li>
+
+          <li>
+            <p>Block requests for 'go.idmnet.bbelements.com/please/showit/'.
+            Reported by kacperdominik in #3372959.</p>
+          </li>
+
+          <li>
+            <p>Unblock adainitiative.org/.</p>
+          </li>
+
+          <li>
+            <p>Add a fast-redirects exception for
+            '.googleusercontent.com/.*=cache'.</p>
+          </li>
+
+          <li>
+            <p>Add a fast-redirects exception for
+            webcache.googleusercontent.com/.</p>
+          </li>
+
+          <li>
+            <p>Unblock http://adassier.wordpress.com/ and
+            http://adassier.files.wordpress.com/.</p>
+          </li>
+        </ul>
+      </li>
+
+      <li>
+        <p>Filter file improvements:</p>
+
+        <ul>
+          <li>
+            <p>Let the yahoo filter hide '.ads'.</p>
+          </li>
+
+          <li>
+            <p>Let the msn filter hide overlay ads for Facebook 'likes' in
+            search results and elements with the id 's_notf_div'. They only
+            seem to be used to advertise site 'enhancements'.</p>
+          </li>
+
+          <li>
+            <p>Let the js-events filter additionally disarm setInterval().
+            Suggested by dg1727 in #3423775.</p>
+          </li>
+        </ul>
+      </li>
+
+      <li>
+        <p>Documentation improvements:</p>
+
+        <ul>
+          <li>
+            <p>Clarify the effect of compiling Privoxy with zlib support.
+            Suggested by dg1727 in #3423782.</p>
+          </li>
+
+          <li>
+            <p>Point out that the SourceForge messaging system works like a
+            black hole and should thus not be used to contact individual
+            developers.</p>
+          </li>
+
+          <li>
+            <p>Mention some of the problems one can experience when not
+            explicitly configuring an IP addresses as listen address.</p>
+          </li>
+
+          <li>
+            <p>Explicitly mention that hostnames can be used instead of IP
+            addresses for the listen-address, that only the first address
+            returned will be used and what happens if the address is invalid.
+            Requested by Calestyo in #3302213.</p>
+          </li>
+        </ul>
+      </li>
+
+      <li>
+        <p>Log message improvements:</p>
+
+        <ul>
+          <li>
+            <p>If only the server connection is kept alive, do not pretend to
+            wait for a new client request.</p>
+          </li>
+
+          <li>
+            <p>Remove a superfluous log message in forget_connection().</p>
+          </li>
+
+          <li>
+            <p>In chat(), properly report missing server responses as such
+            instead of calling them empty.</p>
+          </li>
+
+          <li>
+            <p>In forwarded_connect(), fix a log message nobody should ever
+            see.</p>
+          </li>
+
+          <li>
+            <p>Fix a log message in socks5_connect(), a failed write
+            operation was logged as failed read operation.</p>
+          </li>
+
+          <li>
+            <p>Let load_one_actions_file() properly complain about a missing
+            '{' at the beginning of the file. Simply stating that a line is
+            invalid isn't particularly helpful.</p>
+          </li>
+
+          <li>
+            <p>Do not claim to listen on a socket until Privoxy actually
+            does. Patch submitted by Petr Pisar #3354485</p>
+          </li>
+
+          <li>
+            <p>Prevent a duplicated LOG_LEVEL_CLF message when sending out
+            the "no-server-data" response.</p>
+          </li>
+
+          <li>
+            <p>Also log the client socket when dropping a connection.</p>
+          </li>
+
+          <li>
+            <p>Include the destination host in the 'Request ... marked for
+            blocking. limit-connect{...} doesn't allow CONNECT ...' message
+            Patch submitted by Saperski in #3296250.</p>
+          </li>
+
+          <li>
+            <p>Prevent a duplicated log message if none of the resolved IP
+            addresses were reachable.</p>
+          </li>
+
+          <li>
+            <p>In connect_to(), do not pretend to retry if
+            forwarded-connect-retries is zero or unset.</p>
+          </li>
+
+          <li>
+            <p>When a specified user or group can't be found, put the name in
+            single-quotes when logging it.</p>
+          </li>
+
+          <li>
+            <p>In rfc2553_connect_to(), explain getnameinfo() errors
+            better.</p>
+          </li>
+
+          <li>
+            <p>Remove a useless log message in chat().</p>
+          </li>
+
+          <li>
+            <p>When retrying to connect, also log the maximum number of
+            connection attempts.</p>
+          </li>
+
+          <li>
+            <p>Rephrase a log message in compile_dynamic_pcrs_job_list().
+            Divide the error code and its meaning with a colon. Call the pcrs
+            job dynamic and not the filter. Filters may contain dynamic and
+            non-dynamic pcrs jobs at the same time. Only mention the name of
+            the filter or tagger, but don't claim it's a filter when it could
+            be a tagger.</p>
+          </li>
+
+          <li>
+            <p>In a fatal error message in load_one_actions_file(), cover
+            both URL and TAG patterns.</p>
+          </li>
+
+          <li>
+            <p>In pcrs_strerror(), properly report unknown positive error
+            code values as such. Previously they were handled like 0 (no
+            error).</p>
+          </li>
+
+          <li>
+            <p>In compile_dynamic_pcrs_job_list(), also log the actual error
+            code as pcrs_strerror() doesn't handle all errors reported by
+            pcre.</p>
+          </li>
+
+          <li>
+            <p>Don't bother trying to continue chatting if the client didn't
+            ask for it. Reduces log noise a bit.</p>
+          </li>
+
+          <li>
+            <p>Make two fatal error message in load_one_actions_file() more
+            descriptive.</p>
+          </li>
+
+          <li>
+            <p>In cgi_send_user_manual(), log when rejecting a file name due
+            to '/' or '..'.</p>
+          </li>
+
+          <li>
+            <p>In load_file(), log a message if opening a file failed. The
+            CGI error message alone isn't too helpful.</p>
+          </li>
+
+          <li>
+            <p>In connection_destination_matches(), improve two log messages
+            to help understand why the destinations don't match.</p>
+          </li>
+
+          <li>
+            <p>Rephrase a log message in serve(). Client request arrival
+            should be differentiated from closed client connections now.</p>
+          </li>
+
+          <li>
+            <p>In serve(), log if a client connection isn't reused due to a
+            configuration file change.</p>
+          </li>
+
+          <li>
+            <p>Let mark_server_socket_tainted() always mark the server socket
+            tainted, just don't talk about it in cases where it has no
+            effect. It doesn't change Privoxy's behaviour, but makes
+            understanding the log file easier.</p>
+          </li>
+        </ul>
+      </li>
+
+      <li>
+        <p>configure:</p>
+
+        <ul>
+          <li>
+            <p>Added a --disable-ipv6-support switch for platforms where
+            support is detected but doesn't actually work.</p>
+          </li>
+
+          <li>
+            <p>Do not check for the existence of strerror() and memmove()
+            twice</p>
+          </li>
+
+          <li>
+            <p>Remove a useless test for setpgrp(2). Privoxy doesn't need it
+            and it can cause problems when cross-compiling.</p>
+          </li>
+
+          <li>
+            <p>Rename the --disable-acl-files switch to
+            --disable-acl-support. Since about 2001, ACL directives are
+            specified in the standard config file.</p>
+          </li>
+
+          <li>
+            <p>Update the URL of the 'Removing outdated PCRE version after
+            the next stable release' posting. The old URL stopped working
+            after one of SF's recent site "optimizations". Reported by Han
+            Liu.</p>
+          </li>
+        </ul>
+      </li>
+
+      <li>
+        <p>Privoxy-Regression-Test:</p>
+
+        <ul>
+          <li>
+            <p>Added --shuffle-tests option to increase the chances of
+            detection race conditions.</p>
+          </li>
+
+          <li>
+            <p>Added a --local-test-file option that allows to use
+            Privoxy-Regression-Test without Privoxy.</p>
+          </li>
+
+          <li>
+            <p>Added tests for missing socks4 and socks4a forwarders.</p>
+          </li>
+
+          <li>
+            <p>The --privoxy-address option now works with IPv6 addresses
+            containing brackets, too.</p>
+          </li>
+
+          <li>
+            <p>Perform limited sanity checks for parameters that are supposed
+            to have numerical values.</p>
+          </li>
+
+          <li>
+            <p>Added a --sleep-time option to specify a number of seconds to
+            sleep between tests, defaults to 0.</p>
+          </li>
+
+          <li>
+            <p>Disable the range-requests tagger for tests that break if it's
+            enabled.</p>
+          </li>
+
+          <li>
+            <p>Log messages use the ISO 8601 date format %Y-%m-%d.</p>
+          </li>
+
+          <li>
+            <p>Fix spelling in two error messages.</p>
+          </li>
+
+          <li>
+            <p>In the --help output, include a list of supported tests and
+            their default levels.</p>
+          </li>
+
+          <li>
+            <p>Adjust the tests to properly deal with FEATURE_TOGGLE being
+            disabled.</p>
+          </li>
+        </ul>
+      </li>
+
+      <li>
+        <p>Privoxy-Log-Parser:</p>
+
+        <ul>
+          <li>
+            <p>Perform limited sanity checks for command line parameters that
+            are supposed to have numerical values.</p>
+          </li>
+
+          <li>
+            <p>Implement a --unbreak-lines-only option to try to revert MUA
+            breakage.</p>
+          </li>
+
+          <li>
+            <p>Accept and highlight: Added header: Content-Encoding:
+            deflate</p>
+          </li>
+
+          <li>
+            <p>Accept and highlight: Compressed content from 29258 to 8630
+            bytes.</p>
+          </li>
+
+          <li>
+            <p>Accept and highlight: Client request arrived in time on socket
+            21.</p>
+          </li>
+
+          <li>
+            <p>Highlight: Didn't receive data in time: a.fsdn.com:443</p>
+          </li>
+
+          <li>
+            <p>Accept log messages with ISO 8601 time stamps, too.</p>
+          </li>
+        </ul>
+      </li>
+
+      <li>
+        <p>uagen:</p>
+
+        <ul>
+          <li>
+            <p>Bump generated Firefox version to 8.0.</p>
+          </li>
+
+          <li>
+            <p>Only randomize the release date if the new
+            --randomize-release-date option is enabled. Firefox versions
+            after 4 use a fixed date string without meaning.</p>
+          </li>
+        </ul>
+      </li>
+    </ul>
+
+    <div class="SECT2">
+      <h2 class="SECT2"><a name="UPGRADERSNOTE" id="UPGRADERSNOTE">3.1. Note
+      to Upgraders</a></h2>
+
+      <p>A quick list of things to be aware of before upgrading from earlier
+      versions of <span class="APPLICATION">Privoxy</span>:</p>
+
+      <ul>
+        <li>
+          <p>The recommended way to upgrade <span class=
+          "APPLICATION">Privoxy</span> is to backup your old configuration
+          files, install the new ones, verify that <span class=
+          "APPLICATION">Privoxy</span> is working correctly and finally merge
+          back your changes using <span class="APPLICATION">diff</span> and
+          maybe <span class="APPLICATION">patch</span>.</p>
+
+          <p>There are a number of new features in each <span class=
+          "APPLICATION">Privoxy</span> release and most of them have to be
+          explicitly enabled in the configuration files. Old configuration
+          files obviously don't do that and due to syntax changes using old
+          configuration files with a new <span class=
+          "APPLICATION">Privoxy</span> isn't always possible anyway.</p>
+        </li>
+
+        <li>
+          <p>Note that some installers remove earlier versions completely,
+          including configuration files, therefore you should really save any
+          important configuration files!</p>
+        </li>
+
+        <li>
+          <p>On the other hand, other installers don't overwrite existing
+          configuration files, thinking you will want to do that
+          yourself.</p>
+        </li>
+
+        <li>
+          <p><tt class="FILENAME">standard.action</tt> has been merged into
+          the <tt class="FILENAME">default.action</tt> file.</p>
+        </li>
+
+        <li>
+          <p>In the default configuration only fatal errors are logged now.
+          You can change that in the <a href="config.html#DEBUG">debug
+          section</a> of the configuration file. You may also want to enable
+          more verbose logging until you verified that the new <span class=
+          "APPLICATION">Privoxy</span> version is working as expected.</p>
+        </li>
+
+        <li>
+          <p>Three other config file settings are now off by default:
+          <a href="config.html#ENABLE-REMOTE-TOGGLE">enable-remote-toggle</a>,
+          <a href=
+          "config.html#ENABLE-REMOTE-HTTP-TOGGLE">enable-remote-http-toggle</a>,
+          and <a href=
+          "config.html#ENABLE-EDIT-ACTIONS">enable-edit-actions</a>. If you
+          use or want these, you will need to explicitly enable them, and be
+          aware of the security issues involved.</p>
+        </li>
+      </ul>
+    </div>
+  </div>
+
+  <div class="NAVFOOTER">
+    <hr class="c1" width="100%">
+
+    <table summary="Footer navigation table" width="100%" border="0"
+    cellpadding="0" cellspacing="0">
+      <tr>
+        <td width="33%" align="left" valign="top"><a href="installation.html"
+        accesskey="P">Prev</a></td>
+
+        <td width="34%" align="center" valign="top"><a href="index.html"
+        accesskey="H">Home</a></td>
+
+        <td width="33%" align="right" valign="top"><a href="quickstart.html"
+        accesskey="N">Next</a></td>
+      </tr>
+
+      <tr>
+        <td width="33%" align="left" valign="top">Installation</td>
+
+        <td width="34%" align="center" valign="top">&nbsp;</td>
+
+        <td width="33%" align="right" valign="top">Quickstart to Using
+        Privoxy</td>
+      </tr>
+    </table>
+  </div>
+</body>
+</html>