projects / privoxy.git / blobdiff
? search:
summary | shortlog | log | commit | commitdiff | tree
raw | inline | side by side
bumped version
[privoxy.git] / doc / source / faq.sgml
diff --git a/doc/source/faq.sgml b/doc/source/faq.sgml
index b566aa9..30be80a 100644 (file)
--- a/doc/source/faq.sgml
+++ b/doc/source/faq.sgml
@@ -1,5 +1,5 @@
 <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V3.1//EN"[
 <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V3.1//EN"[
-<!entity % dummy "INCLUDE"> 
+<!entity % dummy "IGNORE"> 
 <!entity supported SYSTEM "supported.sgml">
 <!entity newfeatures SYSTEM "newfeatures.sgml">
 <!entity p-intro SYSTEM "privoxy.sgml">
 <!entity supported SYSTEM "supported.sgml">
 <!entity newfeatures SYSTEM "newfeatures.sgml">
 <!entity p-intro SYSTEM "privoxy.sgml">
@@ -7,7 +7,7 @@
 <!entity contacting SYSTEM "contacting.sgml">
 <!entity history SYSTEM "history.sgml">
 <!entity copyright SYSTEM "copyright.sgml">
 <!entity contacting SYSTEM "contacting.sgml">
 <!entity history SYSTEM "history.sgml">
 <!entity copyright SYSTEM "copyright.sgml">
-<!entity p-version "2.9.14">
+<!entity p-version "2.9.15">
 <!entity p-status "beta">
 <!entity % p-not-stable "INCLUDE">
 <!entity % p-stable "IGNORE">
 <!entity p-status "beta">
 <!entity % p-not-stable "INCLUDE">
 <!entity % p-stable "IGNORE">
@@ -22,7 +22,7 @@
                 This file belongs into
                 ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/
                 
                 This file belongs into
                 ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/
                 
- $Id: faq.sgml,v 1.45 2002/04/08 22:59:26 hal9 Exp $
+ $Id: faq.sgml,v 1.55 2002/05/04 00:41:56 hal9 Exp $
 
  Written by and Copyright (C) 2001 the SourceForge
  Privoxy team. http://www.privoxy.org/
 
  Written by and Copyright (C) 2001 the SourceForge
  Privoxy team. http://www.privoxy.org/
@@ -53,6 +53,7 @@
  to live a peaceful existence!
  ========================================================================
 
  to live a peaceful existence!
  ========================================================================
 
+
 -->
 
 
 -->
 
 
@@ -60,7 +61,7 @@
 <artheader>
 <title>Privoxy Frequently Asked Questions</title>
 
 <artheader>
 <title>Privoxy Frequently Asked Questions</title>
 
-<pubdate>$Id: faq.sgml,v 1.45 2002/04/08 22:59:26 hal9 Exp $</pubdate>
+<pubdate>$Id: faq.sgml,v 1.55 2002/05/04 00:41:56 hal9 Exp $</pubdate>
 
 <authorgroup>
  <author>
 
 <authorgroup>
  <author>
@@ -102,16 +103,10 @@
 </abstract>
 </artheader>
 
 </abstract>
 </artheader>
 
-<!--   ~~~~~       New section      ~~~~~     -->
-<sect1 id="intro" label=""><title></title>
-<!-- dummy section to force TOC on page by itself -->
-<!-- DO NOT REMOVE! please ;) -->
-<para> </para>
-</sect1>
 
 <!--   ~~~~~       New section      ~~~~~     -->
 
 
 <!--   ~~~~~       New section      ~~~~~     -->
 
-<sect1 label="1" id="general"><title>General Information</title>
+<sect1 id="general"><title>General Information</title>
 
 <sect2 renderas="sect3" id="newjb"><title>What is this new version of <application>Privoxy</application>?</title>
  <para>
 
 <sect2 renderas="sect3" id="newjb"><title>What is this new version of <application>Privoxy</application>?</title>
  <para>
@@ -338,7 +333,7 @@ warranty? Registration?</title>
 
 <!--   ~~~~~       New section      ~~~~~     -->
 
 
 <!--   ~~~~~       New section      ~~~~~     -->
 
-<sect1  label="2" id="installation"><title>Installation</title>
+<sect1  id="installation"><title>Installation</title>
 
 <sect2 renderas="sect3" id="whichbrowsers">
 <title>Which browsers are supported by <application>Privoxy</application>?</title>
 
 <sect2 renderas="sect3" id="whichbrowsers">
 <title>Which browsers are supported by <application>Privoxy</application>?</title>
@@ -451,7 +446,7 @@ All the ads are there. What's wrong?</title>
 
 <!--   ~~~~~       New section      ~~~~~     -->
 
 
 <!--   ~~~~~       New section      ~~~~~     -->
 
-<sect1  label="3" id="configuration"><title>Configuration</title>
+<sect1 id="configuration"><title>Configuration</title>
 
 <sect2 renderas="sect3" id="newconfig"><title>Can I use my old config files?</title>
  <para>
 
 <sect2 renderas="sect3" id="newconfig"><title>Can I use my old config files?</title>
  <para>
@@ -472,7 +467,7 @@ All the ads are there. What's wrong?</title>
  <quote>actions</quote> files are where various actions that
  <application>Privoxy</application> might take, are configured. 
  Typically, you would define a set of default actions that apply 
  <quote>actions</quote> files are where various actions that
  <application>Privoxy</application> might take, are configured. 
  Typically, you would define a set of default actions that apply 
- to all URLs, then add exceptions to these defaults.
+ to all URLs, then add exceptions to these defaults where needed.
 </para>
  
 <para>
 </para>
  
 <para>
@@ -484,6 +479,8 @@ All the ads are there. What's wrong?</title>
  site, we would define this in our <quote>actions</quote> file.
 
 </para>
  site, we would define this in our <quote>actions</quote> file.
 
 </para>
+<!--
+No longer appropriate 04/28/02 hal.
 
 <para>
  <application>Privoxy</application> comes with several default
 
 <para>
  <application>Privoxy</application> comes with several default
@@ -491,7 +488,7 @@ All the ads are there. What's wrong?</title>
  of filtering and blocking, as starting points for your own 
  configuration (see below).
 </para>
  of filtering and blocking, as starting points for your own 
  configuration (see below).
 </para>
-
+-->
 </sect2>
 
 <sect2 renderas="sect3" id="actionss">
 </sect2>
 
 <sect2 renderas="sect3" id="actionss">
@@ -499,7 +496,7 @@ All the ads are there. What's wrong?</title>
 some of these <quote>actions</quote>.</title>
 <para>
  These are all explained in the 
 some of these <quote>actions</quote>.</title>
 <para>
  These are all explained in the 
- <ulink url="../user-manual/configuration.html#ACTIONSFILE">user-manual</ulink>.
+ <ulink url="../user-manual/actions-file.html">user-manual</ulink>.
  Please refer to that.
 </para>
 </sect2>
  Please refer to that.
 </para>
 </sect2>
@@ -513,7 +510,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 
  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://config.privoxy.org">Edit the actions list</ulink>"
+ "<ulink url="http://config.privoxy.org">View & change the current configuration</ulink>"
  from the selection list. You can also do this by editing the appropriate 
  file with a text editor.
 </para>
  from the selection list. You can also do this by editing the appropriate 
  file with a text editor.
 </para>
@@ -521,13 +518,36 @@ way to do this?</title>
 <para>
  Please see the 
  <ulink
 <para>
  Please see the 
  <ulink
- url="../user-manual/configuration.html#ACTIONSFILE">user-manual</ulink> for a
+ url="../user-manual/actions-file.html">user-manual</ulink> for a
  detailed explanation of these and other configuration files, and their
  various options and syntax.
 </para>
 </sect2>
 
 
  detailed explanation of these and other configuration files, and their
  various options and syntax.
 </para>
 </sect2>
 
 
+<!--   ~~~~~       New section      ~~~~~     -->
+<sect2 renderas="sect3">
+<title>There are several different <quote>actions</quote> files. What are
+the differences?</title>
+<para>
+ As of <application>Privoxy</application> v2.9.15, three actions files 
+ are being included, to be used for 
+ different purposes. These are 
+ <filename>default.action</filename>, <filename>standard.action</filename>, 
+ and <filename>user.action</filename>. Please see 
+ <ulink url="../user-manual/actions-file.html">the User Manual</ulink> 
+ for an explanation of each.
+</para>
+
+<para>
+ Earlier versions included three different versions
+ <filename>default.action</filename> files. The new scheme allows for 
+ greater flexibility of local configuration, and for browser based 
+ configuration.
+</para>
+
+</sect2>
+
 <!--
 FIXME: Commenting these out until we have some data there. HB 03/17/02.
 
 <!--
 FIXME: Commenting these out until we have some data there. HB 03/17/02.
 
@@ -550,6 +570,7 @@ FIXME: Commenting these out until we have some data there. HB 03/17/02.
 </sect2>
 -->
 
 </sect2>
 -->
 
+<!--
 <sect2 renderas="sect3" id="configfiles"> <title>What are the differences between
 intermediate.action, basic.action, etc.?</title>
  <para>
 <sect2 renderas="sect3" id="configfiles"> <title>What are the differences between
 intermediate.action, basic.action, etc.?</title>
  <para>
@@ -574,7 +595,7 @@ following table shows you, which features are enabled in each configuration.
   <entry>advanced.action</entry>
 </row>
 </thead>
   <entry>advanced.action</entry>
 </row>
 </thead>
-
+-->
 <!--  <tfoot> -->
 <!--  <row> -->
 <!--    <entry>f1</entry> -->
 <!--  <tfoot> -->
 <!--  <row> -->
 <!--    <entry>f1</entry> -->
@@ -584,9 +605,9 @@ following table shows you, which features are enabled in each configuration.
 <!--    <entry>f5</entry> -->
 <!--  </row> -->
 <!--  </tfoot> -->
 <!--    <entry>f5</entry> -->
 <!--  </row> -->
 <!--  </tfoot> -->
-
+<!--
 <tbody>
 <tbody>
-<!-- new row -->
+
 <row>
   <entry>ad-filtering</entry>
   <entry>?</entry>
 <row>
   <entry>ad-filtering</entry>
   <entry>?</entry>
@@ -594,7 +615,7 @@ following table shows you, which features are enabled in each configuration.
   <entry>x</entry>
   <entry>x</entry>
 </row>
   <entry>x</entry>
   <entry>x</entry>
 </row>
-<!-- new row -->
+
 <row>
   <entry>blank image</entry>
   <entry>?</entry>
 <row>
   <entry>blank image</entry>
   <entry>?</entry>
@@ -602,7 +623,7 @@ following table shows you, which features are enabled in each configuration.
   <entry>x</entry>
   <entry>x</entry>
 </row>
   <entry>x</entry>
   <entry>x</entry>
 </row>
-<!-- new row -->
+
 <row>
   <entry>de-animate GIFs</entry>
   <entry>?</entry>
 <row>
   <entry>de-animate GIFs</entry>
   <entry>?</entry>
@@ -610,7 +631,7 @@ following table shows you, which features are enabled in each configuration.
   <entry>x</entry>
   <entry>x</entry>
 </row>
   <entry>x</entry>
   <entry>x</entry>
 </row>
-<!-- new row -->
+
 <row>
   <entry>referer forging</entry>
   <entry>?</entry>
 <row>
   <entry>referer forging</entry>
   <entry>?</entry>
@@ -618,7 +639,7 @@ following table shows you, which features are enabled in each configuration.
   <entry>x</entry>
   <entry>x</entry>
 </row>
   <entry>x</entry>
   <entry>x</entry>
 </row>
-<!-- new row -->
+
 <row>
   <entry>jon's +no-cookies-keep (i.e. session cookies only)</entry>
   <entry>?</entry>
 <row>
   <entry>jon's +no-cookies-keep (i.e. session cookies only)</entry>
   <entry>?</entry>
@@ -626,7 +647,7 @@ following table shows you, which features are enabled in each configuration.
   <entry>x</entry>
   <entry>x</entry>
 </row>
   <entry>x</entry>
   <entry>x</entry>
 </row>
-<!-- new row -->
+
 <row>
   <entry>no-popup windows</entry>
   <entry>?</entry>
 <row>
   <entry>no-popup windows</entry>
   <entry>?</entry>
@@ -634,7 +655,7 @@ following table shows you, which features are enabled in each configuration.
   <entry>x</entry>
   <entry>x</entry>
 </row>
   <entry>x</entry>
   <entry>x</entry>
 </row>
-<!-- new row -->
+
 <row>
   <entry>fast redirects</entry>
   <entry>?</entry>
 <row>
   <entry>fast redirects</entry>
   <entry>?</entry>
@@ -642,7 +663,7 @@ following table shows you, which features are enabled in each configuration.
   <entry>x</entry>
   <entry>x</entry>
 </row>
   <entry>x</entry>
   <entry>x</entry>
 </row>
-<!-- new row -->
+
 <row>
   <entry>hide-referrer</entry>
   <entry>?</entry>
 <row>
   <entry>hide-referrer</entry>
   <entry>?</entry>
@@ -650,7 +671,7 @@ following table shows you, which features are enabled in each configuration.
   <entry>x</entry>
   <entry>x</entry>
 </row>
   <entry>x</entry>
   <entry>x</entry>
 </row>
-<!-- new row -->
+
 <row>
   <entry>hide-useragent</entry>
   <entry>?</entry>
 <row>
   <entry>hide-useragent</entry>
   <entry>?</entry>
@@ -658,7 +679,7 @@ following table shows you, which features are enabled in each configuration.
   <entry>x</entry>
   <entry>x</entry>
 </row>
   <entry>x</entry>
   <entry>x</entry>
 </row>
-<!-- new row -->
+
 <row>
   <entry>content-modification</entry>
   <entry>?</entry>
 <row>
   <entry>content-modification</entry>
   <entry>?</entry>
@@ -666,7 +687,7 @@ following table shows you, which features are enabled in each configuration.
   <entry></entry>
   <entry>x</entry>
 </row>
   <entry></entry>
   <entry>x</entry>
 </row>
-<!-- new row -->
+
 <row>
   <entry>feature-x</entry>
   <entry>?</entry>
 <row>
   <entry>feature-x</entry>
   <entry>?</entry>
@@ -674,7 +695,7 @@ following table shows you, which features are enabled in each configuration.
   <entry></entry>
   <entry></entry>
 </row>
   <entry></entry>
   <entry></entry>
 </row>
-<!-- new row -->
+
 <row>
   <entry>feature-y</entry>
   <entry>?</entry>
 <row>
   <entry>feature-y</entry>
   <entry>?</entry>
@@ -682,7 +703,7 @@ following table shows you, which features are enabled in each configuration.
   <entry></entry>
   <entry></entry>
 </row>
   <entry></entry>
   <entry></entry>
 </row>
-<!-- new row -->
+
 <row>
   <entry>feature-z</entry>
   <entry>?</entry>
 <row>
   <entry>feature-z</entry>
   <entry>?</entry>
@@ -690,13 +711,15 @@ following table shows you, which features are enabled in each configuration.
   <entry></entry>
   <entry></entry>
 </row>
   <entry></entry>
   <entry></entry>
 </row>
-<!-- finish -->
+
 </tbody>
 </tgroup>
 </table>
 </para>
 </sect2>
 
 </tbody>
 </tgroup>
 </table>
 </para>
 </sect2>
 
+ -->
+
 <sect2 renderas="sect3" id="browseconfig"> <title>Why can I change the configuration with a
 browser? Does that not raise security issues?</title>
  <para>
 <sect2 renderas="sect3" id="browseconfig"> <title>Why can I change the configuration with a
 browser? Does that not raise security issues?</title>
  <para>
@@ -727,7 +750,8 @@ problem.
 <sect2 renderas="sect3">
 <title id="filterfile">What is <quote>default.filter</quote>?</title>
 <para>
 <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
+ The <quote>default.filter</quote> file is where <quote>filters</quote>
+ are defined, which are used to <quote>filter</quote> any
  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, and operate 
  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, and operate 
@@ -744,7 +768,8 @@ problem.
 <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 
 <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 <quote>Actions List Editor</quote> from your browser.
+ file with the <quote>View & change the current configuration</quote> from
+ your browser. 
 </para>
 
 </sect2>
 </para>
 
 </sect2>
@@ -765,7 +790,7 @@ problem.
 <para>
  <screen>
   listen-address  192.168.1.1:8118
 <para>
  <screen>
   listen-address  192.168.1.1:8118
- </screen>
+</screen>
 </para>
 
 <para>
 </para>
 
 <para>
@@ -780,21 +805,22 @@ problem.
 <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
 <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
- <application>Privoxy</application> is stopping. You have the choice <!-- of
- 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.
+ <application>Privoxy</application> is stopping. You have the choice 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 <ulink url="../user-manual/actions-file.html#HANDLE-AS-IMAGE"><quote>+handle-as-image</quote></ulink>
+ <emphasis>and</emphasis> 
+ <ulink url="../user-manual/actions-file.html#BLOCK"><quote>+block</quote></ulink> actions.
 </para>
 </para>
-
 <para>
 <para>
- If you want to see nothing, then change the <quote>+image-blocker</quote> 
+ If you want to see nothing, then change the 
+ <ulink url="../user-manual/actions-file.html#SET-IMAGE-BLOCKER"><quote>+set-image-blocker</quote></ulink>
  action to <quote>+image-blocker{blank}</quote>. This can be done from the 
  action to <quote>+image-blocker{blank}</quote>. This can be done from the 
- <quote>Edit Actions List</quote> selection at <ulink
+ <quote>View & change the current configuration</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. Also, some URLs that generate the bright red <quote>Blocked</quote>
  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. Also, some URLs that generate the bright red <quote>Blocked</quote>
- banner, can be moved to the <quote>+image-blocker</quote> section for the
+ banner, can be moved to the <quote>+set-image-blocker</quote> section for the
  same reason, but there are some limits and risks to this (see below).
 </para>
 
  same reason, but there are some limits and risks to this (see below).
 </para>
 
@@ -818,23 +844,27 @@ problem.
 <quote>Blocked</quote>. Why and how do I get rid of this?</title>
 <para>
  These are URLs that match something in one of 
 <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
- 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.
+ <application>Privoxy's</application> block actions 
+ (<ulink
+ url="../user-manual/actions-file.html#BLOCK"><quote>+block</quote></ulink>).
+ 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 explicitly as <quote>images</quote> (e.g. ads that are GIF image
+ files). 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
 </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
+ aribitrary 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
  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.
+ for frames. Such situations can be a little trickier to deal with, and 
+ <application>Privoxy</application> may show the <quote>Blocked</quote> page,
+ despite your best efforts.
 </para>
 
 <para>
 </para>
 
 <para>
@@ -860,20 +890,26 @@ problem.
 <para>
  Another way to deal with this is find why and where
  <application>Privoxy</application> is blocking the frame, and 
 <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 
+ diable this. Then let the <quote>+set-image-blocker</quote> action 
  handle the ad that is embedded in the frame's HTML page. 
 </para>
 
 </sect2>
 
 <sect2 renderas="sect3" id="alliseeisred">
  handle the ad that is embedded in the frame's HTML page. 
 </para>
 
 </sect2>
 
 <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>
+<title>I cannot see all of the <quote>Blocked</quote> page banner. Help.</title>
 <para>
 <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.
+ There is not enough available space to fit the entire Blocked page. Try right
+ clicking on the visible 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>
+<para>
+ As of Privoxy 2.9.14, the Blocked banner page is re-sizeable, and tries
+ to adjust to the allotted space. There may be occassions where there 
+ just isn't enough room to display much of anything useful though. 
+
 </para>
 </sect2>
 
 </para>
 </sect2>
 
@@ -901,18 +937,39 @@ on Win2K/NT?</title>
 proxies like <application>Squid</application>?</title>
 <para>
  This can be done. See the <ulink
 proxies like <application>Squid</application>?</title>
 <para>
  This can be done. See the <ulink
- url="../user-manual/configuration.html#FORWARDING">user manual</ulink>, 
+ url="../user-manual/config.html#FORWARDING">user manual</ulink>, 
  which describes how to do this.
  which describes how to do this.
+</para>
+</sect2>
 
 
+<sect2 renderas="sect3" id="transparent">
+<title>Can <application>Privoxy</application> run as a <quote>transparent
+</quote> proxy?</title>
+<para>
+ No, <application>Privoxy</application> currently does not have this ability, 
+ though it is planned for a future release. Transparent proxies require 
+ special handling of the request headers beyond what
+ <application>Privoxy</application> is now capable of.
+</para>
+
+<para>
+ Chaining <application>Privoxy</application> with another proxy that has 
+ this ability should work though. 
+ See the <ulink url="../user-manual/config.html#FORWARDING">user
+ manual</ulink>, which describes this, and also <ulink
+ url="http://www.transproxy.nlc.net.au/">http://www.transproxy.nlc.net.au/</ulink>.
 </para>
 
 </sect2>
 
 </sect1>
 
 </para>
 
 </sect2>
 
 </sect1>
 
+<!--  ~  End section  ~  -->
+
+
 <!--   ~~~~~       New section      ~~~~~     -->
 
 <!--   ~~~~~       New section      ~~~~~     -->
 
-<sect1  label="4"id="misc"><title>Miscellaneous</title>
+<sect1 id="misc"><title>Miscellaneous</title>
 
 <sect2 renderas="sect3">
 <title id="slowsme">How much does <application>Privoxy</application> slow my browsing down? This 
 
 <sect2 renderas="sect3">
 <title id="slowsme">How much does <application>Privoxy</application> slow my browsing down? This 
@@ -935,25 +992,20 @@ has to add extra time to browsing.</title>
 </sect2>
 
 
 </sect2>
 
 
-
 <sect2 renderas="sect3" id="loadingtimes"><title>I noticed considerable
 delays in page requests compared to the old Junkbuster. What's wrong?</title>
 <para>
 <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
-page requests compared to the old Junkbuster. Loading pages with large contents
-seemed to take forever, then suddenly delivering all the content at once.
- </para>
-<para>
-The whole content must be loaded in order to filter, and nothing is is
-sent to the browser during this time. The loading time does not really
-change in real numbers, but the feeling is different, because most
-browsers are able to start rendering incomplete content, giving the
-user a feeling of "it works". 
+The entire page content must be loaded into memory in order for the filtering 
+mechanism to work, and nothing is sent to the browser during this time. The
+loading time does not really change in real numbers, but the feeling is
+different, because most browsers are able to start rendering incomplete
+content, giving the user a feeling of "it works". 
  </para>
 <para>
  </para>
 <para>
-To modify the content of a page (i.e. make frames resizeable again, etc.) and
-not just replace ads, <application>Privoxy</application> needs to download the
-entire page first, do its content magic and then send the page to the browser.
+ To modify the content of a page (i.e. make frames resizeable again, etc.) and
+ not just replace ads, <application>Privoxy</application> needs to download
+ the entire page first, do its content magic and then send the page to the
+ browser.
 </para>
 </sect2>
 
 </para>
 </sect2>
 
@@ -1017,16 +1069,14 @@ FIXME: commented out until we have data. HB 03/18/02.
 
 <sect2 renderas="sect3" id="newads"><title>How can I submit new ads?</title>
 <para>
 
 <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.
+Please see the <ulink url="contact.html">Contact section</ulink>.
 </para>
 </para>
+
 <para>
 <para>
- This does not work with earlier versions of <application>Privoxy</application>
+ This process does not work with earlier versions of <application>Privoxy</application>
  or <application>Junkbuster</application>.
 </para>
  or <application>Junkbuster</application>.
 </para>
+
 </sect2>
 
 <sect2 renderas="sect3" id="ip"><title>How can I hide my IP address?</title>
 </sect2>
 
 <sect2 renderas="sect3" id="ip"><title>How can I hide my IP address?</title>
@@ -1255,7 +1305,7 @@ and related issues?</title>
 
 <!--   ~~~~~       New section      ~~~~~     -->
 
 
 <!--   ~~~~~       New section      ~~~~~     -->
 
-<sect1 label="5" id="trouble">
+<sect1 id="trouble">
 <title>Troubleshooting</title>
 
 <sect2 renderas="sect3">
 <title>Troubleshooting</title>
 
 <sect2 renderas="sect3">
@@ -1309,15 +1359,16 @@ 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 
  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. It's probably a good idea to flush the browser cache as well.
+ page again. It's probably a good idea to flush the browser cache as well 
+ with <literal>Shift+Reload</literal> to flush caches.
 </para>
 
 <para>
  If still a problem, go to <quote>Show which actions apply to a URL and
  why</quote> from <ulink url="http://p.p/">http://p.p/</ulink> and paste
  the full URL of the page in question into the prompt. See which actions are
 </para>
 
 <para>
  If still a problem, go to <quote>Show which actions apply to a URL and
  why</quote> from <ulink url="http://p.p/">http://p.p/</ulink> and paste
  the full URL of the page in question into the prompt. See which actions are
- 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
+ being applied to the URL. Now, armed with this information, go to 
+ <quote>View & change the current configuration</quote>. Here you should see various sections that have
  various <application>Privoxy</application> features disabled for specific
  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, 
  various <application>Privoxy</application> features disabled for specific
  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, 
@@ -1327,7 +1378,7 @@ What can I do?</title>
  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
  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
+ error involved. This is discussed in more detail in the <ulink
  url="../user-manual/appendix.html#ACTIONSANAT">user-manual appendix</ulink>.
 
 </para>
  url="../user-manual/appendix.html#ACTIONSANAT">user-manual appendix</ulink>.
 
 </para>
@@ -1339,24 +1390,6 @@ What can I do?</title>
 
 </sect2>
 
 
 </sect2>
 
-<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
- page in the <ulink url="../user-manual/contact.html">user-manual</ulink> for
- details.
-
-</para>
-
-</sect2>
-
-<sect2 renderas="sect3">
-<title id="time">What time is it?</title>
-<para>
- Time for you to go!
-</para>
-</sect2>
-
 </sect1>
 <!--
 </sect1>
 </sect1>
 <!--
 </sect1>
@@ -1434,6 +1467,35 @@ 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 $
  Temple Place - Suite 330, Boston, MA  02111-1307, USA.
 
 $Log: faq.sgml,v $
+Revision 1.55  2002/05/04 00:41:56  hal9
+-Remove TOC/first page kludge in favor of proper handling via dsl file.
+
+Revision 1.54  2002/05/03 05:06:44  hal9
+Add brief Q/A on transparent proxies.
+
+Revision 1.53  2002/05/03 01:34:52  hal9
+Fix section numbering for new sections (due to TOC kludge).
+
+Revision 1.52  2002/04/29 03:08:43  hal9
+-Added new Q/A on new actions file set up (pointer to u-m)
+-Fixed a few broken links and converted old actions as a result of
+ recent changes.
+
+Revision 1.51  2002/04/26 17:24:31  swa
+bookmarks cleaned, changed structure of user manual, screen and programlisting cleanups, and numerous other changes that I forgot
+
+Revision 1.50  2002/04/26 05:25:23  hal9
+Mass commit to catch a few scattered fixes.
+
+Revision 1.49  2002/04/12 10:10:18  swa
+version update
+
+Revision 1.48  2002/04/10 18:45:15  swa
+generated
+
+Revision 1.47  2002/04/10 04:05:32  hal9
+More on BML, etc.
+
 Revision 1.45  2002/04/08 22:59:26  hal9
 Version update. Spell chkconfig correctly :)
 
 Revision 1.45  2002/04/08 22:59:26  hal9
 Version update. Spell chkconfig correctly :)
 
The official Privoxy git repository