Update the "What's New in this Release" section with
[privoxy.git] / doc / webserver / user-manual / whatsnew.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
2 <HTML
3 ><HEAD
4 ><TITLE
5 >What's New in this Release</TITLE
6 ><META
7 NAME="GENERATOR"
8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
9 REL="HOME"
10 TITLE="Privoxy 3.0.9 User Manual"
11 HREF="index.html"><LINK
12 REL="PREVIOUS"
13 TITLE="Installation"
14 HREF="installation.html"><LINK
15 REL="NEXT"
16 TITLE="Quickstart to Using Privoxy"
17 HREF="quickstart.html"><LINK
18 REL="STYLESHEET"
19 TYPE="text/css"
20 HREF="../p_doc.css"><META
21 HTTP-EQUIV="Content-Type"
22 CONTENT="text/html;
23 charset=ISO-8859-1">
24 <LINK REL="STYLESHEET" TYPE="text/css" HREF="p_doc.css">
25 </head
26 ><BODY
27 CLASS="SECT1"
28 BGCOLOR="#EEEEEE"
29 TEXT="#000000"
30 LINK="#0000FF"
31 VLINK="#840084"
32 ALINK="#0000FF"
33 ><DIV
34 CLASS="NAVHEADER"
35 ><TABLE
36 SUMMARY="Header navigation table"
37 WIDTH="100%"
38 BORDER="0"
39 CELLPADDING="0"
40 CELLSPACING="0"
41 ><TR
42 ><TH
43 COLSPAN="3"
44 ALIGN="center"
45 >Privoxy 3.0.9 User Manual</TH
46 ></TR
47 ><TR
48 ><TD
49 WIDTH="10%"
50 ALIGN="left"
51 VALIGN="bottom"
52 ><A
53 HREF="installation.html"
54 ACCESSKEY="P"
55 >Prev</A
56 ></TD
57 ><TD
58 WIDTH="80%"
59 ALIGN="center"
60 VALIGN="bottom"
61 ></TD
62 ><TD
63 WIDTH="10%"
64 ALIGN="right"
65 VALIGN="bottom"
66 ><A
67 HREF="quickstart.html"
68 ACCESSKEY="N"
69 >Next</A
70 ></TD
71 ></TR
72 ></TABLE
73 ><HR
74 ALIGN="LEFT"
75 WIDTH="100%"></DIV
76 ><DIV
77 CLASS="SECT1"
78 ><H1
79 CLASS="SECT1"
80 ><A
81 NAME="WHATSNEW"
82 >3. What's New in this Release</A
83 ></H1
84 ><P
85 > There are many improvements and new features since <SPAN
86 CLASS="APPLICATION"
87 >Privoxy 3.0.8</SPAN
88 >, the last stable release:</P
89 ><P
90 > <P
91 ></P
92 ><UL
93 ><LI
94 ><P
95 >    Added SOCKS5 support (with address resolution done by
96     the SOCKS5 server). Patch provided by Eric M. Hopper.
97    </P
98 ></LI
99 ><LI
100 ><P
101 >    The "blocked" CGI pages include a block reason that was
102     provided as argument to the last-applying block action.
103    </P
104 ></LI
105 ><LI
106 ><P
107 >    If enable-edit-actions is disabled (the default since 3.0.7 beta)
108     the show-status page hides the edit buttons and explains why.
109     Previously the user would get the "this feature has been disabled"
110     message after using the edit button.
111    </P
112 ></LI
113 ><LI
114 ><P
115 >    Forbidden CONNECT requests are treated like blocks by default.
116     The now-pointless treat-forbidden-connects-like-blocks action
117     has been removed.
118    </P
119 ></LI
120 ><LI
121 ><P
122 >    Not enabling limit-connect now allows CONNECT requests to all ports.
123     In previous versions it would only allow CONNECT requests to port 443.
124     Use +limit-connect{443} if you think you need the old default behaviour.
125    </P
126 ></LI
127 ><LI
128 ><P
129 >    The CGI editor gets turned off after three edit requests with invalid
130     file modification timestamps. This makes life harder for attackers
131     who can leverage browser bugs to send fake Referers and intend to
132     brute-force edit URLs.
133    </P
134 ></LI
135 ><LI
136 ><P
137 >    Action settings for multiple patterns in the same section are
138     shared in memory. As a result these sections take up less space
139     (and are loaded slightly faster). Problem reported by Franz Schwartau.
140    </P
141 ></LI
142 ><LI
143 ><P
144 >    Linear white space in HTTP headers will be normalized to single
145     spaces before parsing the header's content, headers split across
146     multiple lines get merged first.
147    </P
148 ></LI
149 ><LI
150 ><P
151 >    Host information is gathered outside the main thread so it's less
152     likely to delay other incoming connections if the host is misconfigured.
153    </P
154 ></LI
155 ><LI
156 ><P
157 >    New config option "hostname" to use a hostname other than
158     the one returned by the operating system. Useful to speed-up responses
159     for CGI requests on misconfigured systems. Requested by Max Khon.
160    </P
161 ></LI
162 ><LI
163 ><P
164 >    The CGI editor supports the "disable all filters of this type"
165     directives "-client-header-filter", "-server-header-filter",
166     "-client-header-tagger" and "-server-header-tagger".
167    </P
168 ></LI
169 ><LI
170 ><P
171 >    Fixed false-positives with the link-by-url filter and URLs that
172     contain the pattern "/jump/".
173    </P
174 ></LI
175 ><LI
176 ><P
177 >    The less-download-windows filter no longer messes
178     "Content-Type: application/x-shockwave-flash" headers up.
179    </P
180 ></LI
181 ><LI
182 ><P
183 >    In the show-url-info page's "Final results" section active and
184     inactive actions are listed separately. Patch provided by Lee.
185    </P
186 ></LI
187 ><LI
188 ><P
189 >    The GNUmakefile supports the DESTDIR variable. Patch for
190     the install target submitted by Radoslaw Zielinski.
191    </P
192 ></LI
193 ><LI
194 ><P
195 >    Embedding the content of configuration files in the show-status
196     page is significantly faster now. For a largish action file (1 MB)
197     a speedup of about 2450 times has been measured. This is mostly
198     interesting if you are using large action files or regularly use
199     Privoxy-Regression-Test while running Privoxy through Valgrind,
200     for stock configuration files it doesn't really matter.
201    </P
202 ></LI
203 ><LI
204 ><P
205 >    If zlib support is unavailable and there are content
206     filters active but the prevent-compression action is disabled,
207     the show-url-info page includes a warning that compression
208     might prevent filtering.
209    </P
210 ></LI
211 ><LI
212 ><P
213 >    The show-url-info page provides an OpenSearch Description that
214     allows to access the page through browser search plugins.
215    </P
216 ></LI
217 ><LI
218 ><P
219 >    The obsolete kill-popups action has been removed as the
220     PCRS-based popup filters can do the same and are slightly
221     less unreliable.
222    </P
223 ></LI
224 ><LI
225 ><P
226 >    The inspect-jpegs action has been removed.
227    </P
228 ></LI
229 ><LI
230 ><P
231 >    The send-wafer and send-vanilla-wafer actions have been removed.
232     They weren't particular useful and their behaviour could be emulated
233     with add-header anyway.
234    </P
235 ></LI
236 ><LI
237 ><P
238 >    Privoxy-Regression-Test has been significantly improved.
239    </P
240 ></LI
241 ><LI
242 ><P
243 >    Most sections in the default.action file contain tests for
244     Privoxy-Regression-Test to verify that they are working as intended.
245    </P
246 ></LI
247 ><LI
248 ><P
249 >    Parts of Privoxy have been refactored to increase maintainability.
250    </P
251 ></LI
252 ><LI
253 ><P
254 >    Building with zlib (if available) is done by default.
255    </P
256 ></LI
257 ></UL
258 ></P
259 ><P
260 > For a more detailed list of changes please have a look at the ChangeLog.</P
261 ><DIV
262 CLASS="SECT2"
263 ><H2
264 CLASS="SECT2"
265 ><A
266 NAME="UPGRADERSNOTE"
267 >3.1. Note to Upgraders</A
268 ></H2
269 ><P
270 > A quick list of things to be aware of before upgrading from earlier 
271  versions of <SPAN
272 CLASS="APPLICATION"
273 >Privoxy</SPAN
274 >:</P
275 ><P
276 > <P
277 ></P
278 ><UL
279 ><LI
280 ><P
281 >   The recommended way to upgrade <SPAN
282 CLASS="APPLICATION"
283 >Privoxy</SPAN
284 > is to backup your old 
285    configuration files, install the new ones, verify that <SPAN
286 CLASS="APPLICATION"
287 >Privoxy</SPAN
288 >
289    is working correctly and finally merge back your changes using
290    <SPAN
291 CLASS="APPLICATION"
292 >diff</SPAN
293 > and maybe <SPAN
294 CLASS="APPLICATION"
295 >patch</SPAN
296 >.
297   </P
298 ><P
299 >   There are a number of new features in each <SPAN
300 CLASS="APPLICATION"
301 >Privoxy</SPAN
302 > release and
303    most of them have to be explicitly enabled in the configuration
304    files. Old configuration files obviously don't do that and due
305    to syntax changes using old configuration files with a new
306    <SPAN
307 CLASS="APPLICATION"
308 >Privoxy</SPAN
309 > isn't always possible anyway.
310   </P
311 ></LI
312 ><LI
313 ><P
314 >  
315     Note that some installers remove earlier versions completely,
316     including configuration files, therefore you should really save
317     any important configuration files!
318   </P
319 ></LI
320 ><LI
321 ><P
322 >  
323    On the other hand, other installers don't overwrite existing configuration 
324    files, thinking you will want to do that yourself.
325   </P
326 ></LI
327 ><LI
328 ><P
329 >  
330    <TT
331 CLASS="FILENAME"
332 >standard.action</TT
333 > now only includes the enabled actions.
334    Not all actions as before.
335   </P
336 ></LI
337 ><LI
338 ><P
339 >   In the default configuration only fatal errors are logged now.
340    You can change that in the <A
341 HREF="config.html#DEBUG"
342 >debug section</A
343 >
344    of the configuration file. You may also want to enable more verbose
345    logging until you verified that the new <SPAN
346 CLASS="APPLICATION"
347 >Privoxy</SPAN
348 > version is working
349    as expected.
350   </P
351 ></LI
352 ><LI
353 ><P
354 >     Three other config file settings are now off by default: 
355      <A
356 HREF="config.html#ENABLE-REMOTE-TOGGLE"
357 >enable-remote-toggle</A
358 >,
359      <A
360 HREF="config.html#ENABLE-REMOTE-HTTP-TOGGLE"
361 >enable-remote-http-toggle</A
362 >,
363      and  <A
364 HREF="config.html#ENABLE-EDIT-ACTIONS"
365 >enable-edit-actions</A
366 >. 
367      If you use or want these, you will need to explicitly enable them, and
368      be aware of the security issues involved. 
369     </P
370 ></LI
371 ><LI
372 ><P
373 >    The <SPAN
374 CLASS="QUOTE"
375 >"filter-client-headers"</SPAN
376 > and
377     <SPAN
378 CLASS="QUOTE"
379 >"filter-server-headers"</SPAN
380 > actions that were introduced with
381     <SPAN
382 CLASS="APPLICATION"
383 >Privoxy 3.0.5</SPAN
384 > to apply content filters to
385     the headers  have been removed and replaced with new actions.
386     See the <A
387 HREF="whatsnew.html"
388 >What's New section</A
389 > above.
390    </P
391 ></LI
392 ></UL
393 ></P
394 ></DIV
395 ></DIV
396 ><DIV
397 CLASS="NAVFOOTER"
398 ><HR
399 ALIGN="LEFT"
400 WIDTH="100%"><TABLE
401 SUMMARY="Footer navigation table"
402 WIDTH="100%"
403 BORDER="0"
404 CELLPADDING="0"
405 CELLSPACING="0"
406 ><TR
407 ><TD
408 WIDTH="33%"
409 ALIGN="left"
410 VALIGN="top"
411 ><A
412 HREF="installation.html"
413 ACCESSKEY="P"
414 >Prev</A
415 ></TD
416 ><TD
417 WIDTH="34%"
418 ALIGN="center"
419 VALIGN="top"
420 ><A
421 HREF="index.html"
422 ACCESSKEY="H"
423 >Home</A
424 ></TD
425 ><TD
426 WIDTH="33%"
427 ALIGN="right"
428 VALIGN="top"
429 ><A
430 HREF="quickstart.html"
431 ACCESSKEY="N"
432 >Next</A
433 ></TD
434 ></TR
435 ><TR
436 ><TD
437 WIDTH="33%"
438 ALIGN="left"
439 VALIGN="top"
440 >Installation</TD
441 ><TD
442 WIDTH="34%"
443 ALIGN="center"
444 VALIGN="top"
445 >&nbsp;</TD
446 ><TD
447 WIDTH="33%"
448 ALIGN="right"
449 VALIGN="top"
450 >Quickstart to Using Privoxy</TD
451 ></TR
452 ></TABLE
453 ></DIV
454 ></BODY
455 ></HTML
456 >