tor-android/external/privoxy/doc/webserver/user-manual/upgradersnote.html

296 lines
4.8 KiB
HTML
Raw Normal View History

<!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
>