Added imageblock{pattern}.
[privoxy.git] / doc / source / faq.sgml
index 661c566..6446a4d 100644 (file)
@@ -6,7 +6,7 @@
                 This file belongs into
                 ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/
                 
- $Id: faq.sgml,v 1.3 2001/09/23 10:13:48 swa Exp $
+ $Id: faq.sgml,v 1.6 2002/03/07 13:16:31 oes 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.3 2001/09/23 10:13:48 swa Exp $</pubdate>
+<pubdate>$Id: faq.sgml,v 1.6 2002/03/07 13:16:31 oes Exp $</pubdate>
 
 <authorgroup>
  <author>
@@ -50,7 +50,8 @@ Please see the Contact section in the user-manual if you want to contact the dev
 
 <!--   ~~~~~       New section      ~~~~~     -->
 <sect1 id="introduction"><title>Introduction</title>
-<para>To be filled.
+<para>
+   Fillme.
 </para>
 </sect1>
 
@@ -62,7 +63,7 @@ Please see the Contact section in the user-manual if you want to contact the dev
 
 <sect2 id="installation"><title>Installation</title>
  <para>
-  To be done later.
+   Fillme.
  </para>
 </sect2>
 
@@ -72,17 +73,43 @@ Please see the Contact section in the user-manual if you want to contact the dev
 
 <sect3 id="yahoo"><title>How can I make my Yahoo account work?</title>
  <para>
-  <comment>Blank para tag to quiet jade processing errors</comment>
+   Fillme.
  </para>
 </sect3>
 
 <sect3 id="hotmail"> <title>How can I make my Hotmail account work?</title>
   <para>
+   Fillme.
   </para>
 </sect3>
 
 <sect3 id="gmx"> <title>How can I make my GMX account work?</title>
  <para>
+   Fillme.
+ </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>
 </sect3>
 
@@ -92,6 +119,100 @@ Please see the Contact section in the user-manual if you want to contact the dev
 
 <sect2 id="misc"><title>Misc</title>
 
+<sect3 id="loadingtimes"><title>I noticed considerable
+delays in page requests compared to the old IJB. What's wrong?</title>
+<para>
+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.
+</para>
+</sect3>
+
+
+<sect3 id="configurl"><title>What is the "http://i.j.b/"?</title>
+<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).
+</para>
+</sect3>
+
+
+<sect3 id="badfiledesc"><title>I get the message 'Bad File Descriptor', why?</title>
+<para>
+   Fillme.
+</para>
+</sect3>
+
+<sect3 id="proxy-chaining"><title>How do I chain Junkbuster with other proxies
+(e.g. squid)?</title>
+<para>
+   Fillme.
+</para>
+</sect3>
+
+<sect3 id="jointeam"><title>I would like to help you, what do I do?</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. 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.
+</para>
+</sect3>
+
+<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.
+</para>
+</sect3>
+
+<sect3 id="newads"><title>How can I submit new ads?</title>
+<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.
+</para>
+</sect3>
+
 <sect3 id="ip"><title>How can I hide my IP address?</title>
 <para>
  You cannot hide your IP address with Junkbuster.
@@ -102,7 +223,7 @@ Please see the Contact section in the user-manual if you want to contact the dev
 <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..
+ image or not. The Junkbuster uses the imagefile for that purpose.
 </para>
 </sect3>
 
@@ -153,6 +274,16 @@ Please see the Contact section in the user-manual if you want to contact the dev
  Temple Place - Suite 330, Boston, MA  02111-1307, USA.
 
 $Log: faq.sgml,v $
+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.
+
+Revision 1.4  2002/02/24 14:34:24  jongfoster
+Formatting changes.  Now changing the doctype to DocBook XML 4.1
+will work - no other changes are needed.
+
 Revision 1.3  2001/09/23 10:13:48  swa
 upload process established. run make webserver and
 the documentation is moved to the webserver. documents