Sync generated html with sgml source.
[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 >    Header filtering can be done with dedicated header filters now. As a result
93     the actions <SPAN
94 CLASS="QUOTE"
95 >"filter-client-headers"</SPAN
96 > and <SPAN
97 CLASS="QUOTE"
98 >"filter-server-headers"</SPAN
99 >
100     that were introduced with <SPAN
101 CLASS="APPLICATION"
102 >Privoxy 3.0.5</SPAN
103 > to apply
104     the content filters to the headers as, well have been removed again.
105    </P
106 ></LI
107 ></UL
108 ></P
109 ><DIV
110 CLASS="SECT2"
111 ><H2
112 CLASS="SECT2"
113 ><A
114 NAME="UPGRADERSNOTE"
115 >3.1. Note to Upgraders</A
116 ></H2
117 ><P
118 > A quick list of things to be aware of before upgrading from earlier 
119  versions of <SPAN
120 CLASS="APPLICATION"
121 >Privoxy</SPAN
122 >:</P
123 ><P
124 > <P
125 ></P
126 ><UL
127 ><LI
128 ><P
129 >  
130     Some installers may remove earlier versions completely, including 
131     configuration files. Save any important configuration files!
132   </P
133 ></LI
134 ><LI
135 ><P
136 >  
137    On the other hand, other installers may not overwrite any existing configuration 
138    files, thinking you will want to do that. You may want to manually check 
139    your saved files against the newer versions to see if the improvements have
140    merit, or whether there are new options that you may want to consider.
141    There are a number of new features, but most won't be available unless 
142    these features are incorporated into your configuration somehow.
143   </P
144 ></LI
145 ><LI
146 ><P
147 >     See the full documentation on 
148      <TT
149 CLASS="LITERAL"
150 ><A
151 HREF="actions-file.html#FAST-REDIRECTS"
152 >fast-redirects</A
153 ></TT
154 >
155      which has changed syntax, and will require adjustments to local configs, 
156      such as <TT
157 CLASS="FILENAME"
158 >user.action</TT
159 >. You must reference the new 
160      syntax: 
161    </P
162 ><P
163 > <TABLE
164 BORDER="0"
165 BGCOLOR="#E0E0E0"
166 WIDTH="90%"
167 ><TR
168 ><TD
169 ><PRE
170 CLASS="SCREEN"
171 >  { +fast-redirects{check-decoded-url} }
172    .example.com
173    mybank.com
174    .google.</PRE
175 ></TD
176 ></TR
177 ></TABLE
178 ></P
179 ></LI
180 ><LI
181 ><P
182 >     The <TT
183 CLASS="FILENAME"
184 >jarfile</TT
185 >, 
186      <A
187 HREF="http://en.wikipedia.org/wiki/Browser_cookie"
188 TARGET="_top"
189 >cookie</A
190 > logger, is off by default now.
191     </P
192 ></LI
193 ><LI
194 ><P
195 >  
196    What constitutes a <SPAN
197 CLASS="QUOTE"
198 >"default"</SPAN
199 > configuration has changed, 
200    and you may want to review which actions are <SPAN
201 CLASS="QUOTE"
202 >"on"</SPAN
203 > by 
204    default. This is primarily a matter of emphasis, but some features 
205    you may have been used to, may now be <SPAN
206 CLASS="QUOTE"
207 >"off"</SPAN
208 > by default.
209    There are also a number of new actions and filters you may want to
210    consider, most of which are not fully incorporated into the default
211    settings as yet (see above).
212   </P
213 ></LI
214 ><LI
215 ><P
216 >    The default actions setting is now <TT
217 CLASS="LITERAL"
218 >Cautious</TT
219 >. Previous
220     releases had a default setting of <TT
221 CLASS="LITERAL"
222 >Medium</TT
223 >. Experienced
224     users may want to adjust this, as it is fairly conservative by <SPAN
225 CLASS="APPLICATION"
226 >Privoxy</SPAN
227 >
228     standards and past practices. See <A
229 HREF="http://config.privoxy.org/edit-actions-list?f=default"
230 TARGET="_top"
231 >    http://config.privoxy.org/edit-actions-list?f=default</A
232 >. New users
233     should try the default settings for a while before turning up the volume.
234    </P
235 ></LI
236 ><LI
237 ><P
238 >    The default setting has filtering turned <SPAN
239 CLASS="emphasis"
240 ><I
241 CLASS="EMPHASIS"
242 >off</I
243 ></SPAN
244 >, which
245     subsequently means that compression is <SPAN
246 CLASS="emphasis"
247 ><I
248 CLASS="EMPHASIS"
249 >on</I
250 ></SPAN
251 >. Remember
252     that filtering does not work on compressed pages, so if you use, or want to
253     use, filtering, you will need to force compression off. Example:
254    </P
255 ><P
256 > <TABLE
257 BORDER="0"
258 BGCOLOR="#E0E0E0"
259 WIDTH="90%"
260 ><TR
261 ><TD
262 ><PRE
263 CLASS="SCREEN"
264 >  { +<A
265 HREF="actions-file.html#FILTER"
266 >filter</A
267 >{google}  +<A
268 HREF="actions-file.html#PREVENT-COMPRESSION"
269 >prevent-compression</A
270 > }
271    .google.</PRE
272 ></TD
273 ></TR
274 ></TABLE
275 >
276    </P
277 ><P
278 >    Or if you use a number of filters, or filter many sites, you may just want
279     to turn off compression for all sites in
280     <TT
281 CLASS="FILENAME"
282 >default.action</TT
283 > (or
284     <TT
285 CLASS="FILENAME"
286 >user.action</TT
287 >). 
288    </P
289 ></LI
290 ><LI
291 ><P
292 >   Also, <A
293 HREF="actions-file.html#SESSION-COOKIES-ONLY"
294 >session-cookies-only</A
295 > is 
296    off by default now. If you've liked this feature in the past, you may want 
297    to turn it back on in <TT
298 CLASS="FILENAME"
299 >user.action</TT
300 > now.
301   </P
302 ></LI
303 ><LI
304 ><P
305 >   
306    Some installers may not automatically start
307    <SPAN
308 CLASS="APPLICATION"
309 >Privoxy</SPAN
310 > after installation.
311   </P
312 ></LI
313 ></UL
314 ></P
315 ></DIV
316 ></DIV
317 ><DIV
318 CLASS="NAVFOOTER"
319 ><HR
320 ALIGN="LEFT"
321 WIDTH="100%"><TABLE
322 SUMMARY="Footer navigation table"
323 WIDTH="100%"
324 BORDER="0"
325 CELLPADDING="0"
326 CELLSPACING="0"
327 ><TR
328 ><TD
329 WIDTH="33%"
330 ALIGN="left"
331 VALIGN="top"
332 ><A
333 HREF="installation.html"
334 ACCESSKEY="P"
335 >Prev</A
336 ></TD
337 ><TD
338 WIDTH="34%"
339 ALIGN="center"
340 VALIGN="top"
341 ><A
342 HREF="index.html"
343 ACCESSKEY="H"
344 >Home</A
345 ></TD
346 ><TD
347 WIDTH="33%"
348 ALIGN="right"
349 VALIGN="top"
350 ><A
351 HREF="quickstart.html"
352 ACCESSKEY="N"
353 >Next</A
354 ></TD
355 ></TR
356 ><TR
357 ><TD
358 WIDTH="33%"
359 ALIGN="left"
360 VALIGN="top"
361 >Installation</TD
362 ><TD
363 WIDTH="34%"
364 ALIGN="center"
365 VALIGN="top"
366 >&nbsp;</TD
367 ><TD
368 WIDTH="33%"
369 ALIGN="right"
370 VALIGN="top"
371 >Quickstart to Using Privoxy</TD
372 ></TR
373 ></TABLE
374 ></DIV
375 ></BODY
376 ></HTML
377 >