1a0036b3ea9618394621698948557cdd3cb62460
[privoxy.git] / doc / webserver / user-manual / whatsnew.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01
2 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
3 <html>
4   <head>
5     <title>
6       What's New in this Release
7     </title>
8     <meta name="GENERATOR" content=
9     "Modular DocBook HTML Stylesheet Version 1.79">
10     <link rel="HOME" title="Privoxy 3.0.25 User Manual" href="index.html">
11     <link rel="PREVIOUS" title="Installation" href="installation.html">
12     <link rel="NEXT" title="Quickstart to Using Privoxy" href=
13     "quickstart.html">
14     <link rel="STYLESHEET" type="text/css" href="../p_doc.css">
15     <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
16     <link rel="STYLESHEET" type="text/css" href="p_doc.css">
17   </head>
18   <body class="SECT1" bgcolor="#EEEEEE" text="#000000" link="#0000FF" vlink=
19   "#840084" alink="#0000FF">
20     <div class="NAVHEADER">
21       <table summary="Header navigation table" width="100%" border="0"
22       cellpadding="0" cellspacing="0">
23         <tr>
24           <th colspan="3" align="center">
25             Privoxy 3.0.25 User Manual
26           </th>
27         </tr>
28         <tr>
29           <td width="10%" align="left" valign="bottom">
30             <a href="installation.html" accesskey="P">Prev</a>
31           </td>
32           <td width="80%" align="center" valign="bottom">
33           </td>
34           <td width="10%" align="right" valign="bottom">
35             <a href="quickstart.html" accesskey="N">Next</a>
36           </td>
37         </tr>
38       </table>
39       <hr align="LEFT" width="100%">
40     </div>
41     <div class="SECT1">
42       <h1 class="SECT1">
43         <a name="WHATSNEW">3. What's New in this Release</a>
44       </h1>
45       <p>
46         <span class="APPLICATION">Privoxy 3.0.25</span> beta introduces
47         client-specific tags and includes a couple of minor improvements. It
48         will be followed by a stable release in the near future.
49       </p>
50       <p>
51       </p>
52       <ul>
53         <li>
54           <p>
55             Bug fixes:
56           </p>
57           <ul>
58             <li>
59               <p>
60                 Always use the current toggle state for new requests.
61                 Previously new requests on reused connections inherited the
62                 toggle state from the previous request even though the toggle
63                 state could have changed. Reported by Robert Klemme.
64               </p>
65             </li>
66             <li>
67               <p>
68                 Fixed two buffer-overflows in the (deprecated) static pcre
69                 code. These bugs are not considered security issues as the
70                 input is trusted. Found with afl-fuzz and ASAN.
71               </p>
72             </li>
73           </ul>
74         </li>
75         <li>
76           <p>
77             General improvements:
78           </p>
79           <ul>
80             <li>
81               <p>
82                 Added support for client-specific tags which allow Privoxy
83                 admins to pre-define tags that are set for all requests from
84                 clients that previously opted in through the CGI interface.
85                 They are useful in multi-user setups where admins may want to
86                 allow users to disable certain actions and filters for
87                 themselves without affecting others. In single-user setups
88                 they are useful to allow more fine-grained toggling. For
89                 example to disable request blocking while still crunching
90                 cookies, or to disable experimental filters only. This is an
91                 experimental feature, the syntax and behaviour may change in
92                 future versions. Sponsored by Robert Klemme.
93               </p>
94             </li>
95             <li>
96               <p>
97                 Dynamic filters and taggers now support a $listen-address
98                 variable which contains the address the request came in on.
99                 For external filters the variable is called
100                 $PRIVOXY_LISTEN_ADDRESS. Original patch contributed by
101                 pursievro.
102               </p>
103             </li>
104             <li>
105               <p>
106                 Add client-header-tagger 'listen-address'.
107               </p>
108             </li>
109             <li>
110               <p>
111                 Include the listen-address in the log message when logging
112                 new requests. Patch contributed by pursievro.
113               </p>
114             </li>
115             <li>
116               <p>
117                 Turn invalid max-client-connections values into fatal errors.
118               </p>
119             </li>
120             <li>
121               <p>
122                 The show-status page now shows whether or not dates before
123                 1970 and after 2038 are expected to be handled properly. This
124                 is mainly useful for Privoxy-Regression-Test but could also
125                 come handy when dealing with time-related support requests.
126               </p>
127             </li>
128             <li>
129               <p>
130                 On Mac OS X the thread id in log messages are more likely to
131                 be unique now.
132               </p>
133             </li>
134             <li>
135               <p>
136                 When complaining about missing filters, the filter type is
137                 logged as well.
138               </p>
139             </li>
140             <li>
141               <p>
142                 A couple of harmless coverity warnings were silenced (CID
143                 #161202, CID #161203, CID #161211).
144               </p>
145             </li>
146           </ul>
147         </li>
148         <li>
149           <p>
150             Action file improvements:
151           </p>
152           <ul>
153             <li>
154               <p>
155                 Filtering is disabled for Range requests to let download
156                 resumption and Windows updates work with the default
157                 configuration.
158               </p>
159             </li>
160             <li>
161               <p>
162                 Unblock ".ardmediathek.de/". Reported by ThTomate in #932.
163               </p>
164             </li>
165           </ul>
166         </li>
167         <li>
168           <p>
169             Documentation improvements:
170           </p>
171           <ul>
172             <li>
173               <p>
174                 Add FAQ entry for crashes caused by memory limits.
175               </p>
176             </li>
177             <li>
178               <p>
179                 Remove obsolete FAQ entry about a bug in PHP 4.2.3.
180               </p>
181             </li>
182             <li>
183               <p>
184                 Mention the new mailing lists were appropriate. As the
185                 archives have not been migrated, continue to mention the
186                 archives at SF in the contacting section for now.
187               </p>
188             </li>
189             <li>
190               <p>
191                 Note that the templates should be adjusted if Privoxy is
192                 running as intercepting proxy without getting all requests.
193               </p>
194             </li>
195             <li>
196               <p>
197                 A bunch of links were converted to https://.
198               </p>
199             </li>
200             <li>
201               <p>
202                 Rephrase onion service paragraph to make it more obvious that
203                 Tor is involved and that the whole website (and not just the
204                 homepage) is available as onion service.
205               </p>
206             </li>
207             <li>
208               <p>
209                 Streamline the "More information" section on the homepage
210                 further by additionally ditching the link to the 'See also'
211                 section of the user manual. The section contains mostly links
212                 that are directly reachable from the homepage already and the
213                 rest is not significant enough to get a link from the
214                 homepage.
215               </p>
216             </li>
217             <li>
218               <p>
219                 Change the add-header{} example to set the DNT header and use
220                 a complete section to make copy and pasting more convenient.
221                 Add a comment to make it obvious that adding the header is
222                 not recommended for obvious reasons. Using the DNT header as
223                 example was suggested by Leo Wzukw.
224               </p>
225             </li>
226             <li>
227               <p>
228                 Streamline the support-and-service template Instead of
229                 linking to the various support trackers (whose URLs hopefully
230                 change soon), link to the contact section of the user manual
231                 to increase the chances that users actually read it.
232               </p>
233             </li>
234             <li>
235               <p>
236                 Add a FAQ entry for tainted sockets.
237               </p>
238             </li>
239             <li>
240               <p>
241                 More sections in the documentation have stable URLs now.
242               </p>
243             </li>
244             <li>
245               <p>
246                 FAQ: Explain why 'ping config.privoxy.org' is not expected to
247                 reach a local Privoxy installation.
248               </p>
249             </li>
250             <li>
251               <p>
252                 Note that donations done through Zwiebelfreunde e.V.
253                 currently can't be checked automatically.
254               </p>
255             </li>
256             <li>
257               <p>
258                 Updated section regarding starting Privoxy under OS X.
259               </p>
260             </li>
261             <li>
262               <p>
263                 Use dedicated start instructions for FreeBSD and ElectroBSD.
264               </p>
265             </li>
266             <li>
267               <p>
268                 Removed release instructions for AIX. They haven't been
269                 working for years and unsurprisingly nobody seems to care.
270               </p>
271             </li>
272             <li>
273               <p>
274                 Removed obsolete reference to the solaris-dist target.
275               </p>
276             </li>
277             <li>
278               <p>
279                 Updated the release instructions for FreeBSD.
280               </p>
281             </li>
282             <li>
283               <p>
284                 Removed unfinished release instructions for Amiga OS and
285                 HP-UX 11.
286               </p>
287             </li>
288             <li>
289               <p>
290                 Added a pointer to the Cygwin Time Machine for getting the
291                 last release of Cygwin version 1.5 to use for building
292                 Privoxy on Windows.
293               </p>
294             </li>
295             <li>
296               <p>
297                 Various typos have been fixed.
298               </p>
299             </li>
300           </ul>
301         </li>
302         <li>
303           <p>
304             Infrastructure improvements:
305           </p>
306           <ul>
307             <li>
308               <p>
309                 The website is no longer hosted at SourceForge and can be
310                 reached through https now.
311               </p>
312             </li>
313             <li>
314               <p>
315                 The mailing lists at SourceForge have been deprecated, you
316                 can subscribe to the new ones at: https://lists.privoxy.org/
317               </p>
318             </li>
319             <li>
320               <p>
321                 Migrating the remaining services from SourceForge is work in
322                 progress (TODO list item #53).
323               </p>
324             </li>
325           </ul>
326         </li>
327         <li>
328           <p>
329             Build system improvements:
330           </p>
331           <ul>
332             <li>
333               <p>
334                 Add configure argument to optimistically redefine FD_SETSIZE
335                 with the intent to change the maximum number of client
336                 connections Privoxy can handle. Only works with some libcs.
337                 Sponsored by Robert Klemme.
338               </p>
339             </li>
340             <li>
341               <p>
342                 Let the tarball-dist target skip files in ".git".
343               </p>
344             </li>
345             <li>
346               <p>
347                 Let the tarball-dist target work in cwds other than current.
348               </p>
349             </li>
350             <li>
351               <p>
352                 Make the 'clean' target faster when run from a git
353                 repository.
354               </p>
355             </li>
356             <li>
357               <p>
358                 Include tools in the generic distribution.
359               </p>
360             </li>
361             <li>
362               <p>
363                 Let the gen-dist target work in cwds other than current.
364               </p>
365             </li>
366             <li>
367               <p>
368                 Sort find output that is used for distribution tarballs to
369                 get reproducible results.
370               </p>
371             </li>
372             <li>
373               <p>
374                 Don't add '-src' to the name of the tar ball generated by the
375                 gen-dist target. The package isn't a source distribution but
376                 a binary package. While at it, use a variable for the name to
377                 reduce the chances that the various references get out of
378                 sync and fix the gen-upload target which was looking in the
379                 wrong directory.
380               </p>
381             </li>
382             <li>
383               <p>
384                 Add regression-tests.action to the files that are
385                 distributed.
386               </p>
387             </li>
388             <li>
389               <p>
390                 The gen-dist target which was broken since 2002 (r1.92) has
391                 been fixed.
392               </p>
393             </li>
394             <li>
395               <p>
396                 Remove genclspec.sh which has been obsolete since 2009.
397               </p>
398             </li>
399             <li>
400               <p>
401                 Remove obsolete reference to Redhat spec file.
402               </p>
403             </li>
404             <li>
405               <p>
406                 Remove the obsolete announce target which has been commented
407                 out years ago.
408               </p>
409             </li>
410             <li>
411               <p>
412                 Let rsync skip files if the checksums match.
413               </p>
414             </li>
415           </ul>
416         </li>
417         <li>
418           <p>
419             Privoxy-Regression-Test:
420           </p>
421           <ul>
422             <li>
423               <p>
424                 Add a "Default level offset" directive which can be used to
425                 change the default level by a given value. This directive
426                 affects all tests located after it until the end of the file
427                 or a another "Default level offset" directive is reached. The
428                 purpose of this directive is to make it more convenient to
429                 skip similar tests in a given file without having to remove
430                 or disable the tests completely.
431               </p>
432             </li>
433             <li>
434               <p>
435                 Let test level 17 depend on FEATURE_64_BIT_TIME_T instead of
436                 FEATURE_PTHREAD which has no direct connection to the time_t
437                 size.
438               </p>
439             </li>
440             <li>
441               <p>
442                 Fix indentation in perldoc examples.
443               </p>
444             </li>
445             <li>
446               <p>
447                 Don't overlook directives in the first line of the action
448                 file.
449               </p>
450             </li>
451             <li>
452               <p>
453                 Bump version to 0.7.
454               </p>
455             </li>
456             <li>
457               <p>
458                 Fix detection of the Privoxy version now that https:// is
459                 used for the website.
460               </p>
461             </li>
462           </ul>
463         </li>
464       </ul>
465
466       <div class="SECT2">
467         <h2 class="SECT2">
468           <a name="UPGRADERSNOTE">3.1. Note to Upgraders</a>
469         </h2>
470         <p>
471           A quick list of things to be aware of before upgrading from earlier
472           versions of <span class="APPLICATION">Privoxy</span>:
473         </p>
474         <p>
475         </p>
476         <ul>
477           <li>
478             <p>
479               The recommended way to upgrade <span class=
480               "APPLICATION">Privoxy</span> is to backup your old
481               configuration files, install the new ones, verify that <span
482               class="APPLICATION">Privoxy</span> is working correctly and
483               finally merge back your changes using <span class=
484               "APPLICATION">diff</span> and maybe <span class=
485               "APPLICATION">patch</span>.
486             </p>
487             <p>
488               There are a number of new features in each <span class=
489               "APPLICATION">Privoxy</span> release and most of them have to
490               be explicitly enabled in the configuration files. Old
491               configuration files obviously don't do that and due to syntax
492               changes using old configuration files with a new <span class=
493               "APPLICATION">Privoxy</span> isn't always possible anyway.
494             </p>
495           </li>
496           <li>
497             <p>
498               Note that some installers remove earlier versions completely,
499               including configuration files, therefore you should really save
500               any important configuration files!
501             </p>
502           </li>
503           <li>
504             <p>
505               On the other hand, other installers don't overwrite existing
506               configuration files, thinking you will want to do that
507               yourself.
508             </p>
509           </li>
510           <li>
511             <p>
512               In the default configuration only fatal errors are logged now.
513               You can change that in the <a href="config.html#DEBUG">debug
514               section</a> of the configuration file. You may also want to
515               enable more verbose logging until you verified that the new
516               <span class="APPLICATION">Privoxy</span> version is working as
517               expected.
518             </p>
519           </li>
520           <li>
521             <p>
522               Three other config file settings are now off by default: <a
523               href=
524               "config.html#ENABLE-REMOTE-TOGGLE">enable-remote-toggle</a>, <a
525               href=
526               "config.html#ENABLE-REMOTE-HTTP-TOGGLE">enable-remote-http-toggle</a>,
527               and <a href=
528               "config.html#ENABLE-EDIT-ACTIONS">enable-edit-actions</a>. If
529               you use or want these, you will need to explicitly enable them,
530               and be aware of the security issues involved.
531             </p>
532           </li>
533         </ul>
534       </div>
535     </div>
536     <div class="NAVFOOTER">
537       <hr align="LEFT" width="100%">
538       <table summary="Footer navigation table" width="100%" border="0"
539       cellpadding="0" cellspacing="0">
540         <tr>
541           <td width="33%" align="left" valign="top">
542             <a href="installation.html" accesskey="P">Prev</a>
543           </td>
544           <td width="34%" align="center" valign="top">
545             <a href="index.html" accesskey="H">Home</a>
546           </td>
547           <td width="33%" align="right" valign="top">
548             <a href="quickstart.html" accesskey="N">Next</a>
549           </td>
550         </tr>
551         <tr>
552           <td width="33%" align="left" valign="top">
553             Installation
554           </td>
555           <td width="34%" align="center" valign="top">
556             &nbsp;
557           </td>
558           <td width="33%" align="right" valign="top">
559             Quickstart to Using Privoxy
560           </td>
561         </tr>
562       </table>
563     </div>
564   </body>
565 </html>
566