Updated build of html docs for 3.0.11 release.
[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.11 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"><META
21 HTTP-EQUIV="Content-Type"
22 CONTENT="text/html;
23 charset=ISO-8859-1">
24 <LINK REL="STYLESHEET" TYPE="text/css" HREF="p_doc.css">
25 </head
26 ><BODY
27 CLASS="SECT1"
28 BGCOLOR="#EEEEEE"
29 TEXT="#000000"
30 LINK="#0000FF"
31 VLINK="#840084"
32 ALINK="#0000FF"
33 ><DIV
34 CLASS="NAVHEADER"
35 ><TABLE
36 SUMMARY="Header navigation table"
37 WIDTH="100%"
38 BORDER="0"
39 CELLPADDING="0"
40 CELLSPACING="0"
41 ><TR
42 ><TH
43 COLSPAN="3"
44 ALIGN="center"
45 >Privoxy 3.0.11 User Manual</TH
46 ></TR
47 ><TR
48 ><TD
49 WIDTH="10%"
50 ALIGN="left"
51 VALIGN="bottom"
52 ><A
53 HREF="installation.html"
54 ACCESSKEY="P"
55 >Prev</A
56 ></TD
57 ><TD
58 WIDTH="80%"
59 ALIGN="center"
60 VALIGN="bottom"
61 ></TD
62 ><TD
63 WIDTH="10%"
64 ALIGN="right"
65 VALIGN="bottom"
66 ><A
67 HREF="quickstart.html"
68 ACCESSKEY="N"
69 >Next</A
70 ></TD
71 ></TR
72 ></TABLE
73 ><HR
74 ALIGN="LEFT"
75 WIDTH="100%"></DIV
76 ><DIV
77 CLASS="SECT1"
78 ><H1
79 CLASS="SECT1"
80 ><A
81 NAME="WHATSNEW"
82 >3. What's New in this Release</A
83 ></H1
84 ><P
85 > There are only a few improvements and new features since
86  <SPAN
87 CLASS="APPLICATION"
88 >Privoxy 3.0.10</SPAN
89 >, the last stable release:</P
90 ><P
91 > <P
92 ></P
93 ><UL
94 ><LI
95 ><P
96 >    On most platforms, outgoing connections can be kept alive and
97     reused if the server supports it. Whether or not this improves
98     things depends on the connection.
99    </P
100 ></LI
101 ><LI
102 ><P
103 >    When dropping privileges, membership in supplementary groups
104     is given up as well. Not doing that can lead to Privoxy running
105     with more rights than necessary and violates the principle of
106     least privilege. Users of the --user option are advised to update.
107     Thanks to Matthias Drochner for reporting the problem,
108     providing the initial patch and testing the final version.
109    </P
110 ></LI
111 ><LI
112 ><P
113 >    Passing invalid users or groups with the --user option
114     didn't lead to program exit. Regression introduced in 3.0.7.
115    </P
116 ></LI
117 ><LI
118 ><P
119 >    The match all section has been moved from default.action
120     to a new file called match-all.action. As a result the
121     default.action no longer needs to be touched by the user
122     and can be safely overwritten by updates.
123    </P
124 ></LI
125 ><LI
126 ><P
127 >    The standard.action file has been removed. Its content
128     is now part of the default.action file.
129    </P
130 ></LI
131 ><LI
132 ><P
133 >    In some situations the logged content length was slightly too low.
134    </P
135 ></LI
136 ><LI
137 ><P
138 >    Crunched requests are logged with their own log level.
139     If you used "debug 1" in the past, you'll probably want
140     to additionally enable "debug 1024", otherwise only passed
141     requests will be logged. If you only care about crunched
142     requests, simply replace "debug 1" with "debug 1024".
143    </P
144 ></LI
145 ><LI
146 ><P
147 >    The crunch reason has been moved to the beginning of the
148     crunch message. For HTTP URLs, the protocol is logged as well.
149    </P
150 ></LI
151 ><LI
152 ><P
153 >    Log messages are shortened by printing the thread id on its
154     own (as opposed to putting it inside the string "Privoxy()").
155    </P
156 ></LI
157 ><LI
158 ><P
159 >    The config option socket-timeout has been added to control
160     the time Privoxy waits for data to arrive on a socket.
161    </P
162 ></LI
163 ><LI
164 ><P
165 >    Support for remote toggling is controlled by the configure
166     option --disable-toggle only. In previous versions it also
167     depended on the action editor and thus configuring with the
168     --disable-editor option would disable remote toggling support
169     as well.
170    </P
171 ></LI
172 ><LI
173 ><P
174 >    Requests with invalid HTTP versions are rejected.
175    </P
176 ></LI
177 ><LI
178 ><P
179 >    The template symbol @date@ can be used to include a date(1)-like
180     time string. Initial patch submitted by Endre Szabo.
181    </P
182 ></LI
183 ><LI
184 ><P
185 >    Responses from shoutcast servers are accepted again.
186     Problem reported and fix suggested by Stefan.
187    </P
188 ></LI
189 ><LI
190 ><P
191 >    The hide-forwarded-for-headers action has been replaced with
192     the change-x-forwarded-for{} action which can also be used to
193     add X-Forwarded-For headers. The latter functionality already
194     existed in Privoxy versions prior to 3.0.7 but has been removed
195     as it was often used unintentionally (by not using the
196     hide-forwarded-for-headers action).
197    </P
198 ></LI
199 ><LI
200 ><P
201 >    A "clear log" view option was added to the mingw32 version
202     to clear out all of the lines in the Privoxy log window.
203     Based on a patch submitted by T Ford.
204    </P
205 ></LI
206 ><LI
207 ><P
208 >    The mingw32 version uses "critical sections" now, which prevents
209     log message corruption under load. As a side effect, the
210     "no thread-safe PRNG" warning could be removed as well.
211    </P
212 ></LI
213 ><LI
214 ><P
215 >    The mingw32 version's task bar icon is crossed out and
216     the color changed to gray if Privoxy is toggled off.
217    </P
218 ></LI
219 ></UL
220 ></P
221 ><P
222 > This release marks a departure for Privoxy development.</P
223 ><P
224 > Previously, odd numbered releases were considered beta versions and
225  were only released at the end of the development cycle when the code
226  was already believed to be stable. Usually it was, so the stable release
227  contained pretty much the same code, but got a higher version number.
228  In the future we intend to release several snapshots between stable releases.
229  There will probably still be about two stable releases per year,
230  but hopefully about six snapshots instead of the two betas we have now.
231  The intentions is to make testing without CVS access easier.</P
232 ><DIV
233 CLASS="SECT2"
234 ><H2
235 CLASS="SECT2"
236 ><A
237 NAME="UPGRADERSNOTE"
238 >3.1. Note to Upgraders</A
239 ></H2
240 ><P
241 > A quick list of things to be aware of before upgrading from earlier 
242  versions of <SPAN
243 CLASS="APPLICATION"
244 >Privoxy</SPAN
245 >:</P
246 ><P
247 > <P
248 ></P
249 ><UL
250 ><LI
251 ><P
252 >   The recommended way to upgrade <SPAN
253 CLASS="APPLICATION"
254 >Privoxy</SPAN
255 > is to backup your old 
256    configuration files, install the new ones, verify that <SPAN
257 CLASS="APPLICATION"
258 >Privoxy</SPAN
259 >
260    is working correctly and finally merge back your changes using
261    <SPAN
262 CLASS="APPLICATION"
263 >diff</SPAN
264 > and maybe <SPAN
265 CLASS="APPLICATION"
266 >patch</SPAN
267 >.
268   </P
269 ><P
270 >   There are a number of new features in each <SPAN
271 CLASS="APPLICATION"
272 >Privoxy</SPAN
273 > release and
274    most of them have to be explicitly enabled in the configuration
275    files. Old configuration files obviously don't do that and due
276    to syntax changes using old configuration files with a new
277    <SPAN
278 CLASS="APPLICATION"
279 >Privoxy</SPAN
280 > isn't always possible anyway.
281   </P
282 ></LI
283 ><LI
284 ><P
285 >  
286     Note that some installers remove earlier versions completely,
287     including configuration files, therefore you should really save
288     any important configuration files!
289   </P
290 ></LI
291 ><LI
292 ><P
293 >  
294    On the other hand, other installers don't overwrite existing configuration 
295    files, thinking you will want to do that yourself.
296   </P
297 ></LI
298 ><LI
299 ><P
300 >  
301    <TT
302 CLASS="FILENAME"
303 >standard.action</TT
304 > has been merged into
305    the <TT
306 CLASS="FILENAME"
307 >default.action</TT
308 > file.
309   </P
310 ></LI
311 ><LI
312 ><P
313 >   In the default configuration only fatal errors are logged now.
314    You can change that in the <A
315 HREF="config.html#DEBUG"
316 >debug section</A
317 >
318    of the configuration file. You may also want to enable more verbose
319    logging until you verified that the new <SPAN
320 CLASS="APPLICATION"
321 >Privoxy</SPAN
322 > version is working
323    as expected.
324   </P
325 ></LI
326 ><LI
327 ><P
328 >     Three other config file settings are now off by default: 
329      <A
330 HREF="config.html#ENABLE-REMOTE-TOGGLE"
331 >enable-remote-toggle</A
332 >,
333      <A
334 HREF="config.html#ENABLE-REMOTE-HTTP-TOGGLE"
335 >enable-remote-http-toggle</A
336 >,
337      and  <A
338 HREF="config.html#ENABLE-EDIT-ACTIONS"
339 >enable-edit-actions</A
340 >. 
341      If you use or want these, you will need to explicitly enable them, and
342      be aware of the security issues involved. 
343     </P
344 ></LI
345 ></UL
346 ></P
347 ></DIV
348 ></DIV
349 ><DIV
350 CLASS="NAVFOOTER"
351 ><HR
352 ALIGN="LEFT"
353 WIDTH="100%"><TABLE
354 SUMMARY="Footer navigation table"
355 WIDTH="100%"
356 BORDER="0"
357 CELLPADDING="0"
358 CELLSPACING="0"
359 ><TR
360 ><TD
361 WIDTH="33%"
362 ALIGN="left"
363 VALIGN="top"
364 ><A
365 HREF="installation.html"
366 ACCESSKEY="P"
367 >Prev</A
368 ></TD
369 ><TD
370 WIDTH="34%"
371 ALIGN="center"
372 VALIGN="top"
373 ><A
374 HREF="index.html"
375 ACCESSKEY="H"
376 >Home</A
377 ></TD
378 ><TD
379 WIDTH="33%"
380 ALIGN="right"
381 VALIGN="top"
382 ><A
383 HREF="quickstart.html"
384 ACCESSKEY="N"
385 >Next</A
386 ></TD
387 ></TR
388 ><TR
389 ><TD
390 WIDTH="33%"
391 ALIGN="left"
392 VALIGN="top"
393 >Installation</TD
394 ><TD
395 WIDTH="34%"
396 ALIGN="center"
397 VALIGN="top"
398 >&nbsp;</TD
399 ><TD
400 WIDTH="33%"
401 ALIGN="right"
402 VALIGN="top"
403 >Quickstart to Using Privoxy</TD
404 ></TR
405 ></TABLE
406 ></DIV
407 ></BODY
408 ></HTML
409 >