Apply patch from Mark: s/OSX/OS X/
[privoxy.git] / doc / source / faq.sgml
index 41c8204..5602b19 100644 (file)
@@ -8,7 +8,7 @@
 <!entity history SYSTEM "history.sgml">
 <!entity copyright SYSTEM "copyright.sgml">
 <!entity license SYSTEM "license.sgml">
-<!entity p-version "3.0.6">
+<!entity p-version "3.0.8">
 <!entity p-status "stable">
 <!entity % p-not-stable "IGNORE">
 <!entity % p-stable "INCLUDE">
@@ -26,9 +26,9 @@
                 This file belongs into
                 ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/
                 
- $Id: faq.sgml,v 2.25 2007/07/18 11:00:34 hal9 Exp $
+ $Id: faq.sgml,v 2.38 2008/01/19 17:52:39 hal9 Exp $
 
- Copyright (C) 2001-2007 Privoxy Developers http://privoxy.org
+ Copyright (C) 2001-2008 Privoxy Developers http://www.privoxy.org/
  See LICENSE.
 
  Based partially on the Internet Junkbuster FAQ originally written by and
  <subscript>
 <!-- Completely the wrong markup, but very little is allowed  -->
 <!-- in this part of an article. FIXME -->
- <link linkend="copyright">Copyright</link> &my-copy; 2001-2006 by 
- <ulink url="http://www.privoxy.org">Privoxy Developers</ulink>
+ <link linkend="copyright">Copyright</link> &my-copy; 2001-2008 by 
+ <ulink url="http://www.privoxy.org/">Privoxy Developers</ulink>
  </subscript>
 </pubdate>
 
-<pubdate>$Id: faq.sgml,v 2.25 2007/07/18 11:00:34 hal9 Exp $</pubdate>
+<pubdate>$Id: faq.sgml,v 2.38 2008/01/19 17:52:39 hal9 Exp $</pubdate>
 
 <!--
 
@@ -149,11 +149,10 @@ Hal.
 <!--   ~~~~~       New section      ~~~~~     -->
 
 <sect1 id="general"><title>General Information</title>
-<sect2 renderas="sect3" id="who_uses"><title>Who should use Privoxy?</title>
+<sect2 renderas="sect3" id="who-uses"><title>Who should give &my-app; a try?</title>
  <para>
-  Anyone that is interested in security, privacy, or in 
+  Anyone who is interested in security, privacy, or in 
   finer-grained control over their web and Internet experience.
-  Everyone is encouraged to try &my-app;.
  </para>
 </sect2>
 
@@ -161,15 +160,16 @@ Hal.
 me?</title>
  <para>
   &my-app; is certainly a good choice, especially for those who want more 
-  control and security. Those that have the ability to fine-tune their installation
-  will benefit the most. One of <application>Privoxy's</application>
-  strength's is that it is highly configurable giving you the ability to
+  control and security. Those with the willingness to read the documentation
+  and the ability to fine-tune their installation will benefit the most.
+ </para>
+ <para>
+  One of <application>Privoxy's</application>
+  strengths is that it is highly configurable giving you the ability to
   completely personalize your installation. Being familiar with, or at least
   having an interest in learning about <ulink
   url="http://en.wikipedia.org/wiki/Http">HTTP</ulink> and other networking
-  protocols, <ulink url="http://en.wikipedia.org/wiki/Html">HTML</ulink>, 
-  <ulink url="http://en.wikipedia.org/wiki/Internet_Protocol">IP (Internet
-  Protocol)</ulink>, and 
+  protocols, <ulink url="http://en.wikipedia.org/wiki/Html">HTML</ulink>, and 
   <ulink url="http://en.wikipedia.org/wiki/Regular_expressions"><quote>Regular
   Expressions</quote></ulink>
   will be a big plus and will help you get the most out of &my-app;. 
@@ -183,7 +183,9 @@ me?</title>
   with a  <ulink url="http://en.wikipedia.org/wiki/Web_browser">Web browser</ulink>.
   But there are areas where configuration is done using a 
   <ulink url="http://en.wikipedia.org/wiki/Text_editors">text editor</ulink>
-  to edit configuration files.
+  to edit configuration files. Also note that the web-based action editor
+  doesn't use authentication and should only be enabled in environments
+  where all clients with access to &my-app; listening port can be trusted.
   </para>
 </sect2>
 
@@ -275,18 +277,9 @@ from the old Junkbuster?</title>
  The new <application>Privoxy</application> still blocks ads and banners,
  still manages <ulink
  url="http://en.wikipedia.org/wiki/Browser_cookie">cookies</ulink>, and still
- helps protect your privacy. But, these are all greatly enhanced, and many,
many new features have been added, all in the same vein.
+ helps protect your privacy. But, most of these features have been enhanced,
and many new ones have been added, all in the same vein.
  </para>
- <para>
- The configuration has changed significantly as well. This is something that
- users will notice right off the bat if upgrading from 
- <application>Junkbuster</application> 2.0.x. The <quote>blocklist</quote>
- <quote>cookielist</quote>, <quote>imagelist</quote> and much more has been
- combined into the <quote>actions</quote> files, with a completely different
- syntax. <![%p-newstuff;[ See the <ulink url="../user-manual/whatsnew.html">What's New</ulink> 
- page for the latest updates.]]>
-</para>
 <para>
  <application>Privoxy</application>'s new features include:
 </para>
@@ -351,10 +344,11 @@ This does not sound very scientific.</title>
 <title id="configornot">Will I have to configure Privoxy
  before I can use it?</title>
 <para>
- No, not really. The default installation should give you a good starting
- point, and block <emphasis>most</emphasis> ads and unwanted content. Many of
- the more advanced features are off by default, and would require you to 
- activate them. 
+ That depends on your expectations.
+ The default installation should give you a good starting
+ point, and block <emphasis>most</emphasis> ads and unwanted content,
+ but many of the more advanced features are off by default, and require
+ you to activate them. 
 </para>
 <para>
  You do have to set up your browser to use
@@ -365,7 +359,7 @@ This does not sound very scientific.</title>
  And you will certainly run into situations where there are false positives,
  or ads not being blocked that you may not want to see. In these cases, you
  would certainly benefit by customizing <application>Privoxy's</application>
- configuration to more closely match your individual situation. And we would
+ configuration to more closely match your individual situation. And we
  encourage you to do this. This is where the real power of
  <application>Privoxy</application> lies!
 </para>
@@ -386,8 +380,9 @@ Privoxy. Why should I use Privoxy at all?</title>
  <para>
   Modern browsers do indeed have <emphasis>some</emphasis> of the same
   functionality as <application>Privoxy</application>. Maybe this is
-  adequate for you. But <application>Privoxy</application> is much more
-  versatile and powerful, and can do a number of things that browsers just can't.
+  adequate for you. But <application>Privoxy</application> is very
+  versatile and powerful, and can probably do a number of things
+  your browser just can't.
  </para>
  <para>
   In addition, a proxy is good choice if you use multiple browsers, or 
@@ -396,6 +391,13 @@ Privoxy. Why should I use Privoxy at all?</title>
   have to maintain a similar configuration for possibly many browsers or
   users.
  </para>
+ <para>
+  Note, however, that it's recommended to leverage both your browser's
+  and <application>Privoxy's</application> privacy enhancing features
+  at the same time. While your browser probably lacks some features
+  &my-app; offers, it should also be able to do some things more
+  reliable, for example restricting and suppressing JavaScript.
+ </para>
 </sect2>
 
 <sect2 renderas="sect3" id="whytrust"><title>Why should I trust Privoxy?</title>
@@ -404,8 +406,8 @@ Privoxy. Why should I use Privoxy at all?</title>
   <emphasis>everything</emphasis>, and you can control everything. You can
   check every line of every configuration file yourself. You can check every
   last bit of source code should you desire. And even if you can't read code, 
-  there should be some comfort in knowing that thousands of other people can, 
-  and some of them do read it. You can build the software from scratch, if you want,
+  there should be some comfort in knowing that <!-- thousands of -->other people can, 
+  and do read it. You can build the software from scratch, if you want,
   so that you know the executable is clean, and that it is
   <emphasis>yours</emphasis>. In fact, we encourage this level of scrutiny. It
   is one reason we use &my-app; ourselves.
@@ -415,7 +417,7 @@ Privoxy. Why should I use Privoxy at all?</title>
 <sect2 renderas="sect3" id="license"><title>Is there is a license or fee? What about a 
 warranty? Registration?</title>
  <para>
-  <application>Privoxy</application> is licensed under the <ulink
+  <application>Privoxy</application> is free software and licensed under the <ulink
   url="http://www.gnu.org/licenses/old-licenses/gpl-2.0.html">GNU General Public License (GPL) version 2</ulink>.
   It is free to use, copy, modify or distribute as you wish under the terms of this
   license.  Please see the <link linkend="copyright">Copyright</link> section for more
@@ -425,8 +427,6 @@ warranty? Registration?</title>
  <para>
   There is <emphasis>no warranty</emphasis> of any kind, expressed, implied or otherwise.
   That is something that would cost real money ;-) There is no registration either.
-  <application>Privoxy</application> really is <emphasis>free</emphasis>
-  in every respect!
  </para>
 
 </sect2>
@@ -434,14 +434,17 @@ warranty? Registration?</title>
 <sect2 renderas="sect3" id="spyware">
 <title>Can Privoxy remove spyware? Adware? Viruses?</title>
 <para>
- No, at least not reliable enough to trust it. &my-app; is not designed to be
+ No, at least not reliably enough to trust it. &my-app; is not designed to be
  a malware removal tool and the default configuration doesn't even try to
  filter out any malware.
 </para>
 <para>
  &my-app; could help prevent contact from (known) sites that use such
  tactics with appropriate configuration rules, and thus could conceivably
- prevent contamination from such sites.
+ prevent contamination from such sites. However, keeping such a configuration
+ up to date would require a lot of time and effort that would be better spend
+ on keeping your software itself up to date so it doesn't have known
+ vulnerabilities.
 </para>
 </sect2>
 
@@ -454,9 +457,12 @@ warranty? Registration?</title>
 <para>
  But it is probably not necessary to use &my-app; in conjunction with other
  ad-blocking products, and this could conceivably cause undesirable results.
- It would be better to choose one software or the other and work a little to
+ It might be better to choose one software or the other and work a little to
  tweak its configuration to your liking.
 </para>
+<para>
+ Note that this is an advice specific to ad blocking.
+</para>
 </sect2>
 
 <sect2 renderas="sect3" id="jointeam"><title>I would like to help you, what can I do?</title>
@@ -480,6 +486,11 @@ warranty? Registration?</title>
    url="../developer-manual/index.html">Developer's Manual</ulink>, at least
    the pertinent sections.
 </para>
+ <para>
+  You can also start helping out without SourceForge.net account,
+  simply by showing up on the mailing list, helping out other users,
+  providing general feedback or reporting problems you noticed.
+ </para>
 </sect3>
 
 <sect3 renderas="sect4" id="jointeam-money"><title>Contribute!</title>
@@ -488,7 +499,8 @@ warranty? Registration?</title>
  buying software to test <application>Privoxy</application> with, and, of course,
  for regular world-wide get-togethers (hahaha). If you enjoy the software and feel
  like helping us with a donation, just <ulink
- url="mailto: ijbswa-developers@lists.sourceforge.net">drop us a note</ulink>.
+ url="mailto: ijbswa-developers@lists.sourceforge.net">drop us a note</ulink>
+ and get your name on the list of contributors.
 </para>
 </sect3>
 
@@ -518,7 +530,8 @@ warranty? Registration?</title>
  Any browser that can be configured to use a proxy, which 
  should be virtually all browsers, including
  <application>Firefox</application>, <application>Internet
- Explorer</application>, and <application>Opera</application> among others.
+ Explorer</application>, <application>Opera</application>, and 
+ <application>Safari</application> among others.
  Direct browser support is not an absolute requirement since
  <application>Privoxy</application> runs as a separate application and talks
  to the browser in the standardized HTTP protocol, just like a web server
@@ -553,6 +566,7 @@ Include supported.sgml here:
 </para>
 </sect2>
 
+<!-- Nobody is going to still be doing this!
 <sect2 renderas="sect3" id="newinstall"><title>Can I install  
  Privoxy over Junkbuster?</title>
  <para>
@@ -571,25 +585,28 @@ Include supported.sgml here:
  </para>
 
 </sect2>
+-->
 
 <sect2 renderas="sect3" id="firststep">
 <title>I just installed Privoxy. Is there anything 
 special I have to do now?</title>
 
 <para>
- All browsers must be told to use <application>Privoxy</application> 
+ All browsers should 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 
+ in the appropriate configuration area for the browser. It's possible
+ to combine &my-app; with a packet filter to intercept HTTP requests
+ even if the client isn't explicitly configured to use &my-app;,
+ but where possible, configuring the client is recommended. See 
  <ulink url="../user-manual/startup.html">the User Manual for more
- details</ulink>. You should also flush your browser's memory and disk cache to get rid of any
- cached junk items, and remove any stored 
+ details</ulink>. You should also flush your browser's memory and disk
+ cache to get rid of any cached junk items, and remove any stored 
  <ulink url="http://en.wikipedia.org/wiki/Browser_cookie">cookies</ulink>.
 
 </para>
 
 </sect2>
 
-
 <sect2 renderas="sect3" id="localhost"><title>What is the proxy address of Privoxy?</title>
  <para>
   If you set up the <application>Privoxy</application> to run on
@@ -597,9 +614,10 @@ special I have to do now?</title>
   networked computer on a LAN), the proxy will be on <literal>127.0.0.1</literal> 
   (sometimes referred to as <quote>localhost</quote>,
   which is the special name used by every computer on the Internet to refer
-  to itself) and the port will be 8118 (unless you have <application>Privoxy</application>
-  to run on a different port with the <ulink
-  url="../user-manual/config.html#LISTEN-ADDRESS">listen-address</ulink> config option). 
+  to itself) and the port will be 8118 (unless you used the <ulink
+  url="../user-manual/config.html#LISTEN-ADDRESS">listen-address</ulink>
+  config option to tell <application>Privoxy</application> to run on
+  a different port).
  </para>
  <para>
   When configuring your browser's proxy settings you typically enter
@@ -620,8 +638,7 @@ special I have to do now?</title>
  </para>
  <para>
   <application>Privoxy</application> does not currently handle
-  any other protocols such as FTP, SMTP, IM, IRC, ICQ, etc. Be sure that
-  proxying any of these other protocols is not activated.
+  any other protocols such as FTP, SMTP, IM, IRC, ICQ, etc.
  </para>
 </sect2>
 
@@ -684,11 +701,11 @@ Privoxy is running and being used.</title>
  <guibutton>Advanced</guibutton> --> <guibutton>Cache</guibutton> and
  then click both <quote><guibutton>Clear Memory Cache</guibutton></quote>
  and <quote><guibutton>Clear Disk Cache</guibutton></quote>.
- And, <application>Firefox</application> users would click 
+ In some <application>Firefox</application> versions it's
  <guibutton>Tools</guibutton> --> <guibutton>Options</guibutton> -->
  <guibutton>Privacy</guibutton> --> <guibutton>Cache</guibutton> and
  then click <quote><guibutton>Clear Cache Now</guibutton></quote>.
-
+ <!-- In my Firefox versions it's the Netscape way. fk 2007-11-19-->
 </para>
 </sect2>
 
@@ -754,7 +771,10 @@ way to do this?</title>
  at <ulink url="http://config.privoxy.org/">http://config.privoxy.org/</ulink>
  (Shortcut: <ulink url="http://p.p/">http://p.p/</ulink>) and then select
  <quote><ulink url="http://config.privoxy.org/show-status">View &
- change the current configuration</ulink></quote> from the menu.
+ change the current configuration</ulink></quote> from the menu. Note 
+ that this feature must be explicitly enabled in the main config file 
+ (see <ulink
+ url="../user-manual/config.html#ENABLE-EDIT-ACTIONS">enable-edit-actions</ulink>).
 </para>
 </sect2>
 
@@ -808,22 +828,9 @@ the differences?</title>
   The syntax and purpose of configuration files has remained roughly the
   same throughout the 3.x series, but backwards compatibility is not guaranteed.
   Also each release contains updated, <quote>improved</quote> versions and it is
-  therefore recommended to use the newer configuration files.
- <![%p-newstuff;[ 
-   If upgrading from version prior to 3.0.4 the syntax for <literal>fast-redirects</literal>
-   has changed. See the <ulink url="../user-manual/whatsnew.html">What's New section</ulink> 
-   of the <citetitle>User Manual</citetitle> for details.]]>
- </para>
- <para>
-   But all configuration files have substantially
-   changed from the <application>Junkbuster</application> days, and early
-   versions of <application>Privoxy 2.x</application>. The old files, like
-   <filename>blocklist</filename> will not work at all. 
+  therefore strongly recommended to install the newer configuration files
+  and merge back your modifications.
  </para>
- <![%p-newstuff;[ <para>
-  Refer to the <ulink url="../user-manual/whatsnew.html">What's New</ulink> 
- page for information on configuration changes that may occur from one release to another.
- </para>]]>
 </sect2>
 
 <sect2 renderas="sect3" id="difficult">
@@ -927,21 +934,20 @@ with a browser? Does that not raise security issues?</title>
   When you use the browser-based editor, <application>Privoxy</application>
   itself is writing to the config files.  Because
   <application>Privoxy</application> is running as the user <quote>privoxy</quote>,
-  it can update the config files.
+  it can update its own config files.
  </para>
  <para>
   If you run <application>Privoxy</application> for multiple untrusted users (e.g. in
-  a LAN), you will probably want to turn the web-based editor and remote toggle
-  features off by setting <quote><literal><ulink
+  a LAN) or aren't entirely in control of your own browser, you will probably want
+  to make sure that the the web-based editor and remote toggle features are
+  <quote>off</quote> by setting <quote><literal><ulink
   url="../user-manual/config.html#ENABLE-EDIT-ACTIONS">enable-edit-actions</ulink>
   0</literal></quote> and <quote><literal><ulink
   url="../user-manual/config.html#ENABLE-REMOTE-TOGGLE">enable-remote-toggle</ulink>
   0</literal></quote> in the <ulink url="../user-manual/config.html">main configuration file</ulink>.
  </para>
  <para>
-  Note that in the default configuration, only local users (i.e. those on
-  <quote>localhost</quote>) can connect to <application>Privoxy</application>,
-  so this is (normally) not a security problem.
+  As of &my-app; 3.0.7 these options are disabled by default.
  </para>
 </sect2>
 
@@ -950,17 +956,28 @@ with a browser? Does that not raise security issues?</title>
 <title id="filterfile">What is the <filename>default.filter</filename> file? What is a <quote>filter</quote>?</title>
 <para>
  The <ulink url="../user-manual/filter-file.html"><filename>default.filter</filename></ulink>
- file is where <emphasis>filters</emphasis> as supplied by the developers are defined. 
+ file is where <emphasis>filters</emphasis> as supplied by the developers are defined.
  Filters are a special subset of actions that can be used to modify or
- remove, web page content on the fly. Filters apply to <emphasis>anything</emphasis>
- in the page source (and optionally both client and server headers), including
- HTML tags, and JavaScript. Regular expressions are used to accomplish this.
+ remove web page content or headers on the fly. Content filters can
+ be applied to <emphasis>anything</emphasis> in the page source,
+ header filters can be applied to either server or client headers.
+ Regular expressions are used to accomplish this.
+</para>
+<para>
  There are a number of pre-defined filters to deal with common annoyances. The
  filters are only defined here, to invoke them, you need to use the
  <ulink
  url="../user-manual/actions-file.html#FILTER"><literal>filter</literal>
- action</ulink> in one of the actions files. Filtering is automatically
- disabled for inappropriate MIME types.
+ action</ulink> in one of the actions files. Content filtering is automatically
+ disabled for inappropriate MIME types, but if you now better than Privoxy
+ what should or should not be filtered you can filter any content you like.
+</para>
+<para>
+ Filters should
+ <emphasis>not</emphasis> be confused with <ulink
+ url="../user-manual/actions-file.html#BLOCK"><literal>blocks</literal></ulink>, which
+ is a completely different action, and is more typically used to block ads and
+ unwanted sites.
 </para>
 
 <para>
@@ -981,6 +998,15 @@ with a browser? Does that not raise security issues?</title>
  but you can disable/enable the various pre-defined filters of the included 
  <filename>default.filter</filename> file with the <ulink
  url="http://config.privoxy.org/show-status">web-based actions file editor</ulink>.
+ Note  that the custom actions editor must be explicitly enabled in
+ the main config file (see <ulink
+ url="../user-manual/config.html#ENABLE-EDIT-ACTIONS">enable-edit-actions</ulink>).
+</para>
+
+<para>
+ If you intend to develop your own filters, you might want to have a look at
+ <ulink
+ url="http://www.fabiankeil.de/sourcecode/pft/">Privoxy-Filter-Test</ulink>.
 </para>
 
 </sect2>
@@ -1084,7 +1110,7 @@ with a browser? Does that not raise security issues?</title>
 </sect2>
 
 <sect2 renderas="sect3">
-<title id="blockedbytext">I see some images being replaced by a text
+<title id="blockedbytext">I see some images being replaced with text
 instead of the checkerboard image. Why and how do I get rid of this?</title>
 <para>
  This happens when the banners are not embedded in the HTML code of the
@@ -1162,7 +1188,7 @@ and thus avoid individual browser configuration?</title>
  The whole idea of Privoxy is to modify client requests
  and server responses in all sorts of ways and therefore
  it's not a transparent proxy as described in
- <ulink link="http://tools.ietf.org/html/rfc2616">RFC 2616</ulink>.
+ <ulink url="http://tools.ietf.org/html/rfc2616">RFC 2616</ulink>.
 </para>
 <para>
  However, some people say <quote>transparent proxy</quote> when they
@@ -1177,18 +1203,20 @@ and thus avoid individual browser configuration?</title>
 <para>
  <application>Privoxy</application> can't intercept traffic itself,
   but it can handle requests that where intercepted and redirected
-  with a packet filter (like PF or iptables), as long as the Host
-  header is present.
-</para>
+  with a packet filter (like <application>PF</application> or
+  <application>iptables</application>), as long as the <literal>Host</literal>
+  header is present. 
+  </para>
 <para>
-  As the Host header is required by HTTP/1.1 and as most web sites
-  don't work if it isn't set, this limitation shouldn't be a problem.
+  As the <literal>Host</literal> header is required by HTTP/1.1 and as most
+  web sites rely on it anyway, this limitation shouldn't be a problem.
 </para>
 <para>
   Please refer to your packet filter's documentation to learn how to
-  intercept and redirect traffic into Privoxy. Afterward you just have
-  to configure Privoxy to
-  <ulink url="../user-manual/config.html#ACCEPT-INTERCEPTED-REQUESTS">accept intercepted requests</ulink>.
+  intercept and redirect traffic into <application>Privoxy</application>.
+  Afterward you just have to configure <application>Privoxy</application> to
+  <ulink url="../user-manual/config.html#ACCEPT-INTERCEPTED-REQUESTS">accept
+  intercepted requests</ulink>.
 </para>
 
 </sect2>
@@ -1260,7 +1288,7 @@ and thus avoid individual browser configuration?</title>
  advantage of this layer of trust, and using the data they glean from you  and 
  your browsing habits for their own purposes, and maybe to your potential
  detriment. Such sites are using you and storing their data on your system.
- That is why the security conscious watch from whom those cookies come, and why
+ That is why the privacy conscious watch from whom those cookies come, and why
  they really <emphasis>need</emphasis> to be there.
 </para>
 <para>
@@ -1277,7 +1305,7 @@ and thus avoid individual browser configuration?</title>
   There are several actions that relate to cookies. The default behavior is to 
   allow only <quote>session cookies</quote>, which means the cookies only last
   for the current browser session. This eliminates most kinds of abuse related 
-  to cookies. But there may be cases where we want cookies to last.
+  to cookies. But there may be cases where you want cookies to last.
 </para>
 <para>
   To disable all cookie actions, so that cookies are allowed unrestricted,
@@ -1289,7 +1317,7 @@ and thus avoid individual browser configuration?</title>
   .example.com</screen>
 </para>
 <para>
- Place the above in <filename>user.action</filename>. Note some of these may
+ Place the above in <filename>user.action</filename>. Note that some of these may
  be off by default anyway, so this might be redundant, but there is no harm
  being explicit in what you want to happen. <filename>user.action</filename>
  includes an alias for this situation, called
@@ -1341,18 +1369,18 @@ and thus avoid individual browser configuration?</title>
  then subsequently allowing three specific exceptions.
 </para>
 <para>
- A more interesting approach is <application>Privoxy's</application> 
+ Another approach is <application>Privoxy's</application> 
  <literal>trustfile</literal> concept, which incorporates the notion of 
  <quote>trusted referrers</quote>. See the <ulink
- url="../user-manual/config.html#TRUSTFILE">User Manual Trust</ulink>
documentation.
+ url="../user-manual/config.html#TRUSTFILE">Trust documentation</ulink>
for details.
 </para>
 <para>
  These are fairly simple approaches and are not completely foolproof. There
  are various other configuration options that should be disabled (described
  elsewhere here and in <ulink url="../user-manual/">the User Manual</ulink>)
  so that users can't modify their own configuration and easily circumvent the
- whitelist.  
+ whitelist.
 </para>
 </sect2>
 
@@ -1413,10 +1441,14 @@ and thus avoid individual browser configuration?</title>
  &my-app; for various purposes and can easily be modified using any text
  editor. All the template pages are installed in a sub-directory appropriately
  named: <filename>templates</filename>.  Knowing something about HTML syntax
- will of course be helpful. You cannot rename any of these files, or create
- completely new templates, that is not possible. But you can change the page
- content to whatever you like. Be forewarned that these files are subject to
- being overwritten during upgrades, so be sure to save any customizations.
+ will of course be helpful.
+</para>
+<para>
+ Be forewarned that the default templates are subject to being overwritten
+ during upgrades. You can, however, create completely new templates,
+ place them in another directory and specify the alternate path in the main
+ <filename>config</filename>. For details, have a look at the <ulink
+ url="../user-manual/config.html#templdir">templdir</ulink> option. 
 </para>
 </sect2>
 
@@ -1424,12 +1456,12 @@ and thus avoid individual browser configuration?</title>
 <title>How can I remove the <quote>Go There Anyway</quote> link from 
 the <emphasis>BLOCKED</emphasis> page?</title>
 <para>
- There is more than one way to do it.
+ There is more than one way to do it (although Perl is not involved).
 </para>
 <para>
  Editing the BLOCKED template page (see above) may dissuade some users, but
  this method is easily circumvented. Where you need this level of control, you
should build &my-app; from source, and enable various features that are
might want to build &my-app; from source, and disable various features that are
  available as compile-time options. You should 
  <command>configure</command> the sources as follows:
 </para>
@@ -1443,7 +1475,7 @@ the <emphasis>BLOCKED</emphasis> page?</title>
  current configuration via any connected user's web browser.
 </para>
 <para>
Note that all of these features can also be toggled on/off via options in
Finally, all of these features can also be toggled on/off via options in
  <application>Privoxy's</application> main  <ulink
  url="../user-manual/config.html#ACCESS-CONTROL">config</ulink> file which
  means you don't have to recompile anything.
@@ -1473,8 +1505,8 @@ has to add extra time to browsing.</title>
  retrieved and displayed. The actual processing time required by
  <application>Privoxy</application> itself for each page, is relatively small
  in the overall scheme of things, and happens very quickly. This is typically
- more than offset by time saved not downloading and rendering ad images (if ad
- blocking is being used).
+ more than offset by time saved not downloading and rendering ad images and
other junk content (if ad blocking is being used).
 </para>
 
 <para>
@@ -1483,24 +1515,24 @@ has to add extra time to browsing.</title>
  <literal><ulink
  url="../user-manual/actions-file.html#DEANIMATE-GIFS">deanimate-gifs</ulink></literal>
  actions may cause a perceived slowdown, since the entire document
- needs to be buffered before displaying. And on very large documents, filtering may have 
- some measurable impact. How much depends on the page size, the actual
- definition of the filter(s), etc. See below. Most other actions have little
- to no impact on speed.
+ needs to be buffered before displaying. And on very large documents,
+ filtering may have some measurable impact. How much depends on the page size,
+ the actual definition of the filter(s), etc. See below. Most other actions
have little to no impact on speed.
 </para>
-<para> 
+<para>
  Also, when filtering is enabled but zlib support isn't available, compression
  is often disabled (see <ulink
  url="../user-manual/actions-file.html#PREVENT-COMPRESSION">prevent-compression</ulink>).
- This can have an impact on speed as well. Again, the page size, etc. will 
- determine how much of an impact.
+ This can have an impact on speed as well, although it's probably smaller than
you might think. Again, the page size, etc. will determine how much of an impact.
 </para>
 
 </sect2>
 
 
 <sect2 renderas="sect3" id="loadingtimes"><title>I notice considerable
-delays in page requests compared to the old Junkbuster. What's wrong?</title>
+delays in page requests. What's wrong?</title>
 <para>
  If you use any <literal><ulink
  url="../user-manual/actions-file.html#FILTER">filter</ulink></literal> action,
@@ -1526,7 +1558,6 @@ delays in page requests compared to the old Junkbuster. What's wrong?</title>
  to differentiate filterable content because of the MIME type as reported by
  the server, or because of some configuration setting that enables/disables
  filtering.
-
 </para>
 </sect2>
 
@@ -1551,19 +1582,7 @@ delays in page requests compared to the old Junkbuster. What's wrong?</title>
  hence it could not be intercepted, and you have accessed the <emphasis>real</emphasis>
  web site at config.privoxy.org.
 </para>
-<para>
- With recent versions of <application>Privoxy</application> (version 2.9.x and
- later), the user interface features information on the run time status, the
- configuration, and even a built-in editor for the <ulink
- url="../user-manual/actions-file.html">actions files</ulink>.
-</para>
 
-<para>
- Note that the built-in URLs from earlier versions of <application>Junkbuster</application>
- / <application>Privoxy</application>, http://example.com/show-proxy-args and http://i.j.b/,
- are no longer supported. If you still use such an old version, you should really consider
- upgrading to &p-version;.
-</para>
 </sect2>
 
 <!--
@@ -1629,40 +1648,30 @@ us help you. Your efforts are not wasted, and we do appreciate them.
 </para>
 <para>
  However, these proxies are called "anonymous" because you don't need
a password, not because they would offer any real anonymity.
to authenticate, not because they would offer any real anonymity.
  Most of them will log your IP address and make it available to the
  authorities in case you violate the law of the country they run in. 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>
 <para>
- Your best bet is to chain <application>Privoxy</application>
- with <ulink url="http://tor.eff.org/">Tor</ulink>,
an  <ulink url="http://www.eff.org/">EFF</ulink> supported onion routing system.
+ If you want to hide your IP address from most adversaries,
+ you should consider chaining <application>Privoxy</application>
with <ulink url="http://tor.eff.org/">Tor</ulink>.
  The configuration details can be found in
  <ulink url="#TOR">How do I use <application>Privoxy</application> together
  with <application>Tor</application> section</ulink>
  just below.
 </para>
-<!-- 
-<para>
- There is, however, even in the single-machine case the possibility to make the
- server believe that your machine is in fact a shared proxy serving a large
- LAN, and we are looking into that.
-</para>
- I assume this is about sending fake forward IP addresses?
- David and I looked into it and considered it a waste of time to implement.
- Fabian 2006-09-04 
--->
 </sect2>
 
 <sect2 renderas="sect3">
 <title id="anonforsure">Can Privoxy guarantee I am anonymous?</title>
 <para>
- No. Your chances of remaining anonymous are greatly improved, but unless you
+ No. Your chances of remaining anonymous are improved, but unless you
  <ulink url="#TOR">chain <application>Privoxy</application> with <application>Tor</application></ulink>
- or a similar system and know what you're doing when it comes to configuring
- the rest of your system, it would be safest to assume that everything you do
+ or a similar proxy and know what you're doing when it comes to configuring
+ the rest of your system, you should assume that everything you do
  on the Web can be traced back to you.
 </para>
 <para>
@@ -1675,7 +1684,7 @@ us help you. Your efforts are not wasted, and we do appreciate them.
  configuration and chained it with <application>Tor</application>.
 </para>
 <para>
- Most of <application>Privoxy's</application> protection can be easily subverted
+ Most of <application>Privoxy's</application> privacy-enhancing features can be easily subverted
  by an insecure browser configuration, therefore you should use a browser that can
  be configured to only execute code from trusted sites, and be careful which sites you trust.
  For example there is no point in having <application>Privoxy</application>
@@ -1711,15 +1720,15 @@ us help you. Your efforts are not wasted, and we do appreciate them.
 <sect2 renderas="sect3" id="tor"><title>How do I use Privoxy
  together with Tor?</title>
 <para>
- Before you configure <application>Privoxy</application> to use <application>Tor</application>
(<ulink url="http://tor.eff.org/">http://tor.eff.org/</ulink>),
+ Before you configure <application>Privoxy</application> to use
<ulink url="https://www.torproject.org/">Tor</ulink>,
  please follow the <citetitle>User Manual</citetitle> chapters
  <ulink url="../user-manual/installation.html">2. Installation</ulink> and
  <ulink url="../user-manual/startup.html">5. Startup</ulink> to make sure
  <application>Privoxy</application> itself is setup correctly.
 </para>
 <para> 
- If it is, refer to <ulink url="http://tor.eff.org/documentation.html.en">Tor's
+ If it is, refer to <ulink url="https://www.torproject.org/documentation.html">Tor's
  extensive documentation</ulink> to learn how to install <application>Tor</application>,
  and make sure <application>Tor</application>'s logfile says that
  <quote>Tor has successfully opened a circuit</quote> and it
@@ -1738,8 +1747,7 @@ us help you. Your efforts are not wasted, and we do appreciate them.
  are working, it is time to connect them. As far as <application>Privoxy</application>
  is concerned, <application>Tor</application> is just another proxy that can be reached
  by socks4 or socks4a. Most likely you are interested in <application>Tor</application>
- to increase your anonymity level, therefore you should use socks4a,
- to make sure DNS requests are
+ to increase your anonymity level, therefore you should use socks4a, to make sure DNS requests are
  done through <application>Tor</application> and thus invisible to your local network.
 </para>
 
@@ -1759,7 +1767,7 @@ us help you. Your efforts are not wasted, and we do appreciate them.
  </screen>
 </para>
 <para>
- This is enough to reach the Internet, but additionally you should
+ This is enough to reach the Internet, but additionally you might want to
  uncomment the following forward rules, to make sure your local network is still
  reachable through Privoxy:
 </para>
@@ -1773,10 +1781,15 @@ us help you. Your efforts are not wasted, and we do appreciate them.
 <para>
  Unencrypted connections to systems in these address ranges will
  be as (un)secure as the local network is, but the alternative is
- that you can't reach the network at all.
- If you also want to be able to reach servers in your local
- network by using their names, you will need additional
- exceptions that look like this:
+ that your browser can't reach the network at all. Then again,
+ that may actually be desired and if you don't know for sure
+ that your browser has to be able to reach the local network,
+ there's no reason to allow it.
+</para>
+<para>
+ If you want your browser to be able to reach servers in your local
+ network by using their names, you will need additional exceptions
+ that look like this:
 </para>
 <para>
  <screen>
@@ -1789,14 +1802,15 @@ us help you. Your efforts are not wasted, and we do appreciate them.
  in your browser, confirm that <application>Privoxy</application> has reloaded its configuration
  and that there are no other forward lines, unless you know that you need them. If everything looks good,
  refer to
- <ulink url="http://wiki.noreply.org/noreply/TheOnionRouter/TorFAQ#head-0e1cc2ac330ede8c6ad1ac0d0db0ac163b0e6143">Tor
+ <ulink url="https://wiki.torproject.org/wiki/TheOnionRouter/TorFAQ#head-0e1cc2ac330ede8c6ad1ac0d0db0ac163b0e6143">Tor
  Faq 4.2</ulink> to learn how to verify that you are really using <application>Tor</application>.
 </para>
 <para>
  Afterward, please take the time to at least skim through the rest
  of <application>Tor's</application> documentation. Make sure you understand
  what <application>Tor</application> does, why it is no replacement for
- application level security, and why you shouldn't use it for unencrypted logins.
+ application level security, and why you probably don't want to
+ use it for unencrypted logins.
 </para> ]]>
 </sect2>
 
@@ -1818,7 +1832,7 @@ content is being altered?</title>
 </para>
 
 <para>
- Also, different browsers use different encodings of Russian and Czech
+ Also, different browsers use different encodings of non-English
  characters, certain web servers convert pages on-the-fly according to the
  User Agent header. Giving a <quote>User Agent</quote> with the wrong
  operating system or browser manufacturer causes some sites in these languages
@@ -1828,7 +1842,7 @@ content is being altered?</title>
  weather maps of Intellicast have been blocked by their server when no
  <quote>Referer</quote> or cookie is provided, is another example. (But you
  can forge both headers without giving information away). There are
- many other ways things that can go wrong when trying to fool a web server. The
+ many other ways things can go wrong when trying to fool a web server. The
  results of which could inadvertently cause pages to load incorrectly,
  partially, or even not at all. And there may be no obvious clues as to just
  what went wrong, or why. Nowhere will there be a message that says 
@@ -1868,9 +1882,9 @@ speed up web browsing?</title>
 <sect2 renderas="sect3">
 <title id="firewall">What about as a firewall? Can Privoxy protect me?</title>
 <para>
- Not in the way you mean, or in the way a true firewall can. 
- <application>Privoxy</application> can help protect your privacy, but not
- protect you from intrusion attempts. It is, of course, perfectly possible
+ Not in the way you mean, or in the way some firewall vendors claim they can. 
+ <application>Privoxy</application> can help protect your privacy, but can't
+ protect your system from intrusion attempts. It is, of course, perfectly possible
  to use <emphasis>both</emphasis>.
 </para>
 </sect2>
@@ -1940,14 +1954,14 @@ ads used to be. Why?</title>
 <title id="secure">Privoxy 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 affect
- <application>Privoxy</application>. On Unix-like systems, 
- <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> only. The server aspect of
- <application>Privoxy</application> is not itself directly exposed to the
- Internet in this configuration. If you want to have
+ On Unix-like systems, <application>Privoxy</application> can run as a non-privileged 
+ user, which is how we recommend it be run. Also, by default
+ <application>Privoxy</application> listens to requests from <quote>localhost</quote>
+ only.
+</para>
+<para>
+ 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 
@@ -1962,14 +1976,21 @@ secure is it? Do I need to take any special precautions?</title>
 </sect2>
 
 <sect2 renderas="sect3" id="turnoff">
-<title>How can I temporarily disable Privoxy?</title>
+<title>Can I temporarily disable Privoxy?</title>
+<para>
+ &my-app; doesn't have a transparent proxy mode,
+ but you can toggle off blocking and content filtering.
+</para>
 <para>
- The easiest way is to access <application>Privoxy</application> with your 
browser by using the remote toggle URL: <ulink
+ The easiest way to do that is to point your browser
to the remote toggle URL: <ulink
  url="http://config.privoxy.org/toggle">http://config.privoxy.org/toggle</ulink>.
+</para>
+<para>
  See the <ulink url="../user-manual/appendix.html#BOOKMARKLETS">Bookmarklets section</ulink> 
  of the <citetitle>User Manual</citetitle> for an easy way to access this 
- feature.
+ feature. Note that this is a feature that may need to be enabled in the main 
+ <filename>config</filename> file.
 </para>
 </sect2>
 
@@ -1978,9 +1999,9 @@ secure is it? Do I need to take any special precautions?</title>
 <title>When <quote>disabled</quote> is Privoxy totally 
 out of the picture?</title>
 <para>
- No, this just means all filtering and actions are disabled.
- <application>Privoxy</application> is still acting as a proxy, but just not 
- doing any of the things that <application>Privoxy</application> would
+ No, this just means all optional filtering and actions are disabled.
+ <application>Privoxy</application> is still acting as a proxy, but just 
+ doing less of the things that <application>Privoxy</application> would
  normally be expected to do. It is still a <quote>middle-man</quote> in 
  the interaction between your browser and web sites. See below to bypass 
  the proxy.
@@ -2011,6 +2032,10 @@ ads, but also its own internal CGI pages. What is a <quote>crunch</quote>?</titl
  configuration is returned to the browser, and the log consequently will show
  a <quote>crunch</quote>.
 </para>
+<para>
+ Since version 3.0.7, Privoxy will also log the crunch reason.
+ If you are using an older version you might want to upgrade.
+</para>
 </sect2>
 
 <sect2 renderas="sect3" id="downloads">
@@ -2036,7 +2061,7 @@ from a webserver? FTP server?</title>
 </para>
 <para>
  <application>Privoxy</application> knows the differences in files according
- to the <quote>Document Type</quote> as reported by the webserver. If this is
+ to the <quote>Content Type</quote> as reported by the webserver. If this is
  reported accurately (e.g. <quote>application/zip</quote> for a zip archive),
  then <application>Privoxy</application> knows to ignore these where
  appropriate. <application>Privoxy</application> potentially can filter HTML
@@ -2053,11 +2078,11 @@ from a webserver? FTP server?</title>
  did filter this document type.
 </para>
 <para>
- In short, filtering is <quote>ON</quote> if a) the Document Type as reported
+ In short, filtering is <quote>ON</quote> if a) the content type as reported
  by the webserver is appropriate <emphasis>and</emphasis> b) the configuration
  allows it (or at least does not disallow it). That's it. There is no magic
  cookie anywhere to say this is <quote>good</quote> and this is
- <quote>bad</quote>. It's the configuration that let's it all happen or not.
+ <quote>bad</quote>. It's the configuration that lets it all happen or not.
 </para>
 <para>
  If you download text files, you probably do not want these to be filtered,
@@ -2096,8 +2121,8 @@ altered it! Yikes, what is wrong!</title>
  <application>Privoxy</application>. <application>Privoxy</application>
  does essentially the same thing, much more elegantly and with much more 
  flexibility. A large <filename>HOSTS</filename> file, in fact, not only
- duplicates effort, but may get in the way. It is recommended to remove 
- such entries from your <filename>HOSTS</filename> file. If you think 
+ duplicates effort, but may get in the way and seriously slow down your system.
It is recommended to remove such entries from your <filename>HOSTS</filename> file. If you think 
  your hosts list is neglected by <application>Privoxy's </application> 
  configuration, consider adding your list to your <filename>user.action</filename> file:
 </para>
@@ -2138,7 +2163,7 @@ and related issues?</title>
  is clearly labeled <quote>Text replacements for subversive browsing
  fun!</quote> or you are using an older Privoxy version and have implicitly
  activated it by choosing the  <quote>Adventuresome</quote> profile in the
- web-based editor. Please upgrade!
+ web-based editor. Please upgrade.
 </para>
 </sect2>
 
@@ -2173,7 +2198,7 @@ and related issues?</title>
 <listitem><para>
 <application>Privoxy</application> is not running. Solution: verify 
  that &my-app; is installed correctly, has not crashed, and is indeed running.
Look at <application>Privoxy's</application> logs to see what they say.
Turn on <application>Privoxy's</application> logging, and look at the logs to see what they say.
 </para></listitem>
  <listitem><para>Or your browser is configured for a different port than what
  <application>Privoxy</application> is using. Solution: verify that &my-app;
@@ -2224,7 +2249,8 @@ still getting through. How?</title>
  entirely different from the site URL itself. Most ads are hosted on different
  servers than the main site itself. If you right-click on the ad, you should
  be able to get all the relevant information you need. Alternately, you can 
- find the correct URL by looking at <application>Privoxy's</application> logs.
+ find the correct URL by looking at <application>Privoxy's</application> logs
+ (you may need to enable logging in the main config file if its disabled).
 </para>
 <para>
  Below is a slightly modified real-life log snippet that originates with one 
@@ -2250,31 +2276,31 @@ Request: img.example.com/sr.js
 Request: example.betamarker.com/example.html
 Request: www.lik-sang.com/Banners/bestsellers/skyscraper.php?likref=BSellers
 Request: img.example.com/pb.png
-Request: www.google-analytics.com/urchin.js crunch!
-Request: www.advertising-department.com/ats/switch.ps.php?26856 crunch!
+Request: www.google-analytics.com/urchin.js crunch! (Blocked)
+Request: www.advertising-department.com/ats/switch.ps.php?26856 crunch! (Blocked)
 Request: img.example.com/p.gif
-Request: www.popuptraffic.com/assign.php?l=example&mode=behind crunch!
-Request: www.popuptraffic.com/scripts/popup.php?hid=5c3cf&tmpl=PBa.tmpl crunch!
-Request: www.popuptraffic.com/assign.php?l=example crunch!
+Request: www.popuptraffic.com/assign.php?l=example&mode=behind crunch! (Blocked)
+Request: www.popuptraffic.com/scripts/popup.php?hid=5c3cf&tmpl=PBa.tmpl crunch! (Blocked)
+Request: www.popuptraffic.com/assign.php?l=example crunch! (Blocked)
 Request: www.lik-sang.com/Banners/best_sellers/best_sellers.css
-Request: www.adtrak.net/adx.js crunch!
+Request: www.adtrak.net/adx.js crunch! (Blocked)
 Request: img.example.com/hbg.gif
 Request: img.example.com/example.jpg
 Request: img.example.com/mt.png
 Request: img.example.com/mm.png
 Request: img.example.com/mb.png
-Request: www.popuptraffic.com/scripts/popup.php?hid=a71b91fa5&tmpl=Ua.tmp crunch!
+Request: www.popuptraffic.com/scripts/popup.php?hid=a71b91fa5&tmpl=Ua.tmp crunch! (Blocked)
 Request: www.example.com/tracker.js
 Request: www.lik-sang.com/Banners/best_sellers/lsi_head.gif
-Request: www.adtrak.net/adjs.php?n=020548130&what=zone:61 crunch!
-Request: www.adtrak.net/adjs.php?n=463594413&what=zone:58&source=Ua crunch!
+Request: www.adtrak.net/adjs.php?n=020548130&what=zone:61 crunch! (Blocked)
+Request: www.adtrak.net/adjs.php?n=463594413&what=zone:58&source=Ua crunch! (Blocked)
 Request: www.lik-sang.com/Banners/best_sellers/bottomani.swf
-Request: mmm.elitemediagroup.net/install.php?allowpop=no&popupmincook=0&allowsp2=1 crunch!
+Request: mmm.elitemediagroup.net/install.php?allowpop=no&popupmincook=0&allowsp2=1 crunch! (Blocked)
 Request: www.example.com/tracker.js?screen=1400x1050&win=962x693
-Request: www.adtrak.net/adlog.php?bannerid=1309&clientid=439&zoneid=61 crunch!
+Request: www.adtrak.net/adlog.php?bannerid=1309&clientid=439&zoneid=61 crunch! (Blocked)
 Request: 66.70.21.80/scripts/click.php?hid=5c3cf599a9efd0320d26&si
 Request: 66.70.21.80/img/pixel.gif
-Request: www.adtrak.net/adlog.php?bannerid=1309&clientid=439&zoneid=58&source=Ua&block=86400 crunch!
+Request: www.adtrak.net/adlog.php?bannerid=1309&clientid=439&zoneid=58&source=Ua&block=86400 crunch! (Blocked)
 Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&si=Ua
 ]]>
 </screen>
@@ -2293,7 +2319,9 @@ What can I do?</title>
 <para>
  First verify that it is indeed a <application>Privoxy</application> problem, 
  by toggling off <application>Privoxy</application> through <ulink
- url="http://config.privoxy.org/toggle">http://config.privoxy.org/toggle</ulink>,
+ url="http://config.privoxy.org/toggle">http://config.privoxy.org/toggle</ulink>
+ (the toggle feature may need to be enabled in the main
+ <filename>config</filename>),
  and then shift-reloading the problem page (i.e. holding down the shift key
  while clicking reload. Alternatively, flush your browser's disk and memory
  caches).
@@ -2306,7 +2334,8 @@ What can I do?</title>
  and paste the full URL of the page in question into the prompt. See which
  actions are being applied to the URL, and which matches in which actions
  files are responsible for that. It might be helpful also to look at your logs
- for this site too, to see what else might be happening. Many sites are
+ for this site too, to see what else might be happening (note: logging may need
+ to be enabled in the main config file). Many sites are
  complex and require a number of related pages to help present their content.
  Look at what else might be used by the page in question, and what of that
  might be <emphasis>required</emphasis>.
@@ -2433,8 +2462,8 @@ every time I start IE. What gives?</title>
 </sect2>
 
 <!--   ~~~~~       New section      ~~~~~     -->
-<sect2 id="osxie" renderas="sect3">
-<title>In Mac OSX, I can't configure Microsoft Internet Explorer to use 
+<sect2 id="macosxie" renderas="sect3">
+<title>In Mac OS X, I can't configure Microsoft Internet Explorer to use 
  Privoxy as the HTTP proxy.</title>
  <para>
   Microsoft Internet Explorer (in versions like 5.1) respects system-wide
@@ -2448,8 +2477,8 @@ every time I start IE. What gives?</title>
 </sect2>
 
 <!--   ~~~~~       New section      ~~~~~     -->
-<sect2 renderas="sect3" id="osxuninstall">
-<title>In Mac OSX, I dragged the Privoxy folder to the trash in order to 
+<sect2 renderas="sect3" id="macosxuninstall">
+<title>In Mac OS X, I dragged the Privoxy folder to the trash in order to 
  uninstall it.  Now the finder tells me I don't have sufficient privileges to
  empty the trash.</title>
  <para>
@@ -2468,12 +2497,12 @@ every time I start IE. What gives?</title>
 
 
 <!--   ~~~~~       New section      ~~~~~     -->
-<sect2 renderas="sect3" id="osximages">
-<title>In Mac OSX Panther (10.3), images often fail to load and/or I
+<sect2 renderas="sect3" id="macosximages">
+<title>In Mac OS X Panther (10.3), images often fail to load and/or I
  experience random delays in page loading. I'm using
  <literal>localhost</literal> as my browser's proxy setting.</title>
  <para>
-  We believe this is due to an IPv6-related bug in OSX, but don't fully
+  We believe this is due to an IPv6-related bug in Mac OS X, but don't fully
   understand the issue yet. In any case, changing the proxy setting to 
   <literal>127.0.0.1</literal> instead of <literal>localhost</literal>
   works around the problem.
@@ -2570,7 +2599,7 @@ Why?</title>
 </title>
 <para>
  This may also be caused by the <quote>demoronizer</quote> filter, 
- in conjunction with a web server that is misreporting a file type. Binary 
+ in conjunction with a web server that is misreporting the content type. Binary 
  files are exempted from <application>Privoxy's</application> filtering
  (unless the web server by mistake says the file is something else). Either
  upgrade <application>Privoxy</application>, or go to the most recent
@@ -2604,7 +2633,7 @@ Why?</title>
 </para>
 <para>
  On the other hand, if you use non-Microsoft products, and you occasionally 
- notice wierd characters on pages, you might want to try it.
+ notice weird characters on pages, you might want to try it.
 </para>
 </sect2>
 
@@ -2641,9 +2670,11 @@ Why?</title>
  whatever the outcome was. And tries to give a coherent message if there seems
  to be a problem. In some cases, this might otherwise be mitigated by the
  browser itself which might try some work-arounds and alternate approaches (e.g
- adding <quote>www.</quote> to the URL). In other cases, if
- <application>Privoxy</application> is being chained with another proxy, this
- could complicate the issue, and cause undue
+ adding <quote>www.</quote> to the URL).
+</para>
+<para>
+ In other cases, if <application>Privoxy</application> is being chained
+ with another proxy, this could complicate the issue, and cause undue
  delays and timeouts. In the case of a <quote>socks4a</quote> proxy, the socks
  server handles all the DNS.  <application>Privoxy</application> would just be
  the <quote>messenger</quote> which is reporting whatever problem occurred
@@ -2651,7 +2682,7 @@ Why?</title>
 </para>
 <![%p-newstuff;[
 <para>
- In any case, newer versions include various improvements to help
+ In any case, versions newer than 3.0.3 include various improvements to help
  <application>Privoxy</application> better handle these cases.
 </para>]]>
 </sect2>
@@ -2777,6 +2808,58 @@ browsing has slowed to a crawl. What gives? </title>
  51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
 
 $Log: faq.sgml,v $
+Revision 2.38  2008/01/19 17:52:39  hal9
+Re-commit to fix various minor issues for new release.
+
+Revision 2.37  2008/01/19 15:03:05  hal9
+Doc sources tagged for 3.0.8 release.
+
+Revision 2.36  2008/01/17 01:49:51  hal9
+Change copyright notice for docs s/2007/2008/. All these will be rebuilt soon
+enough.
+
+Revision 2.35  2007/11/19 17:57:59  fabiankeil
+A bunch of rewordings, minor updates and fixes.
+
+Revision 2.34  2007/11/19 02:38:11  hal9
+Minor revisions and rebuild
+
+Revision 2.33  2007/11/15 03:30:20  hal9
+Results of spell check.
+
+Revision 2.32  2007/11/13 03:03:42  hal9
+Various changes to reflect new features and revised configuration for the
+upcoming release.
+
+Revision 2.31  2007/11/05 02:34:53  hal9
+Various changes in preparation for the upcoming release. Much yet to be done.
+
+Revision 2.30  2007/11/04 15:16:40  hal9
+Fix one silly typo.
+
+Revision 2.29  2007/11/04 15:12:47  hal9
+Various minor adjustments.
+
+Revision 2.28  2007/10/27 15:14:16  fabiankeil
+Change Tor links to use the new domain torproject.org.
+
+Revision 2.27  2007/10/22 19:47:05  fabiankeil
+- Bump version and copyright.
+- Adjust Tor section to make it clear that forward exceptions
+  aren't required and may not even be desired.
+- A bunch of other minor rewordings.
+- Fix markup problems Roland noticed (hopefully without adding new ones).
+
+Revision 2.26  2007/08/05 15:37:55  fabiankeil
+- Don't claim that thousands of people read our code.
+- Specify the GPL version and link to GPLv2 instead of v3.
+- Note that configuration syntax may change between releases.
+- Mention zlib support.
+- Answer the "transparent proxy" question properly.
+- Add "intercepting proxy" entry.
+- Mention Polipo.
+- Rephrase some other sentences for various reasons.
+
 Revision 2.25  2007/07/18 11:00:34  hal9
 Add misc note about valid mark-up in Privoxy.
 
@@ -2837,7 +2920,7 @@ Revision 1.61.2.41  2004/04/05 13:44:05  oes
 Fixed allow-all-cookies alias name; closes SR #929746
 
 Revision 1.61.2.40  2004/01/30 17:00:33  oes
-Added OSX Panther problem
+Added Mac OS X Panther problem
 
 Revision 1.61.2.39  2004/01/29 22:53:08  hal9
 Minor changes for exempting docs of text/plain. Change copyright date.
@@ -2924,28 +3007,28 @@ Revision 1.61.2.15  2002/08/10 11:34:22  oes
 Add disclaimer about probably being out-of-date
 
 Revision 1.61.2.14  2002/08/07 02:53:43  hal9
-Fix some minor markup errors, and move one OSX Q/A to troubleshooting section.
+Fix some minor markup errors, and move one Mac OS X Q/A to troubleshooting section.
 
 Revision 1.61.2.13  2002/08/06 11:55:32  oes
 Added missing close tag
 
 Revision 1.61.2.12  2002/08/06 11:43:46  david__schmidt
-Updated OSX uninstall FAQ... we have an uninstall script now.
+Updated Mac OS X uninstall FAQ... we have an uninstall script now.
 
 Revision 1.61.2.11  2002/08/06 08:54:03  oes
 Style police: Fixed formatting details
 
 Revision 1.61.2.10  2002/08/02 14:00:25  david__schmidt
-Made the OSX removal commands far less dangerous
+Made the Mac OS X removal commands far less dangerous
 
 Revision 1.61.2.9  2002/08/02 13:14:45  oes
-Added warning about sudo rm -r for Mac OSX deinstallation; moved this item to install section
+Added warning about sudo rm -r for Mac OS X deinstallation; moved this item to install section
 
 Revision 1.61.2.8  2002/08/02 02:01:42  david__schmidt
-Add FAQ item for MSIE on OSX HTTP proxy confusion
+Add FAQ item for MSIE on Mac OS X HTTP proxy confusion
 
 Revision 1.61.2.7  2002/08/02 01:46:01  david__schmidt
-Added FAQ item for Mac OSX uninstall woes
+Added FAQ item for Mac OS X uninstall woes
 
 Revision 1.61.2.6  2002/07/30 20:04:56  hal9
 Fix typo: 'schould'.