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