Update for 3.0.17 release
[privoxy.git] / doc / webserver / announce.txt
1               Announcing Privoxy v.3.0.17 stable
2 -----------------------------------------------------------------
3
4 This is mainly a bug-fix release for the previously released Privoxy 3.0.16.
5
6 It contains fixes for two bugs that could cause connections to hang under
7 certain circumstances when keep-alive support was enabled, until they timed
8 out or where closed by the server.
9
10 See http://www.privoxy.org/3.0.17/user-manual/whatsnew.html for details.
11
12 --------------------------------------------------------------------
13 ChangeLog for Privoxy
14 --------------------------------------------------------------------
15 *** Version 3.0.17 Stable ***
16
17 - Fixed last-chunk-detection for responses where the content was small
18   enough to be read with the body, causing Privoxy to wait for the
19   end of the content until the server closed the connection.
20   Reported by "Karsten" in #3028326.
21 - Responses with status code 204 weren't properly detected as body-less
22   like RFC2616 mandates. Like the previous bug, this caused Privoxy
23   to wait for the end of the content until the server closed the connection.
24   Fixes #3022042 and #3025553, reported by a user with no visible name.
25   Most likely also fixes a bunch of other AJAX-related problem reports
26   that got closed in the past due to insufficient information and lack
27   of feedback.
28 - Fixed an ACL bug that made it impossible to build a blacklist.
29   Usually the ACL directives are used in a whitelist, which worked
30   as expected, but blacklisting is still useful for public proxies
31   where one only needs to deny known abusers access.
32 - Added LOG_LEVEL_RECEIVED to log the not-yet-parsed data read from the
33   network. This should make debugging various parsing issues a lot easier.
34 - The IPv6 code is enabled by default on Windows versions that support it.
35   Patch submitted by oCameLo in #2942729.
36 - In mingw32 versions, the user.filter file is reachable through the
37   GUI, just like default.filter is. Feature request 3040263.
38 - Added the configure option --enable-large-file-support to set a few
39   defines that are required by platforms like GNU/Linux to support files
40   larger then 2GB. Mainly interesting for users without proper logfile
41   management.
42 - Logging with "debug 16" no longer stops at the first nul byte which is
43   pretty useless. Non-printable characters are replaced with their hex value
44   so the result can't span multiple lines making parsing them harder then
45   necessary.
46 - Privoxy logs when reading an action, filter or trust file.
47 - Fixed incorrect regression test markup which caused a test in
48   3.0.16 to fail while Privoxy itself was working correctly.
49   While Privoxy accepts hide-referer, too, the action name is actually
50   hide-referrer which is also the name used one the final results page,
51   where the test expected the alias.
52
53 - CGI interface improvements:
54   - In finish_http_response(), continue to add the 'Connection: close'
55     header if the client connection will not be kept alive.
56     Anonymously pointed out in #2987454.
57   - Apostrophes in block messages no longer cause parse errors
58     when the blocked page is viewed with JavaScript enabled.
59     Reported by dg1727 in #3062296.
60   - Fix a bunch of anchors that used underscores instead of dashes.
61   - Allow to keep the client connection alive after crunching the previous request.
62     Already opened server connections can be kept alive, too.
63   - In cgi_show_url_info(), don't forget to prefix URLs that only contain
64     http:// or https:// in the path. Fixes #2975765 reported by Adam Piggott.
65   - Show the 404 CGI page if cgi_send_user_manual() is called while
66     local user manual delivery is disabled.
67
68 - Action file improvements:
69   - Enable user.filter by default. Suggested by David White in #3001830.
70   - Block .sitestat.com/. Reported by johnd16 in #3002725.
71   - Block .atemda.com/. Reported by johnd16 in #3002723.
72   - Block js.adlink.net/. Reported by johnd16 in #3002720.
73   - Block .analytics.yahoo.com/. Reported by johnd16 in #3002713.
74   - Block sb.scorecardresearch.com, too. Reported by dg1727 in #2992652.
75   - Fix problems noticed on Yahoo mail and news pages.
76   - Remove the too broad yahoo section, only keeping the
77     fast-redirects exception as discussed on ijbswa-devel@.
78   - Don't block adesklets.sourceforge.net. Reported in #2974204.
79   - Block chartbeat ping tracking. Reported in #2975895.
80   - Tag CSS and image requests with cautious and medium settings, too.
81   - Don't handle view.atdmt.com as image. It's used for click-throughs
82     so users should be able to "go there anyway".
83     Reported by Adam Piggott in #2975927.
84   - Also let the refresh-tags filter remove invalid refresh tags where
85     the 'url=' part is missing. Anonymously reported in #2986382.
86     While at it, update the description to mention the fact that only
87     refresh tags with refresh times above 9 seconds are covered.
88   - javascript needs to be blocked with +handle-as-empty-document to
89     work around Firefox bug 492459.  So move .js blockers from
90     +block{Might be a web-bug.} -handle-as-empty-document
91     to
92     +block{Might be a web-bug.} +handle-as-empty-document
93   - ijbswa-Feature Requests-3006719 - Block 160x578 Banners.
94   - Block another omniture tracking domain
95   - Added a range-requests tagger.
96   - Added two sections to get Flickr's Ajax interface working with
97     default pre-settings. If you change the configuration to block
98     cookies by default, you'll need additional exceptions.
99     Reported by Mathias Homann in #3101419 and by Patrick on ijbswa-users@
100
101 - Documentation improvements:
102   - Explicitly mention how to match all URLs.
103   - Consistently recommend socks5 in the Tor FAQ entry and mention
104     its advantage compared to socks4a. Reported by David in #2960129.
105   - Slightly improve the explanation of why filtering may appear
106     slower than it is.
107   - Grammar fixes for the ACL section.
108
109 - Privoxy-Log-Parser improvements:
110   - Also gather statistics for blocked and redirected requests.
111   - Provide the percentage of keep-alive offers the client accepted.
112   - Add a --url-statistics-threshold option.
113   - Also gather statistics for ressources, methods, and HTTP versions
114     used by the client.
115   - Add a --host-statistics-threshold option to also gather
116     statistics about how many request where made per host.
117   - Fix a bug in handle_loglevel_header() where a 'scan: ' got lost.
118   - Add a --shorten-thread-ids option to replace the thread id with
119     a decimal number.
120   - Accept and ignore: Looks like we got the last chunk together
121     with the server headers. We better stop reading.
122   - Accept and ignore: Continue hack in da house.
123   - Accept and higlight: Rejecting connection from 10.0.0.2.
124     Maximum number of connections reached.
125   - Accept and highlight: Loading actions file: /usr/local/etc/privoxy/default.action
126   - Accept and highlight: Loading filter file: /usr/local/etc/privoxy/default.filter
127   - Accept and highlight: Killed all-caps Host header line: HOST: bestproxydb.com
128   - Accept and highlight: Reducing expected bytes to 0. Marking
129     the server socket tainted after throwing 4 bytes away.
130   - Accept: Merged multiple header lines to: 'X-FORWARDED-PROTO: http X-HOST: 127.0.0.1'
131
132 - Code cleanups:
133   - Remove the next member from the client_state struct. Only the main
134     thread needs access to all client states so give it its own struct.
135   - Garbage-collect request_contains_null_bytes().
136   - Ditch redundant code in unload_configfile().
137   - Ditch LogGetURLUnderCursor() which doesn't seem to be used anywhere.
138   - In write_socket(), remove the write-only variable write_len in
139     an ifdef __OS2__ block. Spotted by cppcheck.
140   - In connect_to(), don't declare the variable 'flags' on OS/2 where
141     it isn't used. Spotted by cppcheck.
142   - Limit the scope of various variables. Spotted by cppcheck.
143   - In add_to_iob(), turn an interestingly looking for loop into a
144     boring while loop.
145   - Code cleanup in preparation for external filters.
146   - In listen_loop(), mention the socket on which we accepted the
147     connection, not just the source IP address.
148   - In write_socket(), also log the socket we're writing to.
149   - In log_error(), assert that escaped characters get logged
150     completely or not at all.
151   - In log_error(), assert that ival and sval have reasonable values.
152     There's no reason not to abort() if they don't.
153   - Remove an incorrect cgi_error_unknown() call in a
154     cannnot-happen-situation in send_crunch_response().
155   - Clean up white-space in http_response definition and
156     move the crunch_reason to the beginning.
157   - Turn http_response.reason into an enum and rename it
158     to http_response.crunch_reason.
159   - Silence a 'gcc (Debian 4.3.2-1.1) 4.3.2' warning on i686 GNU/Linux.
160
161 - GNUmakefile improvements:
162   - Use $(SSH) instead of ssh, so one only needs to specify a username once.
163   - Removed references to the action feedback thingy that hasn't been
164     working for years.
165   - Consistently use shell.sourceforge.net instead of shell.sf.net so
166     one doesn't need to check server fingerprints twice.
167   - Removed GNUisms in the webserver and webactions targets so they
168     work with standard tar.
169
170 -----------------------------------------------------------------
171 About Privoxy:
172 -----------------------------------------------------------------
173
174 Privoxy is a non-caching web proxy with advanced filtering capabilities for
175 enhancing privacy, modifying web page data and HTTP headers, controlling
176 access, and removing ads and other obnoxious Internet junk. Privoxy has a
177 flexible configuration and can be customized to suit individual needs and
178 tastes. It has application for both stand-alone systems and multi-user
179 networks.
180
181 Privoxy is Free Software and licensed under the GNU GPLv2.
182
183 Privoxy is an associated project of Software in the Public Interest (SPI).
184
185 Helping hands and donations are welcome:
186
187   * http://www.privoxy.org/faq/general.html#PARTICIPATE
188
189   * http://www.privoxy.org/faq/general.html#DONATE
190
191 At present, Privoxy is known to run on Windows(95, 98, ME, 2000,
192 XP, Vista), Linux (Ubuntu, RedHat, SuSE, Debian, Fedora, Gentoo and
193 others), Mac OSX, OS/2, AmigaOS, FreeBSD, NetBSD, OpenBSD, Solaris, and
194 various other flavors of Unix.
195
196 In addition to the core features of ad blocking and cookie management,
197 Privoxy provides many supplemental features, that give the end-user
198 more control, more privacy and more freedom:
199
200
201     *  Supports "Connection: keep-alive". Outgoing connections can be kept
202        alive independently from the client. Currently not available on all
203        platforms.
204
205     *  Supports IPv6, provided the operating system does so too,
206        and the configure script detects it.
207
208     *  Supports tagging which allows to change the behaviour based on client
209        and server headers.
210
211     *  Can be run as an "intercepting" proxy, which obviates the need to
212        configure browsers individually.
213
214     *  Sophisticated actions and filters for manipulating both server and
215        client headers.
216
217     *  Can be chained with other proxies.
218
219     *  Integrated browser based configuration and control utility at
220        http://config.privoxy.org/ (shortcut: http://p.p/). Browser-based
221        tracing of rule and filter effects. Remote toggling.
222
223     *  Web page filtering (text replacements, removes banners based on size,
224        invisible <quote>web-bugs</quote> and HTML annoyances, etc.)
225
226     *  Modularized configuration that allows for standard settings and user
227        settings to reside in separate files, so that installing updated actions
228        files won't overwrite individual user settings.
229
230     *  Support for Perl Compatible Regular Expressions in the configuration
231        files, and a more sophisticated and flexible configuration syntax.
232
233     *  GIF de-animation.
234
235     *  Bypass many click-tracking scripts (avoids script redirection).
236
237     *  User-customizable HTML templates for most proxy-generated pages (e.g.
238        "blocked" page).
239
240     *  Auto-detection and re-reading of config file changes.
241     
242     *  Most features are controllable on a per-site or per-location basis.
243     
244
245 Download location: 
246    http://sourceforge.net/project/showfiles.php?group_id=11118
247  
248 Home Page: 
249    http://www.privoxy.org/
250
251
252   - Privoxy Developers <ijbswa-developers@lists.sourceforge.net>