<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML
><HEAD
><TITLE
>Note to Upgraders</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
REL="HOME"
TITLE="Privoxy 3.0.3 User Manual"
HREF="index.html"><LINK
REL="PREVIOUS"
TITLE="Installation"
HREF="installation.html"><LINK
REL="NEXT"
TITLE="Quickstart to Using Privoxy"
HREF="quickstart.html"><LINK
REL="STYLESHEET"
TYPE="text/css"
HREF="../p_doc.css"></HEAD
><BODY
CLASS="SECT1"
BGCOLOR="#EEEEEE"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>Privoxy 3.0.3 User Manual</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="installation.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="quickstart.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="UPGRADERSNOTE"
>3. Note to Upgraders</A
></H1
><P
> There are very significant changes from earlier 
 <SPAN
CLASS="APPLICATION"
>Junkbuster</SPAN
> versions to the current
 <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
>. The number, names, syntax, and
 purposes of configuration files have substantially  changed.
 <SPAN
CLASS="APPLICATION"
>Junkbuster 2.0.x</SPAN
> configuration
 files will not migrate, <SPAN
CLASS="APPLICATION"
>Junkbuster 2.9.x</SPAN
>
 and <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
> configurations will need to be
 ported. The functionalities of the old <TT
CLASS="FILENAME"
>blockfile</TT
>,
 <TT
CLASS="FILENAME"
>cookiefile</TT
> and <TT
CLASS="FILENAME"
>imagelist</TT
> 
 are now combined into the <A
HREF="actions-file.html"
><SPAN
CLASS="QUOTE"
>"actions
 files"</SPAN
></A
>.  
 <TT
CLASS="FILENAME"
>default.action</TT
>, is the main actions file. Local
 exceptions should best be put into <TT
CLASS="FILENAME"
>user.action</TT
>.</P
><P
> A <A
HREF="filter-file.html"
><SPAN
CLASS="QUOTE"
>"filter file"</SPAN
></A
> (typically
 <TT
CLASS="FILENAME"
>default.filter</TT
>) is new as of <SPAN
CLASS="APPLICATION"
>Privoxy
 2.9.x</SPAN
>, and provides some of the new sophistication (explained
 below). <TT
CLASS="FILENAME"
>config</TT
> is much the same as before.</P
><P
> If upgrading from a 2.0.x version, you will have to use the new config 
 files, and possibly adapt any personal rules from your older files.
 When porting personal rules over from the old <TT
CLASS="FILENAME"
>blockfile</TT
>
 to the new actions files, please note that even the pattern syntax has
 changed. If upgrading from 2.9.x development versions, it is still
 recommended to use the new configuration files.</P
><P
> A quick list of things to be aware of before upgrading: </P
><P
> <P
></P
><UL
><LI
><P
>   The default listening port is now 8118 due to a conflict with another 
   service (NAS).
  </P
></LI
><LI
><P
>  
    Some installers may remove earlier versions completely. Save any 
    important configuration files!
  </P
></LI
><LI
><P
>   <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
> is controllable with a web browser 
   at the special URL: <A
HREF="http://config.privoxy.org/"
TARGET="_top"
>http://config.privoxy.org/</A
>
   (Shortcut: <A
HREF="http://p.p/"
TARGET="_top"
>http://p.p/</A
>). Many
   aspects of configuration can be done here, including temporarily disabling
   <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
>.
  </P
></LI
><LI
><P
>   The primary configuration files for cookie management, ad and banner 
   blocking, and many other aspects of <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
>
   configuration are the <A
HREF="actions-file.html"
>actions
   files</A
>. It is strongly recommended to become familiar with the new
   actions concept below, before modifying these files. Locally defined rules 
   should go into <TT
CLASS="FILENAME"
>user.action</TT
>.
  </P
></LI
><LI
><P
>   
   Some installers may not automatically start
   <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
> after installation.
  </P
></LI
></UL
></P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="installation.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="quickstart.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Installation</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
>&nbsp;</TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Quickstart to Using <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
>