Generated
[privoxy.git] / doc / webserver / user-manual / installation.html
index b1669f9..0e18e16 100644 (file)
@@ -4,10 +4,9 @@
 >Installation</TITLE
 ><META
 NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
-"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.60"><LINK
 REL="HOME"
-TITLE="Privoxy User Manual"
+TITLE="Privoxy 2.9.16 User Manual"
 HREF="index.html"><LINK
 REL="PREVIOUS"
 TITLE="Introduction"
@@ -28,7 +27,6 @@ ALINK="#0000FF"
 ><DIV
 CLASS="NAVHEADER"
 ><TABLE
-SUMMARY="Header navigation table"
 WIDTH="100%"
 BORDER="0"
 CELLPADDING="0"
@@ -37,7 +35,7 @@ CELLSPACING="0"
 ><TH
 COLSPAN="3"
 ALIGN="center"
->Privoxy User Manual</TH
+>Privoxy 2.9.16 User Manual</TH
 ></TR
 ><TR
 ><TD
@@ -46,7 +44,6 @@ ALIGN="left"
 VALIGN="bottom"
 ><A
 HREF="introduction.html"
-ACCESSKEY="P"
 >Prev</A
 ></TD
 ><TD
@@ -60,7 +57,6 @@ ALIGN="right"
 VALIGN="bottom"
 ><A
 HREF="upgradersnote.html"
-ACCESSKEY="N"
 >Next</A
 ></TD
 ></TR
@@ -73,7 +69,9 @@ CLASS="SECT1"
 ><H1
 CLASS="SECT1"
 ><A
-NAME="INSTALLATION">2. Installation</H1
+NAME="INSTALLATION"
+>2. Installation</A
+></H1
 ><P
 > <SPAN
 CLASS="APPLICATION"
@@ -98,13 +96,10 @@ CLASS="APPLICATION"
 > installation on your system, you
  will need to remove it.  On some platforms, this may be done for you as part
  of their installation procedure. (See below for your platform). In any case
- <SPAN
-CLASS="emphasis"
-><I
+ <I
 CLASS="EMPHASIS"
 >be sure to backup your old configuration if it is valuable to
  you.</I
-></SPAN
 > See the <A
 HREF="upgradersnote.html"
 >note to
@@ -115,7 +110,9 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="INSTALLATION-PACKAGES">2.1. Binary Packages</H2
+NAME="INSTALLATION-PACKAGES"
+>2.1. Binary Packages</A
+></H2
 ><P
 >How to install the binary packages depends on your operating system:</P
 ><DIV
@@ -123,11 +120,13 @@ CLASS="SECT3"
 ><H3
 CLASS="SECT3"
 ><A
-NAME="INSTALLATION-PACK-RPM">2.1.1. Red Hat, SuSE and Conectiva RPMs</H3
+NAME="INSTALLATION-PACK-RPM"
+>2.1.1. Red Hat, SuSE and Conectiva RPMs</A
+></H3
 ><P
 > RPMs can be installed with <TT
 CLASS="LITERAL"
->rpm -Uvh privoxy-2.9.15-1.rpm</TT
+>rpm -Uvh privoxy-2.9.16-1.rpm</TT
 >,
  and will use <TT
 CLASS="FILENAME"
@@ -139,12 +138,9 @@ CLASS="FILENAME"
 CLASS="APPLICATION"
 >Privoxy</SPAN
 > will
- <SPAN
-CLASS="emphasis"
-><I
+ <I
 CLASS="EMPHASIS"
 >not</I
-></SPAN
 > be automatically started on system boot. You will
  need to enable that using <B
 CLASS="COMMAND"
@@ -159,7 +155,7 @@ automatically start Privoxy in the boot process.</P
 > If you have problems with failed dependencies, try rebuilding the SRC RPM: 
  <TT
 CLASS="LITERAL"
->rpm --rebuild privoxy-2.9.15-1.src.rpm</TT
+>rpm --rebuild privoxy-2.9.16-1.src.rpm</TT
 >. This 
  will use your locally installed libraries and RPM version. </P
 ><P
@@ -182,12 +178,14 @@ CLASS="SECT3"
 ><H3
 CLASS="SECT3"
 ><A
-NAME="INSTALLATION-DEB">2.1.2. Debian</H3
+NAME="INSTALLATION-DEB"
+>2.1.2. Debian</A
+></H3
 ><P
 > DEBs can be installed with <TT
 CLASS="LITERAL"
 >dpkg -i
- privoxy_2.9.15-1.deb</TT
+ privoxy_2.9.16-1.deb</TT
 >, and will use
  <TT
 CLASS="FILENAME"
@@ -200,7 +198,9 @@ CLASS="SECT3"
 ><H3
 CLASS="SECT3"
 ><A
-NAME="INSTALLATION-PACK-WIN">2.1.3. Windows</H3
+NAME="INSTALLATION-PACK-WIN"
+>2.1.3. Windows</A
+></H3
 ><P
 > Just double-click the installer, which will guide you through
  the installation process. You will find the configuration files
@@ -212,7 +212,9 @@ CLASS="SECT3"
 ><H3
 CLASS="SECT3"
 ><A
-NAME="INSTALLATION-PACK-BINTGZ">2.1.4. Solaris, NetBSD, FreeBSD, HP-UX</H3
+NAME="INSTALLATION-PACK-BINTGZ"
+>2.1.4. Solaris, NetBSD, FreeBSD, HP-UX</A
+></H3
 ><P
 > Create a new directory, <TT
 CLASS="LITERAL"
@@ -226,7 +228,9 @@ CLASS="SECT3"
 ><H3
 CLASS="SECT3"
 ><A
-NAME="INSTALLATION-OS2">2.1.5. OS/2</H3
+NAME="INSTALLATION-OS2"
+>2.1.5. OS/2</A
+></H3
 ><P
 > First, make sure that no previous installations of
  <SPAN
@@ -266,36 +270,49 @@ CLASS="SECT3"
 ><H3
 CLASS="SECT3"
 ><A
-NAME="INSTALLATION-MAC">2.1.6. Max OSX</H3
+NAME="INSTALLATION-MAC"
+>2.1.6. Mac OSX</A
+></H3
 ><P
 > Unzip the downloaded package (you can either double-click on the file
- in the finder, or on the desktop if you downloaded it there).  Then,
- double-click on the package installer icon and follow the installation
- process.
+ in the finder, or on the desktop if you downloaded it there).  The
+ Privoxy.pkg package should appear after unzipping. Then,
+ double-click on that Privoxy.pkg package installer icon and follow
+ the installation process.
  <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
-> will be installed in the subdirectory
+> will be installed in the folder
  <TT
 CLASS="LITERAL"
->/Applications/Privoxy.app</TT
+>/Library/Privoxy</TT
 >.
- <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
-> will set itself up to start 
- automatically on system bring-up via
+ It will run automatically whenever you start up.  To prevent it from
+ running automatically, remove or rename the folder
  <TT
 CLASS="LITERAL"
->/System/Library/StartupItems/Privoxy</TT
->.</P
+>/Library/StartupItems/Privoxy</TT
+>. </P
+><P
+> To run Privoxy by hand, double-click on 
+ <TT
+CLASS="LITERAL"
+>RunPrivoxy.command</TT
+>.
+ To run Privoxy from Terminal, execute
+ <TT
+CLASS="LITERAL"
+>/Library/Privoxy/RunPrivoxy.command</TT
+>. </P
 ></DIV
 ><DIV
 CLASS="SECT3"
 ><H3
 CLASS="SECT3"
 ><A
-NAME="INSTALLATION-AMIGA">2.1.7. AmigaOS</H3
+NAME="INSTALLATION-AMIGA"
+>2.1.7. AmigaOS</A
+></H3
 ><P
 > Copy and then unpack the <TT
 CLASS="FILENAME"
@@ -314,7 +331,9 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="INSTALLATION-SOURCE">2.2. Building from Source</H2
+NAME="INSTALLATION-SOURCE"
+>2.2. Building from Source</A
+></H2
 ><P
 > The most convenient way to obtain the <SPAN
 CLASS="APPLICATION"
@@ -377,8 +396,8 @@ WIDTH="100%"
 ><TD
 ><PRE
 CLASS="SCREEN"
-> tar xzvf privoxy-2.9.15-beta-src* [.tgz or .tar.gz]
- cd privoxy-2.9.15-beta</PRE
+> tar xzvf privoxy-2.9.16-beta-src* [.tgz or .tar.gz]
+ cd privoxy-2.9.16-beta</PRE
 ></TD
 ></TR
 ></TABLE
@@ -459,13 +478,73 @@ TARGET="_top"
 >developer manual</A
 >.</P
 ></DIV
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="INSTALLATION-KEEPUPDATED"
+>2.3. Keeping your Installation Up-to-Date</A
+></H2
+><P
+> As user feedback comes in and development continues, we will make updated versions
+ of both the software and the main <A
+HREF="actions-file.html"
+>actions file</A
+>
+ (<TT
+CLASS="LITERAL"
+>default.action</TT
+>) available for download.</P
+><P
+> If you wish to receive an email notification whenever we release updates of
+ <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> or the actions file, <A
+HREF="http://lists.sourceforge.net/lists/listinfo/ijbswa-announce/"
+TARGET="_top"
+>subscribe
+ to our announce  mailing list</A
+>, ijbswa-announce@lists.sourceforge.net.</P
+><P
+> Both can be downloaded from the <A
+HREF="http://sourceforge.net/project/showfiles.php?group_id=11118"
+TARGET="_top"
+>files
+ section</A
+> on <A
+HREF="http://sourceforge.net/"
+TARGET="_top"
+>SourceForge</A
+>.</P
+><P
+> In order not to loose your personal changes and adjustments when updating
+ to the latest <TT
+CLASS="LITERAL"
+>default.action</TT
+> file we <I
+CLASS="EMPHASIS"
+>strongly
+ recommend</I
+> that you use <TT
+CLASS="LITERAL"
+>user.action</TT
+> for your
+ customization of <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+>. See the <A
+HREF="actions-file.html"
+>Chapter on actions files</A
+> for details.</P
+></DIV
 ></DIV
 ><DIV
 CLASS="NAVFOOTER"
 ><HR
 ALIGN="LEFT"
 WIDTH="100%"><TABLE
-SUMMARY="Footer navigation table"
 WIDTH="100%"
 BORDER="0"
 CELLPADDING="0"
@@ -477,7 +556,6 @@ ALIGN="left"
 VALIGN="top"
 ><A
 HREF="introduction.html"
-ACCESSKEY="P"
 >Prev</A
 ></TD
 ><TD
@@ -486,7 +564,6 @@ ALIGN="center"
 VALIGN="top"
 ><A
 HREF="index.html"
-ACCESSKEY="H"
 >Home</A
 ></TD
 ><TD
@@ -495,7 +572,6 @@ ALIGN="right"
 VALIGN="top"
 ><A
 HREF="upgradersnote.html"
-ACCESSKEY="N"
 >Next</A
 ></TD
 ></TR