rebuild docs
[privoxy.git] / doc / webserver / user-manual / whatsnew.html
index 3e38ba0..7d4838a 100644 (file)
-<!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>Fix a logic bug that could cause Privoxy to reuse a tainted
-            server socket. It could happen for server sockets that got
-            tainted by a server-header-tagger-induced block, in which case
-            Privoxy doesn't necessarily read the whole server response. 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 like curl which
-            terminates the client connection after detecting that the whole
-            body has been received it doesn't really matter, but with clients
-            like FreeBSD's fetch the client 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.
-            I've only seen it 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>
-        </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 of by
-            additionally using a +redirect{} pcrs command. Initial patch
-            submitted by Jamie Zawinski in #3429848.</p>
-          </li>
-
-          <li>
-            <p>Properly deal with FEATURE_TOGGLE being disabled</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 actual problems
-            I'm aware of.</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>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.</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>Disable filters if SDCH compression is used unless filtering
-            is forced. If SDCH was combined with a supported compression
-            algorithm, we'd previously try to decompress it, when successful
-            apply the enabled filters and ditch the Content-Encoding header
-            even though the SDCH compression wasn't removed. Reported by
-            zebul666 in #3225863.</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>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 the we are
-            actually forwarding the request. Previously direct connections
-            would be retried as well.</p>
-          </li>
-
-          <li>
-            <p>Fixed a small memory leak when retrying connection</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>
-        </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>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>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>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.</p>
-          </li>
-
-          <li>
-            <p>Let the msn filter hide 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
-            blackhole and should thus not be used</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 pretent to
-            wait for a new client request.</p>
-          </li>
-
-          <li>
-            <p>Remove a superfluos 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 we actually do. 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
-            differently.</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 unknown. 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>Miscellaneous Privoxy improvements:</p>
-
-        <ul>
-          <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>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' isntead of '\0', thus merely
-            preventing group names beginning with a zero.</p>
-          </li>
-
-          <li>
-            <p>Simplify the signal setup in main()</p>
-          </li>
-
-          <li>
-            <p>Streamline socks5_connect() slightly</p>
-          </li>
-
-          <li>
-            <p>In case of SOCKS5 failures, dump the socks response</p>
-          </li>
-
-          <li>
-            <p>In socks5_connect(), require a complete socks response from
-            the server Previously we 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 we can't
-            read more than a whole socks response. This is required to
-            support Tor's optimistic data extension.</p>
-          </li>
-
-          <li>
-            <p>In chat(), do not bother to generate a client request in case
-            of direct CONNECT requests</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>In html_code_map[], use a numeric character reference instead
-            of ' which wasn't standardized before XHTML 1.0</p>
-          </li>
-
-          <li>
-            <p>Introduce a 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>Fix an invalid free when compiled with
-            FEATURE_GRACEFUL_TERMINATION and shut down through
-            http://config.privoxy.org/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 extenstions 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 necessarly correct as the block may be due to
-            tags.</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>
-
-          <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 negotiation as well.</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>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 layout pessimizations. 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>
-        </ul>
-      </li>
-
-      <li>
-        <p>Privoxy-Log-Parser:</p>
-
-        <ul>
-          <li>
-            <p>Perform limited sanity checks for 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 9.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>
+<!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.27 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.27 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.26</SPAN
+> stable is a bug-fix release
+  for the previously released 3.0.25 beta which introduced client-specific
+  tags and included a couple of minor improvements.</P
+><P
+></P
+><UL
+><LI
+><P
+>    Bug fixes:
+   </P
+><P
+></P
+><UL
+><LI
+><P
+>      Fixed crashes with "listen-addr :8118" (SF Bug #902).
+      The regression was introduced in 3.0.25 beta and reported
+      by Marvin Renich in Debian bug #834941.
+    </P
+></LI
+></UL
+></LI
+><LI
+><P
+>    General improvements:
+   </P
+><P
+></P
+><UL
+><LI
+><P
+>      Log when privoxy is toggled on or off via cgi interface.
+     </P
+></LI
+><LI
+><P
+>      Highlight the "Info: Now toggled " on/off log message
+      in the Windows log viewer.
+     </P
+></LI
+><LI
+><P
+>      Highlight the loading actions/filter file log message
+      in the Windows log viewer.
+     </P
+></LI
+><LI
+><P
+>      Mention client-specific tags on the toggle page as a
+      potentionally more appropriate alternative.
+     </P
+></LI
+></UL
+></LI
+><LI
+><P
+>    Documentation improvements:
+   </P
+><P
+></P
+><UL
+><LI
+><P
+>      Update download section on the homepage.
+      The downloads are available from the website now.
+     </P
+></LI
+><LI
+><P
+>      Add sponsor FAQ.
+     </P
+></LI
+><LI
+><P
+>      Remove obsolete reference to mailing lists hosted at SourceForge.
+     </P
+></LI
+><LI
+><P
+>      Update the "Before the Release" section of the developer manual.
+     </P
+></LI
+></UL
+></LI
+><LI
+><P
+>    Infrastructure improvements:
+   </P
+><P
+></P
+><UL
+><LI
+><P
+>      Add perl script to generate an RSS feed for the packages
+      Submitted by "Unknown".
+     </P
+></LI
+></UL
+></LI
+><LI
+><P
+>    Build system improvements:
+   </P
+><P
+></P
+><UL
+><LI
+><P
+>      strptime.h: fix a compiler warning about ambiguous else.
+     </P
+></LI
+><LI
+><P
+>      configure.in: Check for Docbook goo on the BSDs as well.
+     </P
+></LI
+><LI
+><P
+>      GNUMakefile.in: Let the dok-user target remove temporary files.
+     </P
+></LI
+></UL
+></LI
+></UL
+><P
+> Changes between <SPAN
+CLASS="APPLICATION"
+>Privoxy 3.0.25 beta</SPAN
+>
+ and the previous release:</P
+><P
+></P
+><UL
+><LI
+><P
+>    Bug fixes:
+   </P
+><P
+></P
+><UL
+><LI
+><P
+>      Always use the current toggle state for new requests.
+      Previously new requests on reused connections inherited
+      the toggle state from the previous request even though
+      the toggle state could have changed.
+      Reported by Robert Klemme.
+     </P
+></LI
+><LI
+><P
+>      Fixed two buffer-overflows in the (deprecated) static
+      pcre code. These bugs are not considered security issues
+      as the input is trusted.
+      Found with afl-fuzz and ASAN.
+     </P
+></LI
+></UL
+></LI
+><LI
+><P
+>    General improvements:
+   </P
+><P
+></P
+><UL
+><LI
+><P
+>      Added support for client-specific tags which allow Privoxy
+      admins to pre-define tags that are set for all requests from
+      clients that previously opted in through the CGI interface.
+      They are useful in multi-user setups where admins may
+      want to allow users to disable certain actions and filters
+      for themselves without affecting others.
+      In single-user setups they are useful to allow more fine-grained
+      toggling. For example to disable request blocking while still
+      crunching cookies, or to disable experimental filters only.
+      This is an experimental feature, the syntax and behaviour may
+      change in future versions.
+      Sponsored by Robert Klemme.
+     </P
+></LI
+><LI
+><P
+>      Dynamic filters and taggers now support a $listen-address variable
+      which contains the address the request came in on.
+      For external filters the variable is called $PRIVOXY_LISTEN_ADDRESS.
+      Original patch contributed by pursievro.
+     </P
+></LI
+><LI
+><P
+>      Add client-header-tagger 'listen-address'.
+     </P
+></LI
+><LI
+><P
+>      Include the listen-address in the log message when logging new requests.
+      Patch contributed by pursievro.
+     </P
+></LI
+><LI
+><P
+>      Turn invalid max-client-connections values into fatal errors.
+     </P
+></LI
+><LI
+><P
+>      The show-status page now shows whether or not dates before 1970
+      and after 2038 are expected to be handled properly.
+      This is mainly useful for Privoxy-Regression-Test but could
+      also come handy when dealing with time-related support requests.
+     </P
+></LI
+><LI
+><P
+>      On Mac OS X the thread id in log messages are more likely to
+      be unique now.
+     </P
+></LI
+><LI
+><P
+>      When complaining about missing filters, the filter type is logged
+      as well.
+     </P
+></LI
+><LI
+><P
+>      A couple of harmless coverity warnings were silenced
+      (CID #161202, CID #161203, CID #161211).
+     </P
+></LI
+></UL
+></LI
+><LI
+><P
+>    Action file improvements:
+   </P
+><P
+></P
+><UL
+><LI
+><P
+>      Filtering is disabled for Range requests to let download resumption
+      and Windows updates work with the default configuration.
+     </P
+></LI
+><LI
+><P
+>      Unblock ".ardmediathek.de/".
+      Reported by ThTomate in #932.
+     </P
+></LI
+></UL
+></LI
+><LI
+><P
+>    Documentation improvements:
+   </P
+><P
+></P
+><UL
+><LI
+><P
+>      Add FAQ entry for crashes caused by memory limits.
+     </P
+></LI
+><LI
+><P
+>      Remove obsolete FAQ entry about a bug in PHP 4.2.3.
+     </P
+></LI
+><LI
+><P
+>      Mention the new mailing lists were appropriate.
+      As the archives have not been migrated, continue to
+      mention the archives at SF in the contacting section
+      for now.
+     </P
+></LI
+><LI
+><P
+>      Note that the templates should be adjusted if Privoxy is
+      running as intercepting proxy without getting all requests.
+     </P
+></LI
+><LI
+><P
+>      A bunch of links were converted to https://.
+     </P
+></LI
+><LI
+><P
+>      Rephrase onion service paragraph to make it more obvious
+      that Tor is involved and that the whole website (and not
+      just the homepage) is available as onion service.
+     </P
+></LI
+><LI
+><P
+>      Streamline the "More information" section on the homepage further
+      by additionally ditching the link to the 'See also' section
+      of the user manual. The section contains mostly links that are
+      directly reachable from the homepage already and the rest is
+      not significant enough to get a link from the homepage.
+     </P
+></LI
+><LI
+><P
+>      Change the add-header{} example to set the DNT header
+      and use a complete section to make copy and pasting
+      more convenient.
+      Add a comment to make it obvious that adding the
+      header is not recommended for obvious reasons.
+      Using the DNT header as example was suggested by
+      Leo Wzukw.
+     </P
+></LI
+><LI
+><P
+>      Streamline the support-and-service template
+      Instead of linking to the various support trackers
+      (whose URLs hopefully change soon), link to the
+      contact section of the user manual to increase the
+      chances that users actually read it.
+     </P
+></LI
+><LI
+><P
+>      Add a FAQ entry for tainted sockets.
+     </P
+></LI
+><LI
+><P
+>      More sections in the documentation have stable URLs now.
+     </P
+></LI
+><LI
+><P
+>      FAQ: Explain why 'ping config.privoxy.org' is not expected
+      to reach a local Privoxy installation.
+     </P
+></LI
+><LI
+><P
+>      Note that donations done through Zwiebelfreunde e.V. currently
+      can't be checked automatically.
+     </P
+></LI
+><LI
+><P
+>      Updated section regarding starting Privoxy under OS X.
+     </P
+></LI
+><LI
+><P
+>      Use dedicated start instructions for FreeBSD and ElectroBSD.
+     </P
+></LI
+><LI
+><P
+>      Removed release instructions for AIX. They haven't been working
+      for years and unsurprisingly nobody seems to care.
+     </P
+></LI
+><LI
+><P
+>      Removed obsolete reference to the solaris-dist target.
+     </P
+></LI
+><LI
+><P
+>      Updated the release instructions for FreeBSD.
+     </P
+></LI
+><LI
+><P
+>      Removed unfinished release instructions for Amiga OS and HP-UX 11.
+     </P
+></LI
+><LI
+><P
+>      Added a pointer to the Cygwin Time Machine for getting the last release of
+      Cygwin version 1.5 to use for building Privoxy on Windows.
+     </P
+></LI
+><LI
+><P
+>      Various typos have been fixed.
+     </P
+></LI
+></UL
+></LI
+><LI
+><P
+>    Infrastructure improvements:
+   </P
+><P
+></P
+><UL
+><LI
+><P
+>      The website is no longer hosted at SourceForge and
+      can be reached through https now.
+     </P
+></LI
+><LI
+><P
+>      The mailing lists at SourceForge have been deprecated,
+      you can subscribe to the new ones at: https://lists.privoxy.org/
+     </P
+></LI
+><LI
+><P
+>      Migrating the remaining services from SourceForge is
+      work in progress (TODO list item #53).
+     </P
+></LI
+></UL
+></LI
+><LI
+><P
+>    Build system improvements:
+   </P
+><P
+></P
+><UL
+><LI
+><P
+>      Add configure argument to optimistically redefine FD_SETSIZE
+      with the intent to change the maximum number of client
+      connections Privoxy can handle. Only works with some libcs.
+      Sponsored by Robert Klemme.
+     </P
+></LI
+><LI
+><P
+>      Let the tarball-dist target skip files in ".git".
+     </P
+></LI
+><LI
+><P
+>      Let the tarball-dist target work in cwds other than current.
+     </P
+></LI
+><LI
+><P
+>      Make the 'clean' target faster when run from a git repository.
+     </P
+></LI
+><LI
+><P
+>      Include tools in the generic distribution.
+     </P
+></LI
+><LI
+><P
+>      Let the gen-dist target work in cwds other than current.
+     </P
+></LI
+><LI
+><P
+>      Sort find output that is used for distribution tarballs
+      to get reproducible results.
+     </P
+></LI
+><LI
+><P
+>      Don't add '-src' to the name of the tar ball generated by the
+      gen-dist target. The package isn't a source distribution but a
+      binary package.
+      While at it, use a variable for the name to reduce the chances
+      that the various references get out of sync and fix the gen-upload
+      target which was looking in the wrong directory.
+     </P
+></LI
+><LI
+><P
+>      Add regression-tests.action to the files that are distributed.
+     </P
+></LI
+><LI
+><P
+>      The gen-dist target which was broken since 2002 (r1.92) has been fixed.
+     </P
+></LI
+><LI
+><P
+>      Remove genclspec.sh which has been obsolete since 2009.
+     </P
+></LI
+><LI
+><P
+>      Remove obsolete reference to Redhat spec file.
+     </P
+></LI
+><LI
+><P
+>      Remove the obsolete announce target which has been commented out years ago.
+     </P
+></LI
+><LI
+><P
+>      Let rsync skip files if the checksums match.
+     </P
+></LI
+></UL
+></LI
+><LI
+><P
+>    Privoxy-Regression-Test:
+   </P
+><P
+></P
+><UL
+><LI
+><P
+>      Add a "Default level offset" directive which can be used to
+      change the default level by a given value.
+      This directive affects all tests located after it until the end
+      of the file or a another "Default level offset" directive is reached.
+      The purpose of this directive is to make it more convenient to skip
+      similar tests in a given file without having to remove or disable
+      the tests completely.
+     </P
+></LI
+><LI
+><P
+>      Let test level 17 depend on FEATURE_64_BIT_TIME_T
+      instead of FEATURE_PTHREAD which has no direct connection
+      to the time_t size.
+     </P
+></LI
+><LI
+><P
+>      Fix indentation in perldoc examples.
+     </P
+></LI
+><LI
+><P
+>      Don't overlook directives in the first line of the action file.
+     </P
+></LI
+><LI
+><P
+>      Bump version to 0.7.
+     </P
+></LI
+><LI
+><P
+>      Fix detection of the Privoxy version now that https://
+      is used for the website.
+     </P
+></LI
+></UL
+></LI
+></UL
+><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
+><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
+>   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
+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
+>
\ No newline at end of file