doc/webserver/user-manual/whatsnew.html

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