Rebuilt html docs for Privoxy 3.0.8
[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.8 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.8 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 >   In the default configuration only fatal errors are logged now.
366    You can change that in the <A
367 HREF="config.html#DEBUG"
368 >debug section</A
369 >
370    of the configuration file. You may also want to enable more verbose
371    logging until you verified that the new <SPAN
372 CLASS="APPLICATION"
373 >Privoxy</SPAN
374 > version is working
375    as expected.
376   </P
377 ></LI
378 ><LI
379 ><P
380 >     Three other config file settings are now off by default: 
381      <A
382 HREF="config.html#ENABLE-REMOTE-TOGGLE"
383 >enable-remote-toggle</A
384 >,
385      <A
386 HREF="config.html#ENABLE-REMOTE-HTTP-TOGGLE"
387 >enable-remote-http-toggle</A
388 >,
389      and  <A
390 HREF="config.html#ENABLE-EDIT-ACTIONS"
391 >enable-edit-actions</A
392 >. 
393      If you use or want these, you will need to explicitly enable them, and
394      be aware of the security issues involved. 
395     </P
396 ></LI
397 ><LI
398 ><P
399 >    The <SPAN
400 CLASS="QUOTE"
401 >"filter-client-headers"</SPAN
402 > and
403     <SPAN
404 CLASS="QUOTE"
405 >"filter-server-headers"</SPAN
406 > actions that were introduced with
407     <SPAN
408 CLASS="APPLICATION"
409 >Privoxy 3.0.5</SPAN
410 > to apply content filters to
411     the headers  have been removed and replaced with new actions.
412     See the <A
413 HREF="whatsnew.html"
414 >What's New section</A
415 > above.
416    </P
417 ></LI
418 ></UL
419 ></P
420 ></DIV
421 ></DIV
422 ><DIV
423 CLASS="NAVFOOTER"
424 ><HR
425 ALIGN="LEFT"
426 WIDTH="100%"><TABLE
427 SUMMARY="Footer navigation table"
428 WIDTH="100%"
429 BORDER="0"
430 CELLPADDING="0"
431 CELLSPACING="0"
432 ><TR
433 ><TD
434 WIDTH="33%"
435 ALIGN="left"
436 VALIGN="top"
437 ><A
438 HREF="installation.html"
439 ACCESSKEY="P"
440 >Prev</A
441 ></TD
442 ><TD
443 WIDTH="34%"
444 ALIGN="center"
445 VALIGN="top"
446 ><A
447 HREF="index.html"
448 ACCESSKEY="H"
449 >Home</A
450 ></TD
451 ><TD
452 WIDTH="33%"
453 ALIGN="right"
454 VALIGN="top"
455 ><A
456 HREF="quickstart.html"
457 ACCESSKEY="N"
458 >Next</A
459 ></TD
460 ></TR
461 ><TR
462 ><TD
463 WIDTH="33%"
464 ALIGN="left"
465 VALIGN="top"
466 >Installation</TD
467 ><TD
468 WIDTH="34%"
469 ALIGN="center"
470 VALIGN="top"
471 >&nbsp;</TD
472 ><TD
473 WIDTH="33%"
474 ALIGN="right"
475 VALIGN="top"
476 >Quickstart to Using Privoxy</TD
477 ></TR
478 ></TABLE
479 ></DIV
480 ></BODY
481 ></HTML
482 >