doc/webserver/user-manual/whatsnew.html

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