Fix up privoxy.org/actions/
[privoxy.git] / doc / source / faq.sgml
index 4823b2a..b566aa9 100644 (file)
@@ -4,6 +4,16 @@
 <!entity newfeatures SYSTEM "newfeatures.sgml">
 <!entity p-intro SYSTEM "privoxy.sgml">
 <!entity seealso SYSTEM "seealso.sgml">
+<!entity contacting SYSTEM "contacting.sgml">
+<!entity history SYSTEM "history.sgml">
+<!entity copyright SYSTEM "copyright.sgml">
+<!entity p-version "2.9.14">
+<!entity p-status "beta">
+<!entity % p-not-stable "INCLUDE">
+<!entity % p-stable "IGNORE">
+<!entity % p-text "IGNORE">        <!-- define we are not a text only doc -->
+<!entity % p-doc "INCLUDE">        <!-- and we are a formal doc           -->
+<!entity % p-supp-userman "INCLUDE"> <!-- Include all from supported.sgml -->
 ]>
 <!--
  File        :  $Source: /cvsroot/ijbswa/current/doc/source/faq.sgml,v $
@@ -12,7 +22,7 @@
                 This file belongs into
                 ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/
                 
- $Id: faq.sgml,v 1.37 2002/04/01 16:24:07 hal9 Exp $
+ $Id: faq.sgml,v 1.45 2002/04/08 22:59:26 hal9 Exp $
 
  Written by and Copyright (C) 2001 the SourceForge
  Privoxy team. http://www.privoxy.org/
  by and Copyright (C) 1997 Anonymous Coders and 
  Junkbusters Corporation.  http://www.junkbusters.com
 
- =============================================================
- IMPORTANT: READ: This document does not use automatic section
- numbering. It is turned off by GNUmakefile to keep the Table 
- of contents from being so messy. Sections will need to be 
- manually numbered as a consequence.
- =============================================================
+ <Qandaset defaultlabel='qanda'>
+  <QandAEntry>
+   <question>
+    <para> 
+     How are you?
+    </para>
+   </question>
+   <answer>
+    <para> 
+     Fine.
+    </para>
+   </answer>
+  </QandAEntry>
+ </QandASet>
+
+ ========================================================================
+ NOTE: Please read developer-manual/documentation.html before touching 
+ anything in this, or other Privoxy documentation. You have been warned!
+ Failure to abide by this rule will result in the revocation of your license 
+ to live a peaceful existence!
+ ========================================================================
 
 -->
 
 
-<article id="index">
+<article id="index" class="faq">
 <artheader>
 <title>Privoxy Frequently Asked Questions</title>
 
-<pubdate>$Id: faq.sgml,v 1.37 2002/04/01 16:24:07 hal9 Exp $</pubdate>
+<pubdate>$Id: faq.sgml,v 1.45 2002/04/08 22:59:26 hal9 Exp $</pubdate>
 
 <authorgroup>
  <author>
 ]]>
  <para>
  This FAQ gives users and developers alike answers to frequently asked
- questions about <ulink url="http://www.privoxy.org">Privoxy</ulink>. 
+ questions about <ulink url="http://www.privoxy.org">Privoxy</ulink> 
+ <![%p-stable;[ v.&p-version]]>.
  </para>
 
-<!--
- Include privoxy.sgml boilerplate:
--->
+<!-- Include privoxy.sgml boilerplate: -->
  &p-intro;
+<!-- end boilerplate -->
 
  <para>
   You can find the latest version of the document at <ulink
   url="http://www.privoxy.org/faq/">http://www.privoxy.org/faq/</ulink>.
-  Please see the Contact section in the <ulink
-  url="http://www.privoxy.org/user-manual/contact.html">user-manual</ulink> if
-  you want to contact the developers.
+  Please see the Contact section if you want to contact the developers.
  </para>
 
 <!--   <para> -->
 </abstract>
 </artheader>
 
-
 <!--   ~~~~~       New section      ~~~~~     -->
-<sect1 id="intro">
-<title></title>
+<sect1 id="intro" label=""><title></title>
 <!-- dummy section to force TOC on page by itself -->
 <!-- DO NOT REMOVE! please ;) -->
 <para> </para>
 
 <!--   ~~~~~       New section      ~~~~~     -->
 
-<sect1 id="general"><title>1. General Information</title>
+<sect1 label="1" id="general"><title>General Information</title>
 
-<sect2 id="newjb"><title>What is this new version of <application>Privoxy</application>?</title>
+<sect2 renderas="sect3" id="newjb"><title>What is this new version of <application>Privoxy</application>?</title>
  <para>
-  The original <application>Internet Junkbuster</application> (tm) is a 
-  copyrighted product of <ulink url="http://www.junkbusters.com">Junkbusters
-  Corporation</ulink>. Development of this effort stopped some time ago as of
-  version 2.0.2. Stefan Waldherr started the ijbswa project on <ulink
-  url="http://sourceforge.net/projects/ijbswa/">Sourceforge</ulink> to rekindle
-  development. Other developers subsequently joined with Stefan, and have
-  since added many new features, refinements and enhancements. The result 
+  The original <application><trademark>Internet
+  Junkbuster</trademark></application> (tm) is a copyrighted product of <ulink
+  url="http://www.junkbusters.com">Junkbusters Corporation</ulink>.
+  Development of this effort stopped some time ago as of version 2.0.2. Stefan
+  Waldherr started the ijbswa project on <ulink
+  url="http://sourceforge.net/projects/ijbswa/">Sourceforge</ulink> to
+  rekindle development. Other developers subsequently joined with Stefan, and
+  have since added many new features, refinements and enhancements. The result
   of this effort is <application>Privoxy</application>.
  </para>
  <para>
-  <application>Privoxy</application> started with the 
-  <application>Junkbuster 2.0.2</application> code base, but has advanced
+  <application>Privoxy</application> has evolved from the 
+  <application>Junkbuster 2.0.2</application> code base, and has advanced
   significantly at this point. 
  </para>
  <para> 
-  Please see the <ulink
-  url="../user-manual/copyright.html#HISTORY">user-manual</ulink> for more
+  Please see the <link linkend="copyright">History section</link> for more
   information on the history of <application>Junkbuster</application> and 
   <application>Privoxy</application>.
  </para>
 </sect2>
 
 
-<sect2>
+<sect2 renderas="sect3">
 <title id="whyprivoxy">Why <quote>Privoxy</quote>? Why a name change at all?</title>
 <para>
  <application>Privoxy</application> is the 
  <quote><emphasis>Privacy Enhancing Proxy</emphasis></quote>.
 </para>
 <para>
- There are possible legal complications from the continued use of the 
- <application>Junkbuster</application> name, which is a trademark of 
+ There are potential legal complications from the continued use of the 
+ <application>Junkbuster</application> name, which is a registered trademark of 
  <ulink url="http://junkbusters.com">Junkbusters Corporation</ulink>.
+ And thus they <quote>own</quote> the rights to the name.
  (There are, however, no objections from Junkbusters Corporation to the 
  <application>Privoxy</application> project itself, and they, in fact, still
  share our ideals and goals.)
 </para>
 
 <para>
- The developers also believed that there so many changes from the original 
+ The developers also believed that there are so many changes from the original 
  code, that it was time to make a clean break from the past and make 
- a name in their own right, especially now with the pending release of 
- version 3.0.
-
+ a name in their own right<![%p-not-stable;[, especially now with the pending
+ release of version 3.0]]>.
 </para>
 </sect2>
 
 
-<sect2 id="differs"><title>How does <application>Privoxy</application> differ
+<sect2 renderas="sect3" id="differs"><title>How does <application>Privoxy</application> differ
 from the old <application>Junkbuster?</application></title> 
 <para>
   <application>Privoxy</application> picks up where
@@ -154,23 +175,22 @@ from the old <application>Junkbuster?</application></title>
  </para>
  <para>
   The configuration has changed significantly as well. This is something that
-  users will notice right off the bat. The <quote>blocklist</quote> file does
-  not exist any more. This is replaced by <quote>actions</quote> files, such
-  as <filename>default.actions</filename>. This is where most of the per site
-  configuration is now.
-
+  users will notice right off the bat if you are upgrading from 
+  <application>Junkbuster</application> 2.0.x. The <quote>blocklist</quote>
+  file does not exist any more. This is replaced by <quote>actions</quote>
+  files, such as <filename>default.actions</filename>. This is where most of
+  the per site configuration is now.
  </para>
 </sect2>
 
-<sect2 id="features"><title>What are some of the new features?</title>
-<!--
-Include newfeatures.sgml
---> 
-&newfeatures;
+<sect2 renderas="sect3" id="features"><title>What are some of the new features?</title>
+<!-- Include newfeatures.sgml: --> 
+ &newfeatures;
+<!-- end include -->
 
 </sect2>
 
-<sect2 id="proxymoron"><title>What is a <quote>proxy</quote>? How does
+<sect2 renderas="sect3" id="proxymoron"><title>What is a <quote>proxy</quote>? How does
 <application>Privoxy</application> work? </title>
  <para>
   When you connect to a web site with <application>Privoxy</application>, 
@@ -200,7 +220,7 @@ Include newfeatures.sgml
 </sect2>
 
 
-<sect2>
+<sect2 renderas="sect3">
 <title id="knows">How does <application>Privoxy</application> know what is
 an ad, and what is not?</title>
 <para>
@@ -227,7 +247,7 @@ an ad, and what is not?</title>
 </para>
 </sect2>
 
-<sect2>
+<sect2 renderas="sect3">
 <title id="mistakes">Can <application>Privoxy</application> make mistakes? 
 This does not sound very scientific.</title>
 <para>
@@ -242,13 +262,13 @@ This does not sound very scientific.</title>
  <application>Privoxy</application> configuration is very flexible, and
  includes tools to help identify these types of situations so they can be
  addressed as needed, allowing you to customize your installation.
- (<link linkend="badsite">See the appendix below</link>.)
+ (<link linkend="badsite">See the Troubleshooting section below</link>.)
 </para>
 
 </sect2>
 
 
-<sect2 id="browsers2"><title>My browser does the same things as
+<sect2 renderas="sect3" id="browsers2"><title>My browser does the same things as
 <application>Privoxy</application>. Why should I use
 <application>Privoxy</application> at all?</title>
  <para>
@@ -268,15 +288,13 @@ This does not sound very scientific.</title>
 
 
 
-<sect2 id="license"><title>Is there is a license or fee? What about a 
+<sect2 renderas="sect3" id="license"><title>Is there is a license or fee? What about a 
 warranty? Registration?</title>
  <para>
-  <application>Privoxy</application> is licensed under the 
-  GNU General Public License (GPL). It is free to use, copy, 
-  modify or distribute as you wish under the terms of this license.
-  Please see the 
-<ulink url="../user-manual/copyright.html#HISTORY">user-manual</ulink> for 
- more information on the license and copyright.
+  <application>Privoxy</application> is licensed under the GNU General Public
+  License (GPL). It is free to use, copy, modify or distribute as you wish
+  under the terms of this license.  Please see the Copyright section for more
+  information on the license and copyright.
 
   </para>
  <para>
@@ -289,9 +307,9 @@ warranty? Registration?</title>
 
 </sect2>
 
-<sect2 id="jointeam"><title>I would like to help you, what do I do?</title>
+<sect2 renderas="sect3" id="jointeam"><title>I would like to help you, what do I do?</title>
 
-<sect3 id="jointeam-money"><title>Money Money Money</title>
+<sect3 renderas="sect4" id="jointeam-money"><title>Money Money Money</title>
 <para>
  We, of course, welcome donations and use the money for domain registering,
  regular world-wide get-togethers (hahaha). Anyway, we'll soon describe the
@@ -299,12 +317,12 @@ warranty? Registration?</title>
 </para>
 </sect3>
 
-<sect3 id="jointeam-work"><title>You want to work with us?</title>
+<sect3 renderas="sect4" id="jointeam-work"><title>You want to work with us?</title>
 <para>
    Well, helping the team is always a good idea. We welcome new developers,
    RPM gurus or documentation makers. Simply get an account on sourceforge.net
    and mail your id to the developer mailing list. Then read the
-   section Quickstart in the <ulink url="http://privoxy.org/developer-manual/quickstart.html">
+   section Quickstart in the <ulink url="../developer-manual/quickstart.html">
    Developer's Manual</ulink>.
 </para>
 <para>
@@ -320,9 +338,9 @@ warranty? Registration?</title>
 
 <!--   ~~~~~       New section      ~~~~~     -->
 
-<sect1 id="installation"><title>2. Installation</title>
+<sect1  label="2" id="installation"><title>Installation</title>
 
-<sect2 id="whichbrowsers">
+<sect2 renderas="sect3" id="whichbrowsers">
 <title>Which browsers are supported by <application>Privoxy</application>?</title>
 <para>
  Any browser that can be configured to use a <quote>proxy</quote>, which 
@@ -333,7 +351,7 @@ warranty? Registration?</title>
 </para>
 </sect2>
 
-<sect2 id="whichos">
+<sect2 renderas="sect3" id="whichos">
 <title>Which operating systems are supported?</title>
 <!--
 Include supported.sgml here:
@@ -341,7 +359,7 @@ Include supported.sgml here:
 &supported;
 </sect2>
 
-<sect2 id="newinstall"><title>Can I install  
+<sect2 renderas="sect3" id="newinstall"><title>Can I install  
  <application>Privoxy</application> over <application>Junkbuster</application>?</title>
  <para>
    We recommend you uninstall <application>Junkbuster</application>
@@ -352,8 +370,7 @@ Include supported.sgml here:
  <para>
   See the <ulink
   url="../user-manual/index.html">user-manual</ulink> for
-  platform specific installation instructions. [FIXME: This is meant for after
-  the name change for 3.0!]
+  platform specific installation instructions.
  </para>
  <para>
   Note: Some installers may automatically uninstall
@@ -362,7 +379,7 @@ Include supported.sgml here:
 
 </sect2>
 
-<sect2>
+<sect2 renderas="sect3">
 <title id="firststep">I just installed <application>Privoxy</application>. Is there anything 
 special I have to do now?</title>
 
@@ -378,7 +395,7 @@ special I have to do now?</title>
 </sect2>
 
 
-<sect2 id="localhost"><title>What is the proxy address of <application>Privoxy</application>?</title>
+<sect2 renderas="sect3" id="localhost"><title>What is the proxy address of <application>Privoxy</application>?</title>
  <para>
   If you set up the <application>Privoxy</application> to run on
   the computer you browse from (rather than your ISP's server or some
@@ -409,7 +426,7 @@ special I have to do now?</title>
  </para>
 </sect2>
 
-<sect2>
+<sect2 renderas="sect3">
 <title id="nothing">I just installed <application>Privoxy</application>, and nothing is happening.
 All the ads are there. What's wrong?</title>
 
@@ -434,12 +451,12 @@ All the ads are there. What's wrong?</title>
 
 <!--   ~~~~~       New section      ~~~~~     -->
 
-<sect1 id="configuration"><title>3. Configuration</title>
+<sect1  label="3" id="configuration"><title>Configuration</title>
 
-<sect2 id="newconfig"><title>Can I use my old config files?</title>
+<sect2 renderas="sect3" id="newconfig"><title>Can I use my old config files?</title>
  <para>
-   There are major changes to <application>Junkbuster</application>, 
-   <application>Privoxy</application>, configuration from version 2.0.x to
+   There are major changes to <application>Junkbuster</application>/ 
+   <application>Privoxy</application> configuration from version 2.0.x to
    2.9.x and later. Most of the older files will not work at all. This is 
    especially true of <filename>blocklist</filename>. If this is the case, you
    will need to re-enter your old data into the new configuration structure.
@@ -448,7 +465,7 @@ All the ads are there. What's wrong?</title>
  </para>
 </sect2>
 
-<sect2>
+<sect2 renderas="sect3">
 <title id="actionsfile">What is an <quote>actions</quote> file?</title>
 
 <para>
@@ -477,8 +494,8 @@ All the ads are there. What's wrong?</title>
 
 </sect2>
 
-<sect2 id="actionss">
-<title>The <quote>actions</quote>concept confuses me. Please list 
+<sect2 renderas="sect3" id="actionss">
+<title>The <quote>actions</quote> concept confuses me. Please list 
 some of these <quote>actions</quote>.</title>
 <para>
  These are all explained in the 
@@ -488,7 +505,7 @@ some of these <quote>actions</quote>.</title>
 </sect2>
 
 
-<sect2>
+<sect2 renderas="sect3">
 <title id="actconfig">How are actions files configured? What is the easiest
 way to do this?</title> 
 
@@ -514,26 +531,26 @@ way to do this?</title>
 <!--
 FIXME: Commenting these out until we have some data there. HB 03/17/02.
 
-<sect2 id="yahoo"><title>How can I make my Yahoo account work?</title>
+<sect2 renderas="sect3" id="yahoo"><title>How can I make my Yahoo account work?</title>
  <para>
    Fillme.
  </para>
 </sect2>
 
-<sect2 id="hotmail"> <title>How can I make my Hotmail account work?</title>
+<sect2 renderas="sect3" id="hotmail"> <title>How can I make my Hotmail account work?</title>
   <para>
    Fillme.
   </para>
 </sect2>
 
-<sect2 id="gmx"> <title>How can I make my GMX account work?</title>
+<sect2 renderas="sect3" id="gmx"> <title>How can I make my GMX account work?</title>
  <para>
    Fillme.
  </para>
 </sect2>
 -->
 
-<sect2 id="configfiles"> <title>What are the differences between
+<sect2 renderas="sect3" id="configfiles"> <title>What are the differences between
 intermediate.action, basic.action, etc.?</title>
  <para>
 Configuring <application>Privoxy</application> is not easy. To help you get
@@ -680,33 +697,34 @@ following table shows you, which features are enabled in each configuration.
 </para>
 </sect2>
 
-<sect2 id="browseconfig"> <title>Why can I change the configuration with a
+<sect2 renderas="sect3" id="browseconfig"> <title>Why can I change the configuration with a
 browser? Does that not raise security issues?</title>
  <para>
 What I don't understand, is how I can browser edit the config file as a
-regular user, while the whole /etc/privoxy hierarchy belongs to the user
-"privoxy", with only 644 perms.
+regular user, while the whole <filename>/etc/privoxy</filename> hierarchy
+belongs to the user <quote>privoxy</quote>, with only 644 permissions.
  </para>
  <para>
 When you use the browser-based editor, <application>Privoxy</application>
 itself is writing to the config files.  Because
-<application>Privoxy</application> is running as the user "privoxy", it can
+<application>Privoxy</application> is running as the user <quote>privoxy</quote>, it can
 update the config files.
  </para>
  <para>
-If you don't like this, setting "enable-edit-actions 0" in the config file
-will disable the browser-based editor.  If you're that paranoid, you should
-also consider setting "enable-remote-toggle 0" to prevent browser-based
-enabling/disabling of <application>Privoxy</application>.
+If you don't like this, setting <quote>enable-edit-actions 0</quote> in the
+config file will disable the browser-based editor.  If you're that paranoid,
+you should also consider setting <quote>enable-remote-toggle 0</quote> to prevent
+browser-based enabling/disabling of <application>Privoxy</application>.
  </para>
  <para>
-Note that normally only local users can connect to <application>Privoxy</application>, so this is not
-(normally) a security problem.
+Note that normally only local users can connect to
+<application>Privoxy</application>, so this is not (normally) a security
+problem.
  </para>
 </sect2>
 
 
-<sect2>
+<sect2 renderas="sect3">
 <title id="filterfile">What is <quote>default.filter</quote>?</title>
 <para>
  The <quote>default.filter</quote> file is used to <quote>filter</quote> any
@@ -731,7 +749,7 @@ Note that normally only local users can connect to <application>Privoxy</applica
 
 </sect2>
 
-<sect2>
+<sect2 renderas="sect3">
 <title id="lanconfig">How can I set up <application>Privoxy</application> to act as a proxy for my 
  LAN?</title>
 <para>
@@ -758,7 +776,7 @@ Note that normally only local users can connect to <application>Privoxy</applica
 </sect2>
 
 
-<sect2>
+<sect2 renderas="sect3">
 <title id="noseeum">Instead of ads, now I get a checkerboard pattern. I don't want to see anything.</title>
 <para>
  This is a configuration option for images that
@@ -783,7 +801,7 @@ Note that normally only local users can connect to <application>Privoxy</applica
 </sect2>
 
 
-<sect2>
+<sect2 renderas="sect3">
 <title id="whyseeum">Why would anybody want to see a checkerboard pattern?</title>
 <para>
  This can be helpful for troubleshooting problems. It might also be good 
@@ -795,7 +813,7 @@ Note that normally only local users can connect to <application>Privoxy</applica
 
 </sect2>
 
-<sect2>
+<sect2 renderas="sect3">
 <title id="blockedisugly">I see large red banners on some pages that say 
 <quote>Blocked</quote>. Why and how do I get rid of this?</title>
 <para>
@@ -848,7 +866,7 @@ Note that normally only local users can connect to <application>Privoxy</applica
 
 </sect2>
 
-<sect2 id="alliseeisred">
+<sect2 renderas="sect3" id="alliseeisred">
 <title>I cannot see all of the <quote>Blocked</quote> page banner. All I
 see is a bright red square.</title>
 <para>
@@ -859,7 +877,26 @@ see is a bright red square.</title>
 </para>
 </sect2>
 
-<sect2 id="otherproxy">
+<sect2 renderas="sect3" id="srvany">
+<title>Can <application>Privoxy</application> run as a service 
+on Win2K/NT?</title>
+<para>
+ Yes, it can run as a system service using <command>srvany.exe</command>.
+ The only catch is that this will effectively disable the
+ <application>Privoxy</application> icon in the taskbar. You can have 
+ one or the other, but not both at this time :( 
+</para>
+<para>
+ There is a pending feature request for this functionality. See 
+ thread: <ulink
+ url="http://sourceforge.net/tracker/?func=detail&#38;atid=361118&#38;aid=485617&#38;group_id=11118">http://sourceforge.net/tracker/?func=detail&#38;atid=361118&#38;aid=485617&#38;group_id=11118</ulink>, 
+ for details, and a sample configuration.
+
+</para>
+</sect2>
+
+
+<sect2 renderas="sect3" id="otherproxy">
 <title>How can I make <application>Privoxy</application> work with other 
 proxies like <application>Squid</application>?</title>
 <para>
@@ -875,9 +912,9 @@ proxies like <application>Squid</application>?</title>
 
 <!--   ~~~~~       New section      ~~~~~     -->
 
-<sect1 id="misc"><title>4. Miscellaneous</title>
+<sect1  label="4"id="misc"><title>Miscellaneous</title>
 
-<sect2>
+<sect2 renderas="sect3">
 <title id="slowsme">How much does <application>Privoxy</application> slow my browsing down? This 
 has to add extra time to browsing.</title>
 <para>
@@ -899,7 +936,7 @@ has to add extra time to browsing.</title>
 
 
 
-<sect2 id="loadingtimes"><title>I noticed considerable
+<sect2 renderas="sect3" id="loadingtimes"><title>I noticed considerable
 delays in page requests compared to the old Junkbuster. What's wrong?</title>
 <para>
 Using the default filtering configuration, I noticed considerable delays in
@@ -921,79 +958,81 @@ entire page first, do its content magic and then send the page to the browser.
 </sect2>
 
 
-<sect2 id="configurl"><title>What is the "http://p.p/"?</title>
+<sect2 renderas="sect3" id="configurl"><title>What is the "http://p.p/"?</title>
 <para>
 Since <application>Privoxy</application> sits between your web browser and the Internet, it can be
 programmed to handle certain pages specially.
 </para>
 
 <para>
-With recent versions of <application>Privoxy</application> (version 2.9.x), you can get some
-information about <application>Privoxy</application> and change some settings by going to
-<ulink url="http://p.p/">http://p.p/</ulink> or, equivalently, <ulink url="http://config.privoxy.org/">http://config.privoxy.org/</ulink>
-(Note that p.p is far easier to type but may not work in some
-configurations. With the name change to <application>Privoxy</application>,
-this is changed from the previous http://i.j.b/ or earlier 2.9.x versions).
+ With recent versions of <application>Privoxy</application> (version 2.9.x and
+ greater), you can get some information about
+ <application>Privoxy</application> and change some settings by going to
+ <ulink url="http://p.p/">http://p.p/</ulink> or, equivalently, <ulink
+ url="http://config.privoxy.org/">http://config.privoxy.org/</ulink> (Note
+ that p.p is far easier to type but may not work in some configurations. With
+ the name change to <application>Privoxy</application>, this is changed from
+ the previous http://i.j.b/ and earlier 2.9.x versions).
 </para>
 
 <para>
-These pages are <emphasis>not</emphasis> forwarded to a server on the Internet
-- instead they are handled by a special web server which is built in to
-<application>Privoxy</application>.
+ These pages are <emphasis>not</emphasis> forwarded to a server on the
+ Internet - instead they are handled by a special web server which is built in to
+  <application>Privoxy</application>.
 </para>
 
 <para>
-If you are not running <application>Privoxy</application>, then <ulink
-url="http://p.p/">http://p.p/</ulink> will fail, and <ulink
-url="http://config.privoxy.org/">http://config.privoxy.org/</ulink> will
-return a web page telling you you're not running
-<application>Privoxy</application>.
+ If you are not running <application>Privoxy</application>, then <ulink
+ url="http://p.p/">http://p.p/</ulink> will fail, and <ulink
+ url="http://config.privoxy.org/">http://config.privoxy.org/</ulink> will
+ return a web page telling you you're not running
+ <application>Privoxy</application>.
 </para>
 
 <para>
-If you have version 2.0.2, then the equivalent is
-http://example.com/show-proxy-args (but you get far less information, and you
-should really consider upgrading to 2.9.x).
+ If you have version 2.0.2, then the equivalent is
+ http://example.com/show-proxy-args (but you get far less information, and
+ you should really consider upgrading to &p-version;).
 </para>
 </sect2>
 
 <!--
 FIXME: commented out until we have data. HB 03/18/02.
 
-<sect2 id="badfiledesc"><title>I get the message 'Bad File Descriptor', why?</title>
+<sect2 renderas="sect3" id="badfiledesc"><title>I get the message 'Bad File Descriptor', why?</title>
 <para>
    Fillme.
 </para>
 </sect2>
 
-<sect2 id="proxy-chaining"><title>How do I chain <application>Privoxy</application> with other proxies
-(e.g. squid)?</title>
-<para>
-   Fillme.
-</para>
-</sect2>
 -->
 
-<sect2 id="blocklist"><title>Do you still maintain the blocklists?</title>
+<sect2 renderas="sect3" id="blocklist"><title>Do you still maintain the blocklists?</title>
 <para>
-    No. The format of the blocklists has changed significantly in the versions
-    2.9.x. Once we have released the new stable version, v3.0, there will
-    again be blocklists that you can update automatically.
+    No, not by this name. The format of the blocklists has changed
+    significantly in versions 2.9.x and later. This functionality 
+    is done by the <quote>actions</quote> file now. See next question ...
 </para>
 </sect2>
 
-<sect2 id="newads"><title>How can I submit new ads?</title>
+<sect2 renderas="sect3" id="newads"><title>How can I submit new ads?</title>
+<para>
+ Beginning with <application>Privoxy v2.9.14</application>, missed ads and 
+ banners and other actions file problems, can be submitted by accessing
+ <ulink url="javascript:void(window.open('http://www.privoxy.org/actions','Feedback','width=600,scrollbars=yes,toolbar=no,location=no,directories=no,status=no,menubar=no,copyhistory=no').focus());"><quote>actions file feedback system</quote></ulink>
+ from <ulink url="http://p.p/">http://p.p/</ulink>
+ There will soon be an easy way to update your actions file as well.
+</para>
 <para>
-    As of now, please discontinue to submit new ad blocking infos. Once we
-    have released the new version, there will again be a form on the website,
-    which you can use to contribute new ads.
+ This does not work with earlier versions of <application>Privoxy</application>
+ or <application>Junkbuster</application>.
 </para>
 </sect2>
 
-<sect2 id="ip"><title>How can I hide my IP address?</title>
+<sect2 renderas="sect3" id="ip"><title>How can I hide my IP address?</title>
 <para>
  You cannot hide your IP address with <application>Privoxy</application> or any other software, since
-the server needs to know your IP address to send the answer to you.
+the server needs to know your IP address to send the answers back to you.
 </para>
 <para>
 Fortunately there are many publicly usable anonymous proxies out there, which
@@ -1014,7 +1053,7 @@ more through Google.
 </para>
 </sect2>
 
-<!--  <sect2 id="image"><title>What is the imagefile (simage.ini, etc.) for?</title> -->
+<!--  <sect2 renderas="sect3" id="image"><title>What is the imagefile (simage.ini, etc.) for?</title> -->
 <!--  <para> -->
 <!--   Anytime <application>Privoxy</application> determines (with the help of the blocklist) that a URL -->
 <!--   contains an advertisement, it has to decide whether this advertisement is an -->
@@ -1022,7 +1061,7 @@ more through Google.
 <!--  </para> -->
 <!--  </sect2> -->
 
-<sect2>
+<sect2 renderas="sect3">
 <title id="anonforsure">Can <application>Privoxy</application> guarantee I am anonymous?</title>
 <para>
  No. Your chances of remaining anonymous are greatly improved, but unless you
@@ -1032,8 +1071,8 @@ more through Google.
 <para>
  <application>Privoxy</application> can remove various information about you,
  and allows <emphasis>you</emphasis> more freedom  to decide which sites 
- you can trust. But it's still possible that web sites can find out who you
- are. Here's one way this can happen.
+ you can trust, and what details you want to reveal. But it's still possible
that web sites can find out who you are. Here's one way this can happen.
 </para>
 <para>
  A few browsers disclose the user's email address in certain situations, such
@@ -1053,7 +1092,7 @@ more through Google.
 
 </sect2>
 
-<sect2>
+<sect2 renderas="sect3">
 <title id="sitebreak">Might some things break because header information is
 being altered?</title>
 
@@ -1087,13 +1126,12 @@ being altered?</title>
  If you have problems with a site, you will have to adjust your configuration 
  accordingly. Cookies are probably the most likely adjustment that may 
  be required, but by no means the only one.
-
 </para>
 
 </sect2>
 
 
-<sect2>
+<sect2 renderas="sect3">
 <title id="caching">Can <application>Privoxy</application> act as a <quote>caching</quote> proxy to 
 speed up web browsing?</title>
 <para>
@@ -1104,7 +1142,7 @@ speed up web browsing?</title>
 </para>
 </sect2>
 
-<sect2>
+<sect2 renderas="sect3">
 <title id="firewall">What about as a firewall? Can <application>Privoxy</application> protect me?</title>
 <para>
  Not in the way you mean, or in the way a true firewall can, or a proxy that
@@ -1114,7 +1152,7 @@ speed up web browsing?</title>
 </sect2>
 
 
-<sect2>
+<sect2 renderas="sect3">
 <title id="logo">The <application>Privoxy</application> logo that replaces ads is very blocky 
 and ugly looking. Can't a better font be used?</title>
 
@@ -1134,7 +1172,7 @@ Given the above problem, we have decided to remove the logo option entirely
 </sect2>
 
 
-<sect2>
+<sect2 renderas="sect3">
 <title id="wasted">I have large empty spaces now where ads used to be. 
 Why?</title>
 <para>
@@ -1147,7 +1185,7 @@ Why?</title>
 
 </sect2>
 
-<sect2>
+<sect2 renderas="sect3">
 <title id="ssl">How can <application>Privoxy</application> filter Secure (HTTPS) URLs?</title>
 <para>
  This is a limitation since HTTPS transactions are encrypted SSL sessions
@@ -1163,7 +1201,7 @@ Why?</title>
 </sect2>
 
 
-<sect2>
+<sect2 renderas="sect3">
 <title id="secure"><application>Privoxy</application> runs as a <quote>server</quote>. How 
 secure is it? Do I need to take any special precautions?</title>
 <para>
@@ -1186,7 +1224,7 @@ secure is it? Do I need to take any special precautions?</title>
 
 </sect2>
 
-<sect2 id="turnoff">
+<sect2 renderas="sect3" id="turnoff">
 <title>How can I temporarily disable <application>Privoxy</application>?</title>
 <para>
  The easiest way is to access <application>Privoxy</application> with your 
@@ -1196,15 +1234,12 @@ secure is it? Do I need to take any special precautions?</title>
 </para>
 </sect2>
 
-<sect2 id="seealso">
+<sect2 renderas="sect3" id="seealso">
 <title>Where can I find more information about <application>Privoxy</application>
 and related issues?</title>
-
-<!--
- Include seealso.sgml
--->
+<!-- Include seealso.sgml boilerplate: -->
  &seealso;
+<!-- end boilerplate -->
 
 <!--
 <para>
@@ -1220,10 +1255,10 @@ and related issues?</title>
 
 <!--   ~~~~~       New section      ~~~~~     -->
 
-<sect1 id="trouble">
-<title>5. Troubleshooting</title>
+<sect1 label="5" id="trouble">
+<title>Troubleshooting</title>
 
-<sect2>
+<sect2 renderas="sect3">
 <title id="refused">I just upgraded and am getting <quote>connection refused</quote>
 with every web page?</title>
 <para>
@@ -1245,7 +1280,7 @@ with every web page?</title>
 
 </sect2>
 
-<sect2>
+<sect2 renderas="sect3">
 <title id="flushit">I just added a new rule, but the steenkin ad is 
 still getting through. How?</title>
 <para>
@@ -1265,7 +1300,7 @@ still getting through. How?</title>
 
 </sect2>
 
-<sect2>
+<sect2 renderas="sect3">
 <title id="badsite">One of my favorite sites does not work with <application>Privoxy</application>.
 What can I do?</title>
 
@@ -1284,13 +1319,16 @@ What can I do?</title>
  being applied to the URL. Now, armed with this information, go to <quote>Edit
  the actions list</quote>. Here you should see various sections that have
  various <application>Privoxy</application> features disabled for specific
- sites. Disabled <quote>actions</quote> will have a <quote>-</quote> (minus
- sign) in front of them. Add your problem page URL to one of these sections
- that looks like it is disabling the feature that is causing the
- problem. Re-try the page. There might be some trial and error involved. This
- is discussed in a little more detail in the 
- <ulink url="../user-manual/appendix.html#ACTIONSANAT">user-manual
- appendix</ulink>.
+ sites. Most disabled <quote>actions</quote> will have a <quote>-</quote> (minus
+ sign) in front of them. Some aliases are used just to disable other actions, 
+ e.g. <quote>shop</quote> and <quote>fragile</quote>, and won't necessarily 
+ use a <quote>+</quote> or <quote>-</quote> sign. Add your problem page
+ URL to one of these sections that looks like it is disabling the feature that
+ is causing the problem. Rember to flush your browser's caches when making 
+ such changes! As a last resort, try <quote>fragile</quote> which
+ disables most actions. Now re-try the page. There might be some trial and
+ error involved. This is discussed in a little more detail in the <ulink
+ url="../user-manual/appendix.html#ACTIONSANAT">user-manual appendix</ulink>.
 
 </para>
 
@@ -1301,7 +1339,7 @@ What can I do?</title>
 
 </sect2>
 
-<sect2 id="bugs">
+<sect2 renderas="sect3" id="bugs">
 <title>Where can I get help? Report bugs? Feature Requests? Etc?</title>
 <para>
  Feedback is encouraged, whether good, bad or ugly. Please see the contact
@@ -1312,7 +1350,7 @@ What can I do?</title>
 
 </sect2>
 
-<sect2>
+<sect2 renderas="sect3">
 <title id="time">What time is it?</title>
 <para>
  Time for you to go!
@@ -1334,18 +1372,43 @@ FIXME: Commented out until we have something to put here. HB 03/18/02.
 </sect1>
 -->
 
-<!--   ~~~~~       New section      ~~~~~     -->
-<!--
+  <!--   ~~~~~       New section      ~~~~~     -->
+  <sect1 id="contact"><title>Contacting the developers, Bug Reporting and Feature Requests</title>
+<!-- Include contacting.sgml  -->
+ &contacting;
+<!-- end contacting -->
+  </sect1>
+  
+  <!--   ~~~~~       New section      ~~~~~     -->
+  <sect1 id="copyright"><title>Copyright and History</title>
+
+<sect2><title>Copyright</title>
+<!-- Include copyright.sgml -->
+ &copyright;
+<!-- end -->
+</sect2>
 
-This is referenced in the doc header already. HB 03/25/02
+<sect2><title>History</title>
+<!-- Include history.sgml -->
+ &history;
+<!-- end -->
+</sect2>
 
-<sect1 id="contact"><title>Contact the developers</title>
-<para>Please see the user manual for information on how to contact the developers.
-</para>
+  </sect1>
+  
+<!--   ~~~~~       New section      ~~~~~     -->
+<!--
+<sect1 id="seealso"><title>See also</title>
+-->
+<!-- Include seealso.sgml -->
+<!--
+ &see;
+-->
+<!-- end  -->
+<!--
 </sect1>
 -->
 
-
 <!-- hhmts end -->
  <!--
  Tue 09/11/01 06:38:14 PM EST: Test SGML doc by Hal Burgiss.
@@ -1371,6 +1434,35 @@ This is referenced in the doc header already. HB 03/25/02
  Temple Place - Suite 330, Boston, MA  02111-1307, USA.
 
 $Log: faq.sgml,v $
+Revision 1.45  2002/04/08 22:59:26  hal9
+Version update. Spell chkconfig correctly :)
+
+Revision 1.44  2002/04/07 21:24:29  hal9
+Touch up on name change.
+
+Revision 1.43  2002/04/04 21:59:53  hal9
+Added NT/W2K service/icon situation.
+
+Revision 1.42  2002/04/04 18:46:47  swa
+consistent look. reuse of copyright, history et. al.
+
+Revision 1.41  2002/04/04 06:48:37  hal9
+Structural changes to allow for conditional inclusion/exclusion of content
+based on entity toggles, e.g. 'entity % p-not-stable  "INCLUDE"'. And
+definition of internal entities, e.g. 'entity p-version "2.9.13"' that will
+eventually be set by Makefile.
+More boilerplate text for use across multiple docs.
+
+Revision 1.40  2002/04/03 04:22:03  hal9
+Fixed several typos.
+
+Revision 1.39  2002/04/03 03:53:03  hal9
+Revert some changes, and then make some news, to layout, and appearance.
+
+Revision 1.38  2002/04/02 03:49:10  hal9
+Major changes to doc structure and layout. Sections are not automatically
+numbered now. TOC is on page by itself.
+
 Revision 1.37  2002/04/01 16:24:07  hal9
 -Rework of supported Q/A.
 -Set up entities to include boilerplate text.