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