Import ChangeLog.
[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 not printing the thread id
154     on its own (as opposed to putting it inside "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 > For a more detailed list of changes please have a look at the ChangeLog.</P
223 ><DIV
224 CLASS="SECT2"
225 ><H2
226 CLASS="SECT2"
227 ><A
228 NAME="UPGRADERSNOTE"
229 >3.1. Note to Upgraders</A
230 ></H2
231 ><P
232 > A quick list of things to be aware of before upgrading from earlier 
233  versions of <SPAN
234 CLASS="APPLICATION"
235 >Privoxy</SPAN
236 >:</P
237 ><P
238 > <P
239 ></P
240 ><UL
241 ><LI
242 ><P
243 >   The recommended way to upgrade <SPAN
244 CLASS="APPLICATION"
245 >Privoxy</SPAN
246 > is to backup your old 
247    configuration files, install the new ones, verify that <SPAN
248 CLASS="APPLICATION"
249 >Privoxy</SPAN
250 >
251    is working correctly and finally merge back your changes using
252    <SPAN
253 CLASS="APPLICATION"
254 >diff</SPAN
255 > and maybe <SPAN
256 CLASS="APPLICATION"
257 >patch</SPAN
258 >.
259   </P
260 ><P
261 >   There are a number of new features in each <SPAN
262 CLASS="APPLICATION"
263 >Privoxy</SPAN
264 > release and
265    most of them have to be explicitly enabled in the configuration
266    files. Old configuration files obviously don't do that and due
267    to syntax changes using old configuration files with a new
268    <SPAN
269 CLASS="APPLICATION"
270 >Privoxy</SPAN
271 > isn't always possible anyway.
272   </P
273 ></LI
274 ><LI
275 ><P
276 >  
277     Note that some installers remove earlier versions completely,
278     including configuration files, therefore you should really save
279     any important configuration files!
280   </P
281 ></LI
282 ><LI
283 ><P
284 >  
285    On the other hand, other installers don't overwrite existing configuration 
286    files, thinking you will want to do that yourself.
287   </P
288 ></LI
289 ><LI
290 ><P
291 >  
292    <TT
293 CLASS="FILENAME"
294 >standard.action</TT
295 > has been merged into
296    the <TT
297 CLASS="FILENAME"
298 >default.action</TT
299 > file.
300   </P
301 ></LI
302 ><LI
303 ><P
304 >   In the default configuration only fatal errors are logged now.
305    You can change that in the <A
306 HREF="config.html#DEBUG"
307 >debug section</A
308 >
309    of the configuration file. You may also want to enable more verbose
310    logging until you verified that the new <SPAN
311 CLASS="APPLICATION"
312 >Privoxy</SPAN
313 > version is working
314    as expected.
315   </P
316 ></LI
317 ><LI
318 ><P
319 >     Three other config file settings are now off by default: 
320      <A
321 HREF="config.html#ENABLE-REMOTE-TOGGLE"
322 >enable-remote-toggle</A
323 >,
324      <A
325 HREF="config.html#ENABLE-REMOTE-HTTP-TOGGLE"
326 >enable-remote-http-toggle</A
327 >,
328      and  <A
329 HREF="config.html#ENABLE-EDIT-ACTIONS"
330 >enable-edit-actions</A
331 >. 
332      If you use or want these, you will need to explicitly enable them, and
333      be aware of the security issues involved. 
334     </P
335 ></LI
336 ></UL
337 ></P
338 ></DIV
339 ></DIV
340 ><DIV
341 CLASS="NAVFOOTER"
342 ><HR
343 ALIGN="LEFT"
344 WIDTH="100%"><TABLE
345 SUMMARY="Footer navigation table"
346 WIDTH="100%"
347 BORDER="0"
348 CELLPADDING="0"
349 CELLSPACING="0"
350 ><TR
351 ><TD
352 WIDTH="33%"
353 ALIGN="left"
354 VALIGN="top"
355 ><A
356 HREF="installation.html"
357 ACCESSKEY="P"
358 >Prev</A
359 ></TD
360 ><TD
361 WIDTH="34%"
362 ALIGN="center"
363 VALIGN="top"
364 ><A
365 HREF="index.html"
366 ACCESSKEY="H"
367 >Home</A
368 ></TD
369 ><TD
370 WIDTH="33%"
371 ALIGN="right"
372 VALIGN="top"
373 ><A
374 HREF="quickstart.html"
375 ACCESSKEY="N"
376 >Next</A
377 ></TD
378 ></TR
379 ><TR
380 ><TD
381 WIDTH="33%"
382 ALIGN="left"
383 VALIGN="top"
384 >Installation</TD
385 ><TD
386 WIDTH="34%"
387 ALIGN="center"
388 VALIGN="top"
389 >&nbsp;</TD
390 ><TD
391 WIDTH="33%"
392 ALIGN="right"
393 VALIGN="top"
394 >Quickstart to Using Privoxy</TD
395 ></TR
396 ></TABLE
397 ></DIV
398 ></BODY
399 ></HTML
400 >