correct feedback channels
[privoxy.git] / doc / source / faq.sgml
index 49144cd..6b950ed 100644 (file)
@@ -6,7 +6,7 @@
                 This file belongs into
                 ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/
                 
- $Id: faq.sgml,v 1.5 2002/03/02 15:50:04 swa Exp $
+ $Id: faq.sgml,v 1.9 2002/03/10 23:34:04 swa Exp $
 
  Written by and Copyright (C) 2001 the SourceForge
  IJBSWA team.  http://ijbswa.sourceforge.net
@@ -20,7 +20,7 @@
 <artheader>
 <title>Junkbuster Frequently Asked Questions</title>
 
-<pubdate>$Id: faq.sgml,v 1.5 2002/03/02 15:50:04 swa Exp $</pubdate>
+<pubdate>$Id: faq.sgml,v 1.9 2002/03/10 23:34:04 swa Exp $</pubdate>
 
 <authorgroup>
  <author>
 
 <abstract>
  <para>
-    The FAQ document gives users and developers alike answers to frequently
-asked questions about the Internet Junkbuster. The Internet Junkbuster is an application
-that provides privacy and security to the user of the world wide web.
+The FAQ document gives users and developers alike answers to frequently asked
+questions about the Internet Junkbuster. <application>Internet
+Junkbuster</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. Junkbuster has a very flexible configuration and can be
+customized to suit individual needs and tastes. <application>Internet
+Junkbuster</application> has application for both stand-alone systems and
+multi-user networks.
  </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>.
 Please see the Contact section in the user-manual if you want to contact the developers.
  </para>
 
- <para>
-  Feel free to send a note to the developers at <email>ijbswa-developers@lists.sourceforge.net</email>.
- </para>
+<!--   <para> -->
+<!--    Feel free to send a note to the developers at <email>ijbswa-developers@lists.sourceforge.net</email>. -->
+<!--   </para> -->
 </abstract>
 </artheader>
 
@@ -89,22 +95,172 @@ Please see the Contact section in the user-manual if you want to contact the dev
  </para>
 </sect3>
 
+<sect3 id="configfiles"> <title>What are the differences between
+ijb-intermediate.action, ijb-basci.action, etc.?</title>
+ <para>
+Configuring the Internet Junkbuster is not easy. To help you get started, we
+provide you with three different default configurations. The following table
+shows you, which features are enabled in each configuration.
+ </para>
+ <para>
+<table frame=all><title>Default Configurations</title>
+<tgroup cols=5 align=left colsep=1 rowsep=1>
+<colspec colname=c1>
+<colspec colname=c2>
+<colspec colname=c3>
+<colspec colname=c4>
+<colspec colname=c5>
+<thead>
+<row>
+  <entry>Feature</entry>
+  <entry>ijb.action</entry>
+  <entry>ijb-basic.action</entry>
+  <entry>ijb-intermediate.action</entry>
+  <entry>ijb-advanced.action</entry>
+</row>
+</thead>
+
+<!--  <tfoot> -->
+<!--  <row> -->
+<!--    <entry>f1</entry> -->
+<!--    <entry>f2</entry> -->
+<!--    <entry>f3</entry> -->
+<!--    <entry>f4</entry> -->
+<!--    <entry>f5</entry> -->
+<!--  </row> -->
+<!--  </tfoot> -->
+
+<tbody>
+<!-- new row -->
+<row>
+  <entry>ad-filtering</entry>
+  <entry>?</entry>
+  <entry>x</entry>
+  <entry>x</entry>
+  <entry>x</entry>
+</row>
+<!-- new row -->
+<row>
+  <entry>blank image</entry>
+  <entry>?</entry>
+  <entry>x</entry>
+  <entry>x</entry>
+  <entry>x</entry>
+</row>
+<!-- new row -->
+<row>
+  <entry>de-animate GIFs</entry>
+  <entry>?</entry>
+  <entry>x</entry>
+  <entry>x</entry>
+  <entry>x</entry>
+</row>
+<!-- new row -->
+<row>
+  <entry>referer forging</entry>
+  <entry>?</entry>
+  <entry>x</entry>
+  <entry>x</entry>
+  <entry>x</entry>
+</row>
+<!-- new row -->
+<row>
+  <entry>jon's +no-cookies-keep (i.e. session cookies only)</entry>
+  <entry>?</entry>
+  <entry>x</entry>
+  <entry>x</entry>
+  <entry>x</entry>
+</row>
+<!-- new row -->
+<row>
+  <entry>no-popup windows</entry>
+  <entry>?</entry>
+  <entry></entry>
+  <entry>x</entry>
+  <entry>x</entry>
+</row>
+<!-- new row -->
+<row>
+  <entry>fast redirects</entry>
+  <entry>?</entry>
+  <entry></entry>
+  <entry>x</entry>
+  <entry>x</entry>
+</row>
+<!-- new row -->
+<row>
+  <entry>hide-referrer</entry>
+  <entry>?</entry>
+  <entry></entry>
+  <entry>x</entry>
+  <entry>x</entry>
+</row>
+<!-- new row -->
+<row>
+  <entry>hide-useragent</entry>
+  <entry>?</entry>
+  <entry></entry>
+  <entry>x</entry>
+  <entry>x</entry>
+</row>
+<!-- new row -->
+<row>
+  <entry>content-modification</entry>
+  <entry>?</entry>
+  <entry></entry>
+  <entry></entry>
+  <entry>x</entry>
+</row>
+<!-- new row -->
+<row>
+  <entry>feature-x</entry>
+  <entry>?</entry>
+  <entry></entry>
+  <entry></entry>
+  <entry></entry>
+</row>
+<!-- new row -->
+<row>
+  <entry>feature-y</entry>
+  <entry>?</entry>
+  <entry></entry>
+  <entry></entry>
+  <entry></entry>
+</row>
+<!-- new row -->
+<row>
+  <entry>feature-z</entry>
+  <entry>?</entry>
+  <entry></entry>
+  <entry></entry>
+  <entry></entry>
+</row>
+<!-- finish -->
+</tbody>
+</tgroup>
+</table>
+</para>
+</sect3>
+
 <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/junkbuster hierarchy belongs to the user
 "junkbuster", with only 644 perms.
-
+ </para>
+ <para>
 When you use the browser-based editor, JunkBuster itself is writing to the
 config files.  Because JunkBuster is running as the user "junkbuster", 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 JunkBuster.
-
+ </para>
+ <para>
 Note that normally only local users can connect to JunkBuster, so this is not
 (normally) a security problem.
  </para>
@@ -122,13 +278,15 @@ delays in page requests compared to the old IJB. What's wrong?</title>
 Using the default filtering configuration, I noticed considerable delays in
 page requests compared to the old IJB. 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". 
-
+ </para>
+<para>
 To modify the content of a page (i.e. make frames resizeable again, etc.) and
 not just replace ads, the Internet Junkbuster needs to download the entire
 page first, do its content magic and then send the page to the browser.
@@ -140,20 +298,28 @@ page first, do its content magic and then send the page to the browser.
 <para>
 Since JunkBuster sits between your web browser and the Internet, it can be
 programmed to handle certain pages specially.
+</para>
 
+<para>
 With recent versions of JunkBuster (version 2.9.x), you can get some
 information about JunkBuster and change some settings by going to
 http://i.j.b/ or, equivalently, http://ijbswa.sourceforge.net/config/
 (Note that i.j.b is far easier to type but may not work in some
 configurations).
+</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 JunkBuster.
+</para>
 
+<para>
 If you are not running JunkBuster, then http://i.j.b/ will fail, and
 http://ijbswa.sourceforge.net/config/ will return a web page telling you
 you're not running JunkBuster.
+</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).
@@ -179,8 +345,8 @@ should really consider upgrading to 2.9.x).
    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. Once we have added you to
-   the team, you'll have write access to the CVS repository, and we'll find a
-   suitable task for you together.
+   the team, you'll have write access to the CVS repository, and together
+   we'll find a suitable task for you.
 </para>
 </sect3>
 
@@ -202,18 +368,36 @@ should really consider upgrading to 2.9.x).
 
 <sect3 id="ip"><title>How can I hide my IP address?</title>
 <para>
- You cannot hide your IP address with Junkbuster.
+ You cannot hide your IP address with Junkbuster or any other software, since
+the server needs to know your IP address to send the answer to you.
+</para>
+<para>
+Fortunately there are many publicly usable anonymous proxies out there, which
+solve the problem by providing a further level of indirection between you and
+the web server, shared by many people and thus letting your requests "drown"
+in white noise of unrelated requests as far as user tracking is concerned.
+</para>
+<para>
+Most of them will, however, log your IP address and make it available to the
+authorities in case you abuse that anonymity for criminal purposes. In fact
+you can't even rule out that some of them only exist to *collect* information
+on (those suspicious) people with a more than average preference for privacy.
 </para>
-</sect3>
-
-<sect3 id="image"><title>What is the imagefile (simage.ini, etc.) for?</title>
 <para>
- Anytime the Junkbuster determines (with the help of the blocklist) that a URL
- contains an advertisement, it has to decide whether this advertisement is an
- image or not. The Junkbuster uses the imagefile for that purpose.
+You can find a list of anonymous public proxies at <ulink
+url="http://www.multiproxy.org/anon_list.htm">multiproxy.org</ulink> and many
+more through Google.
 </para>
 </sect3>
 
+<!--  <sect3 id="image"><title>What is the imagefile (simage.ini, etc.) for?</title> -->
+<!--  <para> -->
+<!--   Anytime the Junkbuster determines (with the help of the blocklist) that a URL -->
+<!--   contains an advertisement, it has to decide whether this advertisement is an -->
+<!--   image or not. The Junkbuster uses the imagefile for that purpose. -->
+<!--  </para> -->
+<!--  </sect3> -->
+
 </sect2>
 
 </sect1>
@@ -261,6 +445,18 @@ should really consider upgrading to 2.9.x).
  Temple Place - Suite 330, Boston, MA  02111-1307, USA.
 
 $Log: faq.sgml,v $
+Revision 1.9  2002/03/10 23:34:04  swa
+more info on not hiding ip address
+
+Revision 1.8  2002/03/09 15:55:48  swa
+added default config section
+
+Revision 1.7  2002/03/07 18:16:55  swa
+looks better
+
+Revision 1.6  2002/03/07 13:16:31  oes
+Committing changes by Stefan
+
 Revision 1.5  2002/03/02 15:50:04  swa
 2.9.11 version. more input for docs.