doc/webserver/user-manual/whatsnew.html

   1 <HTML
   2 ><HEAD
   3 ><TITLE
   4 >What's New in this Release</TITLE
   5 ><META
   6 NAME="GENERATOR"
   7 CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
   8 "><LINK
   9 REL="HOME"
  10 TITLE="Privoxy 3.0.6 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">
  21 <LINK REL="STYLESHEET" TYPE="text/css" HREF="p_doc.css">
  22 </head
  23 ><BODY
  24 CLASS="SECT1"
  25 BGCOLOR="#EEEEEE"
  26 TEXT="#000000"
  27 LINK="#0000FF"
  28 VLINK="#840084"
  29 ALINK="#0000FF"
  30 ><DIV
  31 CLASS="NAVHEADER"
  32 ><TABLE
  33 SUMMARY="Header navigation table"
  34 WIDTH="100%"
  35 BORDER="0"
  36 CELLPADDING="0"
  37 CELLSPACING="0"
  38 ><TR
  39 ><TH
  40 COLSPAN="3"
  41 ALIGN="center"
  42 >Privoxy 3.0.6 User Manual</TH
  43 ></TR
  44 ><TR
  45 ><TD
  46 WIDTH="10%"
  47 ALIGN="left"
  48 VALIGN="bottom"
  49 ><A
  50 HREF="installation.html"
  51 ACCESSKEY="P"
  52 >Prev</A
  53 ></TD
  54 ><TD
  55 WIDTH="80%"
  56 ALIGN="center"
  57 VALIGN="bottom"
  58 ></TD
  59 ><TD
  60 WIDTH="10%"
  61 ALIGN="right"
  62 VALIGN="bottom"
  63 ><A
  64 HREF="quickstart.html"
  65 ACCESSKEY="N"
  66 >Next</A
  67 ></TD
  68 ></TR
  69 ></TABLE
  70 ><HR
  71 ALIGN="LEFT"
  72 WIDTH="100%"></DIV
  73 ><DIV
  74 CLASS="SECT1"
  75 ><H1
  76 CLASS="SECT1"
  77 ><A
  78 NAME="WHATSNEW"
  79 ></A
  80 >3. What's New in this Release</H1
  81 ><P
  82 > There are many improvements and new features since <SPAN
  83 CLASS="APPLICATION"
  84 >Privoxy 3.0.3</SPAN
  85 >, the last stable release:</P
  86 ><P
  87 > <P
  88 ></P
  89 ><UL
  90 ><LI
  91 ><P
  92 >    Multiple <A
  93 HREF="filter-file.html"
  94 >filter files</A
  95 > can now be specified in <TT
  96 CLASS="FILENAME"
  97 >config</TT
  98 >. This allows for
  99     locally defined filters that can be maintained separately from the filters as
 100     supplied by the developers, i.e. <TT
 101 CLASS="FILENAME"
 102 >default.filter</TT
 103 >.
 104    </P
 105 ></LI
 106 ><LI
 107 ><P
 108 >
 109    There are a number of new <A
 110 HREF="actions-file.html"
 111 >actions</A
 112 >:
 113   </P
 114 ><P
 115 >  <P
 116 ></P
 117 ><UL
 118 ><LI
 119 ><P
 120 >       <TT
 121 CLASS="LITERAL"
 122 ><A
 123 HREF="actions-file.html#CONTENT-TYPE-OVERWRITE"
 124 >content-type-overwrite</A
 125 ></TT
 126 >
 127       </P
 128 ></LI
 129 ><LI
 130 ><P
 131 >       <TT
 132 CLASS="LITERAL"
 133 ><A
 134 HREF="actions-file.html#CRUNCH-CLIENT-HEADER"
 135 >crunch-client-header</A
 136 ></TT
 137 >
 138       </P
 139 ></LI
 140 ><LI
 141 ><P
 142 >       <TT
 143 CLASS="LITERAL"
 144 ><A
 145 HREF="actions-file.html#CRUNCH-IF-NONE-MATCH"
 146 >crunch-if-none-match</A
 147 ></TT
 148 >
 149       </P
 150 ></LI
 151 ><LI
 152 ><P
 153 >       <TT
 154 CLASS="LITERAL"
 155 ><A
 156 HREF="actions-file.html#CRUNCH-SERVER-HEADER"
 157 >crunch-server-header</A
 158 ></TT
 159 >
 160       </P
 161 ></LI
 162 ><LI
 163 ><P
 164 >       <TT
 165 CLASS="LITERAL"
 166 ><A
 167 HREF="actions-file.html#FILTER-CLIENT-HEADERS"
 168 >filter-client-headers</A
 169 ></TT
 170 >
 171       </P
 172 ></LI
 173 ><LI
 174 ><P
 175 >       <TT
 176 CLASS="LITERAL"
 177 ><A
 178 HREF="actions-file.html#FILTER-SERVER-HEADERS"
 179 >filter-server-headers</A
 180 ></TT
 181 >
 182       </P
 183 ></LI
 184 ><LI
 185 ><P
 186 >       <TT
 187 CLASS="LITERAL"
 188 ><A
 189 HREF="actions-file.html#FORCE-TEXT-MODE"
 190 >force-text-mode</A
 191 ></TT
 192 >
 193       </P
 194 ></LI
 195 ><LI
 196 ><P
 197 >       <TT
 198 CLASS="LITERAL"
 199 ><A
 200 HREF="actions-file.html#HANDLE-AS-EMPTY-DOCUMENT"
 201 >handle-as-empty-document</A
 202 ></TT
 203 >
 204       </P
 205 ></LI
 206 ><LI
 207 ><P
 208 >       <TT
 209 CLASS="LITERAL"
 210 ><A
 211 HREF="actions-file.html#HIDE-ACCEPT-LANGUAGE"
 212 >hide-accept-language</A
 213 ></TT
 214 >
 215       </P
 216 ></LI
 217 ><LI
 218 ><P
 219 >       <TT
 220 CLASS="LITERAL"
 221 ><A
 222 HREF="actions-file.html#HIDE-CONTENT-DISPOSITION"
 223 >hide-content-disposition</A
 224 ></TT
 225 >
 226       </P
 227 ></LI
 228 ><LI
 229 ><P
 230 >       <TT
 231 CLASS="LITERAL"
 232 ><A
 233 HREF="actions-file.html#HIDE-IF-MODIFIED-SINCE"
 234 >hide-if-modified-since</A
 235 ></TT
 236 >
 237       </P
 238 ></LI
 239 ><LI
 240 ><P
 241 >       <TT
 242 CLASS="LITERAL"
 243 ><A
 244 HREF="actions-file.html#INSPECT-JPEGS"
 245 >inspect-jpegs</A
 246 ></TT
 247 >
 248       </P
 249 ></LI
 250 ><LI
 251 ><P
 252 >       <TT
 253 CLASS="LITERAL"
 254 ><A
 255 HREF="actions-file.html#OVERWRITE-LAST-MODIFIED"
 256 >overwrite-last-modified</A
 257 ></TT
 258 >
 259       </P
 260 ></LI
 261 ><LI
 262 ><P
 263 >       <TT
 264 CLASS="LITERAL"
 265 ><A
 266 HREF="actions-file.html#REDIRECT"
 267 >redirect</A
 268 ></TT
 269 >
 270       </P
 271 ></LI
 272 ><LI
 273 ><P
 274 >       <TT
 275 CLASS="LITERAL"
 276 ><A
 277 HREF="actions-file.html#TREAT-FORBIDDEN-CONNECTS-LIKE-BLOCKS"
 278 >treat-forbidden-connects-like-blocks</A
 279 ></TT
 280 >
 281       </P
 282 ></LI
 283 ></UL
 284 >
 285   </P
 286 ><P
 287 >     In addition, <TT
 288 CLASS="LITERAL"
 289 ><A
 290 HREF="actions-file.html#FAST-REDIRECTS"
 291 >fast-redirects</A
 292 ></TT
 293 >
 294      has been significantly improved with enhanced syntax.
 295   </P
 296 ><P
 297 >     And <TT
 298 CLASS="LITERAL"
 299 ><A
 300 HREF="actions-file.html#HIDE-REFERRER"
 301 >hide-referrer</A
 302 ></TT
 303 >
 304      has a new option, <TT
 305 CLASS="LITERAL"
 306 >conditional block</TT
 307 >.
 308    </P
 309 ></LI
 310 ><LI
 311 ><P
 312 >    <SPAN
 313 CLASS="APPLICATION"
 314 >MS-Windows</SPAN
 315 > versions can now be
 316     <A
 317 HREF="installation.html#INSTALLATION-PACK-WIN"
 318 >installed and
 319     started as a <SPAN
 320 CLASS="emphasis"
 321 ><I
 322 CLASS="EMPHASIS"
 323 >Windows service</I
 324 ></SPAN
 325 ></A
 326 >.
 327    </P
 328 ></LI
 329 ><LI
 330 ><P
 331 >    <TT
 332 CLASS="FILENAME"
 333 >config</TT
 334 > has two new options:
 335     <A
 336 HREF="config.html#ENABLE-REMOTE-HTTP-TOGGLE"
 337 >enable-remote-http-toggle</A
 338 >,
 339     and <A
 340 HREF="config.html#FORWARDED-CONNECT-RETRIES"
 341 >forwarded-connect-retries</A
 342 >.
 343    </P
 344 ><P
 345 >    And there is improved handling of the <A
 346 HREF="config.html#USER-MANUAL"
 347 >user-manual</A
 348 >
 349     option, for placing documentation and help files on the local system.
 350    </P
 351 ></LI
 352 ><LI
 353 ><P
 354 >    There are six new <A
 355 HREF="actions-file.html#FILTER"
 356 >filters</A
 357 >.
 358    </P
 359 ></LI
 360 ><LI
 361 ><P
 362 >    Actions files problems and suggestions are now being directed to:
 363     <A
 364 HREF="http://sourceforge.net/tracker/?group_id=11118&atid=460288"
 365 TARGET="_top"
 366 >http://sourceforge.net/tracker/?group_id=11118&#38;atid=460288</A
 367 >.
 368     Please use this to report such configuration related problems as missed
 369     ads, sites that don't function properly due to one action or another,
 370     innocent images being blocked, etc.
 371    </P
 372 ></LI
 373 ><LI
 374 ><P
 375 >    In addition, there are numerous bug fixes and significant enhancements,
 376     including error pages should no longer be cached if the problem is fixed,
 377     much better DNS error handling, various logging improvements, and
 378     configuration updates for better ad blocking and junk elimination.
 379    </P
 380 ></LI
 381 ></UL
 382 ></P
 383 ><DIV
 384 CLASS="SECT2"
 385 ><H2
 386 CLASS="SECT2"
 387 ><A
 388 NAME="UPGRADERSNOTE"
 389 ></A
 390 >3.1. Note to Upgraders</H2
 391 ><P
 392 > A quick list of things to be aware of before upgrading from earlier
 393  versions of <SPAN
 394 CLASS="APPLICATION"
 395 >Privoxy</SPAN
 396 >:</P
 397 ><P
 398 > <P
 399 ></P
 400 ><UL
 401 ><LI
 402 ><P
 403 >
 404     Some installers may remove earlier versions completely, including
 405     configuration files. Save any important configuration files!
 406   </P
 407 ></LI
 408 ><LI
 409 ><P
 410 >
 411    On the other hand, other installers may not overwrite any existing configuration
 412    files, thinking you will want to do that. You may want to manually check
 413    your saved files against the newer versions to see if the improvements have
 414    merit, or whether there are new options that you may want to consider.
 415    There are a number of new features, but most won't be available unless
 416    these features are incorporated into your configuration somehow.
 417   </P
 418 ></LI
 419 ><LI
 420 ><P
 421 >     See the full documentation on
 422      <TT
 423 CLASS="LITERAL"
 424 ><A
 425 HREF="actions-file.html#FAST-REDIRECTS"
 426 >fast-redirects</A
 427 ></TT
 428 >
 429      which has changed syntax, and will require adjustments to local configs,
 430      such as <TT
 431 CLASS="FILENAME"
 432 >user.action</TT
 433 >. You must reference the new
 434      syntax:
 435    </P
 436 ><P
 437 > <TABLE
 438 BORDER="0"
 439 BGCOLOR="#E0E0E0"
 440 WIDTH="90%"
 441 ><TR
 442 ><TD
 443 ><PRE
 444 CLASS="SCREEN"
 445 >  { +fast-redirects{check-decoded-url} }
 446    .example.com
 447    mybank.com
 448    .google.</PRE
 449 ></TD
 450 ></TR
 451 ></TABLE
 452 ></P
 453 ></LI
 454 ><LI
 455 ><P
 456 >     The <TT
 457 CLASS="FILENAME"
 458 >jarfile</TT
 459 >,
 460      <A
 461 HREF="http://en.wikipedia.org/wiki/Browser_cookie"
 462 TARGET="_top"
 463 >cookie</A
 464 > logger, is off by default now.
 465     </P
 466 ></LI
 467 ><LI
 468 ><P
 469 >
 470    What constitutes a <SPAN
 471 CLASS="QUOTE"
 472 >"default"</SPAN
 473 > configuration has changed,
 474    and you may want to review which actions are <SPAN
 475 CLASS="QUOTE"
 476 >"on"</SPAN
 477 > by
 478    default. This is primarily a matter of emphasis, but some features
 479    you may have been used to, may now be <SPAN
 480 CLASS="QUOTE"
 481 >"off"</SPAN
 482 > by default.
 483    There are also a number of new actions and filters you may want to
 484    consider, most of which are not fully incorporated into the default
 485    settings as yet (see above).
 486   </P
 487 ></LI
 488 ><LI
 489 ><P
 490 >    The default actions setting is now <TT
 491 CLASS="LITERAL"
 492 >Cautious</TT
 493 >. Previous
 494     releases had a default setting of <TT
 495 CLASS="LITERAL"
 496 >Medium</TT
 497 >. Experienced
 498     users may want to adjust this, as it is fairly conservative by <SPAN
 499 CLASS="APPLICATION"
 500 >Privoxy</SPAN
 501 >
 502     standards and past practices. See <A
 503 HREF="http://config.privoxy.org/edit-actions-list?f=default"
 504 TARGET="_top"
 505 >    http://config.privoxy.org/edit-actions-list?f=default</A
 506 >. New users
 507     should try the default settings for a while before turning up the volume.
 508    </P
 509 ></LI
 510 ><LI
 511 ><P
 512 >    The default setting has filtering turned <SPAN
 513 CLASS="emphasis"
 514 ><I
 515 CLASS="EMPHASIS"
 516 >off</I
 517 ></SPAN
 518 >, which
 519     subsequently means that compression is <SPAN
 520 CLASS="emphasis"
 521 ><I
 522 CLASS="EMPHASIS"
 523 >on</I
 524 ></SPAN
 525 >. Remember
 526     that filtering does not work on compressed pages, so if you use, or want to
 527     use, filtering, you will need to force compression off. Example:
 528    </P
 529 ><P
 530 > <TABLE
 531 BORDER="0"
 532 BGCOLOR="#E0E0E0"
 533 WIDTH="90%"
 534 ><TR
 535 ><TD
 536 ><PRE
 537 CLASS="SCREEN"
 538 >  { +<A
 539 HREF="actions-file.html#FILTER"
 540 >filter</A
 541 >{google}  +<A
 542 HREF="actions-file.html#PREVENT-COMPRESSION"
 543 >prevent-compression</A
 544 > }
 545    .google.</PRE
 546 ></TD
 547 ></TR
 548 ></TABLE
 549 >
 550    </P
 551 ><P
 552 >    Or if you use a number of filters, or filter many sites, you may just want
 553     to turn off compression for all sites in
 554     <TT
 555 CLASS="FILENAME"
 556 >default.action</TT
 557 > (or
 558     <TT
 559 CLASS="FILENAME"
 560 >user.action</TT
 561 >).
 562    </P
 563 ></LI
 564 ><LI
 565 ><P
 566 >   Also, <A
 567 HREF="actions-file.html#SESSION-COOKIES-ONLY"
 568 >session-cookies-only</A
 569 > is
 570    off by default now. If you've liked this feature in the past, you may want
 571    to turn it back on in <TT
 572 CLASS="FILENAME"
 573 >user.action</TT
 574 > now.
 575   </P
 576 ></LI
 577 ><LI
 578 ><P
 579 >
 580    Some installers may not automatically start
 581    <SPAN
 582 CLASS="APPLICATION"
 583 >Privoxy</SPAN
 584 > after installation.
 585   </P
 586 ></LI
 587 ></UL
 588 ></P
 589 ></DIV
 590 ></DIV
 591 ><DIV
 592 CLASS="NAVFOOTER"
 593 ><HR
 594 ALIGN="LEFT"
 595 WIDTH="100%"><TABLE
 596 SUMMARY="Footer navigation table"
 597 WIDTH="100%"
 598 BORDER="0"
 599 CELLPADDING="0"
 600 CELLSPACING="0"
 601 ><TR
 602 ><TD
 603 WIDTH="33%"
 604 ALIGN="left"
 605 VALIGN="top"
 606 ><A
 607 HREF="installation.html"
 608 ACCESSKEY="P"
 609 >Prev</A
 610 ></TD
 611 ><TD
 612 WIDTH="34%"
 613 ALIGN="center"
 614 VALIGN="top"
 615 ><A
 616 HREF="index.html"
 617 ACCESSKEY="H"
 618 >Home</A
 619 ></TD
 620 ><TD
 621 WIDTH="33%"
 622 ALIGN="right"
 623 VALIGN="top"
 624 ><A
 625 HREF="quickstart.html"
 626 ACCESSKEY="N"
 627 >Next</A
 628 ></TD
 629 ></TR
 630 ><TR
 631 ><TD
 632 WIDTH="33%"
 633 ALIGN="left"
 634 VALIGN="top"
 635 >Installation</TD
 636 ><TD
 637 WIDTH="34%"
 638 ALIGN="center"
 639 VALIGN="top"
 640 >&nbsp;</TD
 641 ><TD
 642 WIDTH="33%"
 643 ALIGN="right"
 644 VALIGN="top"
 645 >Quickstart to Using Privoxy</TD
 646 ></TR
 647 ></TABLE
 648 ></DIV
 649 ></BODY
 650 ></HTML
 651 >