More references to the new filters. Include html this time around.
[privoxy.git] / doc / webserver / user-manual / whatsnew.html
1 <HTML
2 ><HEAD
3 ><TITLE
4 >What's New in this Release</TITLE
5 ><META
6 NAME="GENERATOR"
7 CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
8 "><LINK
9 REL="HOME"
10 TITLE="Privoxy 3.0.6 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.6 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 ></A
80 >3. What's New in this Release</H1
81 ><P
82 > There are many improvements and new features since the last <SPAN
83 CLASS="APPLICATION"
84 >Privoxy</SPAN
85 > stable release:</P
86 ><P
87 > <P
88 ></P
89 ><UL
90 ><LI
91 ><P
92 >    Multiple <A
93 HREF="filter-file.html"
94 >filter files</A
95 > can now be specified in <TT
96 CLASS="FILENAME"
97 >config</TT
98 >. This allows for 
99     locally defined filters that can be maintained separately from the filters as
100     supplied by the developers, i.e. <TT
101 CLASS="FILENAME"
102 >default.filter</TT
103 >.
104    </P
105 ></LI
106 ><LI
107 ><P
108 >  
109    There are a number of new <A
110 HREF="actions-file.html"
111 >actions</A
112 >:
113   </P
114 ><P
115 >  <P
116 ></P
117 ><UL
118 ><LI
119 ><P
120 >       <TT
121 CLASS="LITERAL"
122 ><A
123 HREF="actions-file.html#CONTENT-TYPE-OVERWRITE"
124 >content-type-overwrite</A
125 ></TT
126 >
127       </P
128 ></LI
129 ><LI
130 ><P
131 >       <TT
132 CLASS="LITERAL"
133 ><A
134 HREF="actions-file.html#CRUNCH-CLIENT-HEADER"
135 >crunch-client-header</A
136 ></TT
137 >
138       </P
139 ></LI
140 ><LI
141 ><P
142 >       <TT
143 CLASS="LITERAL"
144 ><A
145 HREF="actions-file.html#CRUNCH-IF-NONE-MATCH"
146 >crunch-if-none-match</A
147 ></TT
148 >
149       </P
150 ></LI
151 ><LI
152 ><P
153 >       <TT
154 CLASS="LITERAL"
155 ><A
156 HREF="actions-file.html#CRUNCH-SERVER-HEADER"
157 >crunch-server-header</A
158 ></TT
159 >
160       </P
161 ></LI
162 ><LI
163 ><P
164 >       <TT
165 CLASS="LITERAL"
166 ><A
167 HREF="actions-file.html#FILTER-CLIENT-HEADERS"
168 >filter-client-headers</A
169 ></TT
170 >
171       </P
172 ></LI
173 ><LI
174 ><P
175 >       <TT
176 CLASS="LITERAL"
177 ><A
178 HREF="actions-file.html#FILTER-SERVER-HEADERS"
179 >filter-server-headers</A
180 ></TT
181 >
182       </P
183 ></LI
184 ><LI
185 ><P
186 >       <TT
187 CLASS="LITERAL"
188 ><A
189 HREF="actions-file.html#FORCE-TEXT-MODE"
190 >force-text-mode</A
191 ></TT
192 >
193       </P
194 ></LI
195 ><LI
196 ><P
197 >       <TT
198 CLASS="LITERAL"
199 ><A
200 HREF="actions-file.html#HANDLE-AS-EMPTY-DOCUMENT"
201 >handle-as-empty-document</A
202 ></TT
203 >
204       </P
205 ></LI
206 ><LI
207 ><P
208 >       <TT
209 CLASS="LITERAL"
210 ><A
211 HREF="actions-file.html#HIDE-ACCEPT-LANGUAGE"
212 >hide-accept-language</A
213 ></TT
214 >
215       </P
216 ></LI
217 ><LI
218 ><P
219 >       <TT
220 CLASS="LITERAL"
221 ><A
222 HREF="actions-file.html#HIDE-CONTENT-DISPOSITION"
223 >hide-content-disposition</A
224 ></TT
225 >
226       </P
227 ></LI
228 ><LI
229 ><P
230 >       <TT
231 CLASS="LITERAL"
232 ><A
233 HREF="actions-file.html#HIDE-IF-MODIFIED-SINCE"
234 >hide-if-modified-since</A
235 ></TT
236 >
237       </P
238 ></LI
239 ><LI
240 ><P
241 >       <TT
242 CLASS="LITERAL"
243 ><A
244 HREF="actions-file.html#INSPECT-JPEGS"
245 >inspect-jpegs</A
246 ></TT
247 >
248       </P
249 ></LI
250 ><LI
251 ><P
252 >       <TT
253 CLASS="LITERAL"
254 ><A
255 HREF="actions-file.html#OVERWRITE-LAST-MODIFIED"
256 >overwrite-last-modified</A
257 ></TT
258 >
259       </P
260 ></LI
261 ><LI
262 ><P
263 >       <TT
264 CLASS="LITERAL"
265 ><A
266 HREF="actions-file.html#REDIRECT"
267 >redirect</A
268 ></TT
269 >
270       </P
271 ></LI
272 ><LI
273 ><P
274 >       <TT
275 CLASS="LITERAL"
276 ><A
277 HREF="actions-file.html#TREAT-FORBIDDEN-CONNECTS-LIKE-BLOCKS"
278 >treat-forbidden-connects-like-blocks</A
279 ></TT
280 >
281       </P
282 ></LI
283 ></UL
284 >
285   </P
286 ><P
287 >     In addition, <TT
288 CLASS="LITERAL"
289 ><A
290 HREF="actions-file.html#FAST-REDIRECTS"
291 >fast-redirects</A
292 ></TT
293 >
294      has been significantly improved with enhanced syntax.
295   </P
296 ><P
297 >     And <TT
298 CLASS="LITERAL"
299 ><A
300 HREF="actions-file.html#HIDE-REFERRER"
301 >hide-referrer</A
302 ></TT
303 >
304      has a new option, <TT
305 CLASS="LITERAL"
306 >conditional block</TT
307 >.
308    </P
309 ></LI
310 ><LI
311 ><P
312 >    <SPAN
313 CLASS="APPLICATION"
314 >MS-Windows</SPAN
315 > versions can now be 
316     <A
317 HREF="installation.html#INSTALLATION-PACK-WIN"
318 >installed and 
319     started as a <SPAN
320 CLASS="emphasis"
321 ><I
322 CLASS="EMPHASIS"
323 >Windows service</I
324 ></SPAN
325 ></A
326 >.
327    </P
328 ></LI
329 ><LI
330 ><P
331 >    <TT
332 CLASS="FILENAME"
333 >config</TT
334 > has two new options: 
335     <A
336 HREF="config.html#ENABLE-REMOTE-HTTP-TOGGLE"
337 >enable-remote-http-toggle</A
338 >, 
339     and <A
340 HREF="config.html#FORWARDED-CONNECT-RETRIES"
341 >forwarded-connect-retries</A
342 >.
343    </P
344 ><P
345 >    And there is improved handling of the <A
346 HREF="config.html#USER-MANUAL"
347 >user-manual</A
348 >
349     option, for placing documentation and help files on the local system.
350    </P
351 ></LI
352 ><LI
353 ><P
354 >    There are six new <A
355 HREF="actions-file.html#FILTER"
356 >filters</A
357 >.
358    </P
359 ></LI
360 ><LI
361 ><P
362 >    Actions files problems and suggestions are now being directed to: 
363     <A
364 HREF="http://sourceforge.net/tracker/?group_id=11118&atid=460288"
365 TARGET="_top"
366 >http://sourceforge.net/tracker/?group_id=11118&#38;atid=460288</A
367 >.
368     Please use this to report such configuration related problems as missed
369     ads, sites that don't function properly due to one action or another, 
370     innocent images being blocked, etc.
371    </P
372 ></LI
373 ><LI
374 ><P
375 >    In addition, there are numerous bug fixes and significant enhancements,
376     including error pages should no longer be cached if the problem is fixed,
377     much better DNS error handling, and various logging improvements.
378    </P
379 ></LI
380 ><LI
381 ><P
382 >    The default actions setting is now <TT
383 CLASS="LITERAL"
384 >Cautious</TT
385 >. Previous
386     releases had a default setting of <TT
387 CLASS="LITERAL"
388 >Medium</TT
389 >. Experienced
390     users may want to adjust this, as it is fairly conservative by <SPAN
391 CLASS="APPLICATION"
392 >Privoxy</SPAN
393 >
394     standards and past practices. See <A
395 HREF="http://config.privoxy.org/edit-actions-list?f=default"
396 TARGET="_top"
397 >    http://config.privoxy.org/edit-actions-list?f=default</A
398 >. New users
399     should try the default settings for a while before turning up the volume.
400    </P
401 ></LI
402 ></UL
403 ></P
404 ><DIV
405 CLASS="SECT2"
406 ><H2
407 CLASS="SECT2"
408 ><A
409 NAME="UPGRADERSNOTE"
410 ></A
411 >3.1. Note to Upgraders</H2
412 ><P
413 > A quick list of things to be aware of before upgrading from earlier 
414  versions of <SPAN
415 CLASS="APPLICATION"
416 >Privoxy</SPAN
417 >:</P
418 ><P
419 > <P
420 ></P
421 ><UL
422 ><LI
423 ><P
424 >  
425     Some installers may remove earlier versions completely, including 
426     configuration files. Save any important configuration files!
427   </P
428 ></LI
429 ><LI
430 ><P
431 >  
432    On the other hand, other installers may not overwrite any existing configuration 
433    files, thinking you will want to do that. You may want to manually check 
434    your saved files against the newer versions to see if the improvements have
435    merit, or whether there are new options that you may want to consider.
436    There are a number of new features, but most won't be available unless 
437    these features are incorporated into your configuration somehow.
438   </P
439 ></LI
440 ><LI
441 ><P
442 >     See the full documentation on 
443      <TT
444 CLASS="LITERAL"
445 ><A
446 HREF="actions-file.html#FAST-REDIRECTS"
447 >fast-redirects</A
448 ></TT
449 >
450      which has changed syntax, and will require adjustments to local configs, 
451      such as <TT
452 CLASS="FILENAME"
453 >user.action</TT
454 >. You must reference the new 
455      syntax: 
456    </P
457 ><P
458 > <TABLE
459 BORDER="0"
460 BGCOLOR="#E0E0E0"
461 WIDTH="90%"
462 ><TR
463 ><TD
464 ><PRE
465 CLASS="SCREEN"
466 >  { +fast-redirects{check-decoded-url} }
467    .example.com
468    mybank.com
469    .google.</PRE
470 ></TD
471 ></TR
472 ></TABLE
473 ></P
474 ></LI
475 ><LI
476 ><P
477 >     The <TT
478 CLASS="FILENAME"
479 >jarfile</TT
480 >, 
481      <A
482 HREF="http://en.wikipedia.org/wiki/Browser_cookie"
483 TARGET="_top"
484 >cookie</A
485 > logger, is off by default now.
486     </P
487 ></LI
488 ><LI
489 ><P
490 >  
491    What constitutes a <SPAN
492 CLASS="QUOTE"
493 >"default"</SPAN
494 > configuration has changed, 
495    and you may want to review which actions are <SPAN
496 CLASS="QUOTE"
497 >"on"</SPAN
498 > by 
499    default. This is primarily a matter of emphasis, but some features 
500    you may have been used to, may now be <SPAN
501 CLASS="QUOTE"
502 >"off"</SPAN
503 > by default.
504    There are also a number of new actions and filters you may want to
505    consider, most of which are not incorporated into the default settings as
506    yet (see above).
507   </P
508 ></LI
509 ><LI
510 ><P
511 >   
512    Some installers may not automatically start
513    <SPAN
514 CLASS="APPLICATION"
515 >Privoxy</SPAN
516 > after installation.
517   </P
518 ></LI
519 ></UL
520 ></P
521 ></DIV
522 ></DIV
523 ><DIV
524 CLASS="NAVFOOTER"
525 ><HR
526 ALIGN="LEFT"
527 WIDTH="100%"><TABLE
528 SUMMARY="Footer navigation table"
529 WIDTH="100%"
530 BORDER="0"
531 CELLPADDING="0"
532 CELLSPACING="0"
533 ><TR
534 ><TD
535 WIDTH="33%"
536 ALIGN="left"
537 VALIGN="top"
538 ><A
539 HREF="installation.html"
540 ACCESSKEY="P"
541 >Prev</A
542 ></TD
543 ><TD
544 WIDTH="34%"
545 ALIGN="center"
546 VALIGN="top"
547 ><A
548 HREF="index.html"
549 ACCESSKEY="H"
550 >Home</A
551 ></TD
552 ><TD
553 WIDTH="33%"
554 ALIGN="right"
555 VALIGN="top"
556 ><A
557 HREF="quickstart.html"
558 ACCESSKEY="N"
559 >Next</A
560 ></TD
561 ></TR
562 ><TR
563 ><TD
564 WIDTH="33%"
565 ALIGN="left"
566 VALIGN="top"
567 >Installation</TD
568 ><TD
569 WIDTH="34%"
570 ALIGN="center"
571 VALIGN="top"
572 >&nbsp;</TD
573 ><TD
574 WIDTH="33%"
575 ALIGN="right"
576 VALIGN="top"
577 >Quickstart to Using Privoxy</TD
578 ></TR
579 ></TABLE
580 ></DIV
581 ></BODY
582 ></HTML
583 >