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.11 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.11 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 > There are many improvements and new features since <SPAN
  86 CLASS="APPLICATION"
  87 >Privoxy 3.0.8</SPAN
  88 >, the last stable release:</P
  89 ><P
  90 > <P
  91 ></P
  92 ><UL
  93 ><LI
  94 ><P
  95 >    Added SOCKS5 support (with address resolution done by
  96     the SOCKS5 server). Patch provided by Eric M. Hopper.
  97    </P
  98 ></LI
  99 ><LI
 100 ><P
 101 >    The "blocked" CGI pages include a block reason that was
 102     provided as argument to the last-applying block action.
 103    </P
 104 ></LI
 105 ><LI
 106 ><P
 107 >    If enable-edit-actions is disabled (the default since 3.0.7 beta)
 108     the show-status page hides the edit buttons and explains why.
 109     Previously the user would get the "this feature has been disabled"
 110     message after using the edit button.
 111    </P
 112 ></LI
 113 ><LI
 114 ><P
 115 >    Forbidden CONNECT requests are treated like blocks by default.
 116     The now-pointless treat-forbidden-connects-like-blocks action
 117     has been removed.
 118    </P
 119 ></LI
 120 ><LI
 121 ><P
 122 >    Not enabling limit-connect now allows CONNECT requests to all ports.
 123     In previous versions it would only allow CONNECT requests to port 443.
 124     Use +limit-connect{443} if you think you need the old default behaviour.
 125    </P
 126 ></LI
 127 ><LI
 128 ><P
 129 >    The CGI editor gets turned off after three edit requests with invalid
 130     file modification timestamps. This makes life harder for attackers
 131     who can leverage browser bugs to send fake Referers and intend to
 132     brute-force edit URLs.
 133    </P
 134 ></LI
 135 ><LI
 136 ><P
 137 >    Action settings for multiple patterns in the same section are
 138     shared in memory. As a result these sections take up less space
 139     (and are loaded slightly faster). Problem reported by Franz Schwartau.
 140    </P
 141 ></LI
 142 ><LI
 143 ><P
 144 >    Linear white space in HTTP headers will be normalized to single
 145     spaces before parsing the header's content, headers split across
 146     multiple lines get merged first.
 147    </P
 148 ></LI
 149 ><LI
 150 ><P
 151 >    Host information is gathered outside the main thread so it's less
 152     likely to delay other incoming connections if the host is misconfigured.
 153    </P
 154 ></LI
 155 ><LI
 156 ><P
 157 >    New config option "hostname" to use a hostname other than
 158     the one returned by the operating system. Useful to speed-up responses
 159     for CGI requests on misconfigured systems. Requested by Max Khon.
 160    </P
 161 ></LI
 162 ><LI
 163 ><P
 164 >    The CGI editor supports the "disable all filters of this type"
 165     directives "-client-header-filter", "-server-header-filter",
 166     "-client-header-tagger" and "-server-header-tagger".
 167    </P
 168 ></LI
 169 ><LI
 170 ><P
 171 >    Fixed false-positives with the link-by-url filter and URLs that
 172     contain the pattern "/jump/".
 173    </P
 174 ></LI
 175 ><LI
 176 ><P
 177 >    The less-download-windows filter no longer messes
 178     "Content-Type: application/x-shockwave-flash" headers up.
 179    </P
 180 ></LI
 181 ><LI
 182 ><P
 183 >    In the show-url-info page's "Final results" section active and
 184     inactive actions are listed separately. Patch provided by Lee.
 185    </P
 186 ></LI
 187 ><LI
 188 ><P
 189 >    The GNUmakefile supports the DESTDIR variable. Patch for
 190     the install target submitted by Radoslaw Zielinski.
 191    </P
 192 ></LI
 193 ><LI
 194 ><P
 195 >    Embedding the content of configuration files in the show-status
 196     page is significantly faster now. For a largish action file (1 MB)
 197     a speedup of about 2450 times has been measured. This is mostly
 198     interesting if you are using large action files or regularly use
 199     Privoxy-Regression-Test while running Privoxy through Valgrind,
 200     for stock configuration files it doesn't really matter.
 201    </P
 202 ></LI
 203 ><LI
 204 ><P
 205 >    If zlib support is unavailable and there are content
 206     filters active but the prevent-compression action is disabled,
 207     the show-url-info page includes a warning that compression
 208     might prevent filtering.
 209    </P
 210 ></LI
 211 ><LI
 212 ><P
 213 >    The show-url-info page provides an OpenSearch Description that
 214     allows to access the page through browser search plugins.
 215    </P
 216 ></LI
 217 ><LI
 218 ><P
 219 >    The obsolete kill-popups action has been removed as the
 220     PCRS-based popup filters can do the same and are slightly
 221     less unreliable.
 222    </P
 223 ></LI
 224 ><LI
 225 ><P
 226 >    The inspect-jpegs action has been removed.
 227    </P
 228 ></LI
 229 ><LI
 230 ><P
 231 >    The send-wafer and send-vanilla-wafer actions have been removed.
 232     They weren't particular useful and their behaviour could be emulated
 233     with add-header anyway.
 234    </P
 235 ></LI
 236 ><LI
 237 ><P
 238 >    Privoxy-Regression-Test has been significantly improved.
 239    </P
 240 ></LI
 241 ><LI
 242 ><P
 243 >    Most sections in the default.action file contain tests for
 244     Privoxy-Regression-Test to verify that they are working as intended.
 245    </P
 246 ></LI
 247 ><LI
 248 ><P
 249 >    Parts of Privoxy have been refactored to increase maintainability.
 250    </P
 251 ></LI
 252 ><LI
 253 ><P
 254 >    Building with zlib (if available) is done by default.
 255    </P
 256 ></LI
 257 ><LI
 258 ><P
 259 >    Ordinary configuration file changes no longer cause program
 260     termination on OS/2 if the name of the logfile hasn't been
 261     changed as well. This regression probably crept in with the
 262     logging improvements in 3.0.7. Reported by Maynard.
 263    </P
 264 ></LI
 265 ><LI
 266 ><P
 267 >    The img-reorder filter is less likely to mess up JavaScript code in
 268     img tags. Problem and solution reported by Glenn Washburn in #2014552.
 269    </P
 270 ></LI
 271 ><LI
 272 ><P
 273 >    The source tar ball now includes Privoxy-Log-Parser,
 274     a syntax-highlighter for Privoxy logs. Documentation is available
 275     through perldoc(1), for fancy screenshots see:
 276     <A
 277 HREF="http://www.fabiankeil.de/sourcecode/privoxy-log-parser/"
 278 TARGET="_top"
 279 >http://www.fabiankeil.de/sourcecode/privoxy-log-parser/</A
 280 >.
 281    </P
 282 ></LI
 283 ></UL
 284 ></P
 285 ><P
 286 > For a more detailed list of changes please have a look at the ChangeLog.</P
 287 ><DIV
 288 CLASS="SECT2"
 289 ><H2
 290 CLASS="SECT2"
 291 ><A
 292 NAME="UPGRADERSNOTE"
 293 >3.1. Note to Upgraders</A
 294 ></H2
 295 ><P
 296 > A quick list of things to be aware of before upgrading from earlier
 297  versions of <SPAN
 298 CLASS="APPLICATION"
 299 >Privoxy</SPAN
 300 >:</P
 301 ><P
 302 > <P
 303 ></P
 304 ><UL
 305 ><LI
 306 ><P
 307 >   The recommended way to upgrade <SPAN
 308 CLASS="APPLICATION"
 309 >Privoxy</SPAN
 310 > is to backup your old
 311    configuration files, install the new ones, verify that <SPAN
 312 CLASS="APPLICATION"
 313 >Privoxy</SPAN
 314 >
 315    is working correctly and finally merge back your changes using
 316    <SPAN
 317 CLASS="APPLICATION"
 318 >diff</SPAN
 319 > and maybe <SPAN
 320 CLASS="APPLICATION"
 321 >patch</SPAN
 322 >.
 323   </P
 324 ><P
 325 >   There are a number of new features in each <SPAN
 326 CLASS="APPLICATION"
 327 >Privoxy</SPAN
 328 > release and
 329    most of them have to be explicitly enabled in the configuration
 330    files. Old configuration files obviously don't do that and due
 331    to syntax changes using old configuration files with a new
 332    <SPAN
 333 CLASS="APPLICATION"
 334 >Privoxy</SPAN
 335 > isn't always possible anyway.
 336   </P
 337 ></LI
 338 ><LI
 339 ><P
 340 >
 341     Note that some installers remove earlier versions completely,
 342     including configuration files, therefore you should really save
 343     any important configuration files!
 344   </P
 345 ></LI
 346 ><LI
 347 ><P
 348 >
 349    On the other hand, other installers don't overwrite existing configuration
 350    files, thinking you will want to do that yourself.
 351   </P
 352 ></LI
 353 ><LI
 354 ><P
 355 >
 356    <TT
 357 CLASS="FILENAME"
 358 >standard.action</TT
 359 > now only includes the enabled actions.
 360    Not all actions as before.
 361   </P
 362 ></LI
 363 ><LI
 364 ><P
 365 >   In the default configuration only fatal errors are logged now.
 366    You can change that in the <A
 367 HREF="config.html#DEBUG"
 368 >debug section</A
 369 >
 370    of the configuration file. You may also want to enable more verbose
 371    logging until you verified that the new <SPAN
 372 CLASS="APPLICATION"
 373 >Privoxy</SPAN
 374 > version is working
 375    as expected.
 376   </P
 377 ></LI
 378 ><LI
 379 ><P
 380 >     Three other config file settings are now off by default:
 381      <A
 382 HREF="config.html#ENABLE-REMOTE-TOGGLE"
 383 >enable-remote-toggle</A
 384 >,
 385      <A
 386 HREF="config.html#ENABLE-REMOTE-HTTP-TOGGLE"
 387 >enable-remote-http-toggle</A
 388 >,
 389      and  <A
 390 HREF="config.html#ENABLE-EDIT-ACTIONS"
 391 >enable-edit-actions</A
 392 >.
 393      If you use or want these, you will need to explicitly enable them, and
 394      be aware of the security issues involved.
 395     </P
 396 ></LI
 397 ><LI
 398 ><P
 399 >    The <SPAN
 400 CLASS="QUOTE"
 401 >"filter-client-headers"</SPAN
 402 > and
 403     <SPAN
 404 CLASS="QUOTE"
 405 >"filter-server-headers"</SPAN
 406 > actions that were introduced with
 407     <SPAN
 408 CLASS="APPLICATION"
 409 >Privoxy 3.0.5</SPAN
 410 > to apply content filters to
 411     the headers  have been removed and replaced with new actions.
 412     See the <A
 413 HREF="whatsnew.html"
 414 >What's New section</A
 415 > above.
 416    </P
 417 ></LI
 418 ></UL
 419 ></P
 420 ></DIV
 421 ></DIV
 422 ><DIV
 423 CLASS="NAVFOOTER"
 424 ><HR
 425 ALIGN="LEFT"
 426 WIDTH="100%"><TABLE
 427 SUMMARY="Footer navigation table"
 428 WIDTH="100%"
 429 BORDER="0"
 430 CELLPADDING="0"
 431 CELLSPACING="0"
 432 ><TR
 433 ><TD
 434 WIDTH="33%"
 435 ALIGN="left"
 436 VALIGN="top"
 437 ><A
 438 HREF="installation.html"
 439 ACCESSKEY="P"
 440 >Prev</A
 441 ></TD
 442 ><TD
 443 WIDTH="34%"
 444 ALIGN="center"
 445 VALIGN="top"
 446 ><A
 447 HREF="index.html"
 448 ACCESSKEY="H"
 449 >Home</A
 450 ></TD
 451 ><TD
 452 WIDTH="33%"
 453 ALIGN="right"
 454 VALIGN="top"
 455 ><A
 456 HREF="quickstart.html"
 457 ACCESSKEY="N"
 458 >Next</A
 459 ></TD
 460 ></TR
 461 ><TR
 462 ><TD
 463 WIDTH="33%"
 464 ALIGN="left"
 465 VALIGN="top"
 466 >Installation</TD
 467 ><TD
 468 WIDTH="34%"
 469 ALIGN="center"
 470 VALIGN="top"
 471 >&nbsp;</TD
 472 ><TD
 473 WIDTH="33%"
 474 ALIGN="right"
 475 VALIGN="top"
 476 >Quickstart to Using Privoxy</TD
 477 ></TR
 478 ></TABLE
 479 ></DIV
 480 ></BODY
 481 ></HTML
 482 >