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