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.9 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.9 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.6</SPAN
  88 >, the last stable release:</P
  89 ><P
  90 > <P
  91 ></P
  92 ><UL
  93 ><LI
  94 ><P
  95 >    Two new actions <A
  96 HREF="actions-file.html#SERVER-HEADER-TAGGER"
  97 >server-header-tagger</A
  98 >
  99           and <A
 100 HREF="actions-file.html#CLIENT-HEADER-TAGGER"
 101 >client-header-tagger</A
 102 >
 103           that can be used to create arbitrary <SPAN
 104 CLASS="QUOTE"
 105 >"tags"</SPAN
 106 >
 107           based on client and server headers.
 108           These <SPAN
 109 CLASS="QUOTE"
 110 >"tags"</SPAN
 111 > can then subsequently be used
 112           to control the other actions used for the current request,
 113           greatly increasing <SPAN
 114 CLASS="APPLICATION"
 115 >Privoxy</SPAN
 116 >'s flexibility and selectivity. See <A
 117 HREF="actions-file.html#TAG-PATTERN"
 118 >tag patterns</A
 119 > for more information on tags.
 120    </P
 121 ></LI
 122 ><LI
 123 ><P
 124 >    Header filtering is done with dedicated header filters now. As a result
 125     the actions <SPAN
 126 CLASS="QUOTE"
 127 >"filter-client-headers"</SPAN
 128 > and <SPAN
 129 CLASS="QUOTE"
 130 >"filter-server-headers"</SPAN
 131 >
 132     that were introduced with <SPAN
 133 CLASS="APPLICATION"
 134 >Privoxy 3.0.5</SPAN
 135 > to apply
 136     content filters to the headers have been removed.
 137     See the new actions <A
 138 HREF="actions-file.html#SERVER-HEADER-FILTER"
 139 >server-header-filter</A
 140 >
 141           and <A
 142 HREF="actions-file.html#CLIENT-HEADER-FILTER"
 143 >client-header-filter</A
 144 > for details.
 145    </P
 146 ></LI
 147 ><LI
 148 ><P
 149 >     There are four new options for the main <TT
 150 CLASS="FILENAME"
 151 >config</TT
 152 > file:
 153    </P
 154 ><P
 155 ></P
 156 ><UL
 157 ><LI
 158 ><P
 159 >          <A
 160 HREF="config.html#ALLOW-CGI-REQUEST-CRUNCHING"
 161 >allow-cgi-request-crunching</A
 162 >
 163           which allows requests for Privoxy's internal CGI pages to be
 164           blocked, redirected or (un)trusted like ordinary requests.
 165         </P
 166 ></LI
 167 ><LI
 168 ><P
 169 >          <A
 170 HREF="config.html#SPLIT-LARGE-FORMS"
 171 >split-large-forms</A
 172 >
 173           that will work around a browser bug that caused IE6 and IE7 to
 174           ignore the Submit button on the Privoxy's edit-actions-for-url CGI
 175           page.
 176           </P
 177 ></LI
 178 ><LI
 179 ><P
 180 >          <A
 181 HREF="config.html#ACCEPT-INTERCEPTED-REQUESTS"
 182 >accept-intercepted-requests</A
 183 >
 184           which allows to combine Privoxy with any packet filter to create an
 185           intercepting proxy for HTTP/1.1 requests (and for HTTP/1.0 requests
 186           with Host header set). This means clients can be forced to use
 187           <SPAN
 188 CLASS="APPLICATION"
 189 >Privoxy</SPAN
 190 > even if their proxy settings are configured differently.
 191          </P
 192 ></LI
 193 ><LI
 194 ><P
 195 >          <A
 196 HREF="config.html#TEMPLDIR"
 197 >templdir</A
 198 >
 199           to designate an alternate location for <SPAN
 200 CLASS="APPLICATION"
 201 >Privoxy</SPAN
 202 >'s
 203           locally customized CGI templates so that
 204           these are not overwritten during upgrades.
 205         </P
 206 ></LI
 207 ></UL
 208 ></LI
 209 ><LI
 210 ><P
 211 >   A new command line option <TT
 212 CLASS="LITERAL"
 213 >--pre-chroot-nslookup hostname</TT
 214 > to
 215    initialize the resolver library before chroot'ing. On some systems this
 216    reduces the number of files that must be copied into the chroot tree.
 217    (Patch provided by Stephen Gildea)
 218    </P
 219 ></LI
 220 ><LI
 221 ><P
 222 >     The <A
 223 HREF="actions-file.html#FORWARD-OVERRIDE"
 224 >forward-override</A
 225 > action
 226      allows changing of the forwarding settings through the actions files.
 227      Combined with tags, this allows to choose the forwarder based on
 228      client headers like the <TT
 229 CLASS="LITERAL"
 230 >User-Agent</TT
 231 >, or the request origin.
 232   </P
 233 ></LI
 234 ><LI
 235 ><P
 236 >     The  <A
 237 HREF="actions-file.html#REDIRECT"
 238 >redirect</A
 239 > action can now use regular
 240           expression substitutions against the original URL.
 241    </P
 242 ></LI
 243 ><LI
 244 ><P
 245 >     <SPAN
 246 CLASS="APPLICATION"
 247 >zlib</SPAN
 248 > support is now available as a compile
 249      time option to filter compressed content. Patch provided by Wil Mahan.
 250    </P
 251 ></LI
 252 ><LI
 253 ><P
 254 >     Improve various filters, and add new ones.
 255    </P
 256 ></LI
 257 ><LI
 258 ><P
 259 >    Include support for RFC 3253 so that <TT
 260 CLASS="FILENAME"
 261 >Subversion</TT
 262 > works
 263     with <SPAN
 264 CLASS="APPLICATION"
 265 >Privoxy</SPAN
 266 >. Patch provided by Petr Kadlec.
 267    </P
 268 ></LI
 269 ><LI
 270 ><P
 271 >     Logging can be completely turned off by not specifying a logfile directive.
 272    </P
 273 ></LI
 274 ><LI
 275 ><P
 276 >     A number of improvements to Privoxy's internal CGI pages, including the
 277      use of favicons for error and control pages.
 278    </P
 279 ></LI
 280 ><LI
 281 ><P
 282 >     Many bugfixes, memory leaks addressed, code improvements, and logging
 283      improvements.
 284    </P
 285 ></LI
 286 ></UL
 287 ></P
 288 ><P
 289 > For a more detailed list of changes please have a look at the ChangeLog.</P
 290 ><DIV
 291 CLASS="SECT2"
 292 ><H2
 293 CLASS="SECT2"
 294 ><A
 295 NAME="UPGRADERSNOTE"
 296 >3.1. Note to Upgraders</A
 297 ></H2
 298 ><P
 299 > A quick list of things to be aware of before upgrading from earlier
 300  versions of <SPAN
 301 CLASS="APPLICATION"
 302 >Privoxy</SPAN
 303 >:</P
 304 ><P
 305 > <P
 306 ></P
 307 ><UL
 308 ><LI
 309 ><P
 310 >   The recommended way to upgrade <SPAN
 311 CLASS="APPLICATION"
 312 >Privoxy</SPAN
 313 > is to backup your old
 314    configuration files, install the new ones, verify that <SPAN
 315 CLASS="APPLICATION"
 316 >Privoxy</SPAN
 317 >
 318    is working correctly and finally merge back your changes using
 319    <SPAN
 320 CLASS="APPLICATION"
 321 >diff</SPAN
 322 > and maybe <SPAN
 323 CLASS="APPLICATION"
 324 >patch</SPAN
 325 >.
 326   </P
 327 ><P
 328 >   There are a number of new features in each <SPAN
 329 CLASS="APPLICATION"
 330 >Privoxy</SPAN
 331 > release and
 332    most of them have to be explicitly enabled in the configuration
 333    files. Old configuration files obviously don't do that and due
 334    to syntax changes using old configuration files with a new
 335    <SPAN
 336 CLASS="APPLICATION"
 337 >Privoxy</SPAN
 338 > isn't always possible anyway.
 339   </P
 340 ></LI
 341 ><LI
 342 ><P
 343 >
 344     Note that some installers remove earlier versions completely,
 345     including configuration files, therefore you should really save
 346     any important configuration files!
 347   </P
 348 ></LI
 349 ><LI
 350 ><P
 351 >
 352    On the other hand, other installers don't overwrite existing configuration
 353    files, thinking you will want to do that yourself.
 354   </P
 355 ></LI
 356 ><LI
 357 ><P
 358 >
 359    <TT
 360 CLASS="FILENAME"
 361 >standard.action</TT
 362 > now only includes the enabled actions.
 363    Not all actions as before.
 364   </P
 365 ></LI
 366 ><LI
 367 ><P
 368 >   In the default configuration only fatal errors are logged now.
 369    You can change that in the <A
 370 HREF="config.html#DEBUG"
 371 >debug section</A
 372 >
 373    of the configuration file. You may also want to enable more verbose
 374    logging until you verified that the new <SPAN
 375 CLASS="APPLICATION"
 376 >Privoxy</SPAN
 377 > version is working
 378    as expected.
 379   </P
 380 ></LI
 381 ><LI
 382 ><P
 383 >     Three other config file settings are now off by default:
 384      <A
 385 HREF="config.html#ENABLE-REMOTE-TOGGLE"
 386 >enable-remote-toggle</A
 387 >,
 388      <A
 389 HREF="config.html#ENABLE-REMOTE-HTTP-TOGGLE"
 390 >enable-remote-http-toggle</A
 391 >,
 392      and  <A
 393 HREF="config.html#ENABLE-EDIT-ACTIONS"
 394 >enable-edit-actions</A
 395 >.
 396      If you use or want these, you will need to explicitly enable them, and
 397      be aware of the security issues involved.
 398     </P
 399 ></LI
 400 ><LI
 401 ><P
 402 >    The <SPAN
 403 CLASS="QUOTE"
 404 >"filter-client-headers"</SPAN
 405 > and
 406     <SPAN
 407 CLASS="QUOTE"
 408 >"filter-server-headers"</SPAN
 409 > actions that were introduced with
 410     <SPAN
 411 CLASS="APPLICATION"
 412 >Privoxy 3.0.5</SPAN
 413 > to apply content filters to
 414     the headers  have been removed and replaced with new actions.
 415     See the <A
 416 HREF="whatsnew.html"
 417 >What's New section</A
 418 > above.
 419    </P
 420 ></LI
 421 ></UL
 422 ></P
 423 ></DIV
 424 ></DIV
 425 ><DIV
 426 CLASS="NAVFOOTER"
 427 ><HR
 428 ALIGN="LEFT"
 429 WIDTH="100%"><TABLE
 430 SUMMARY="Footer navigation table"
 431 WIDTH="100%"
 432 BORDER="0"
 433 CELLPADDING="0"
 434 CELLSPACING="0"
 435 ><TR
 436 ><TD
 437 WIDTH="33%"
 438 ALIGN="left"
 439 VALIGN="top"
 440 ><A
 441 HREF="installation.html"
 442 ACCESSKEY="P"
 443 >Prev</A
 444 ></TD
 445 ><TD
 446 WIDTH="34%"
 447 ALIGN="center"
 448 VALIGN="top"
 449 ><A
 450 HREF="index.html"
 451 ACCESSKEY="H"
 452 >Home</A
 453 ></TD
 454 ><TD
 455 WIDTH="33%"
 456 ALIGN="right"
 457 VALIGN="top"
 458 ><A
 459 HREF="quickstart.html"
 460 ACCESSKEY="N"
 461 >Next</A
 462 ></TD
 463 ></TR
 464 ><TR
 465 ><TD
 466 WIDTH="33%"
 467 ALIGN="left"
 468 VALIGN="top"
 469 >Installation</TD
 470 ><TD
 471 WIDTH="34%"
 472 ALIGN="center"
 473 VALIGN="top"
 474 >&nbsp;</TD
 475 ><TD
 476 WIDTH="33%"
 477 ALIGN="right"
 478 VALIGN="top"
 479 >Quickstart to Using Privoxy</TD
 480 ></TR
 481 ></TABLE
 482 ></DIV
 483 ></BODY
 484 ></HTML
 485 >