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