Fresh build of ALL html docs.
[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 >  
308     Some installers may remove earlier versions completely, including 
309     configuration files. Save any important configuration files!
310   </P
311 ></LI
312 ><LI
313 ><P
314 >  
315    On the other hand, other installers may not overwrite any existing configuration 
316    files, thinking you will want to do that. You may want to manually check 
317    your saved files against the newer versions to see if the improvements have
318    merit, or whether there are new options that you may want to consider.
319    There are a number of new features, but most won't be available unless 
320    these features are incorporated into your configuration somehow.
321   </P
322 ></LI
323 ><LI
324 ><P
325 >  
326    <TT
327 CLASS="FILENAME"
328 >standard.action</TT
329 > now only includes the enabled actions.
330    Not all actions as before.
331   </P
332 ></LI
333 ><LI
334 ><P
335 >     Logging is off by default now. If you need logging, it can be turned on
336      in the <A
337 HREF="config.html#LOGFILE"
338 >config file</A
339 >.
340     </P
341 ></LI
342 ><LI
343 ><P
344 >     Three other config file settings are now off by default: 
345      <A
346 HREF="config.html#ENABLE-REMOTE-TOGGLE"
347 >enable-remote-toggle</A
348 >,
349      <A
350 HREF="config.html#ENABLE-REMOTE-HTTP-TOGGLE"
351 >enable-remote-http-toggle</A
352 >,
353      and  <A
354 HREF="config.html#ENABLE-EDIT-ACTIONS"
355 >enable-edit-actions</A
356 >. 
357      If you use or want these, you will need to explicitly enable them, and
358      be aware of the security issues involved. 
359     </P
360 ></LI
361 ><LI
362 ><P
363 >    The <SPAN
364 CLASS="QUOTE"
365 >"filter-client-headers"</SPAN
366 > and
367     <SPAN
368 CLASS="QUOTE"
369 >"filter-server-headers"</SPAN
370 > actions that were introduced with
371     <SPAN
372 CLASS="APPLICATION"
373 >Privoxy 3.0.5</SPAN
374 > to apply content filters to
375     the headers  have been removed and replaced with new actions.
376     See the <A
377 HREF="whatsnew.html"
378 >What's New section</A
379 > above.
380    </P
381 ></LI
382 ></UL
383 ></P
384 ></DIV
385 ></DIV
386 ><DIV
387 CLASS="NAVFOOTER"
388 ><HR
389 ALIGN="LEFT"
390 WIDTH="100%"><TABLE
391 SUMMARY="Footer navigation table"
392 WIDTH="100%"
393 BORDER="0"
394 CELLPADDING="0"
395 CELLSPACING="0"
396 ><TR
397 ><TD
398 WIDTH="33%"
399 ALIGN="left"
400 VALIGN="top"
401 ><A
402 HREF="installation.html"
403 ACCESSKEY="P"
404 >Prev</A
405 ></TD
406 ><TD
407 WIDTH="34%"
408 ALIGN="center"
409 VALIGN="top"
410 ><A
411 HREF="index.html"
412 ACCESSKEY="H"
413 >Home</A
414 ></TD
415 ><TD
416 WIDTH="33%"
417 ALIGN="right"
418 VALIGN="top"
419 ><A
420 HREF="quickstart.html"
421 ACCESSKEY="N"
422 >Next</A
423 ></TD
424 ></TR
425 ><TR
426 ><TD
427 WIDTH="33%"
428 ALIGN="left"
429 VALIGN="top"
430 >Installation</TD
431 ><TD
432 WIDTH="34%"
433 ALIGN="center"
434 VALIGN="top"
435 >&nbsp;</TD
436 ><TD
437 WIDTH="33%"
438 ALIGN="right"
439 VALIGN="top"
440 >Quickstart to Using Privoxy</TD
441 ></TR
442 ></TABLE
443 ></DIV
444 ></BODY
445 ></HTML
446 >