More re-usable boilerplate
[privoxy.git] / doc / source / faq.sgml
index 9c39a81..c71ef5f 100644 (file)
@@ -1,4 +1,8 @@
-<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V3.1//EN">
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V3.1//EN"[
+<!entity % dummy "INCLUDE"> 
+<!entity supported SYSTEM "supported.sgml">
+<!entity newfeatures SYSTEM "newfeatures.sgml">
+]>
 <!--
  File        :  $Source: /cvsroot/ijbswa/current/doc/source/faq.sgml,v $
 
                 This file belongs into
                 ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/
                 
- $Id: faq.sgml,v 1.28 2002/03/25 04:27:33 hal9 Exp $
+ $Id: faq.sgml,v 1.36 2002/03/31 23:18:47 hal9 Exp $
 
  Written by and Copyright (C) 2001 the SourceForge
- PRIVOXY team.  http://ijbswa.sourceforge.net
+ Privoxy team. http://www.privoxy.org/
 
  Based on the Internet Junkbuster originally written
  by and Copyright (C) 1997 Anonymous Coders and 
  Junkbusters Corporation.  http://www.junkbusters.com
+
 -->
 
+
 <article id="index">
 <artheader>
 <title>Privoxy Frequently Asked Questions</title>
 
-<pubdate>$Id: faq.sgml,v 1.28 2002/03/25 04:27:33 hal9 Exp $</pubdate>
+<pubdate>$Id: faq.sgml,v 1.36 2002/03/31 23:18:47 hal9 Exp $</pubdate>
 
 <authorgroup>
  <author>
 </authorgroup>
 
 <abstract>
+<![%dummy;[
+<para>
+ <comment>
+  This is here to keep vim syntax file from breaking :/
+  If I knew enough to fix it, I would.
+  PLEASE DO NOT REMOVE! HB: hal@foobox.net
+ </comment>
+</para>
+]]>
  <para>
-The FAQ document gives users and developers alike answers to frequently asked
-questions about
-<application>Privoxy</application>. <application>Privoxy</application> is a web
-proxy with advanced filtering capabilities for protecting privacy, filtering
-web page content, managing cookies, controlling access, and removing ads,
-banners, pop-ups and other obnoxious Internet
-Junk. <application>Privoxy</application> has a very flexible configuration and
-can be customized to suit individual needs and
-tastes. <application>Privoxy</application> has application for both stand-alone
-systems and multi-user networks.
+ This FAQ gives users and developers alike answers to frequently asked
+ questions about <ulink url="http://www.privoxy.org">Privoxy</ulink>. 
  </para>
  <para>
-You can find the latest version of the document at <ulink url="http://ijbswa.sourceforge.net/faq/">http://ijbswa.sourceforge.net/faq/</ulink>.
+ <application>Privoxy</application> is a web proxy with advanced filtering
+ capabilities for protecting privacy, filtering web page content, managing
+ cookies, controlling access, and removing ads, banners, pop-ups and other
+ obnoxious Internet junk. <application>Privoxy</application> has a very
+ flexible configuration and can be customized to suit individual needs and
+ tastes. <application>Privoxy</application> has application for both
+ stand-alone systems and multi-user networks.
+</para>
+<para>
+ <application>Privoxy</application> is based on the code of the 
+ <application>Internet Junkbuster</application>.
+ <application>Junkbuster</application> was originally written by JunkBusters
+ Corporation, and was released as free open-source software under the GNU GPL.
+ Stefan Waldherr made many improvements, and started the SourceForge project
+ to continue development.
+</para>
+
+ <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://ijbswa.sourceforge.net/user-manual/contact.html">user-manual</ulink> if you want to contact the developers.
+<ulink url="http://www.privoxy.org/user-manual/contact.html">user-manual</ulink> if you want to contact the developers.
  </para>
 
 <!--   <para> -->
@@ -79,13 +105,15 @@ Please see the Contact section in the
   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://ijbswa.sourceforge.net">Sourceforge</ulink> to rekindle
+  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. 
+  since added many new features, refinements and enhancements. The result 
+  of this effort is <application>Privoxy</application>.
  </para>
  <para>
-  The new <application>Privoxy</application> started with the same
-  code base, but has changed significantly at this point.
+  <application>Privoxy</application> started with the 
+  <application>Junkbuster 2.0.2</application> code base, but has advanced
+  significantly at this point. 
  </para>
 
 </sect3>
@@ -94,28 +122,36 @@ Please see the Contact section in the
 <sect3>
 <title id="whyprivoxy">Why <quote>Privoxy</quote>? Why a name change at all?</title>
 <para>
- <application>Privoxy</application> is for <quote>Privacy Enhancing Proxy</quote>.
+ <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 
- <ulink url="http://junkbusters.com">The Junkbusters Corporation</ulink>.
- There are no objections from Junkbusters Corporation to the project 
- itself though.
+ <ulink url="http://junkbusters.com">Junkbusters Corporation</ulink>.
+ (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 
  code, that it was time to make a clean break from the past and make 
- a name in their own right.
+ a name in their own right, especially now with the pending release of 
+ version 3.0.
+
 </para>
 </sect3>
 
 
-<sect3 id="differs"><title>How does it differ from the old <application>Junkbuster?</application></title>
- <para>
-   All the old features remain. The new <application>Privoxy</application> 
-   still blocks ads and banners, still manages cookies, and still helps protect
-   your privacy. But, these are all enhanced, and many new features have been 
-   added, all in the same vein.
+<sect3 id="differs"><title>How does <application>Privoxy</application> differ
+from the old <application>Junkbuster?</application></title> 
+<para>
+  <application>Privoxy</application> picks up where
+  <application>Junkbuster</application> left off. All the old features remain.
+  The new <application>Privoxy</application> still blocks ads and banners,
+  still manages cookies, and still helps protect your privacy. But, these are
+  all enhanced, and many new features have been added, all in the same vein.
  </para>
  <para>
   The configuration has changed significantly as well. This is something that
@@ -129,107 +165,9 @@ Please see the Contact section in the
 
 <sect3 id="features"><title>What are some of the new features?</title>
 <!--
- This section is in both user-manual and faq. Please keep in sync!!!
--->
-<para>
- <itemizedlist>
-
- <listitem>
-  <para>
-   Integrated browser based configuration and control utility (<ulink
-   url="http://p.p">http://p.p</ulink>). Browser-based tracing of rule
-   and filter effects.
-  </para>
- </listitem> 
-<!--
- <listitem>
-  <para>
-   Modularized configuration that will allow for system wide settings, and
-   individual user settings. (not implemented yet, probably a 3.1 feature)
-  </para>
- </listitem> 
--->
- <listitem>
-  <para>
-    Blocking of annoying pop-up browser windows.
-  </para>
- </listitem> 
-
- <listitem>
-  <para>
-   HTTP/1.1 compliant (most, but not all 1.1 features are supported).
-  </para>
- </listitem> 
-
- <listitem>
-  <para>
-   Support for Perl Compatible Regular Expressions in the configuration files, and 
-   generally a more sophisticated and flexible configuration syntax over
-   previous versions. 
-  </para>
- </listitem> 
-
- <listitem>
-  <para>
-   GIF de-animation. 
-  </para>
- </listitem> 
- <listitem>
-  <para>
-   Web page content filtering (removes banners based on size,
-   invisible <quote>web-bugs</quote>, JavaScript, pop-ups, status bar abuse,
-   etc.)
-  </para>
- </listitem> 
- <listitem>
-  <para>
-   Bypass many click-tracking scripts (avoids script redirection).
-  </para>
- </listitem> 
- <listitem>
-  <para>
-   Multi-threaded (POSIX and native threads).
-  </para>
- </listitem> 
-
- <listitem>
-  <para>
-   Auto-detection and re-reading of config file changes.
-  </para>
- </listitem> 
-
- <listitem>
-  <para>
-   User-customizable HTML templates (e.g. 404 error page).
-  </para>
- </listitem> 
-
- <listitem>
-  <para>
-   Improved cookie management features (e.g. session based cookies).
-  </para>
-</listitem> 
-
- <listitem>
-  <para>
-   Builds from source on most UNIX-like systems. Packages available for: Linux
-   (RedHat, SuSE, or Debian), Windows, Sun Solaris, Mac OSX, OS/2, HP-UX 11 and AmigaOS.
-  </para>
- </listitem> 
-
- <listitem>
-  <para>
-   In addition, the configuration is much more powerful and versatile over-all.
-  </para>
-</listitem> 
-
- </itemizedlist>
-</para>
+Include newfeatures.sgml
+--> 
+&newfeatures;
 
 </sect3>
 
@@ -262,6 +200,55 @@ Please see the Contact section in the
 
 </sect3>
 
+
+<sect3>
+<title id="knows">How does <application>Privoxy</application> know what is
+an ad, and what is not?</title>
+<para>
+ <application>Privoxy</application> processes all the raw content of every 
+ web page. So it reads everything on each page. It then compares this to the
+ rules as set up in the configuration files, and looks for any matches to
+ these rules. <application>Privoxy</application> makes heavy use of
+ <quote>regular expressions</quote>. (If you are not familiar with regular
+ expressions, it is explained briefly in <ulink
+ url="../user-manual/appendix.html">the user manual</ulink>.) Regular
+ expressions facilitate matching of one text string against another, using
+ wildcards to build complex patterns. So <application>Privoxy</application>
+ will typically look for URLs and other content that match certain key words
+ and expressions as defined in the configuration files. For instance a URL
+ that contains <quote>/banners</quote>, has a high probability of containing
+ ad banners, and thus would be a prime candidate to have a matching rule.
+</para>
+<para>
+ So <application>Privoxy</application> will look for these kinds of obvious 
+ looking culprits. And also, will use lists of known organizations that
+ specialize in ads. Again, using complex patterns to match as many potential 
+ combinations as possible since there tend to be many, many variations used by 
+ advertisers, and new ones are being introduced all the time.
+</para>
+</sect3>
+
+<sect3>
+<title id="mistakes">Can <application>Privoxy</application> make mistakes? 
+This does not sound very scientific.</title>
+<para>
+ Actually, it's a black art ;-) And yes, it is always possible to have a broad rule
+ accidentally block something by mistake. There is a good chance you may run 
+ into such a situation at some point. It is tricky writing rules to cover
+ every conceivable possibility, and not occasionally get false positives.
+</para>
+
+<para>
+ But this should not be a big concern since the
+ <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>.)
+</para>
+
+</sect3>
+
+
 <sect3 id="browsers2"><title>My browser does the same things as
 <application>Privoxy</application>. Why should I use
 <application>Privoxy</application> at all?</title>
@@ -316,11 +303,12 @@ warranty? Registration?</title>
    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 developers manual.
+   section Quickstart in the <ulink url="http://privoxy.org/developer-manual/quickstart.html">
+   Developer's Manual</ulink>.
 </para>
 <para>
-Once we have added you to the team, you'll have write access to the CVS
-repository, and together we'll find a suitable task for you.
+ Once we have added you to the team, you'll have write access to the CVS
+ repository, and together we'll find a suitable task for you.
 </para>
 </sect4>
 
@@ -333,21 +321,44 @@ repository, and together we'll find a suitable task for you.
 
 <sect2 id="installation"><title>Installation</title>
 
-<sect3 id="newinstall"><title>Can I install the new 
- <application>Privoxy</application> over the old one?</title>
+<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 
+ should be virtually all browsers. Direct browser support is not necessary
+ since <application>Privoxy</application> runs as a separate application and
+ just exchanges standard HTML data with your browser, just like a web server
+ does.
+</para>
+</sect3>
+
+<sect3 id="whichos">
+<title>Which operating systems are supported?</title>
+<!--
+Include supported.sgml here:
+-->
+&supported;
+</sect3>
+
+<sect3 id="newinstall"><title>Can I install  
+ <application>Privoxy</application> over <application>Junkbuster</application>?</title>
  <para>
-   We recommend you uninstall the old <application>Junkbuster</application>
+   We recommend you uninstall <application>Junkbuster</application>
    first to minimize conflicts and confusion. You may want to 
    save your old configuration files for future reference. The configuration
    is substantially changed.
  </para>
  <para>
   See the <ulink
-  url="http://ijbswa.sourceforge.net/user-manual/">user-manual</ulink> for
+  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!]
  </para>
+ <para>
+  Note: Some installers may automatically uninstall
+  <application>Junkbuster</application>, if present!
+ </para>
+
 </sect3>
 
 <sect3>
@@ -358,6 +369,8 @@ special I have to do now?</title>
  All browsers must be told to use <application>Privoxy</application> 
  as a proxy by specifying the correct proxy address and port number 
  in the appropriate configuration area for the browser. See below.
+ Also, you should flush your browser's memory and disk cache to get rid of any
+ cached items.
 
 </para>
 
@@ -424,12 +437,13 @@ All the ads are there. What's wrong?</title>
 
 <sect3 id="newconfig"><title>Can I use my old config files?</title>
  <para>
-   There are major changes to <application>Junkbuster</application> 
-   configuration from version 2.0.x to 2.9.x and later. The older files will
-   not work at all. If this is the case, you will need to re-enter your old
-   data into the new configuration structure. This is probably also a good 
-   recommendation even if upgrading from 2.9.x to 3.x since there were 
-   many minor changes along the way.
+   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.
+   This is probably also a good recommendation even if upgrading from 2.9.x to
+   3.x since there were many minor changes along the way.
  </para>
 </sect3>
 
@@ -467,7 +481,7 @@ All the ads are there. What's wrong?</title>
 some of these <quote>actions</quote>.</title>
 <para>
  These are all explained in the 
- <ulink url="http://ijbswa.sourceforge.net/user-manual/configuration.html#ACTIONSFILE">user-manual</ulink>.
+ <ulink url="../user-manual/configuration.html#ACTIONSFILE">user-manual</ulink>.
  Please refer to that.
 </para>
 </sect3>
@@ -481,7 +495,7 @@ way to do this?</title>
  The easiest way to do this, is to access <application>Privoxy</application>
  with your web browser at <ulink url="http://p.p/">http://p.p/</ulink>, 
  and then select 
- "<ulink url="http://ijbswa.sourceforge.net/config/edit-actions">Edit the actions list</ulink>"
+ "<ulink url="http://config.privoxy.org">Edit the actions list</ulink>"
  from the selection list. You can also do this by editing the appropriate 
  file with a text editor.
 </para>
@@ -489,7 +503,7 @@ way to do this?</title>
 <para>
  Please see the 
  <ulink
- url="http://ijbswa.sourceforge.net/user-manual/configuration.html#ACTIONSFILE">user-manual</ulink> for a
+ url="../user-manual/configuration.html#ACTIONSFILE">user-manual</ulink> for a
  detailed explanation of these and other configuration files, and their
  various options and syntax.
 </para>
@@ -692,13 +706,14 @@ Note that normally only local users can connect to <application>Privoxy</applica
 
 
 <sect3>
-<title id="filterfile">What is <quote>default.filter</quote>?</title>
+<title id="filterfile">What is <quote>default.filter</quote>?</title>
 <para>
  The <quote>default.filter</quote> file is used to <quote>filter</quote> any
- page content. By <quote>filtering</quote> we mean it can modify, remove, 
web page content. By <quote>filtering</quote> we mean it can modify, remove, 
  or change <emphasis>anything</emphasis> on the page, including HTML tags, and
- JavaScript. Regular expressions are used to accomplish this. This is
- potentially a very powerful feature, but requires some expertise. 
+ JavaScript. Regular expressions are used to accomplish this, and operate 
+ on a line by line basis. This is potentially a very powerful feature, but
+ requires some expertise. 
 </para>
 
 <para>
@@ -710,7 +725,7 @@ Note that normally only local users can connect to <application>Privoxy</applica
 <para>
  Presently, there is no GUI editor option for this part of the configuration, 
  but you can disable/enable various sections of the included default 
- file with the Actions List Editor from your browser.
+ file with the <quote>Actions List Editor</quote> from your browser.
 </para>
 
 </sect3>
@@ -747,9 +762,10 @@ Note that normally only local users can connect to <application>Privoxy</applica
 <para>
  This is a configuration option for images that
  <application>Privoxy</application> is stopping. You have the choice <!-- of
- the --> <!-- <application>Privoxy</application> logo, --> a checkerboard
- pattern (this scales better), a transparent 1x1 GIF image, or a custom URL or
- your choice.
+ the --> <!-- <application>Privoxy</application> logo, --> of a checkerboard
+ pattern, a transparent 1x1 GIF image (aka <quote>blank</quote>), or a custom
+ URL of your choice. Note that to fit this category, the URL must match both 
+ the <quote>+image</quote> and <quote>+block</quote> actions.
 </para>
 
 <para>
@@ -758,15 +774,16 @@ Note that normally only local users can connect to <application>Privoxy</applica
  <quote>Edit Actions List</quote> selection at <ulink
  url="http://p.p/">http://p.p/</ulink>. Or by hand editing the appropriate 
  actions file. This will only effect what is defined as <quote>images</quote>
- though. 
-
+ though. Also, some URLs that generate the bright red <quote>Blocked</quote>
+ banner, can be moved to the <quote>+image-blocker</quote> section for the
+ same reason, but there are some limits and risks to this (see below).
 </para>
 
 </sect3>
 
 
 <sect3>
-<title id="whyseeum">Why would anybody want to see the checkerboard?</title>
+<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 
  for anyone new to <application>Privoxy</application> so that they can 
@@ -779,19 +796,76 @@ Note that normally only local users can connect to <application>Privoxy</applica
 
 <sect3>
 <title id="blockedisugly">I see large red banners on some pages that say 
-<quote>Blocked</quote>. How do I get rid of this?</title>
+<quote>Blocked</quote>. Why and how do I get rid of this?</title>
 <para>
  These are URLs that match something in one of 
  <application>Privoxy's</application> block actions (+block). It is meant
  to be a warning so that you know something has been blocked and an easy way
  for you to see why. These are handled differently than what has been defined
- as <quote>images</quote> (e.g. ad banners). If you want them to be treated
- as if they were images, so that they can be invisible, then move the
- offending URL from the <quote>+block</quote> section to the
- <quote>+imageblock</quote> section of your actions file. Alternately, you
- could modify the <quote><filename>block</filename></quote> HTML template that
- is used by <application>Privoxy</application> to display this, and make it
- something more to your liking.
+ explicitly as <quote>images</quote> (e.g. ad banners). Depending on the 
+ URL itself, it is sometimes hard for <application>Privoxy</application> to 
+ really know whether there is indeed an ad image there or not. And there are
+ limitations as to what <application>Privoxy</application> can do to 
+ <quote>fool</quote> the browser.
+</para>
+
+<para>
+ For instance, if the ad is in a frame, then it is embedded in the separate
+ HTML page used for the frame. In this case, you cannot just substitute an
+ aribitray image (like we would for a <quote>blank</quote> image), for an HTML
+ page. The browser is expecting an HTML page, and that is what it must have
+ for frames. So this situation can be a little trickier to deal with, and 
+ <application>Privoxy</application> will use the <quote>Blocked</quote> page.
+</para>
+
+<para>
+ If you want these to be treated as if they were images, so that they can be
+ made invisible, you can try moving the offending URL from the
+ <quote>+block</quote> section to the <quote>+imageblock</quote> section of
+ your actions file. Just be forewarned, if any URL is made
+ <quote>invisible</quote>, you may not have any inkling that something has
+ been removed from that page, or why. If this approach does not work, then you are
+ probably dealing with a frame (or <quote>ilayer</quote>), and the only thing
+ that can go there is an HTML page of some sort.
+</para>
+<para>
+ To deal with this situation, you could modify the
+ <quote><filename>block</filename></quote> HTML template that is used by
+ <application>Privoxy</application> to display this, and make it something
+ more to your liking. Currently, there is no configuration option for this.
+ You will have to modify, or create your own page, and use this to replace
+ <filename>templates/blocked</filename>, which is what
+ <application>Privoxy</application> uses to display the <quote>Blocked</quote>
+ page.
+</para>
+<para>
+ Another way to deal with this is find why and where
+ <application>Privoxy</application> is blocking the frame, and 
+ diable this. Then let the <quote>+image-blocker</quote> action 
+ handle the ad that is embedded in the frame's HTML page. 
+</para>
+
+</sect3>
+
+<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>
+ There is not enough space to fit the entire page. Try right clicking on the
+ visible, red portion, and select <quote>Show Frame</quote>, or equivalent.
+ This will usually allow you to see the entire Privoxy <quote>Blocked</quote>
+ page, and from there you can see just what is being blocked, and why.
+</para>
+</sect3>
+
+<sect3 id="otherproxy">
+<title>How can I make <application>Privoxy</application> work with other 
+proxies like <application>Squid</application>?</title>
+<para>
+ This can be done. See the <ulink
+ url="../user-manual/configuration.html#FORWARDING">user manual</ulink>, 
+ which describes how to do this.
+
 </para>
 
 </sect3>
@@ -800,7 +874,7 @@ Note that normally only local users can connect to <application>Privoxy</applica
 
 <!--   ~~~~~       New section      ~~~~~     -->
 
-<sect2 id="misc"><title>Misc</title>
+<sect2 id="misc"><title>Miscellaneous</title>
 
 <sect3>
 <title id="slowsme">How much does <application>Privoxy</application> slow my browsing down? This 
@@ -855,20 +929,24 @@ programmed to handle certain pages specially.
 <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
-http://p.p/ or, equivalently, http://ijbswa.sourceforge.net/config/
+<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).
+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).
 </para>
 
 <para>
-These pages are *not* 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 http://p.p/ will fail, and
-http://ijbswa.sourceforge.net/config/ 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>
@@ -898,8 +976,8 @@ FIXME: commented out until we have data. HB 03/18/02.
 <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 version, there will again be
-    blocklists that you can update automatically.
+    2.9.x. Once we have released the new stable version, v3.0, there will
+    again be blocklists that you can update automatically.
 </para>
 </sect3>
 
@@ -1021,7 +1099,7 @@ speed up web browsing?</title>
  No, it does not have this ability at all. You want something like 
  <ulink url="http://www.squid-cache.org/">Squid</ulink> for this. And, yes, 
  before you ask, <application>Privoxy</application> can co-exist 
- with other kinds of proxies like <quote>Squid</quote>.
+ with other kinds of proxies like <application>Squid</application>.
 </para>
 </sect3>
 
@@ -1049,14 +1127,15 @@ and ugly looking. Can't a better font be used?</title>
  <emphasis>blank</emphasis>, or a URL of your choosing.
 </para>
 <para>
-Given the above problem, we have decided to remove the logo option entirely.
+Given the above problem, we have decided to remove the logo option entirely 
+[as of v2.9.13].
 </para>
 </sect3>
 
 
 <sect3>
 <title id="wasted">I have large empty spaces now where ads used to be. 
-Why does <application>Privoxy</application> leave these large gaps?</title>
+Why?</title>
 <para>
  It would be easy enough to just eliminate this space altogether, rather than
  fill it with blank space. But, this would create problems with many pages
@@ -1092,11 +1171,12 @@ secure is it? Do I need to take any special precautions?</title>
  <application>Privoxy</application> can run as a non-privileged 
  user, which is how we recommend it be run. Also, by default 
  <application>Privoxy</application> only listens to requests 
- from <quote>localhost</quote>. It is not itself directly exposed to the
+ from <quote>localhost</quote>. The server aspect of
+ <application>Privoxy</application> is not itself directly exposed to the
  Internet in this configuration. If you want to have
  <application>Privoxy</application> serve as a LAN proxy, this will have to
  be opened up to allow for LAN requests. In this case, we'd recommend
- you specify only the LAN gateway address, e.g. 192.168.1.1 in the main 
+ you specify only the LAN gateway address, e.g. 192.168.1.1, in the main 
  <application>Privoxy</application> config file. All LAN hosts can then use 
  this as their proxy address in the browser proxy configuration. In this way, 
  <application>Privoxy</application> will not listen on any external ports.
@@ -1105,6 +1185,16 @@ secure is it? Do I need to take any special precautions?</title>
 
 </sect3>
 
+<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 
+ browser by using the special URL: <ulink url="http://p.p/">http://p.p/</ulink>
+ and select "Toggle Privoxy on or off" from that page.
+
+</para>
+</sect3>
+
 </sect2>
 
 
@@ -1149,7 +1239,7 @@ still getting through. How?</title>
 <para>
  If this doesn't help, you probably have an error in the rule you
  applied. Try pasting the full URL of the offending ad into <ulink
- url="http://ijbswa.sourceforge.net/config/show-url-info">http://ijbswa.sourceforge.net/config/show-url-info</ulink>
+ url="http://config.privoxy.org/show-url-info">http://config.privoxy.org/show-url-info</ulink>
  and see if any actions match your new rule.
 </para>
 
@@ -1164,7 +1254,7 @@ What can I do?</title>
  by disabling <application>Privoxy</application> filtering and blocking. 
  Go to <ulink url="http://p.p/">http://p.p/</ulink> and click on 
  <quote>Toggle Privoxy On or Off</quote>, then disable it. Now try that 
- page again.
+ page again. It's probably a good idea to flush the browser cache as well.
 </para>
 
 <para>
@@ -1178,8 +1268,8 @@ What can I do?</title>
  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="http://ijbswa.sourceforge.net/user-manual/appendix.html#ACTIONSANAT">user-manual
+ is discussed in a little more detail in the 
<ulink url="../user-manual/appendix.html#ACTIONSANAT">user-manual
  appendix</ulink>.
 
 </para>
@@ -1191,6 +1281,17 @@ What can I do?</title>
 
 </sect3>
 
+<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
+ page in the <ulink url="../user-manual/contact.html">user-manual</ulink> for
+ details.
+
+</para>
+
+</sect3>
+
 <sect3>
 <title id="time">What time is it?</title>
 <para>
@@ -1212,21 +1313,32 @@ FIXME: Commented out until we have something to put here. HB 03/18/02.
 </para>
 </sect1>
 -->
+
 <!--   ~~~~~       New section      ~~~~~     -->
+<!--
+
+This is referenced in the doc header already. HB 03/25/02
+
 <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="copyright"><title>Copyright and History</title>
-<para>Please see the user manual for information on Copyright and History.
+<para>
+ Please see the 
+<ulink url="../user-manual/copyright.html#HISTORY">user-manual</ulink> for 
+ information on Copyright and History.
 </para>
 </sect1>
 
 <!--   ~~~~~       New section      ~~~~~     -->
 <sect1 id="seealso"><title>See also</title>
-<para>Please see the user manual for information on references.
+<para>
+ Please see the 
+ <ulink url="../user-manual/seealso.html">user-manual</ulink> for 
+ others references.
 </para>
 </sect1>
 
@@ -1255,6 +1367,30 @@ FIXME: Commented out until we have something to put here. HB 03/18/02.
  Temple Place - Suite 330, Boston, MA  02111-1307, USA.
 
 $Log: faq.sgml,v $
+Revision 1.36  2002/03/31 23:18:47  hal9
+More on dealing with BLOCKED.
+
+Revision 1.35  2002/03/30 04:14:19  hal9
+Fix privoxy.org/config links.
+
+Revision 1.34  2002/03/29 04:35:56  hal9
+Touch ups.
+
+Revision 1.33  2002/03/29 01:31:48  hal9
+Several new Q/A's and other touch ups.
+
+Revision 1.32  2002/03/27 00:57:03  hal9
+Touch ups for name change.
+
+Revision 1.31  2002/03/26 22:29:55  swa
+we have a new homepage!
+
+Revision 1.30  2002/03/25 16:39:22  hal9
+A few new sections. Made all links relative to user-manual.
+
+Revision 1.29  2002/03/25 05:23:57  hal9
+Moved section, and touch ups.
+
 Revision 1.28  2002/03/25 04:27:33  hal9
 New section related to name change.