Add Roland Rosenfeld to contributors.
[privoxy.git] / doc / text / faq.txt
index 27cb184..5c4cbeb 100644 (file)
@@ -1,8 +1,8 @@
 Privoxy Frequently Asked Questions
 
-By: Privoxy Developers
+Copyright © 2001, 2002 by Privoxy Developers
 
-$Id: faq.sgml,v 1.52 2002/04/29 03:08:43 hal9 Exp $
+$Id: faq.sgml,v 1.57 2002/05/05 20:26:02 hal9 Exp $
 
 This FAQ gives users and developers alike answers to frequently asked questions
 about Privoxy .
@@ -22,7 +22,6 @@ Please see the Contact section if you want to contact the developers.
 -------------------------------------------------------------------------------
 
 Table of Contents
 1. General Information
    
     1.1. What is this new version of Privoxy?
@@ -70,6 +69,7 @@ Table of Contents
     3.12. I cannot see all of the "Blocked" page banner. Help.
     3.13. Can Privoxy run as a service on Win2K/NT?
     3.14. How can I make Privoxy work with other proxies like Squid?
+    3.15. Can Privoxy run as a "transparent" proxy?
    
 4. Miscellaneous
    
@@ -102,31 +102,29 @@ Table of Contents
         How?
     5.3. One of my favorite sites does not work with Privoxy. What can I do?
    
-7. Contacting the developers, Bug Reporting and Feature Requests
+6. Contacting the developers, Bug Reporting and Feature Requests
    
-    7.1. Get Support
-    7.2. Report bugs
-    7.3. Request new features
-    7.4. Report ads or other filter problems
-    7.5. Other
+    6.1. Get Support
+    6.2. Report bugs
+    6.3. Request new features
+    6.4. Report ads or other filter problems
+    6.5. Other
    
-8. Copyright and History
+7. Privoxy Copyright, License and History
    
-    8.1. Copyright
-    8.2. History
+    7.1. License
+    7.2. History
    
--------------------------------------------------------------------------------
-
 1. General Information
 
 1.1. What is this new version of Privoxy?
 
-The original Internet Junkbuster™ (tm) is a copyrighted product of 
-Junkbusters Corporation. Development of this effort stopped some time ago as of
-version 2.0.2. Stefan Waldherr started the ijbswa project on Sourceforge to
-rekindle development. Other developers subsequently joined with Stefan, and
-have since added many new features, refinements and enhancements. The result of
-this effort is Privoxy.
+The original Internet JunkbusterTM (tm) is a copyrighted product of Junkbusters
+Corporation. Development of this effort stopped some time ago as of version
+2.0.2. Stefan Waldherr started the ijbswa project on Sourceforge to rekindle
+development. Other developers subsequently joined with Stefan, and have since
+added many new features, refinements and enhancements. The result of this
+effort is Privoxy.
 
 Privoxy has evolved from the Junkbuster 2.0.2 code base, and has advanced
 significantly at this point.
@@ -169,14 +167,16 @@ configuration is now.
 
 1.4. What are some of the new features?
 
-  * FIXME: complete the list of features. change the order: most important
-    features to the top of the list. prefix new features with "NEW".
-   
   * Integrated browser based configuration and control utility at http://
     config.privoxy.org/ (shortcut: http://p.p/). Browser-based tracing of rule
     and filter effects. Remote toggling.
    
-  * Blocking of annoying pop-up browser windows.
+  * Web page content filtering (removes banners based on size, invisible
+    "web-bugs", JavaScript and HTML annoyances, pop-up windows, etc.)
+   
+  * Modularized configuration that allows for standard settings and user
+    settings to reside in separate files, so that installing updated actions
+    files won't overwrite idividual user settings.
    
   * HTTP/1.1 compliant (but not all optional 1.1 features are supported).
    
@@ -184,20 +184,18 @@ configuration is now.
     and generally a more sophisticated and flexible configuration syntax over
     previous versions.
    
-  * GIF de-animation.
+  * Improved cookie management features (e.g. session based cookies).
    
-  * Web page content filtering (removes banners based on size, invisible
-    "web-bugs", JavaScript and HTML annoyances, pop-ups, etc.)
+  * GIF de-animation.
    
   * Bypass many click-tracking scripts (avoids script redirection).
    
   * Multi-threaded (POSIX and native threads).
    
-  * Auto-detection and re-reading of config file changes.
-   
-  * User-customizable HTML templates (e.g. 404 error page).
+  * User-customizable HTML templates for all proxy-generated pages (e.g.
+    "blocked" page).
    
-  * Improved cookie management features (e.g. session based cookies).
+  * Auto-detection and re-reading of config file changes.
    
   * Improved signal handling, and a true daemon mode (Unix).
    
@@ -280,7 +278,7 @@ you don't have to maintain a similar configuration for possibly many browsers.
 Privoxy is licensed under the GNU General Public License (GPL). It is free to
 use, copy, modify or distribute as you wish under the terms of this license.
 Please see the Copyright section for more information on the license and
-copyright.
+copyright. Or the LICENSE file that should be included.
 
 There is no warranty of any kind, expressed, implied or otherwise. That is
 something that would cost real money ;-) There is no registration either.
@@ -596,7 +594,19 @@ details, and a sample configuration.
 
 3.14. How can I make Privoxy work with other proxies like Squid?
 
-This can be done. See the user manual, which describes how to do this. 
+This can be done. See the user manual, which describes how to do this.
+
+-------------------------------------------------------------------------------
+
+3.15. Can Privoxy run as a "transparent" proxy?
+
+No, Privoxy 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 Privoxy is now capable of.
+
+Chaining Privoxy with another proxy that has this ability should work though.
+See the user manual, which describes this, and also http://
+www.transproxy.nlc.net.au/.
 
 -------------------------------------------------------------------------------
 
@@ -651,7 +661,7 @@ Privoxy.
 
 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.14).
+consider upgrading to 2.9.15).
 
 -------------------------------------------------------------------------------
 
@@ -900,14 +910,14 @@ same thing by editing the appropriate "actions" file.
 
 -------------------------------------------------------------------------------
 
-7. Contacting the developers, Bug Reporting and Feature Requests
+6. Contacting the developers, Bug Reporting and Feature Requests
 
 We value your feedback. However, to provide you with the best support, please
 note the following sections.
 
 -------------------------------------------------------------------------------
 
-7.1. Get Support
+6.1. Get Support
 
 To get support, use the Sourceforge Support Forum:
 
@@ -915,7 +925,7 @@ To get support, use the Sourceforge Support Forum:
 
 -------------------------------------------------------------------------------
 
-7.2. Report bugs
+6.2. Report bugs
 
 To submit bugs, use the Sourceforge Bug Forum:
 
@@ -932,7 +942,7 @@ reproduce the bug.
 
 -------------------------------------------------------------------------------
 
-7.3. Request new features
+6.3. Request new features
 
 To submit ideas on new features, use the Sourceforge feature request forum:
 
@@ -940,7 +950,7 @@ To submit ideas on new features, use the Sourceforge feature request forum:
 
 -------------------------------------------------------------------------------
 
-7.4. Report ads or other filter problems
+6.4. Report ads or other filter problems
 
 You can also send feedback on websites that Privoxy has problems with. Please
 bookmark the following link: "Privoxy - Submit Filter Feedback". Once you surf
@@ -952,7 +962,7 @@ your feedback. These will be announced on the ijbswa-announce list.
 
 -------------------------------------------------------------------------------
 
-7.5. Other
+6.5. Other
 
 For any other issues, feel free to use the mailing lists:
  
@@ -964,14 +974,23 @@ too. See the page on Sourceforge.
 
 -------------------------------------------------------------------------------
 
-8. Copyright and History
+7. Privoxy Copyright, License and History
 
-8.1. Copyright
+Copyright © 2001, 2002 by Privoxy Developers <developers@privoxy.org>
+
+Some source code is based on code Copyright © 1997 by Anonymous Coders and
+Junkbusters, Inc. and licensed under the GNU General Public License.
+
+Portions of this document are "borrowed" from the original Junkbuster (tm) FAQ,
+and modified as appropriate for Privoxy.
+
+-------------------------------------------------------------------------------
+
+7.1. License
 
 Privoxy is free software; you can redistribute it and/or modify it under the
-terms of the GNU General Public License as published by the Free Software
-Foundation; either version 2 of the License, or (at your option) any later
-version.
+terms of the GNU General Public License, version 2, as published by the Free
+Software Foundation.
 
 This program is distributed in the hope that it will be useful, but WITHOUT ANY
 WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
@@ -980,12 +999,16 @@ is available from the Free Software Foundation, Inc, 59 Temple Place - Suite
 330, Boston, MA 02111-1307, USA.
 
 You should have received a copy of the GNU General Public License along with
-this program; if not, write to the Free Software Foundation, Inc., 59 Temple
-Place, Suite 330, Boston, MA 02111-1307 USA.
+this program; if not, write to the
+
+ Free Software
+ Foundation, Inc. 59 Temple Place - Suite 330
+ Boston, MA 02111-1307
+ USA 
 
 -------------------------------------------------------------------------------
 
-8.2. History
+7.2. History
 
 Privoxy is evolved, and derived from, the Internet Junkbuster, with many
 improvments and enhancements over the original.