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 <html>
   4 <head>
   5   <title>What's New in this Release</title>
   6   <meta name="GENERATOR" content="Modular DocBook HTML Stylesheet Version 1.79">
   7   <link rel="HOME" title="Privoxy 3.0.30 User Manual" href="index.html">
   8   <link rel="PREVIOUS" title="Installation" href="installation.html">
   9   <link rel="NEXT" title="Quickstart to Using Privoxy" href="quickstart.html">
  10   <link rel="STYLESHEET" type="text/css" href="../p_doc.css">
  11   <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
  12   <link rel="STYLESHEET" type="text/css" href="p_doc.css">
  13 </head>
  14 <body class="SECT1" bgcolor="#EEEEEE" text="#000000" link="#0000FF" vlink="#840084" alink="#0000FF">
  15   <div class="NAVHEADER">
  16     <table summary="Header navigation table" width="100%" border="0" cellpadding="0" cellspacing="0">
  17       <tr>
  18         <th colspan="3" align="center">Privoxy 3.0.30 User Manual</th>
  19       </tr>
  20       <tr>
  21         <td width="10%" align="left" valign="bottom"><a href="installation.html" accesskey="P">Prev</a></td>
  22         <td width="80%" align="center" valign="bottom"></td>
  23         <td width="10%" align="right" valign="bottom"><a href="quickstart.html" accesskey="N">Next</a></td>
  24       </tr>
  25     </table>
  26     <hr align="left" width="100%">
  27   </div>
  28   <div class="SECT1">
  29     <h1 class="SECT1"><a name="WHATSNEW" id="WHATSNEW">3. What's New in this Release</a></h1>
  30     <p><span class="APPLICATION">Privoxy 3.0.30</span> fixes a couple of bugs and introduces a few new features.</p>
  31     <p>Changes in <span class="APPLICATION">Privoxy 3.0.30</span> stable:</p>
  32     <ul>
  33       <li>
  34         <p>Bug fixes:</p>
  35         <ul>
  36           <li>
  37             <p>Check the actual URL for redirects when https inspecting requests. Previously Privoxy would only check
  38             the path which resulted in rewrite results being rejected as invalid URLs. Reported by withoutname in
  39             #1736.</p>
  40           </li>
  41           <li>
  42             <p>Let the hide-referrer code tolerate Referer headers with https:// URLs. Previously they would always be
  43             treated like a changed host.</p>
  44           </li>
  45           <li>
  46             <p>Use the https headers if the show-request handler is reached through https://. Previously Privoxy would
  47             use the http headers which may be empty on a reused connection.</p>
  48           </li>
  49           <li>
  50             <p>Make CGI_PREFIX protocol-relative when building with FEATURE_HTTPS_INSPECTION. This unbreaks (at least)
  51             https://config.privoxy.org/client-tags whose buttons would previously use a http:// URL resulting in
  52             browser warnings.</p>
  53           </li>
  54           <li>
  55             <p>Support using https-inspection and client-header-order at the same time. Previously Privoxy would crash.
  56             Reported by: Kai Raven</p>
  57           </li>
  58           <li>
  59             <p>Properly reject rewrites from http to https as they currently aren't supported. Previously Privoxy would
  60             wait for the client to establish an encrypted connection which obviously would not happen.</p>
  61           </li>
  62           <li>
  63             <p>When https inspection is enabled and Privoxy has been compiled with FEATURE_GRACEFUL_TERMINATION (not
  64             recommended for production builds), the TLS backend resources are free'd later on and only if no active
  65             connections are left. Prevents crashes when exiting "gracefully" at the wrong time.</p>
  66           </li>
  67           <li>
  68             <p>Let the uninstall target remove the config file even if DESTDIR is set and properly announce the
  69             deletion of the configuration files.</p>
  70           </li>
  71         </ul>
  72       </li>
  73       <li>
  74         <p>General improvements:</p>
  75         <ul>
  76           <li>
  77             <p>Allow to rewrite the request destination for https-inspected requests behind the client's back. The
  78             documentation already sort of claimed that it was supported by not especially mentioning that it didn't
  79             work for https-inspected requests. Fixes SF bug #923 reported by withoutname.</p>
  80           </li>
  81           <li>
  82             <p>Add support for filtering client request bodies by using CLIENT-BODY-FILTER filters which can be enabled
  83             with the client-body-filter action. Patch submitted by Maxim Antonov. Sponsored by: Robert Klemme</p>
  84           </li>
  85           <li>
  86             <p>Add the new action suppress-tag{} which can be used to prevent a tagger from adding a tag. Patch
  87             submitted by Maxim Antonov. Sponsored by: Robert Klemme</p>
  88           </li>
  89           <li>
  90             <p>Gracefully handle existing website keys without matching certificates. This can happen if Privoxy was
  91             previously running with an invalid TLS configuration that didn't allow it to create a certificate.</p>
  92           </li>
  93           <li>
  94             <p>Recycle debug bit 4 for Tagging-related messages.</p>
  95           </li>
  96           <li>
  97             <p>Improve the message shown when the client-tags CGI page is requested with no tags configured.</p>
  98           </li>
  99           <li>
 100             <p>Shorten the 'donate' and 'participate' links used by templates using redirects. Currently the redirects
 101             lead to the FAQ entries but in the future we may want to relocate the content and using redirects makes
 102             this more convenient.</p>
 103           </li>
 104           <li>
 105             <p>Log an error when a PCRE-HOST-PATTERN is used with FEATURE_PCRE_HOST_PATTERNS disabled. Don't treat this
 106             a fatal error so the regression tests can be used with and without FEATURE_PCRE_HOST_PATTERNS.</p>
 107           </li>
 108           <li>
 109             <p>The code compiles with older C compilers again.</p>
 110           </li>
 111           <li>
 112             <p>The chdir() return code is checked to fix a compiler warning.</p>
 113           </li>
 114           <li>
 115             <p>The packages feed has been removed from the source tarball. It's usually out of date when the source
 116             tarball is generated for the release.</p>
 117           </li>
 118           <li>
 119             <p>Fixed harmless compiler warnings from GCC9 with -D_FORTIFY_SOURCE=2.</p>
 120           </li>
 121           <li>
 122             <p>windows: Remove obsolete '$(DEST)/doc/images' target.</p>
 123           </li>
 124           <li>
 125             <p>windows: Install the images referenced in the user manual.</p>
 126           </li>
 127           <li>
 128             <p>Remove obsolete 'gnu_regex.@OBJEXT@' target.</p>
 129           </li>
 130           <li>
 131             <p>When installing from the GNUMAkefile, don't create an 'images' directory which is no longer used. The
 132             images were relocated to the user-manual directory years ago.</p>
 133           </li>
 134           <li>
 135             <p>Add new FEATURES to the show-status page and resort list.</p>
 136           </li>
 137           <li>
 138             <p>Remove unused variable in the OpenSSL-specific code.</p>
 139           </li>
 140           <li>
 141             <p>Update bug tracker URL in cgi_error_unknown().</p>
 142           </li>
 143           <li>
 144             <p>Saved a couple of memory allocations when sorting client headers.</p>
 145           </li>
 146           <li>
 147             <p>Improved a couple of error messages.</p>
 148           </li>
 149           <li>
 150             <p>Saved memory allocations when using OpenSSL and checking if a key already exists.</p>
 151           </li>
 152           <li>
 153             <p>The configure script will bail out if OpenSSL and mbedTLS are enabled at the same time.</p>
 154           </li>
 155           <li>
 156             <p>Log a message right before exiting gracefully.</p>
 157           </li>
 158           <li>
 159             <p>A couple of structures have been rearranged to require slightly less memory.</p>
 160           </li>
 161           <li>
 162             <p>When https inspection is enabled and the certificate is invalid the error message is now sent with
 163             status code 403 instead of 200.</p>
 164           </li>
 165           <li>
 166             <p>The Slackware rc script template has been renamed to slackware/rc.privoxy.in to silence complaints when
 167             building Debian packages.</p>
 168           </li>
 169           <li>
 170             <p>When building with MbedTLS support, mbedtls_md5_ret() is used instead of mbedtls_md5() which is
 171             deprecated and causes a warning on Debian GNU/Linux.</p>
 172           </li>
 173         </ul>
 174       </li>
 175       <li>
 176         <p>Action file improvements:</p>
 177         <ul>
 178           <li>
 179             <p>Block requests to eu-tlp03.kameleoon.com/.</p>
 180           </li>
 181           <li>
 182             <p>Unblock metrics.sr.ht/.</p>
 183           </li>
 184           <li>
 185             <p>Disable fast-redirects for .fsf.org/.</p>
 186           </li>
 187           <li>
 188             <p>Disable fast-redirects for .gravater.com/.</p>
 189           </li>
 190           <li>
 191             <p>Disable fast-redirects for .ksta.de/.</p>
 192           </li>
 193           <li>
 194             <p>Block requests to tag.crsspxl.com/.</p>
 195           </li>
 196           <li>
 197             <p>Block requests to analytics.slashdotmedia.com/.</p>
 198           </li>
 199           <li>
 200             <p>Block requests to ml314.com/.</p>
 201           </li>
 202           <li>
 203             <p>Block requests to .adroll.com/.</p>
 204           </li>
 205           <li>
 206             <p>Block requests to fastlane.rubiconproject.com/.</p>
 207           </li>
 208           <li>
 209             <p>Block requests to api.theadex.com/.</p>
 210           </li>
 211           <li>
 212             <p>Block requests to ih.adscale.de/.</p>
 213           </li>
 214           <li>
 215             <p>Block requests to .s400.meetrics.net/.</p>
 216           </li>
 217           <li>
 218             <p>Block requests for pp.lp4.io/.</p>
 219           </li>
 220           <li>
 221             <p>Block requests for trc-events.taboola.com/.</p>
 222           </li>
 223         </ul>
 224       </li>
 225       <li>
 226         <p>Filter file improvements:</p>
 227         <ul>
 228           <li>
 229             <p>A allow-autocompletion filter has been added which changes autocomplete="off" to "on" on input fields to
 230             allow autocompletion. Requested by Jamie Zawinski in #370. Filter based on a submission by Aaron
 231             Linville.</p>
 232           </li>
 233           <li>
 234             <p>Added an imdb filter.</p>
 235           </li>
 236           <li>
 237             <p>Added a sourceforge filter that reduces the amount of ads for proprietary software.</p>
 238           </li>
 239           <li>
 240             <p>Added a github filter that removes the annoying "Sign-Up" banner and the Cookie disclaimer.</p>
 241           </li>
 242           <li>
 243             <p>Removed a duplicated pcrs command from the js-annoyances filter.</p>
 244           </li>
 245           <li>
 246             <p>The crude-parental filter now provides a short reason when blocking, inserts a link to Privoxy's
 247             webinterface and adds a new line at the end of the generated page.</p>
 248           </li>
 249         </ul>
 250       </li>
 251       <li>
 252         <p>Privoxy-Log-Parser:</p>
 253         <ul>
 254           <li>
 255             <p>Highlight a few more messages.</p>
 256           </li>
 257           <li>
 258             <p>Add a handler for tagging messages.</p>
 259           </li>
 260           <li>
 261             <p>Properly deal with 'Certificate error' crunches Previously the error description was highlighted as
 262             'host'.</p>
 263           </li>
 264           <li>
 265             <p>Log truncated LOG_LEVEL_CLF messages more gracefully and note that the statistics will be imprecise.</p>
 266           </li>
 267           <li>
 268             <p>Fixed perldoc typo.</p>
 269           </li>
 270           <li>
 271             <p>Bump version to 0.9.2.</p>
 272           </li>
 273         </ul>
 274       </li>
 275       <li>
 276         <p>Privoxy-Regression-Test:</p>
 277         <ul>
 278           <li>
 279             <p>Use http://127.0.0.1:8118/ as default Privoxy address unless http_proxy is set through the
 280             environment.</p>
 281           </li>
 282           <li>
 283             <p>Add a --privoxy-cgi-prefix option that specifies the prefix to use when building URLs that are supposed
 284             to reach Privoxy's CGI interface. If it's not set, http://p.p/ is used, which is supposed to work with the
 285             default Privoxy configuration. If Privoxy has been built with FEATURE_HTTPS_INSPECTION enabled, and if
 286             https inspection is activated with the +https-inspection action, this option can be used with
 287             "https://p.p/" provided the system running Privoxy-Regression-Test has been configured to trust the
 288             certificate used by Privoxy. Note that there are currently two tests in the official
 289             regression-tests.action file that are expected to fail when using "https://p.p/" as privoxy-cgi-prefix.</p>
 290           </li>
 291           <li>
 292             <p>Skip the connection-established response in get_status_code() when looking for the status code with a
 293             CGI prefix that starts with https://. We care about the status code sent by the impersonated web
 294             server.</p>
 295           </li>
 296           <li>
 297             <p>Use --proxy-header when using a CGI prefix with https:// and a "Host:" header.</p>
 298           </li>
 299           <li>
 300             <p>Allow '|' in tokens and values to allow tag patterns like
 301             "TAG:^(application|text)/(x-)?javascript$".</p>
 302           </li>
 303           <li>
 304             <p>When get_cgi_page_or_else() fails, include the URL of the requested page in the log message.</p>
 305           </li>
 306           <li>
 307             <p>Added a --check-bad-ssl option that can be used to verify that Privoxy detects certificate problems when
 308             accessing the test sites from badssl.com.</p>
 309           </li>
 310           <li>
 311             <p>Bumped version to 0.7.2</p>
 312           </li>
 313         </ul>
 314       </li>
 315       <li>
 316         <p>uagen:</p>
 317         <ul>
 318           <li>
 319             <p>Update example output.</p>
 320           </li>
 321           <li>
 322             <p>Recommend the use of the https-inspection action in the documentation.</p>
 323           </li>
 324           <li>
 325             <p>Upgrade a couple of URLs to https://.</p>
 326           </li>
 327           <li>
 328             <p>Add ElectroBSD to the list of operating systems.</p>
 329           </li>
 330           <li>
 331             <p>Bumped generated Firefox version to 78 (ESR).</p>
 332           </li>
 333           <li>
 334             <p>Bumped version to 1.2.2.</p>
 335           </li>
 336         </ul>
 337       </li>
 338       <li>
 339         <p>User documentation:</p>
 340         <ul>
 341           <li>
 342             <p>Remove reference to 'How to Report Bugs Effectively'. It was only rendered as text without URL in the
 343             README anyway and there's no indication that users read it ...</p>
 344           </li>
 345           <li>
 346             <p>Let the dok-readme target fix the location embedded into the README file. This used to be done by CVS
 347             but since the git migration it has to be done through other means.</p>
 348           </li>
 349           <li>
 350             <p>Remove 'experimental' warning for client-specific-tag-related directives. They seem to work reliably and
 351             there is no obvious reason why we would change the syntax in the near future.</p>
 352           </li>
 353           <li>
 354             <p>Describe how to check if Privoxy has been built with FEATURE_HTTPS_INSPECTION.</p>
 355           </li>
 356           <li>
 357             <p>Add a link to the trusted-cas-file documentation that explains how the user can create the file
 358             herself.</p>
 359           </li>
 360           <li>
 361             <p>Don't explicitly mention the license for the code coming from 'Anonymous Coders' and Junkbusters. It's
 362             obviously licensed under the GNU GPL like the rest of Privoxy or we wouldn't be allowed to distribute
 363             it.</p>
 364           </li>
 365           <li>
 366             <p>Update the +hide-user-agent example with uagen output.</p>
 367           </li>
 368           <li>
 369             <p>Slightly improve the wording of the ca-key-file documentation.</p>
 370           </li>
 371           <li>
 372             <p>Explicitly mention Windows 10 as supported so search engines and users looking for it can find it.</p>
 373           </li>
 374           <li>
 375             <p>Import a bunch of contributors from the ChangeLog.</p>
 376           </li>
 377           <li>
 378             <p>Remove obsolete doc/gpl.html.</p>
 379           </li>
 380           <li>
 381             <p>Upgrade a couple of links to https://.</p>
 382           </li>
 383           <li>
 384             <p>Don't prefer the SourceForge patch tracker over the privoxy-devel mailing list. While at it, link to the
 385             SourceForge patch tracker.</p>
 386           </li>
 387           <li>
 388             <p>Mention http-inspection in the 'my browser warns me about unauthenticated content' FAQ entry.</p>
 389           </li>
 390           <li>
 391             <p>Simplify the 'Is there is a license or fee?' FAQ entry.</p>
 392           </li>
 393           <li>
 394             <p>Add another +redirect{} example.</p>
 395           </li>
 396           <li>
 397             <p>Explicitly mention that interested sponsors should include the link target in their first mail.</p>
 398           </li>
 399           <li>
 400             <p>Clarify that only Privoxy team members can object to new sponsors and link to the list of current team
 401             members.</p>
 402           </li>
 403           <li>
 404             <p>Note that sponsor URLs may not contain keyword spam.</p>
 405           </li>
 406           <li>
 407             <p>Garbage collect doc/webserver/images which isn't referenced anymore.</p>
 408           </li>
 409           <li>
 410             <p>Update the method to reach the proxy settings in Firefox.</p>
 411           </li>
 412           <li>
 413             <p>Update proxy_setup.jpg description to refer to Firefox.</p>
 414           </li>
 415           <li>
 416             <p>Regenerate proxy_setup.jpg with a more recent Firefox (78.0).</p>
 417           </li>
 418           <li>
 419             <p>Regenerate files-in-use.jpg without obsolete standard.action with modern colors and a slightly better
 420             quality.</p>
 421           </li>
 422           <li>
 423             <p>Update URL to the actionsfile tracker.</p>
 424           </li>
 425           <li>
 426             <p>Update a support request URL.</p>
 427           </li>
 428           <li>
 429             <p>Rephrase the 'Can Privoxy run as service' FAQ entry and remove an obsolete paragraph.</p>
 430           </li>
 431           <li>
 432             <p>Let the 'Where can I get updated Actions Files?' entry link to the gitweb version of
 433             default.action.master.</p>
 434           </li>
 435           <li>
 436             <p>Update a link to the default.action file.</p>
 437           </li>
 438           <li>
 439             <p>Update URLs for trackers and mailing lists.</p>
 440           </li>
 441           <li>
 442             <p>Replace CVS reference with git.</p>
 443           </li>
 444           <li>
 445             <p>Mention regression-tests.action in the config file.</p>
 446           </li>
 447           <li>
 448             <p>Explicitly mention in the config file that access to the CA key should be limited to Privoxy.</p>
 449           </li>
 450           <li>
 451             <p>List more client-specific-tag examples for inspiration.</p>
 452           </li>
 453           <li>
 454             <p>Add additional headers to the client-header-order example.</p>
 455           </li>
 456           <li>
 457             <p>Note that actions aren't updated after rewrites.</p>
 458           </li>
 459           <li>
 460             <p>Explicitly mention that upgrading from http to https with a client-header filter is not supported</p>
 461           </li>
 462           <li>
 463             <p>Note that protocol and host have to be added when rewriting the destination host for https-inspected
 464             requests.</p>
 465           </li>
 466           <li>
 467             <p>Explicitly mention that the CA key is used to sign certificates.</p>
 468           </li>
 469           <li>
 470             <p>Put openssl command in 'command' tags.</p>
 471           </li>
 472           <li>
 473             <p>The man page has been moved from section 1 to man section 8.</p>
 474           </li>
 475         </ul>
 476       </li>
 477       <li>
 478         <p>Developer manual:</p>
 479         <ul>
 480           <li>
 481             <p>Flesh out the build instructions for Debian.</p>
 482           </li>
 483           <li>
 484             <p>Remove the packaging instructions for RPM-based systems. They don't work and we don't release RPM
 485             packages anymore anyway.</p>
 486           </li>
 487           <li>
 488             <p>Remove the packaging instructions for Solaris. They don't work and we don't release Solaris packages
 489             anymore anyway.</p>
 490           </li>
 491           <li>
 492             <p>Update the suggested subject for the announce mails.</p>
 493           </li>
 494           <li>
 495             <p>Update upload instructions. ftp://upload.sourceforge.net is no longer functional.</p>
 496           </li>
 497           <li>
 498             <p>Remove a couple of package-dependent upload instructions that don't actually work.</p>
 499           </li>
 500           <li>
 501             <p>Remove 'cd current' that no longer works.</p>
 502           </li>
 503           <li>
 504             <p>Add regression-tests.action to the list of files that should be installed.</p>
 505           </li>
 506           <li>
 507             <p>Stop claiming that there are text versions of the manuals. We stopped building them in 2008
 508             (9ed36a3c5e6f12).</p>
 509           </li>
 510           <li>
 511             <p>Note that the 'webserver' target creates the link needed for the user-manual.</p>
 512           </li>
 513           <li>
 514             <p>Suggest to use the master branch as reference when creating the ChangeLog so the steps work when the
 515             current branch differs from master which is likely as the developer manual suggests to use a local branch
 516             for development.</p>
 517           </li>
 518           <li>
 519             <p>Add the -s flag to the suggested 'git tag' command. We prefer signed tags.</p>
 520           </li>
 521           <li>
 522             <p>Mention that merges into 'master' should be avoided.</p>
 523           </li>
 524           <li>
 525             <p>Add git commands that should result in a merge-free history.</p>
 526           </li>
 527           <li>
 528             <p>Mention Privoxy-Regression-Test.</p>
 529           </li>
 530           <li>
 531             <p>Add a section id to reduce link churn.</p>
 532           </li>
 533           <li>
 534             <p>Recommend the dok-tidy target when building docs for the webserver.</p>
 535           </li>
 536           <li>
 537             <p>Add another plug for the privoxy-devel mailing list.</p>
 538           </li>
 539           <li>
 540             <p>Let the intro link the copyright section in the user manual instead of giving an incomplete summary of
 541             the license status.</p>
 542           </li>
 543           <li>
 544             <p>Clarify that the webserver target uploads to the SourceForge webserver.</p>
 545           </li>
 546           <li>
 547             <p>Mark the documentation for the Mac OS X installers as out of date and change the SCM name back to
 548             CVS.</p>
 549           </li>
 550           <li>
 551             <p>Fix the location of the installer modules for Mac OS X. They are not actually available through git
 552             (yet).</p>
 553           </li>
 554           <li>
 555             <p>Don't speak of Privoxy version 3 in the past tense.</p>
 556           </li>
 557           <li>
 558             <p>Update the list of programs required for the release process.</p>
 559           </li>
 560           <li>
 561             <p>Update description of the webserver target which uses ssh, not scp.</p>
 562           </li>
 563           <li>
 564             <p>Remove obsolete reference to config.new.</p>
 565           </li>
 566         </ul>
 567       </li>
 568       <li>
 569         <p>Tests:</p>
 570         <ul>
 571           <li>
 572             <p>Add another hide-referrer{conditional-block} test.</p>
 573           </li>
 574           <li>
 575             <p>Add another hide-referrer{conditional-forge} test.</p>
 576           </li>
 577           <li>
 578             <p>Fix a hide-referrer{conditional-forge} test that expected an acceptable header to be forged.</p>
 579           </li>
 580           <li>
 581             <p>Fix a hide-referrer{conditional-block} test that expected an acceptable Referer to be removed.</p>
 582           </li>
 583           <li>
 584             <p>Explain why the "Set Header = Host: whatever.example.org" test is expected to fail when using a CGI
 585             prefix that starts with "https://".</p>
 586           </li>
 587           <li>
 588             <p>Explain why a connection-sharing test is known to fail when using "https://p.p/" as CGI prefix.</p>
 589           </li>
 590           <li>
 591             <p>Add a link to Privoxy-Regression-Test to regression-tests.action in case it isn't packaged.</p>
 592           </li>
 593           <li>
 594             <p>Add regression tests for pcre host patterns.</p>
 595           </li>
 596           <li>
 597             <p>Fixed a regression test that is executed when FEATURE_GRACEFUL_TERMINATION is enabled.</p>
 598           </li>
 599         </ul>
 600       </li>
 601       <li>
 602         <p>Privoxy infrastructure:</p>
 603         <ul>
 604           <li>
 605             <p>Import a Privoxy logo for the website.</p>
 606           </li>
 607           <li>
 608             <p>Update Tor onion service to HiddenServiceVersion 3.</p>
 609           </li>
 610           <li>
 611             <p>Display the "model" photos in a single row and remove placeholder images.</p>
 612           </li>
 613           <li>
 614             <p>Regenerate homepage with updated sponsor list.</p>
 615           </li>
 616           <li>
 617             <p>Use the '/sponsor' redirect for the link to the sponsor page.</p>
 618           </li>
 619           <li>
 620             <p>Git commit messages are sent to the Privoxy-commits mailing list.</p>
 621           </li>
 622         </ul>
 623       </li>
 624     </ul>
 625     <div class="SECT2">
 626       <h2 class="SECT2"><a name="UPGRADERSNOTE" id="UPGRADERSNOTE">3.1. Note to Upgraders</a></h2>
 627       <p>A quick list of things to be aware of before upgrading from earlier versions of <span class=
 628       "APPLICATION">Privoxy</span>:</p>
 629       <ul>
 630         <li>
 631           <p>The recommended way to upgrade <span class="APPLICATION">Privoxy</span> is to backup your old
 632           configuration files, install the new ones, verify that <span class="APPLICATION">Privoxy</span> is working
 633           correctly and finally merge back your changes using <span class="APPLICATION">diff</span> and maybe
 634           <span class="APPLICATION">patch</span>.</p>
 635           <p>There are a number of new features in each <span class="APPLICATION">Privoxy</span> release and most of
 636           them have to be explicitly enabled in the configuration files. Old configuration files obviously don't do
 637           that and due to syntax changes using old configuration files with a new <span class=
 638           "APPLICATION">Privoxy</span> isn't always possible anyway.</p>
 639         </li>
 640         <li>
 641           <p>Note that some installers remove earlier versions completely, including configuration files, therefore you
 642           should really save any important configuration files!</p>
 643         </li>
 644         <li>
 645           <p>On the other hand, other installers don't overwrite existing configuration files, thinking you will want
 646           to do that yourself.</p>
 647         </li>
 648         <li>
 649           <p>In the default configuration only fatal errors are logged now. You can change that in the <a href=
 650           "config.html#DEBUG">debug section</a> of the configuration file. You may also want to enable more verbose
 651           logging until you verified that the new <span class="APPLICATION">Privoxy</span> version is working as
 652           expected.</p>
 653         </li>
 654         <li>
 655           <p>Three other config file settings are now off by default: <a href=
 656           "config.html#ENABLE-REMOTE-TOGGLE">enable-remote-toggle</a>, <a href=
 657           "config.html#ENABLE-REMOTE-HTTP-TOGGLE">enable-remote-http-toggle</a>, and <a href=
 658           "config.html#ENABLE-EDIT-ACTIONS">enable-edit-actions</a>. If you use or want these, you will need to
 659           explicitly enable them, and be aware of the security issues involved.</p>
 660         </li>
 661       </ul>
 662     </div>
 663   </div>
 664   <div class="NAVFOOTER">
 665     <hr align="left" width="100%">
 666     <table summary="Footer navigation table" width="100%" border="0" cellpadding="0" cellspacing="0">
 667       <tr>
 668         <td width="33%" align="left" valign="top"><a href="installation.html" accesskey="P">Prev</a></td>
 669         <td width="34%" align="center" valign="top"><a href="index.html" accesskey="H">Home</a></td>
 670         <td width="33%" align="right" valign="top"><a href="quickstart.html" accesskey="N">Next</a></td>
 671       </tr>
 672       <tr>
 673         <td width="33%" align="left" valign="top">Installation</td>
 674         <td width="34%" align="center" valign="top">&nbsp;</td>
 675         <td width="33%" align="right" valign="top">Quickstart to Using Privoxy</td>
 676       </tr>
 677     </table>
 678   </div>
 679 </body>
 680 </html>