A few more additions.

diff --git a/doc/source/faq.sgml b/doc/source/faq.sgml
index 2861519..b84c590 100644 (file)
--- a/doc/source/faq.sgml
+++ b/doc/source/faq.sgml
@@ -6,7 +6,7 @@
                 This file belongs into
                 ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/
                 
- $Id: faq.sgml,v 1.14 2002/03/17 02:39:13 hal9 Exp $
+ $Id: faq.sgml,v 1.15 2002/03/17 07:25:59 hal9 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.14 2002/03/17 02:39:13 hal9 Exp $</pubdate>
+<pubdate>$Id: faq.sgml,v 1.15 2002/03/17 07:25:59 hal9 Exp $</pubdate>
 
 <authorgroup>
  <author>
@@ -91,7 +91,7 @@ Please see the Contact section in the user-manual if you want to contact the dev
 <sect3 id="differs"><title>How does it differ from the old <application>Junkbuster?</application></title>
  <para>
    All the old features remain. The new <application>Junkbuster</application> 
-   still blocks ads and banners, still manages cookies, and protects 
+   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>
@@ -295,6 +295,19 @@ warranty? Registration?</title>
  
 </sect3>
 
+<sect3>
+<title id="nothing">I just installed Junkbuster, and nothing is happening.
+All the ads are there. What's wrong?</title>
+
+<para>
+ Did you configure your browser to use <application>Junkbuster</application> 
+ as a proxy? It does not sound like it. See below. You might also try flushing
+ the browser's caches to force a full re-reading of pages.
+
+</para>
+
+</sect3>
+
 <sect3 id="localhost"><title>What is the proxy address of Junkbuster?</title>
  <para>
   If you set up the <application>Junkbuster</application> to run on
@@ -309,7 +322,9 @@ warranty? Registration?</title>
   When configuring your browser's proxy settings you typically enter
   the word <quote>localhost</quote> in the boxes next to <quote>HTTP</quote>
   and <quote>Secure</quote> (HTTPS) and then the number <quote>8118</quote>
-  for <quote>port</quote>.  
+  for <quote>port</quote>.  This tells your browser to send all web 
+  requests to <quote>Junkbuster</quote> instead of directly to the 
+  Interenet.
  </para>
  <para>
   <application>Junkbuster</application> can also be used to proxy for 
@@ -339,6 +354,8 @@ warranty? Registration?</title>
  </para>
 </sect3>
 
+<!--
+FIXME: Commenting these out until we have some data there. HB 03/17/02.
 
 <sect3 id="yahoo"><title>How can I make my Yahoo account work?</title>
  <para>
@@ -357,6 +374,7 @@ warranty? Registration?</title>
    Fillme.
  </para>
 </sect3>
+-->
 
 <sect3 id="configfiles"> <title>What are the differences between
 ijb-intermediate.action, ijb-basic.action, etc.?</title>
@@ -715,12 +733,11 @@ being altered?</title>
  User Agent header. Giving a <quote>User Agent</quote> with the wrong
  operating system or browser manufacturer causes some sites in these languages
  to be garbled; Surfers to Eastern European sites should change it to
- something closer. Some page access counters work by looking at the
+ something closer. And then some page access counters work by looking at the
  <quote>REFERER</quote> header; they may fail or break if unavailable. The
  weather maps of Intellicast have been blocked by their server when no
- <quote>REFERER</quote> or cookie is provided, is another example. There 
- are many, many other ways things can go wrong when trying to fool a 
- web server.
+ <quote>REFERER</quote> or cookie is provided, is another example. There are
+ many, many other ways things can go wrong when trying to fool a web server.
 </para>
 
 <para>
@@ -747,11 +764,11 @@ speed up web browsing?</title>
 
 <sect3>
 <title id="logo">The Junkbuster logo that replaces ads is very blocky 
-looking. Can't a better font be used?</title>
+and ugly looking. Can't a better font be used?</title>
 
 <para>
  This is not a font problem. The logo is an image that is created by 
- <application>Junkbuster</application> on the fly. So as not waste 
+ <application>Junkbuster</application> on the fly. So as to not waste 
  memory, the image is rather small. The blockiness comes when the 
  image is scaled to fill a largish area. There is not much to be done 
  about this, other than to use one of the other
@@ -776,6 +793,27 @@ Why does Junkbuster leave these large gaps?</title>
 
 </sect3>
 
+<sect3>
+<title id="secure">Junkbuster runs as a <quote>server</quote>. How 
+secure is it? Do I need to take any special precautions?</title>
+<para>
+ There are no known exploits that might effect
+ <application>Junkbuster</application>. On Unix-like systems, 
+ <application>Junkbuster</application> can run as a non-privileged 
+ user, which is how we recommend it be run. Also, by default 
+ <application>Junkbuster</application> only listens to requests 
+ from <quote>localhost</quote>. It is not itself directly exposed to the
+ Internet in this configuration. If you want to have
+ <application>Junkbuster</application> serve as a LAN proxy, this will have to
+ be opened up to allow for external requests. In this case, we'd recommend
+ that the port used by <application>Junkbuster</application> (default is
+ 8118), be firewalled from outside (Internet) connections. Better safe than 
+ sorry.
+
+</para>
+
+</sect3>
+
 <!--
 <sect3>
 <title id="blank">Now I see the ugly Junkbuster logo (or checkboard pattern) in
@@ -834,10 +872,46 @@ still getting through. How?</title>
 
 </sect3>
 
+<sect3>
+<title id="badsite">One of my favorite sites does not work with Junkbuster.
+What can I do?</title>
+
+<para>
+ First verify that it is indeed a <application>Junkbuster</application> problem, 
+ by disabling <application>Junkbuster</application> filtering and blocking. 
+ Go to <ulink url="http://i.j.b/">http://i.j.b/</ulink> and click on 
+ <quote>Toggle Junkbuster On or Off</quote>, then disable it. Now try that 
+ page again.
+</para>
+
+<para>
+ If still a problem, go to <quote>Show which actions apply to a URL and
+ why</quote> from  <ulink url="http://i.j.b/">http://i.j.b/</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 various <quote>Junkbuster</quote> 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.
+
+</para>
+
+<para>
+ Alternately, if you are comfortable with a text editor, you can accomplish 
+ the same thing by editing the appropriate <quote>actions</quote> file.
+
+</para>
+
+</sect3>
+
 </sect2>
 
 </sect1>
 
+
 <!--   ~~~~~       New section      ~~~~~     -->
 <sect1 id="knownissues"><title>Known Issues</title>
 <para>
@@ -888,6 +962,9 @@ still getting through. How?</title>
  Temple Place - Suite 330, Boston, MA  02111-1307, USA.
 
 $Log: faq.sgml,v $
+Revision 1.15  2002/03/17 07:25:59  hal9
+Correcting some of my typos, and some additions.
+
 Revision 1.14  2002/03/17 02:39:13  hal9
 A little more added ...