4e15cf16426a94bdad9a867bf87c57751e0e65c8
[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.7 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">
21 <LINK REL="STYLESHEET" TYPE="text/css" HREF="p_doc.css">
22 </head
23 ><BODY
24 CLASS="SECT1"
25 BGCOLOR="#EEEEEE"
26 TEXT="#000000"
27 LINK="#0000FF"
28 VLINK="#840084"
29 ALINK="#0000FF"
30 ><DIV
31 CLASS="NAVHEADER"
32 ><TABLE
33 SUMMARY="Header navigation table"
34 WIDTH="100%"
35 BORDER="0"
36 CELLPADDING="0"
37 CELLSPACING="0"
38 ><TR
39 ><TH
40 COLSPAN="3"
41 ALIGN="center"
42 >Privoxy 3.0.7 User Manual</TH
43 ></TR
44 ><TR
45 ><TD
46 WIDTH="10%"
47 ALIGN="left"
48 VALIGN="bottom"
49 ><A
50 HREF="installation.html"
51 ACCESSKEY="P"
52 >Prev</A
53 ></TD
54 ><TD
55 WIDTH="80%"
56 ALIGN="center"
57 VALIGN="bottom"
58 ></TD
59 ><TD
60 WIDTH="10%"
61 ALIGN="right"
62 VALIGN="bottom"
63 ><A
64 HREF="quickstart.html"
65 ACCESSKEY="N"
66 >Next</A
67 ></TD
68 ></TR
69 ></TABLE
70 ><HR
71 ALIGN="LEFT"
72 WIDTH="100%"></DIV
73 ><DIV
74 CLASS="SECT1"
75 ><H1
76 CLASS="SECT1"
77 ><A
78 NAME="WHATSNEW"
79 >3. What's New in this Release</A
80 ></H1
81 ><P
82 > There are many improvements and new features since <SPAN
83 CLASS="APPLICATION"
84 >Privoxy 3.0.6</SPAN
85 >, the last stable release:</P
86 ><P
87 > <P
88 ></P
89 ><UL
90 ><LI
91 ><P
92 >    Two new actions <A
93 HREF="actions-file.html#SERVER-HEADER-TAGGER"
94 >server-header-tagger</A
95 >
96           and <A
97 HREF="actions-file.html#CLIENT-HEADER-TAGGER"
98 >client-header-tagger</A
99 >
100           that can be used to create arbitrary <SPAN
101 CLASS="QUOTE"
102 >"tags"</SPAN
103 >
104           based on client and server headers.
105           These <SPAN
106 CLASS="QUOTE"
107 >"tags"</SPAN
108 > can then subsequently be used
109           to control the other actions used for the current request,
110           greatly increasing <SPAN
111 CLASS="APPLICATION"
112 >Privoxy</SPAN
113 >'s flexibility and selectivity. See <A
114 HREF="actions-file.html#TAG-PATTERN"
115 >tag patterns</A
116 > for more information on tags.
117    </P
118 ></LI
119 ><LI
120 ><P
121 >    Header filtering is done with dedicated header filters now. As a result
122     the actions <SPAN
123 CLASS="QUOTE"
124 >"filter-client-headers"</SPAN
125 > and <SPAN
126 CLASS="QUOTE"
127 >"filter-server-headers"</SPAN
128 >
129     that were introduced with <SPAN
130 CLASS="APPLICATION"
131 >Privoxy 3.0.5</SPAN
132 > to apply
133     content filters to the headers have been removed.
134     See the new actions <A
135 HREF="actions-file.html#SERVER-HEADER-FILTER"
136 >server-header-filter</A
137 >
138           and <A
139 HREF="actions-file.html#CLIENT-HEADER-FILTER"
140 >client-header-filter</A
141 > for details.
142    </P
143 ></LI
144 ><LI
145 ><P
146 >     There are four new options for the main <TT
147 CLASS="FILENAME"
148 >config</TT
149 > file:
150    </P
151 ><P
152 ></P
153 ><UL
154 ><LI
155 ><P
156 >          <A
157 HREF="config.html#ALLOW-CGI-REQUEST-CRUNCHING"
158 >allow-cgi-request-crunching</A
159 >
160           which allows requests for Privoxy's internal CGI pages to be
161           blocked, redirected or (un)trusted like ordinary requests.
162         </P
163 ></LI
164 ><LI
165 ><P
166 >          <A
167 HREF="config.html#SPLIT-LARGE-FORMS"
168 >split-large-forms</A
169 >
170           that will work around a browser bug that caused IE6 and IE7 to
171           ignore the Submit button on the Privoxy's edit-actions-for-url CGI
172           page.
173           </P
174 ></LI
175 ><LI
176 ><P
177 >          <A
178 HREF="config.html#ACCEPT-INTERCEPTED-REQUESTS"
179 >accept-intercepted-requests</A
180 >
181           which allows to combine Privoxy with any packet filter to create an
182           intercepting proxy for HTTP/1.1 requests (and for HTTP/1.0 requests
183           with Host header set). This means clients can be forced to use
184           <SPAN
185 CLASS="APPLICATION"
186 >Privoxy</SPAN
187 > even if their proxy settings are configured differently.
188          </P
189 ></LI
190 ><LI
191 ><P
192 >          <A
193 HREF="config.html#TEMPLDIR"
194 >templdir</A
195 >
196           to designate an alternate location for <SPAN
197 CLASS="APPLICATION"
198 >Privoxy</SPAN
199 >'s 
200           locally customized CGI templates so that
201           these are not overwritten during upgrades.         
202         </P
203 ></LI
204 ></UL
205 ></LI
206 ><LI
207 ><P
208 >   A new command line option <TT
209 CLASS="LITERAL"
210 >--pre-chroot-nslookup hostname</TT
211 > to
212    initialize the resolver library before chroot'ing. On some systems this
213    reduces the number of files that must be copied into the chroot tree.
214    (Patch provided by Stephen Gildea)
215    </P
216 ></LI
217 ><LI
218 ><P
219 >     The <A
220 HREF="actions-file.html#FORWARD-OVERRIDE"
221 >forward-override</A
222 > action 
223      allows changing of the forwarding settings through the actions files.
224      Combined with tags, this allows to choose the forwarder based on
225      client headers like the <TT
226 CLASS="LITERAL"
227 >User-Agent</TT
228 >, or the request origin.
229   </P
230 ></LI
231 ><LI
232 ><P
233 >     The  <A
234 HREF="actions-file.html#REDIRECT"
235 >redirect</A
236 > action can now use regular
237           expression substitutions against the original URL.
238    </P
239 ></LI
240 ><LI
241 ><P
242 >     <SPAN
243 CLASS="APPLICATION"
244 >zlib</SPAN
245 > support is now available as a compile
246      time option to filter compressed content. Patch provided by Wil Mahan.
247    </P
248 ></LI
249 ><LI
250 ><P
251 >     Improve various filters, and add new ones.
252    </P
253 ></LI
254 ><LI
255 ><P
256 >    Include support for RFC 3253 so that <TT
257 CLASS="FILENAME"
258 >Subversion</TT
259 > works
260     with <SPAN
261 CLASS="APPLICATION"
262 >Privoxy</SPAN
263 >. Patch provided by Petr Kadlec.
264    </P
265 ></LI
266 ><LI
267 ><P
268 >     Logging can be completely turned off by not specifying a logfile directive.
269    </P
270 ></LI
271 ><LI
272 ><P
273 >     A number of improvements to Privoxy's internal CGI pages, including the
274      use of favicons for error and control pages.
275    </P
276 ></LI
277 ><LI
278 ><P
279 >     Many bugfixes, memory leaks addressed, code improvements, and logging 
280      improvements.
281    </P
282 ></LI
283 ></UL
284 ></P
285 ><P
286 > For a more detailed list of changes please have a look at the ChangeLog.</P
287 ><DIV
288 CLASS="SECT2"
289 ><H2
290 CLASS="SECT2"
291 ><A
292 NAME="UPGRADERSNOTE"
293 >3.1. Note to Upgraders</A
294 ></H2
295 ><P
296 > A quick list of things to be aware of before upgrading from earlier 
297  versions of <SPAN
298 CLASS="APPLICATION"
299 >Privoxy</SPAN
300 >:</P
301 ><P
302 > <P
303 ></P
304 ><UL
305 ><LI
306 ><P
307 >   The recommended way to upgrade <SPAN
308 CLASS="APPLICATION"
309 >Privoxy</SPAN
310 > is to backup your old 
311    configuration files, install the new ones, verify that <SPAN
312 CLASS="APPLICATION"
313 >Privoxy</SPAN
314 >
315    is working correctly and finally merge back your changes using
316    <SPAN
317 CLASS="APPLICATION"
318 >diff</SPAN
319 > and maybe <SPAN
320 CLASS="APPLICATION"
321 >patch</SPAN
322 >.
323   </P
324 ><P
325 >   There are a number of new features in each <SPAN
326 CLASS="APPLICATION"
327 >Privoxy</SPAN
328 > release and
329    most of them have to be explicitly enabled in the configuration
330    files. Old configuration files obviously don't do that and due
331    to syntax changes using old configuration files with a new
332    <SPAN
333 CLASS="APPLICATION"
334 >Privoxy</SPAN
335 > isn't always possible anyway.
336   </P
337 ></LI
338 ><LI
339 ><P
340 >  
341     Note that some installers remove earlier versions completely,
342     including configuration files, therefore you should really save
343     any important configuration files!
344   </P
345 ></LI
346 ><LI
347 ><P
348 >  
349    On the other hand, other installers don't overwrite existing configuration 
350    files, thinking you will want to do that yourself.
351   </P
352 ></LI
353 ><LI
354 ><P
355 >  
356    <TT
357 CLASS="FILENAME"
358 >standard.action</TT
359 > now only includes the enabled actions.
360    Not all actions as before.
361   </P
362 ></LI
363 ><LI
364 ><P
365 >   Logging is off by default now. If you need logging, it can be turned on
366    in the <A
367 HREF="config.html#LOGFILE"
368 >config file</A
369 >. You may also want
370    to enable logging until you verified that the new <SPAN
371 CLASS="APPLICATION"
372 >Privoxy</SPAN
373 > version
374    is working as expected.
375   </P
376 ></LI
377 ><LI
378 ><P
379 >     Three other config file settings are now off by default: 
380      <A
381 HREF="config.html#ENABLE-REMOTE-TOGGLE"
382 >enable-remote-toggle</A
383 >,
384      <A
385 HREF="config.html#ENABLE-REMOTE-HTTP-TOGGLE"
386 >enable-remote-http-toggle</A
387 >,
388      and  <A
389 HREF="config.html#ENABLE-EDIT-ACTIONS"
390 >enable-edit-actions</A
391 >. 
392      If you use or want these, you will need to explicitly enable them, and
393      be aware of the security issues involved. 
394     </P
395 ></LI
396 ><LI
397 ><P
398 >    The <SPAN
399 CLASS="QUOTE"
400 >"filter-client-headers"</SPAN
401 > and
402     <SPAN
403 CLASS="QUOTE"
404 >"filter-server-headers"</SPAN
405 > actions that were introduced with
406     <SPAN
407 CLASS="APPLICATION"
408 >Privoxy 3.0.5</SPAN
409 > to apply content filters to
410     the headers  have been removed and replaced with new actions.
411     See the <A
412 HREF="whatsnew.html"
413 >What's New section</A
414 > above.
415    </P
416 ></LI
417 ></UL
418 ></P
419 ></DIV
420 ></DIV
421 ><DIV
422 CLASS="NAVFOOTER"
423 ><HR
424 ALIGN="LEFT"
425 WIDTH="100%"><TABLE
426 SUMMARY="Footer navigation table"
427 WIDTH="100%"
428 BORDER="0"
429 CELLPADDING="0"
430 CELLSPACING="0"
431 ><TR
432 ><TD
433 WIDTH="33%"
434 ALIGN="left"
435 VALIGN="top"
436 ><A
437 HREF="installation.html"
438 ACCESSKEY="P"
439 >Prev</A
440 ></TD
441 ><TD
442 WIDTH="34%"
443 ALIGN="center"
444 VALIGN="top"
445 ><A
446 HREF="index.html"
447 ACCESSKEY="H"
448 >Home</A
449 ></TD
450 ><TD
451 WIDTH="33%"
452 ALIGN="right"
453 VALIGN="top"
454 ><A
455 HREF="quickstart.html"
456 ACCESSKEY="N"
457 >Next</A
458 ></TD
459 ></TR
460 ><TR
461 ><TD
462 WIDTH="33%"
463 ALIGN="left"
464 VALIGN="top"
465 >Installation</TD
466 ><TD
467 WIDTH="34%"
468 ALIGN="center"
469 VALIGN="top"
470 >&nbsp;</TD
471 ><TD
472 WIDTH="33%"
473 ALIGN="right"
474 VALIGN="top"
475 >Quickstart to Using Privoxy</TD
476 ></TR
477 ></TABLE
478 ></DIV
479 ></BODY
480 ></HTML
481 >