generated
authorswa <swa@users.sourceforge.net>
Sat, 4 May 2002 08:41:23 +0000 (08:41 +0000)
committerswa <swa@users.sourceforge.net>
Sat, 4 May 2002 08:41:23 +0000 (08:41 +0000)
41 files changed:
README
doc/pdf/privoxy-developer-manual.pdf
doc/pdf/privoxy-faq.pdf
doc/pdf/privoxy-user-manual.pdf
doc/text/developer-manual.txt
doc/text/faq.txt
doc/text/user-manual.txt
doc/webserver/developer-manual/coding.html
doc/webserver/developer-manual/contact.html
doc/webserver/developer-manual/copyright.html
doc/webserver/developer-manual/cvs.html
doc/webserver/developer-manual/documentation.html
doc/webserver/developer-manual/index.html
doc/webserver/developer-manual/introduction.html
doc/webserver/developer-manual/newrelease.html
doc/webserver/developer-manual/seealso.html
doc/webserver/developer-manual/testing.html
doc/webserver/developer-manual/webserver-update.html
doc/webserver/faq/configuration.html
doc/webserver/faq/contact.html
doc/webserver/faq/copyright.html
doc/webserver/faq/general.html
doc/webserver/faq/index.html
doc/webserver/faq/installation.html
doc/webserver/faq/misc.html
doc/webserver/faq/trouble.html
doc/webserver/user-manual/actions-file.html
doc/webserver/user-manual/appendix.html
doc/webserver/user-manual/config.html
doc/webserver/user-manual/configuration.html
doc/webserver/user-manual/contact.html
doc/webserver/user-manual/copyright.html
doc/webserver/user-manual/filter-file.html
doc/webserver/user-manual/index.html
doc/webserver/user-manual/installation.html
doc/webserver/user-manual/introduction.html
doc/webserver/user-manual/quickstart.html
doc/webserver/user-manual/seealso.html
doc/webserver/user-manual/startup.html
doc/webserver/user-manual/templates.html
doc/webserver/user-manual/upgradersnote.html

diff --git a/README b/README
index e48c733..9c5af93 100644 (file)
--- a/README
+++ b/README
@@ -31,7 +31,7 @@
  *
  *********************************************************************/
 
-This README is included with the development version of Privoxy 2.9.14, which
+This README is included with the development version of Privoxy 2.9.15, which
 will eventually become Privoxy v3.0 (and soon we hope!). See http://
 www.privoxy.org/ for more information. The current code level is beta, and
 seems stable to us :).
@@ -63,14 +63,14 @@ change your browser if upgrading!!! And maybe firewall, etc.
  INSTALL
 --------
 
-To build Privoxy from source, autoheader, autoconf, GNU make (gmake), and, of
-course, a C compiler are required.
+To build Privoxy from source, autoconf, GNU make (gmake), and, of course, a C
+compiler like gcc are required.
 
 When building from a source tarball (either release version or nightly CVS
 tarball), first unpack the source:
 
- tar xzvf privoxy-2.9.14-beta-src* [.tgz or .tar.gz]                           
- cd privoxy-2.9.14-beta                                                        
+ tar xzvf privoxy-2.9.15-beta-src* [.tgz or .tar.gz]                           
+ cd privoxy-2.9.15-beta                                                        
 
 For retrieving the current CVS sources, you'll need CVS installed. Note that
 sources from CVS are development quality, and may not be stable, or well
index f179197..2575a0b 100644 (file)
Binary files a/doc/pdf/privoxy-developer-manual.pdf and b/doc/pdf/privoxy-developer-manual.pdf differ
index b071c57..e5a458c 100644 (file)
Binary files a/doc/pdf/privoxy-faq.pdf and b/doc/pdf/privoxy-faq.pdf differ
index dd137ef..012e2e4 100644 (file)
Binary files a/doc/pdf/privoxy-user-manual.pdf and b/doc/pdf/privoxy-user-manual.pdf differ
index 9722f5b..5541e66 100644 (file)
@@ -2,7 +2,7 @@ Privoxy Developer Manual
 
 By: Privoxy Developers
 
-$Id: developer-manual.sgml,v 1.39 2002/05/02 15:08:25 oes Exp $
+$Id: developer-manual.sgml,v 1.40 2002/05/04 00:43:43 hal9 Exp $
 
 The developer manual gives the users information on how to help the developer
 team. It provides guidance on coding, testing, documentation and other issues.
@@ -296,17 +296,18 @@ sufficient for our purposes.
 
 Some common elements that you likely will use:
 
-<para></para>, paragraph delimiter. Most text needs to be within paragraph     
-elements (there are some exceptions).                                          
-<emphasis></emphasis>, the stylesheets make this italics.                      
-<filename></filename>, files and directories.                                  
-<command></command>, command examples.                                         
-<literallayout></literallayout>, like <pre>, more or less.                     
-<itemizedlist></itemizedlist>, list with bullets.                              
-<listitem></listitem>, member of the above.                                    
-<screen></screen>, screen output, implies <literallayout>.                     
-<ulink url="example.com"></ulink>, like HTML <a> tag.                          
-<quote></quote>, for, doh, quoting text.                                       
+, paragraph delimiter. Most text needs to be within paragraph elements (there  
+are some exceptions).                                                          
+, the stylesheets make this italics.                                           
+, files and directories.                                                       
+, command examples.                                                            
+, like                                                                         
+, more or less.                                                                
+, list with bullets.                                                           
+, member of the above.                                                         
+, screen output, implies .                                                     
+, like HTML tag.                                                               
+, for, doh, quoting text.                                                      
 
 Look at any of the existing docs for examples of all these and more.
 
@@ -416,7 +417,7 @@ entities are listed below. See any of the main docs for examples.
    
   * Commonly used "internal entities":
    
-    p-version: the Privoxy version string, e.g. "2.9.14".                      
+    p-version: the Privoxy version string, e.g. "2.9.15".                      
     p-status: the project status, either "alpha", "beta", or "stable".         
     p-not-stable: use to conditionally include text in "not stable" releases   
     (e.g. "beta").                                                             
@@ -1081,13 +1082,13 @@ other header files.
 
 Example:
 
-#include <iostream.h>     /* This is not a local include */                    
+#include      /* This is not a local include */                                
 #include "config.h"       /* This IS a local include */                        
 
 Exception:
 
 /* This is not a local include, but requires a path element. */                
-#include <sys/fileName.h>                                                      
+#include                                                                       
 
 Note: Please! do not add "-I." to the Makefile without a _very_ good reason.
 This duplicates the #include "file.h" behavior.
@@ -1370,49 +1371,49 @@ from the project).
 
 Example for file comments:
 
-const char FILENAME_rcs[] = "$Id: developer-manual.sgml,v 1.39 2002/05/02 15:08:25 oes Exp $"; 
-/*********************************************************************                         
- *                                                                                             
- * File        :  $Source$                                                                     
- *                                                                                             
- * Purpose     :  (Fill me in with a good description!)                                        
- *                                                                                             
- * Copyright   :  Written by and Copyright (C) 2001 the SourceForge                            
- *                Privoxy team. http://www.privoxy.org/                                        
- *                                                                                             
- *                Based on the Internet Junkbuster originally written                          
- *                by and Copyright (C) 1997 Anonymous Coders and                               
- *                Junkbusters Corporation.  http://www.junkbusters.com                         
- *                                                                                             
- *                This program 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.                                              
- *                                                                                             
- *                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                         
- *                PARTICULAR PURPOSE.  See the GNU General Public                              
- *                License for more details.                                                    
- *                                                                                             
- *                The GNU General Public License should be included with                       
- *                this file.  If not, you can view it at                                       
- *                http://www.gnu.org/copyleft/gpl.html                                         
- *                or write to the Free Software Foundation, Inc., 59                           
- *                Temple Place - Suite 330, Boston, MA  02111-1307, USA.                       
- *                                                                                             
- * Revisions   :                                                                               
- *    $Log$                                                                                    
- *                                                                                             
- *********************************************************************/                        
-                                                                                               
-                                                                                               
-#include "config.h"                                                                            
-                                                                                               
-   ...necessary include files for us to do our work...                                         
-                                                                                               
-const char FILENAME_h_rcs[] = FILENAME_H_VERSION;                                              
+const char FILENAME_rcs[] = "$Id: developer-manual.sgml,v 1.40 2002/05/04 00:43:43 hal9 Exp $"; 
+/*********************************************************************                          
+ *                                                                                              
+ * File        :  $Source$                                                                      
+ *                                                                                              
+ * Purpose     :  (Fill me in with a good description!)                                         
+ *                                                                                              
+ * Copyright   :  Written by and Copyright (C) 2001 the SourceForge                             
+ *                Privoxy team. http://www.privoxy.org/                                         
+ *                                                                                              
+ *                Based on the Internet Junkbuster originally written                           
+ *                by and Copyright (C) 1997 Anonymous Coders and                                
+ *                Junkbusters Corporation.  http://www.junkbusters.com                          
+ *                                                                                              
+ *                This program 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.                                               
+ *                                                                                              
+ *                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                          
+ *                PARTICULAR PURPOSE.  See the GNU General Public                               
+ *                License for more details.                                                     
+ *                                                                                              
+ *                The GNU General Public License should be included with                        
+ *                this file.  If not, you can view it at                                        
+ *                http://www.gnu.org/copyleft/gpl.html                                          
+ *                or write to the Free Software Foundation, Inc., 59                            
+ *                Temple Place - Suite 330, Boston, MA  02111-1307, USA.                        
+ *                                                                                              
+ * Revisions   :                                                                                
+ *    $Log$                                                                                     
+ *                                                                                              
+ *********************************************************************/                         
+                                                                                                
+                                                                                                
+#include "config.h"                                                                             
+                                                                                                
+   ...necessary include files for us to do our work...                                          
+                                                                                                
+const char FILENAME_h_rcs[] = FILENAME_H_VERSION;                                               
 
 Note: This declares the rcs variables that should be added to the
 "show-proxy-args" page. If this is a brand new creation by you, you are free to
@@ -1425,71 +1426,71 @@ can.
 
 Example for file header comments:
 
-#ifndef _FILENAME_H                                                                          
-#define _FILENAME_H                                                                          
-#define FILENAME_H_VERSION "$Id: developer-manual.sgml,v 1.39 2002/05/02 15:08:25 oes Exp $" 
-/*********************************************************************                       
- *                                                                                           
- * File        :  $Source$                                                                   
- *                                                                                           
- * Purpose     :  (Fill me in with a good description!)                                      
- *                                                                                           
- * Copyright   :  Written by and Copyright (C) 2001 the SourceForge                          
- *                Privoxy team. http://www.privoxy.org/                                      
- *                                                                                           
- *                Based on the Internet Junkbuster originally written                        
- *                by and Copyright (C) 1997 Anonymous Coders and                             
- *                Junkbusters Corporation.  http://www.junkbusters.com                       
- *                                                                                           
- *                This program 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.                                            
- *                                                                                           
- *                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                       
- *                PARTICULAR PURPOSE.  See the GNU General Public                            
- *                License for more details.                                                  
- *                                                                                           
- *                The GNU General Public License should be included with                     
- *                this file.  If not, you can view it at                                     
- *                http://www.gnu.org/copyleft/gpl.html                                       
- *                or write to the Free Software Foundation, Inc., 59                         
- *                Temple Place - Suite 330, Boston, MA  02111-1307, USA.                     
- *                                                                                           
- * Revisions   :                                                                             
- *    $Log$                                                                                  
- *                                                                                           
- *********************************************************************/                      
-                                                                                             
-                                                                                             
-#include "project.h"                                                                         
-                                                                                             
-#ifdef __cplusplus                                                                           
-extern "C" {                                                                                 
-#endif                                                                                       
-                                                                                             
-   ... function headers here ...                                                             
-                                                                                             
-                                                                                             
-/* Revision control strings from this header and associated .c file */                       
-extern const char FILENAME_rcs[];                                                            
-extern const char FILENAME_h_rcs[];                                                          
-                                                                                             
-                                                                                             
-#ifdef __cplusplus                                                                           
-} /* extern "C" */                                                                           
-#endif                                                                                       
-                                                                                             
-#endif /* ndef _FILENAME_H */                                                                
-                                                                                             
-/*                                                                                           
-  Local Variables:                                                                           
-  tab-width: 3                                                                               
-  end:                                                                                       
-*/                                                                                           
+#ifndef _FILENAME_H                                                                           
+#define _FILENAME_H                                                                           
+#define FILENAME_H_VERSION "$Id: developer-manual.sgml,v 1.40 2002/05/04 00:43:43 hal9 Exp $" 
+/*********************************************************************                        
+ *                                                                                            
+ * File        :  $Source$                                                                    
+ *                                                                                            
+ * Purpose     :  (Fill me in with a good description!)                                       
+ *                                                                                            
+ * Copyright   :  Written by and Copyright (C) 2001 the SourceForge                           
+ *                Privoxy team. http://www.privoxy.org/                                       
+ *                                                                                            
+ *                Based on the Internet Junkbuster originally written                         
+ *                by and Copyright (C) 1997 Anonymous Coders and                              
+ *                Junkbusters Corporation.  http://www.junkbusters.com                        
+ *                                                                                            
+ *                This program 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.                                             
+ *                                                                                            
+ *                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                        
+ *                PARTICULAR PURPOSE.  See the GNU General Public                             
+ *                License for more details.                                                   
+ *                                                                                            
+ *                The GNU General Public License should be included with                      
+ *                this file.  If not, you can view it at                                      
+ *                http://www.gnu.org/copyleft/gpl.html                                        
+ *                or write to the Free Software Foundation, Inc., 59                          
+ *                Temple Place - Suite 330, Boston, MA  02111-1307, USA.                      
+ *                                                                                            
+ * Revisions   :                                                                              
+ *    $Log$                                                                                   
+ *                                                                                            
+ *********************************************************************/                       
+                                                                                              
+                                                                                              
+#include "project.h"                                                                          
+                                                                                              
+#ifdef __cplusplus                                                                            
+extern "C" {                                                                                  
+#endif                                                                                        
+                                                                                              
+   ... function headers here ...                                                              
+                                                                                              
+                                                                                              
+/* Revision control strings from this header and associated .c file */                        
+extern const char FILENAME_rcs[];                                                             
+extern const char FILENAME_h_rcs[];                                                           
+                                                                                              
+                                                                                              
+#ifdef __cplusplus                                                                            
+} /* extern "C" */                                                                            
+#endif                                                                                        
+                                                                                              
+#endif /* ndef _FILENAME_H */                                                                 
+                                                                                              
+/*                                                                                            
+  Local Variables:                                                                            
+  tab-width: 3                                                                                
+  end:                                                                                        
+*/                                                                                            
 
 Example for function comments:
 
@@ -1951,7 +1952,7 @@ Once this done go to http://sourceforge.net/project/admin/editpackages.php?
 group_id=11118, making sure you are logged in. Find your target platform in the
 second column, and click Add Release. You will then need to create a new
 release for your package, using the format of $VERSION ($CODE_STATUS), e.g.
-2.9.14 (beta).
+2.9.15 (beta).
 
 Now just follow the prompts. Be sure to add any appropriate Release notes. You
 should see your freshly uploaded packages in "Step 2. Add Files To This
index 917696f..5027daa 100644 (file)
@@ -2,7 +2,7 @@ Privoxy Frequently Asked Questions
 
 By: Privoxy Developers
 
-$Id: faq.sgml,v 1.54 2002/05/03 05:06:44 hal9 Exp $
+$Id: faq.sgml,v 1.55 2002/05/04 00:41:56 hal9 Exp $
 
 This FAQ gives users and developers alike answers to frequently asked questions
 about Privoxy .
@@ -119,12 +119,12 @@ Table of Contents
 
 1.1. What is this new version of 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.
+The original Internet Junkbuster&trade; (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.
@@ -661,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).
 
 -------------------------------------------------------------------------------
 
index 680bee0..9aa97ee 100644 (file)
@@ -2,7 +2,7 @@ Privoxy User Manual
 
 By: Privoxy Developers
 
-$Id: user-manual.sgml,v 1.102 2002/05/03 17:46:00 oes Exp $
+$Id: user-manual.sgml,v 1.103 2002/05/04 00:40:53 hal9 Exp $
 
 The user manual gives users information on how to install, configure and use 
 Privoxy.
@@ -168,7 +168,7 @@ Table of Contents
 1. Introduction
 
 This documentation is included with the current beta version of Privoxy,
-v.2.9.14, and is mostly complete at this point. The most up to date reference
+v.2.9.15, and is mostly complete at this point. The most up to date reference
 for the time being is still the comments in the source files and in the
 individual configuration files. Development of version 3.0 is currently nearing
 completion, and includes many significant changes and enhancements over earlier
@@ -248,7 +248,7 @@ How to install the binary packages depends on your operating system:
 
 2.1.1. Red Hat and SuSE RPMs
 
-RPMs can be installed with rpm -Uvh privoxy-2.9.14-1.rpm, and will use /etc/
+RPMs can be installed with rpm -Uvh privoxy-2.9.15-1.rpm, and will use /etc/
 privoxy for the location of configuration files.
 
 Note that on Red Hat, Privoxy will not be automatically started on system boot.
@@ -256,7 +256,7 @@ You will need to enable that using chkconfig, ntsysv, or similar methods. Note
 that SuSE will automatically start Privoxy in the boot process.
 
 If you have problems with failed dependencies, try rebuilding the SRC RPM: rpm
---rebuild privoxy-2.9.14-1.src.rpm;. This will use your locally installed
+--rebuild privoxy-2.9.15-1.src.rpm;. This will use your locally installed
 libraries and RPM version.
 
 Also note that if you have a Junkbuster RPM installed on your system, you need
@@ -341,8 +341,8 @@ compiler like gcc are required.
 When building from a source tarball (either release version or nightly CVS
 tarball), first unpack the source:
 
- tar xzvf privoxy-2.9.14-beta-src* [.tgz or .tar.gz]                           
- cd privoxy-2.9.14-beta                                                        
+ tar xzvf privoxy-2.9.15-beta-src* [.tgz or .tar.gz]                           
+ cd privoxy-2.9.15-beta                                                        
 
 For retrieving the current CVS sources, you'll need CVS installed. Note that
 sources from CVS are development quality, and may not be stable, or well
@@ -582,11 +582,11 @@ config.privoxy.org/ (shortcut: http://p.p/), which is a built-in page and works
 without Internet access. You will see the following section: 
 
  Privoxy Menu                                                                  
-        ?  View & change the current configuration                             
-        ?  View the source code version numbers                                
-        ?  View the request headers.                                           
-        ?  Look up which actions apply to a URL and why                        
-        ?  Toggle Privoxy on or off                                            
+        ??  View & change the current configuration                            
+        ??  View the source code version numbers                               
+        ??  View the request headers.                                          
+        ??  Look up which actions apply to a URL and why                       
+        ??  Toggle Privoxy on or off                                           
                                                                                
 
 This should be self-explanatory. Note the first item leads to an editor for the
@@ -958,7 +958,7 @@ Notes:
    
     Unix, in local filesystem:
    
-    user-manual  file:///usr/share/doc/privoxy-2.9.14/user-manual/     
+    user-manual  file:///usr/share/doc/privoxy-2.9.15/user-manual/     
    
     Any platform, on local webserver (called "local-webserver"):
    
@@ -3508,7 +3508,7 @@ Then, for our user.action file, we again have no hits.
 And finally we pull it all together in the bottom section and summarize how
 Privoxy is applying all its "actions" to "google.com": 
 
- Final results:                                                                    
+  Final results:                                                                   
  -add-header -block +deanimate-gifs{last} -downgrade-http-version -fast-redirects  
  -filter{popups} -filter{fun} -filter{shockwave-flash} -filter{crude-parental}     
  +filter{html-annoyances} +filter{js-annoyances} +filter{content-cookies}          
@@ -3523,7 +3523,7 @@ and "session-cookies-only".
 
 Now another example, "ad.doubleclick.net":
 
- { +block +handle-as-image }                                                   
+  { +block +handle-as-image }                                                  
   .ad.doubleclick.net                                                          
                                                                                
  { +block +handle-as-image }                                                   
@@ -3549,7 +3549,7 @@ and make it more readable.
 One last example. Let's try "http://www.rhapsodyk.net/adsl/HOWTO/". This one is
 giving us problems. We are getting a blank page. Hmmm...
 
- Matches for http://www.rhapsodyk.net/adsl/HOWTO/:                                   
+  Matches for http://www.rhapsodyk.net/adsl/HOWTO/:                                  
                                                                                      
  { -add-header -block +deanimate-gifs -downgrade-http-version +fast-redirects        
    +filter{html-annoyances} +filter{js-annoyances} +filter{kill-popups}              
@@ -3568,7 +3568,7 @@ see why we get the blank page. We could now add a new action below this that
 explicitly does not block ("{-block}") paths with "adsl". There are various
 ways to handle such exceptions. Example:
 
- { -block }                                                                    
+  { -block }                                                                   
   /adsl                                                                        
 
 Now the page displays ;-) Be sure to flush your browser's caches when making
@@ -3577,7 +3577,7 @@ such changes. Or, try using Shift+Reload.
 But now what about a situation where we get no explicit matches like we did
 with:
 
- { +block +handle-as-image }                                                   
+  { +block +handle-as-image }                                                  
  /ads                                                                          
 
 That actually was very telling and pointed us quickly to where the problem was.
@@ -3587,7 +3587,7 @@ and maybe a little trial and error to isolate the offending rule. One likely
 cause would be one of the "{+filter}" actions. Try adding the URL for the site
 to one of aliases that turn off "+filter":
 
- {shop}                                                                        
+  {shop}                                                                       
  .quietpc.com                                                                  
  .worldpay.com   # for quietpc.com                                             
  .jungle.com                                                                   
@@ -3597,7 +3597,7 @@ to one of aliases that turn off "+filter":
 "{shop}" is an "alias" that expands to "{ -filter -session-cookies-only }". Or
 you could do your own exception to negate filtering: 
 
- {-filter}                                                                     
+  {-filter}                                                                    
  .forbes.com                                                                   
 
 This would probably be most appropriately put in user.action, for local site
index d30b740..28b0017 100644 (file)
@@ -71,7 +71,7 @@ CLASS="SECT1"
 CLASS="SECT1"
 ><A
 NAME="CODING"
->6. Coding Guidelines</A
+>4. Coding Guidelines</A
 ></H1
 ><DIV
 CLASS="SECT2"
@@ -79,7 +79,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="S1"
->6.1. Introduction</A
+>4.1. Introduction</A
 ></H2
 ><P
 >This set of standards is designed to make our lives easier.  It is
@@ -102,7 +102,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="S2"
->6.2. Using Comments</A
+>4.2. Using Comments</A
 ></H2
 ><DIV
 CLASS="SECT3"
@@ -110,7 +110,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="S3"
->6.2.1. Comment, Comment, Comment</A
+>4.2.1. Comment, Comment, Comment</A
 ></H3
 ><P
 ><I
@@ -168,7 +168,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="S4"
->6.2.2. Use blocks for comments</A
+>4.2.2. Use blocks for comments</A
 ></H3
 ><P
 ><I
@@ -233,7 +233,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="S5"
->6.2.3. Keep Comments on their own line</A
+>4.2.3. Keep Comments on their own line</A
 ></H3
 ><P
 ><I
@@ -306,7 +306,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="S6"
->6.2.4. Comment each logical step</A
+>4.2.4. Comment each logical step</A
 ></H3
 ><P
 ><I
@@ -332,7 +332,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="S7"
->6.2.5. Comment All Functions Thoroughly</A
+>4.2.5. Comment All Functions Thoroughly</A
 ></H3
 ><P
 ><I
@@ -359,7 +359,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="S8"
->6.2.6. Comment at the end of braces if the
+>4.2.6. Comment at the end of braces if the
     content is more than one screen length</A
 ></H3
 ><P
@@ -416,7 +416,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="S9"
->6.3. Naming Conventions</A
+>4.3. Naming Conventions</A
 ></H2
 ><DIV
 CLASS="SECT3"
@@ -424,7 +424,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="S10"
->6.3.1. Variable Names</A
+>4.3.1. Variable Names</A
 ></H3
 ><P
 ><I
@@ -481,7 +481,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="S11"
->6.3.2. Function Names</A
+>4.3.2. Function Names</A
 ></H3
 ><P
 ><I
@@ -539,7 +539,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="S12"
->6.3.3. Header file prototypes</A
+>4.3.3. Header file prototypes</A
 ></H3
 ><P
 ><I
@@ -595,7 +595,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="S13"
->6.3.4. Enumerations, and #defines</A
+>4.3.4. Enumerations, and #defines</A
 ></H3
 ><P
 ><I
@@ -659,7 +659,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="S14"
->6.3.5. Constants</A
+>4.3.5. Constants</A
 ></H3
 ><P
 ><I
@@ -722,7 +722,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="S15"
->6.4. Using Space</A
+>4.4. Using Space</A
 ></H2
 ><DIV
 CLASS="SECT3"
@@ -730,7 +730,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="S16"
->6.4.1. Put braces on a line by themselves.</A
+>4.4.1. Put braces on a line by themselves.</A
 ></H3
 ><P
 ><I
@@ -818,7 +818,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="S17"
->6.4.2. ALL control statements should have a
+>4.4.2. ALL control statements should have a
     block</A
 ></H3
 ><P
@@ -878,7 +878,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="S18"
->6.4.3. Do not belabor/blow-up boolean
+>4.4.3. Do not belabor/blow-up boolean
     expressions</A
 ></H3
 ><P
@@ -921,7 +921,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="S19"
->6.4.4. Use white space freely because it is
+>4.4.4. Use white space freely because it is
     free</A
 ></H3
 ><P
@@ -963,7 +963,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="S20"
->6.4.5. Don't use white space around structure
+>4.4.5. Don't use white space around structure
     operators</A
 ></H3
 ><P
@@ -1011,7 +1011,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="S21"
->6.4.6. Make the last brace of a function stand
+>4.4.6. Make the last brace of a function stand
     out</A
 ></H3
 ><P
@@ -1073,7 +1073,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="S22"
->6.4.7. Use 3 character indentions</A
+>4.4.7. Use 3 character indentions</A
 ></H3
 ><P
 ><I
@@ -1129,7 +1129,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="S23"
->6.5. Initializing</A
+>4.5. Initializing</A
 ></H2
 ><DIV
 CLASS="SECT3"
@@ -1137,7 +1137,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="S24"
->6.5.1. Initialize all variables</A
+>4.5.1. Initialize all variables</A
 ></H3
 ><P
 ><I
@@ -1190,7 +1190,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="S25"
->6.6. Functions</A
+>4.6. Functions</A
 ></H2
 ><DIV
 CLASS="SECT3"
@@ -1198,7 +1198,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="S26"
->6.6.1. Name functions that return a boolean as a
+>4.6.1. Name functions that return a boolean as a
     question.</A
 ></H3
 ><P
@@ -1235,7 +1235,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="S27"
->6.6.2. Always specify a return type for a
+>4.6.2. Always specify a return type for a
     function.</A
 ></H3
 ><P
@@ -1255,7 +1255,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="S28"
->6.6.3. Minimize function calls when iterating by
+>4.6.3. Minimize function calls when iterating by
     using variables</A
 ></H3
 ><P
@@ -1339,7 +1339,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="S29"
->6.6.4. Pass and Return by Const Reference</A
+>4.6.4. Pass and Return by Const Reference</A
 ></H3
 ><P
 ><I
@@ -1366,7 +1366,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="S30"
->6.6.5. Pass and Return by Value</A
+>4.6.5. Pass and Return by Value</A
 ></H3
 ><P
 ><I
@@ -1388,7 +1388,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="S31"
->6.6.6. Names of include files</A
+>4.6.6. Names of include files</A
 ></H3
 ><P
 ><I
@@ -1454,7 +1454,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="S32"
->6.6.7. Provide multiple inclusion
+>4.6.7. Provide multiple inclusion
     protection</A
 ></H3
 ><P
@@ -1497,7 +1497,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="S33"
->6.6.8. Use `extern "C"` when appropriate</A
+>4.6.8. Use `extern "C"` when appropriate</A
 ></H3
 ><P
 ><I
@@ -1541,7 +1541,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="S34"
->6.6.9. Where Possible, Use Forward Struct
+>4.6.9. Where Possible, Use Forward Struct
     Declaration Instead of Includes</A
 ></H3
 ><P
@@ -1595,7 +1595,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="S35"
->6.7. General Coding Practices</A
+>4.7. General Coding Practices</A
 ></H2
 ><DIV
 CLASS="SECT3"
@@ -1603,7 +1603,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="S36"
->6.7.1. Turn on warnings</A
+>4.7.1. Turn on warnings</A
 ></H3
 ><P
 ><I
@@ -1621,7 +1621,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="S37"
->6.7.2. Provide a default case for all switch
+>4.7.2. Provide a default case for all switch
     statements</A
 ></H3
 ><P
@@ -1694,7 +1694,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="S38"
->6.7.3. Try to avoid falling through cases in a
+>4.7.3. Try to avoid falling through cases in a
     switch statement.</A
 ></H3
 ><P
@@ -1725,7 +1725,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="S39"
->6.7.4. Use 'long' or 'short' Instead of
+>4.7.4. Use 'long' or 'short' Instead of
     'int'</A
 ></H3
 ><P
@@ -1752,7 +1752,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="S40"
->6.7.5. Don't mix size_t and other types</A
+>4.7.5. Don't mix size_t and other types</A
 ></H3
 ><P
 ><I
@@ -1773,7 +1773,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="S41"
->6.7.6. Declare each variable and struct on its
+>4.7.6. Declare each variable and struct on its
     own line.</A
 ></H3
 ><P
@@ -1839,7 +1839,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="S42"
->6.7.7. Use malloc/zalloc sparingly</A
+>4.7.7. Use malloc/zalloc sparingly</A
 ></H3
 ><P
 ><I
@@ -1877,7 +1877,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="S43"
->6.7.8. The Programmer Who Uses 'malloc' is
+>4.7.8. The Programmer Who Uses 'malloc' is
     Responsible for Ensuring 'free'</A
 ></H3
 ><P
@@ -1934,7 +1934,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="S44"
->6.7.9. Add loaders to the `file_list' structure
+>4.7.9. Add loaders to the `file_list' structure
     and in order</A
 ></H3
 ><P
@@ -1961,7 +1961,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="S45"
->6.7.10. "Uncertain" new code and/or changes to
+>4.7.10. "Uncertain" new code and/or changes to
     existing code, use FIXME</A
 ></H3
 ><P
@@ -2003,7 +2003,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="S46"
->6.8. Addendum: Template for files and function
+>4.8. Addendum: Template for files and function
     comment blocks:</A
 ></H2
 ><P
@@ -2019,7 +2019,7 @@ WIDTH="100%"
 ><TD
 ><PRE
 CLASS="PROGRAMLISTING"
->const char FILENAME_rcs[] = "$Id: developer-manual.sgml,v 1.39 2002/05/02 15:08:25 oes Exp $";
+>const char FILENAME_rcs[] = "$Id: developer-manual.sgml,v 1.40 2002/05/04 00:43:43 hal9 Exp $";
 /*********************************************************************
  *
  * File        :  $Source$
@@ -2097,7 +2097,7 @@ WIDTH="100%"
 CLASS="PROGRAMLISTING"
 >#ifndef _FILENAME_H
 #define _FILENAME_H
-#define FILENAME_H_VERSION "$Id: developer-manual.sgml,v 1.39 2002/05/02 15:08:25 oes Exp $"
+#define FILENAME_H_VERSION "$Id: developer-manual.sgml,v 1.40 2002/05/04 00:43:43 hal9 Exp $"
 /*********************************************************************
  *
  * File        :  $Source$
index 2ab0bcb..1e5a773 100644 (file)
@@ -71,7 +71,7 @@ CLASS="SECT1"
 CLASS="SECT1"
 ><A
 NAME="CONTACT"
->10. Contacting the developers, Bug Reporting and Feature Requests</A
+>8. Contacting the developers, Bug Reporting and Feature Requests</A
 ></H1
 ><P
 > We value your feedback. However, to provide you with the best support, please
@@ -82,7 +82,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="CONTACT-SUPPORT"
->10.1. Get Support</A
+>8.1. Get Support</A
 ></H2
 ><P
 >   <P
@@ -103,7 +103,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="CONTACT-BUGS"
->10.2. Report bugs</A
+>8.2. Report bugs</A
 ></H2
 ><P
 >   <P
@@ -141,7 +141,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="CONTACT-FEATURE"
->10.3. Request new features</A
+>8.3. Request new features</A
 ></H2
 ><P
 >   <P
@@ -162,7 +162,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="CONTACT-ADS"
->10.4. Report ads or other filter problems</A
+>8.4. Report ads or other filter problems</A
 ></H2
 ><P
 >You can also send feedback on websites that Privoxy has problems with. Please bookmark
@@ -194,7 +194,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="CONTACT-OTHER"
->10.5. Other</A
+>8.5. Other</A
 ></H2
 ><P
 >   <P
index e888f7f..e4a3f2e 100644 (file)
@@ -71,15 +71,15 @@ CLASS="SECT1"
 CLASS="SECT1"
 ><A
 NAME="COPYRIGHT"
->11. Copyright and History</A
+>9. Copyright and History</A
 ></H1
 ><DIV
 CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="AEN1060"
->11.1. Copyright</A
+NAME="AEN1057"
+>9.1. Copyright</A
 ></H2
 ><P
 > <SPAN
@@ -112,8 +112,8 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="AEN1067"
->11.2. History</A
+NAME="AEN1064"
+>9.2. History</A
 ></H2
 ><P
 > <SPAN
index e78d185..8801054 100644 (file)
@@ -10,8 +10,8 @@ REL="HOME"
 TITLE="Privoxy Developer Manual"
 HREF="index.html"><LINK
 REL="PREVIOUS"
-TITLE="Quickstart to Privoxy Development"
-HREF="quickstart.html"><LINK
+TITLE="Introduction"
+HREF="introduction.html"><LINK
 REL="NEXT"
 TITLE="Documentation Guidelines"
 HREF="documentation.html"><LINK
@@ -44,7 +44,7 @@ WIDTH="10%"
 ALIGN="left"
 VALIGN="bottom"
 ><A
-HREF="quickstart.html"
+HREF="introduction.html"
 >Prev</A
 ></TD
 ><TD
@@ -71,7 +71,7 @@ CLASS="SECT1"
 CLASS="SECT1"
 ><A
 NAME="CVS"
->4. The CVS Repository</A
+>2. The CVS Repository</A
 ></H1
 ><P
 >      If you intend to help us with programming, documentation or packaging
@@ -84,7 +84,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="CVSACCESS"
->4.1. Access to CVS</A
+>2.1. Access to CVS</A
 ></H2
 ><P
 >        The project's CVS repository is hosted on
@@ -121,7 +121,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="CVSCOMMIT"
->4.2. CVS Commit Guideline</A
+>2.2. CVS Commit Guideline</A
 ></H2
 ><P
 >        The source tree is the heart of every software project. Every effort must
@@ -185,7 +185,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="CVSWHENASK"
->4.3. Discussing Changes First</A
+>2.3. Discussing Changes First</A
 ></H2
 ><P
 >        We don't have a too formal policy on this, just use common sense. Hints: If it is..
@@ -257,7 +257,7 @@ WIDTH="33%"
 ALIGN="left"
 VALIGN="top"
 ><A
-HREF="quickstart.html"
+HREF="introduction.html"
 >Prev</A
 ></TD
 ><TD
@@ -282,7 +282,7 @@ HREF="documentation.html"
 WIDTH="33%"
 ALIGN="left"
 VALIGN="top"
->Quickstart to Privoxy Development</TD
+>Introduction</TD
 ><TD
 WIDTH="34%"
 ALIGN="center"
index 5d60d94..19ac418 100644 (file)
@@ -71,7 +71,7 @@ CLASS="SECT1"
 CLASS="SECT1"
 ><A
 NAME="DOCUMENTATION"
->5. Documentation Guidelines</A
+>3. Documentation Guidelines</A
 ></H1
 ><P
 >    All formal documents are maintained in Docbook SGML and located in the
@@ -251,7 +251,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="SGML"
->5.1. Quickstart to Docbook and SGML</A
+>3.1. Quickstart to Docbook and SGML</A
 ></H2
 ><P
 > If you are not familiar with SGML, it is a markup language similar to HTML. 
@@ -467,7 +467,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="DOCSTYLE"
->5.2. <SPAN
+>3.2. <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
 > Documentation Style</A
@@ -607,8 +607,8 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="AEN212"
->5.3. Privoxy Custom Entities</A
+NAME="AEN209"
+>3.3. Privoxy Custom Entities</A
 ></H2
 ><P
 >  <SPAN
@@ -712,7 +712,7 @@ CLASS="APPLICATION"
 > 
     version string, e.g. <SPAN
 CLASS="QUOTE"
->"2.9.14"</SPAN
+>"2.9.15"</SPAN
 >.
    </TD
 ></TR
index a9bb4a6..6377574 100644 (file)
@@ -49,7 +49,7 @@ CLASS="ORGNAME"
 ></DIV
 ><P
 CLASS="PUBDATE"
->$Id: developer-manual.sgml,v 1.39 2002/05/02 15:08:25 oes Exp $<BR></P
+>$Id: developer-manual.sgml,v 1.40 2002/05/04 00:43:43 hal9 Exp $<BR></P
 ><DIV
 ><DIV
 CLASS="ABSTRACT"
@@ -88,58 +88,57 @@ CLASS="TOC"
 >Table of Contents</B
 ></DT
 ><DT
-><A
-HREF="index.html#INTRO"
-></A
-></DT
-><DT
 >1. <A
 HREF="introduction.html"
 >Introduction</A
 ></DT
+><DD
+><DL
 ><DT
->3. <A
-HREF="quickstart.html"
+>1.1. <A
+HREF="introduction.html#QUICKSTART"
 >Quickstart to Privoxy Development</A
 ></DT
+></DL
+></DD
 ><DT
->4. <A
+>2. <A
 HREF="cvs.html"
 >The CVS Repository</A
 ></DT
 ><DD
 ><DL
 ><DT
->4.1. <A
+>2.1. <A
 HREF="cvs.html#CVSACCESS"
 >Access to CVS</A
 ></DT
 ><DT
->4.2. <A
+>2.2. <A
 HREF="cvs.html#CVSCOMMIT"
 >CVS Commit Guideline</A
 ></DT
 ><DT
->4.3. <A
+>2.3. <A
 HREF="cvs.html#CVSWHENASK"
 >Discussing Changes First</A
 ></DT
 ></DL
 ></DD
 ><DT
->5. <A
+>3. <A
 HREF="documentation.html"
 >Documentation Guidelines</A
 ></DT
 ><DD
 ><DL
 ><DT
->5.1. <A
+>3.1. <A
 HREF="documentation.html#SGML"
 >Quickstart to Docbook and SGML</A
 ></DT
 ><DT
->5.2. <A
+>3.2. <A
 HREF="documentation.html#DOCSTYLE"
 ><SPAN
 CLASS="APPLICATION"
@@ -147,58 +146,58 @@ CLASS="APPLICATION"
 > Documentation Style</A
 ></DT
 ><DT
->5.3. <A
-HREF="documentation.html#AEN212"
+>3.3. <A
+HREF="documentation.html#AEN209"
 >Privoxy Custom Entities</A
 ></DT
 ></DL
 ></DD
 ><DT
->6. <A
+>4. <A
 HREF="coding.html"
 >Coding Guidelines</A
 ></DT
 ><DD
 ><DL
 ><DT
->6.1. <A
+>4.1. <A
 HREF="coding.html#S1"
 >Introduction</A
 ></DT
 ><DT
->6.2. <A
+>4.2. <A
 HREF="coding.html#S2"
 >Using Comments</A
 ></DT
 ><DD
 ><DL
 ><DT
->6.2.1. <A
+>4.2.1. <A
 HREF="coding.html#S3"
 >Comment, Comment, Comment</A
 ></DT
 ><DT
->6.2.2. <A
+>4.2.2. <A
 HREF="coding.html#S4"
 >Use blocks for comments</A
 ></DT
 ><DT
->6.2.3. <A
+>4.2.3. <A
 HREF="coding.html#S5"
 >Keep Comments on their own line</A
 ></DT
 ><DT
->6.2.4. <A
+>4.2.4. <A
 HREF="coding.html#S6"
 >Comment each logical step</A
 ></DT
 ><DT
->6.2.5. <A
+>4.2.5. <A
 HREF="coding.html#S7"
 >Comment All Functions Thoroughly</A
 ></DT
 ><DT
->6.2.6. <A
+>4.2.6. <A
 HREF="coding.html#S8"
 >Comment at the end of braces if the
     content is more than one screen length</A
@@ -206,155 +205,155 @@ HREF="coding.html#S8"
 ></DL
 ></DD
 ><DT
->6.3. <A
+>4.3. <A
 HREF="coding.html#S9"
 >Naming Conventions</A
 ></DT
 ><DD
 ><DL
 ><DT
->6.3.1. <A
+>4.3.1. <A
 HREF="coding.html#S10"
 >Variable Names</A
 ></DT
 ><DT
->6.3.2. <A
+>4.3.2. <A
 HREF="coding.html#S11"
 >Function Names</A
 ></DT
 ><DT
->6.3.3. <A
+>4.3.3. <A
 HREF="coding.html#S12"
 >Header file prototypes</A
 ></DT
 ><DT
->6.3.4. <A
+>4.3.4. <A
 HREF="coding.html#S13"
 >Enumerations, and #defines</A
 ></DT
 ><DT
->6.3.5. <A
+>4.3.5. <A
 HREF="coding.html#S14"
 >Constants</A
 ></DT
 ></DL
 ></DD
 ><DT
->6.4. <A
+>4.4. <A
 HREF="coding.html#S15"
 >Using Space</A
 ></DT
 ><DD
 ><DL
 ><DT
->6.4.1. <A
+>4.4.1. <A
 HREF="coding.html#S16"
 >Put braces on a line by themselves.</A
 ></DT
 ><DT
->6.4.2. <A
+>4.4.2. <A
 HREF="coding.html#S17"
 >ALL control statements should have a
     block</A
 ></DT
 ><DT
->6.4.3. <A
+>4.4.3. <A
 HREF="coding.html#S18"
 >Do not belabor/blow-up boolean
     expressions</A
 ></DT
 ><DT
->6.4.4. <A
+>4.4.4. <A
 HREF="coding.html#S19"
 >Use white space freely because it is
     free</A
 ></DT
 ><DT
->6.4.5. <A
+>4.4.5. <A
 HREF="coding.html#S20"
 >Don't use white space around structure
     operators</A
 ></DT
 ><DT
->6.4.6. <A
+>4.4.6. <A
 HREF="coding.html#S21"
 >Make the last brace of a function stand
     out</A
 ></DT
 ><DT
->6.4.7. <A
+>4.4.7. <A
 HREF="coding.html#S22"
 >Use 3 character indentions</A
 ></DT
 ></DL
 ></DD
 ><DT
->6.5. <A
+>4.5. <A
 HREF="coding.html#S23"
 >Initializing</A
 ></DT
 ><DD
 ><DL
 ><DT
->6.5.1. <A
+>4.5.1. <A
 HREF="coding.html#S24"
 >Initialize all variables</A
 ></DT
 ></DL
 ></DD
 ><DT
->6.6. <A
+>4.6. <A
 HREF="coding.html#S25"
 >Functions</A
 ></DT
 ><DD
 ><DL
 ><DT
->6.6.1. <A
+>4.6.1. <A
 HREF="coding.html#S26"
 >Name functions that return a boolean as a
     question.</A
 ></DT
 ><DT
->6.6.2. <A
+>4.6.2. <A
 HREF="coding.html#S27"
 >Always specify a return type for a
     function.</A
 ></DT
 ><DT
->6.6.3. <A
+>4.6.3. <A
 HREF="coding.html#S28"
 >Minimize function calls when iterating by
     using variables</A
 ></DT
 ><DT
->6.6.4. <A
+>4.6.4. <A
 HREF="coding.html#S29"
 >Pass and Return by Const Reference</A
 ></DT
 ><DT
->6.6.5. <A
+>4.6.5. <A
 HREF="coding.html#S30"
 >Pass and Return by Value</A
 ></DT
 ><DT
->6.6.6. <A
+>4.6.6. <A
 HREF="coding.html#S31"
 >Names of include files</A
 ></DT
 ><DT
->6.6.7. <A
+>4.6.7. <A
 HREF="coding.html#S32"
 >Provide multiple inclusion
     protection</A
 ></DT
 ><DT
->6.6.8. <A
+>4.6.8. <A
 HREF="coding.html#S33"
 >Use `extern "C"` when appropriate</A
 ></DT
 ><DT
->6.6.9. <A
+>4.6.9. <A
 HREF="coding.html#S34"
 >Where Possible, Use Forward Struct
     Declaration Instead of Includes</A
@@ -362,65 +361,65 @@ HREF="coding.html#S34"
 ></DL
 ></DD
 ><DT
->6.7. <A
+>4.7. <A
 HREF="coding.html#S35"
 >General Coding Practices</A
 ></DT
 ><DD
 ><DL
 ><DT
->6.7.1. <A
+>4.7.1. <A
 HREF="coding.html#S36"
 >Turn on warnings</A
 ></DT
 ><DT
->6.7.2. <A
+>4.7.2. <A
 HREF="coding.html#S37"
 >Provide a default case for all switch
     statements</A
 ></DT
 ><DT
->6.7.3. <A
+>4.7.3. <A
 HREF="coding.html#S38"
 >Try to avoid falling through cases in a
     switch statement.</A
 ></DT
 ><DT
->6.7.4. <A
+>4.7.4. <A
 HREF="coding.html#S39"
 >Use 'long' or 'short' Instead of
     'int'</A
 ></DT
 ><DT
->6.7.5. <A
+>4.7.5. <A
 HREF="coding.html#S40"
 >Don't mix size_t and other types</A
 ></DT
 ><DT
->6.7.6. <A
+>4.7.6. <A
 HREF="coding.html#S41"
 >Declare each variable and struct on its
     own line.</A
 ></DT
 ><DT
->6.7.7. <A
+>4.7.7. <A
 HREF="coding.html#S42"
 >Use malloc/zalloc sparingly</A
 ></DT
 ><DT
->6.7.8. <A
+>4.7.8. <A
 HREF="coding.html#S43"
 >The Programmer Who Uses 'malloc' is
     Responsible for Ensuring 'free'</A
 ></DT
 ><DT
->6.7.9. <A
+>4.7.9. <A
 HREF="coding.html#S44"
 >Add loaders to the `file_list' structure
     and in order</A
 ></DT
 ><DT
->6.7.10. <A
+>4.7.10. <A
 HREF="coding.html#S45"
 >"Uncertain" new code and/or changes to
     existing code, use FIXME</A
@@ -428,7 +427,7 @@ HREF="coding.html#S45"
 ></DL
 ></DD
 ><DT
->6.8. <A
+>4.8. <A
 HREF="coding.html#S46"
 >Addendum: Template for files and function
     comment blocks:</A
@@ -436,193 +435,182 @@ HREF="coding.html#S46"
 ></DL
 ></DD
 ><DT
->7. <A
+>5. <A
 HREF="testing.html"
 >Testing Guidelines</A
 ></DT
 ><DD
 ><DL
 ><DT
->7.1. <A
+>5.1. <A
 HREF="testing.html#TESTING-PLAN"
 >Testplan for releases</A
 ></DT
 ><DT
->7.2. <A
+>5.2. <A
 HREF="testing.html#TESTING-REPORT"
 >Test reports</A
 ></DT
 ></DL
 ></DD
 ><DT
->8. <A
+>6. <A
 HREF="newrelease.html"
 >Releasing a New Version</A
 ></DT
 ><DD
 ><DL
 ><DT
->8.1. <A
+>6.1. <A
 HREF="newrelease.html#VERSIONNUMBERS"
 >Version numbers</A
 ></DT
 ><DT
->8.2. <A
+>6.2. <A
 HREF="newrelease.html#BEFORERELEASE"
 >Before the Release: Freeze</A
 ></DT
 ><DT
->8.3. <A
+>6.3. <A
 HREF="newrelease.html#THERELEASE"
 >Building and Releasing the Packages</A
 ></DT
 ><DD
 ><DL
 ><DT
->8.3.1. <A
+>6.3.1. <A
 HREF="newrelease.html#NEWRELEASE-TARBALL"
 >Source Tarball</A
 ></DT
 ><DT
->8.3.2. <A
+>6.3.2. <A
 HREF="newrelease.html#NEWRELEASE-RPM"
 >SuSE or Red Hat RPM</A
 ></DT
 ><DT
->8.3.3. <A
+>6.3.3. <A
 HREF="newrelease.html#NEWRELEASE-OS2"
 >OS/2</A
 ></DT
 ><DT
->8.3.4. <A
+>6.3.4. <A
 HREF="newrelease.html#NEWRELEASE-SOLARIS"
 >Solaris</A
 ></DT
 ><DT
->8.3.5. <A
+>6.3.5. <A
 HREF="newrelease.html#NEWRELEASE-WINDOWS"
 >Windows</A
 ></DT
 ><DT
->8.3.6. <A
+>6.3.6. <A
 HREF="newrelease.html#NEWRELEASE-DEBIAN"
 >Debian</A
 ></DT
 ><DT
->8.3.7. <A
+>6.3.7. <A
 HREF="newrelease.html#NEWRELEASE-MACOSX"
 >Mac OSX</A
 ></DT
 ><DT
->8.3.8. <A
+>6.3.8. <A
 HREF="newrelease.html#NEWRELEASE-FREEBSD"
 >FreeBSD</A
 ></DT
 ><DT
->8.3.9. <A
+>6.3.9. <A
 HREF="newrelease.html#NEWRELEASE-HPUX"
 >HP-UX 11</A
 ></DT
 ><DT
->8.3.10. <A
+>6.3.10. <A
 HREF="newrelease.html#NEWRELEASE-AMIGA"
 >Amiga OS</A
 ></DT
 ><DT
->8.3.11. <A
+>6.3.11. <A
 HREF="newrelease.html#NEWRELEASE-AIX"
 >AIX</A
 ></DT
 ></DL
 ></DD
 ><DT
->8.4. <A
+>6.4. <A
 HREF="newrelease.html#RELEASING"
 >Uploading and Releasing Your Package</A
 ></DT
 ><DT
->8.5. <A
+>6.5. <A
 HREF="newrelease.html#AFTERRELEASE"
 >After the Release</A
 ></DT
 ></DL
 ></DD
 ><DT
->9. <A
+>7. <A
 HREF="webserver-update.html"
 >Update the Webserver</A
 ></DT
 ><DT
->10. <A
+>8. <A
 HREF="contact.html"
 >Contacting the developers, Bug Reporting and Feature Requests</A
 ></DT
 ><DD
 ><DL
 ><DT
->10.1. <A
+>8.1. <A
 HREF="contact.html#CONTACT-SUPPORT"
 >Get Support</A
 ></DT
 ><DT
->10.2. <A
+>8.2. <A
 HREF="contact.html#CONTACT-BUGS"
 >Report bugs</A
 ></DT
 ><DT
->10.3. <A
+>8.3. <A
 HREF="contact.html#CONTACT-FEATURE"
 >Request new features</A
 ></DT
 ><DT
->10.4. <A
+>8.4. <A
 HREF="contact.html#CONTACT-ADS"
 >Report ads or other filter problems</A
 ></DT
 ><DT
->10.5. <A
+>8.5. <A
 HREF="contact.html#CONTACT-OTHER"
 >Other</A
 ></DT
 ></DL
 ></DD
 ><DT
->11. <A
+>9. <A
 HREF="copyright.html"
 >Copyright and History</A
 ></DT
 ><DD
 ><DL
 ><DT
->11.1. <A
-HREF="copyright.html#AEN1060"
+>9.1. <A
+HREF="copyright.html#AEN1057"
 >Copyright</A
 ></DT
 ><DT
->11.2. <A
-HREF="copyright.html#AEN1067"
+>9.2. <A
+HREF="copyright.html#AEN1064"
 >History</A
 ></DT
 ></DL
 ></DD
 ><DT
->12. <A
+>10. <A
 HREF="seealso.html"
 >See also</A
 ></DT
 ></DL
 ></DIV
-><DIV
-CLASS="SECT1"
-><H1
-CLASS="SECT1"
-><A
-NAME="INTRO"
-></A
-></H1
-><P
-> </P
-></DIV
 ></DIV
 ><DIV
 CLASS="NAVFOOTER"
index 1ea3637..b4bcd2b 100644 (file)
@@ -13,8 +13,8 @@ REL="PREVIOUS"
 TITLE="Privoxy Developer Manual"
 HREF="index.html"><LINK
 REL="NEXT"
-TITLE="Quickstart to Privoxy Development"
-HREF="quickstart.html"><LINK
+TITLE="The CVS Repository"
+HREF="cvs.html"><LINK
 REL="STYLESHEET"
 TYPE="text/css"
 HREF="../p_doc.css"></HEAD
@@ -57,7 +57,7 @@ WIDTH="10%"
 ALIGN="right"
 VALIGN="bottom"
 ><A
-HREF="quickstart.html"
+HREF="cvs.html"
 >Next</A
 ></TD
 ></TR
@@ -98,6 +98,32 @@ CLASS="APPLICATION"
 >     One does not have to be a programmer to contribute. Packaging, testing,
      and porting, are all important jobs as well.
     </P
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="QUICKSTART"
+>1.1. Quickstart to Privoxy Development</A
+></H2
+><P
+>      You'll need an account on <A
+HREF="http://sourceforge.net/"
+TARGET="_top"
+>Sourceforge</A
+> to support our
+      development.  Mail your ID to <A
+HREF="mailto:developers@privoxy.org"
+TARGET="_top"
+>the list</A
+> and wait until a
+      project manager has added you.
+    </P
+><P
+>      For the time being (read, this section is under construction), please
+      refer to the extensive comments in the source code.
+    </P
+></DIV
 ></DIV
 ><DIV
 CLASS="NAVFOOTER"
@@ -130,7 +156,7 @@ WIDTH="33%"
 ALIGN="right"
 VALIGN="top"
 ><A
-HREF="quickstart.html"
+HREF="cvs.html"
 >Next</A
 ></TD
 ></TR
@@ -149,7 +175,7 @@ VALIGN="top"
 WIDTH="33%"
 ALIGN="right"
 VALIGN="top"
->Quickstart to Privoxy Development</TD
+>The CVS Repository</TD
 ></TR
 ></TABLE
 ></DIV
index 81cad14..62721d3 100644 (file)
@@ -71,7 +71,7 @@ CLASS="SECT1"
 CLASS="SECT1"
 ><A
 NAME="NEWRELEASE"
->8. Releasing a New Version</A
+>6. Releasing a New Version</A
 ></H1
 ><P
 >        When we release versions of <SPAN
@@ -108,7 +108,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="VERSIONNUMBERS"
->8.1. Version numbers</A
+>6.1. Version numbers</A
 ></H2
 ><P
 >      First you need to determine which version number the release will have. 
@@ -177,7 +177,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="BEFORERELEASE"
->8.2. Before the Release: Freeze</A
+>6.2. Before the Release: Freeze</A
 ></H2
 ><P
 >       The following <I
@@ -315,7 +315,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="THERELEASE"
->8.3. Building and Releasing the Packages</A
+>6.3. Building and Releasing the Packages</A
 ></H2
 ><P
 >      Now the individual packages can be built and released. Note that for
@@ -369,7 +369,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="NEWRELEASE-TARBALL"
->8.3.1. Source Tarball</A
+>6.3.1. Source Tarball</A
 ></H3
 ><P
 >      First, <I
@@ -446,7 +446,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="NEWRELEASE-RPM"
->8.3.2. SuSE or Red Hat RPM</A
+>6.3.2. SuSE or Red Hat RPM</A
 ></H3
 ><P
 >        In following text, replace <TT
@@ -591,7 +591,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="NEWRELEASE-OS2"
->8.3.3. OS/2</A
+>6.3.3. OS/2</A
 ></H3
 ><P
 >      First, <I
@@ -725,7 +725,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="NEWRELEASE-SOLARIS"
->8.3.4. Solaris</A
+>6.3.4. Solaris</A
 ></H3
 ><P
 >      Login to Sourceforge's compilefarm via ssh:
@@ -805,7 +805,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="NEWRELEASE-WINDOWS"
->8.3.5. Windows</A
+>6.3.5. Windows</A
 ></H3
 ><P
 >        You should ensure you have the latest version of Cygwin (from
@@ -882,7 +882,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="NEWRELEASE-DEBIAN"
->8.3.6. Debian</A
+>6.3.6. Debian</A
 ></H3
 ><P
 >      First, <I
@@ -918,7 +918,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="NEWRELEASE-MACOSX"
->8.3.7. Mac OSX</A
+>6.3.7. Mac OSX</A
 ></H3
 ><P
 >      First, <I
@@ -1023,7 +1023,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="NEWRELEASE-FREEBSD"
->8.3.8. FreeBSD</A
+>6.3.8. FreeBSD</A
 ></H3
 ><P
 >      Login to Sourceforge's compilefarm via ssh:
@@ -1103,7 +1103,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="NEWRELEASE-HPUX"
->8.3.9. HP-UX 11</A
+>6.3.9. HP-UX 11</A
 ></H3
 ><P
 >      First, <I
@@ -1139,7 +1139,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="NEWRELEASE-AMIGA"
->8.3.10. Amiga OS</A
+>6.3.10. Amiga OS</A
 ></H3
 ><P
 >      First, <I
@@ -1175,7 +1175,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="NEWRELEASE-AIX"
->8.3.11. AIX</A
+>6.3.11. AIX</A
 ></H3
 ><P
 >      Login to Sourceforge's compilefarm via ssh:
@@ -1256,7 +1256,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="RELEASING"
->8.4. Uploading and Releasing Your Package</A
+>6.4. Uploading and Releasing Your Package</A
 ></H2
 ><P
 >      After the package is ready, it is time to upload it 
@@ -1312,7 +1312,7 @@ CLASS="LITERAL"
 >$VERSION ($CODE_STATUS)</TT
 >, e.g. <I
 CLASS="EMPHASIS"
->2.9.14
+>2.9.15
      (beta)</I
 >.
     </P
@@ -1358,7 +1358,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="AFTERRELEASE"
->8.5. After the Release</A
+>6.5. After the Release</A
 ></H2
 ><P
 >      When all (or: most of the) packages have been uploaded and made available,
index a6bc4ad..1dc8fce 100644 (file)
@@ -65,7 +65,7 @@ CLASS="SECT1"
 CLASS="SECT1"
 ><A
 NAME="SEEALSO"
->12. See also</A
+>10. See also</A
 ></H1
 ><P
 > Other references and sites of interest to <SPAN
index e40b5fd..d957a18 100644 (file)
@@ -71,7 +71,7 @@ CLASS="SECT1"
 CLASS="SECT1"
 ><A
 NAME="TESTING"
->7. Testing Guidelines</A
+>5. Testing Guidelines</A
 ></H1
 ><P
 >To be filled.</P
@@ -81,7 +81,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="TESTING-PLAN"
->7.1. Testplan for releases</A
+>5.1. Testplan for releases</A
 ></H2
 ><P
 >       Explain release numbers. major, minor. developer releases. etc.
@@ -156,7 +156,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="TESTING-REPORT"
->7.2. Test reports</A
+>5.2. Test reports</A
 ></H2
 ><P
 >Please submit test reports only with the <A
index 90976c4..5112a56 100644 (file)
@@ -71,7 +71,7 @@ CLASS="SECT1"
 CLASS="SECT1"
 ><A
 NAME="WEBSERVER-UPDATE"
->9. Update the Webserver</A
+>7. Update the Webserver</A
 ></H1
 ><P
 >    When updating the webserver, please follow these steps to make
index 45bfeac..d575d16 100644 (file)
@@ -105,7 +105,7 @@ CLASS="SECT2"
 ><H3
 CLASS="SECT2"
 ><A
-NAME="AEN237"
+NAME="AEN232"
 >3.2. What is an <SPAN
 CLASS="QUOTE"
 >"actions"</SPAN
@@ -165,7 +165,7 @@ CLASS="SECT2"
 ><H3
 CLASS="SECT2"
 ><A
-NAME="AEN252"
+NAME="AEN247"
 >3.4. How are actions files configured? What is the easiest
 way to do this?</A
 ></H3
@@ -202,7 +202,7 @@ CLASS="SECT2"
 ><H3
 CLASS="SECT2"
 ><A
-NAME="AEN260"
+NAME="AEN255"
 >3.5. There are several different <SPAN
 CLASS="QUOTE"
 >"actions"</SPAN
@@ -306,7 +306,7 @@ CLASS="SECT2"
 ><H3
 CLASS="SECT2"
 ><A
-NAME="AEN286"
+NAME="AEN281"
 >3.7. What is <SPAN
 CLASS="QUOTE"
 >"default.filter"</SPAN
@@ -356,7 +356,7 @@ CLASS="SECT2"
 ><H3
 CLASS="SECT2"
 ><A
-NAME="AEN299"
+NAME="AEN294"
 >3.8. How can I set up <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
@@ -409,7 +409,7 @@ CLASS="SECT2"
 ><H3
 CLASS="SECT2"
 ><A
-NAME="AEN311"
+NAME="AEN306"
 >3.9. Instead of ads, now I get a checkerboard pattern. I don't want to see anything.</A
 ></H3
 ><P
@@ -484,7 +484,7 @@ CLASS="SECT2"
 ><H3
 CLASS="SECT2"
 ><A
-NAME="AEN330"
+NAME="AEN325"
 >3.10. Why would anybody want to see a checkerboard pattern?</A
 ></H3
 ><P
@@ -505,7 +505,7 @@ CLASS="SECT2"
 ><H3
 CLASS="SECT2"
 ><A
-NAME="AEN335"
+NAME="AEN330"
 >3.11. I see large red banners on some pages that say 
 <SPAN
 CLASS="QUOTE"
@@ -704,7 +704,49 @@ HREF="../user-manual/config.html#FORWARDING"
 TARGET="_top"
 >user manual</A
 >, 
- which describes how to do this.&#13;</P
+ which describes how to do this.</P
+></DIV
+><DIV
+CLASS="SECT2"
+><H3
+CLASS="SECT2"
+><A
+NAME="TRANSPARENT"
+>3.15. Can <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> run as a <SPAN
+CLASS="QUOTE"
+>"transparent"</SPAN
+> proxy?</A
+></H3
+><P
+> No, <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> 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
+ <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> is now capable of.</P
+><P
+> Chaining <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> with another proxy that has 
+ this ability should work though. 
+ See the <A
+HREF="../user-manual/config.html#FORWARDING"
+TARGET="_top"
+>user
+ manual</A
+>, which describes this, and also <A
+HREF="http://www.transproxy.nlc.net.au/"
+TARGET="_top"
+>http://www.transproxy.nlc.net.au/</A
+>.</P
 ></DIV
 ></DIV
 ><DIV
index 6a1d6e4..bc2f42c 100644 (file)
@@ -71,7 +71,7 @@ CLASS="SECT1"
 CLASS="SECT1"
 ><A
 NAME="CONTACT"
->7. Contacting the developers, Bug Reporting and Feature Requests</A
+>6. Contacting the developers, Bug Reporting and Feature Requests</A
 ></H1
 ><P
 > We value your feedback. However, to provide you with the best support, please
@@ -82,7 +82,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="CONTACT-SUPPORT"
->7.1. Get Support</A
+>6.1. Get Support</A
 ></H2
 ><P
 >   <P
@@ -103,7 +103,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="CONTACT-BUGS"
->7.2. Report bugs</A
+>6.2. Report bugs</A
 ></H2
 ><P
 >   <P
@@ -141,7 +141,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="CONTACT-FEATURE"
->7.3. Request new features</A
+>6.3. Request new features</A
 ></H2
 ><P
 >   <P
@@ -162,7 +162,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="CONTACT-ADS"
->7.4. Report ads or other filter problems</A
+>6.4. Report ads or other filter problems</A
 ></H2
 ><P
 >You can also send feedback on websites that Privoxy has problems with. Please bookmark
@@ -194,7 +194,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="CONTACT-OTHER"
->7.5. Other</A
+>6.5. Other</A
 ></H2
 ><P
 >   <P
index 3a57b94..10c1fc6 100644 (file)
@@ -65,15 +65,15 @@ CLASS="SECT1"
 CLASS="SECT1"
 ><A
 NAME="COPYRIGHT"
->8. Copyright and History</A
+>7. Copyright and History</A
 ></H1
 ><DIV
 CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="AEN631"
->8.1. Copyright</A
+NAME="AEN637"
+>7.1. Copyright</A
 ></H2
 ><P
 > <SPAN
@@ -106,8 +106,8 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="AEN638"
->8.2. History</A
+NAME="AEN644"
+>7.2. History</A
 ></H2
 ><P
 > <SPAN
index 9a1eb46..d3e9aad 100644 (file)
@@ -142,7 +142,7 @@ CLASS="SECT2"
 ><H3
 CLASS="SECT2"
 ><A
-NAME="AEN42"
+NAME="AEN39"
 >1.2. Why <SPAN
 CLASS="QUOTE"
 >"Privoxy"</SPAN
@@ -253,12 +253,6 @@ NAME="FEATURES"
 ><UL
 ><LI
 ><P
->  FIXME: complete the list of features. change the order: most important
-  features to the top of the list. prefix new features with "NEW".
-  </P
-></LI
-><LI
-><P
 >   Integrated browser based configuration and control utility at <A
 HREF="http://config.privoxy.org/"
 TARGET="_top"
@@ -274,7 +268,18 @@ TARGET="_top"
 ></LI
 ><LI
 ><P
->    Blocking of annoying pop-up browser windows.
+>   Web page content filtering (removes banners based on size,
+   invisible <SPAN
+CLASS="QUOTE"
+>"web-bugs"</SPAN
+>, JavaScript and HTML annoyances, pop-up windows, etc.)
+  </P
+></LI
+><LI
+><P
+>   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.
   </P
 ></LI
 ><LI
@@ -286,21 +291,17 @@ TARGET="_top"
 ><P
 >   Support for Perl Compatible Regular Expressions in the configuration files, and 
    generally a more sophisticated and flexible configuration syntax over
-   previous versions. 
+   previous versions.
   </P
 ></LI
 ><LI
 ><P
->   GIF de-animation. 
+>   Improved cookie management features (e.g. session based cookies).
   </P
 ></LI
 ><LI
 ><P
->   Web page content filtering (removes banners based on size,
-   invisible <SPAN
-CLASS="QUOTE"
->"web-bugs"</SPAN
->, JavaScript and HTML annoyances, pop-ups, etc.)
+>   GIF de-animation. 
   </P
 ></LI
 ><LI
@@ -315,17 +316,12 @@ CLASS="QUOTE"
 ></LI
 ><LI
 ><P
->   Auto-detection and re-reading of config file changes.
+>   User-customizable HTML templates for all proxy-generated pages (e.g. "blocked" page).
   </P
 ></LI
 ><LI
 ><P
->   User-customizable HTML templates (e.g. 404 error page).
-  </P
-></LI
-><LI
-><P
->   Improved cookie management features (e.g. session based cookies).
+>   Auto-detection and re-reading of config file changes.
   </P
 ></LI
 ><LI
@@ -420,7 +416,7 @@ CLASS="SECT2"
 ><H3
 CLASS="SECT2"
 ><A
-NAME="AEN122"
+NAME="AEN117"
 >1.6. How does <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
@@ -474,7 +470,7 @@ CLASS="SECT2"
 ><H3
 CLASS="SECT2"
 ><A
-NAME="AEN134"
+NAME="AEN129"
 >1.7. Can <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
@@ -495,7 +491,7 @@ CLASS="APPLICATION"
  includes tools to help identify these types of situations so they can be
  addressed as needed, allowing you to customize your installation.
  (<A
-HREF="trouble.html#AEN570"
+HREF="trouble.html#AEN576"
 >See the Troubleshooting section below</A
 >.)</P
 ></DIV
index 1ebd80e..a75ced4 100644 (file)
@@ -49,7 +49,7 @@ CLASS="ORGNAME"
 ></DIV
 ><P
 CLASS="PUBDATE"
->$Id: faq.sgml,v 1.52 2002/04/29 03:08:43 hal9 Exp $<BR></P
+>$Id: faq.sgml,v 1.55 2002/05/04 00:41:56 hal9 Exp $<BR></P
 ><DIV
 ><DIV
 CLASS="ABSTRACT"
@@ -114,11 +114,6 @@ CLASS="TOC"
 >Table of Contents</B
 ></DT
 ><DT
-><A
-HREF="index.html#INTRO"
-></A
-></DT
-><DT
 >1. <A
 HREF="general.html"
 >General Information</A
@@ -135,7 +130,7 @@ CLASS="APPLICATION"
 ></DT
 ><DT
 >1.2. <A
-HREF="general.html#AEN42"
+HREF="general.html#AEN39"
 >Why <SPAN
 CLASS="QUOTE"
 >"Privoxy"</SPAN
@@ -172,7 +167,7 @@ CLASS="APPLICATION"
 ></DT
 ><DT
 >1.6. <A
-HREF="general.html#AEN122"
+HREF="general.html#AEN117"
 >How does <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
@@ -181,7 +176,7 @@ an ad, and what is not?</A
 ></DT
 ><DT
 >1.7. <A
-HREF="general.html#AEN134"
+HREF="general.html#AEN129"
 >Can <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
@@ -262,7 +257,7 @@ CLASS="APPLICATION"
 ></DT
 ><DT
 >2.4. <A
-HREF="installation.html#AEN194"
+HREF="installation.html#AEN189"
 >I just installed <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
@@ -279,7 +274,7 @@ CLASS="APPLICATION"
 ></DT
 ><DT
 >2.6. <A
-HREF="installation.html#AEN219"
+HREF="installation.html#AEN214"
 >I just installed <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
@@ -302,7 +297,7 @@ HREF="configuration.html#NEWCONFIG"
 ></DT
 ><DT
 >3.2. <A
-HREF="configuration.html#AEN237"
+HREF="configuration.html#AEN232"
 >What is an <SPAN
 CLASS="QUOTE"
 >"actions"</SPAN
@@ -322,13 +317,13 @@ CLASS="QUOTE"
 ></DT
 ><DT
 >3.4. <A
-HREF="configuration.html#AEN252"
+HREF="configuration.html#AEN247"
 >How are actions files configured? What is the easiest
 way to do this?</A
 ></DT
 ><DT
 >3.5. <A
-HREF="configuration.html#AEN260"
+HREF="configuration.html#AEN255"
 >There are several different <SPAN
 CLASS="QUOTE"
 >"actions"</SPAN
@@ -343,7 +338,7 @@ browser? Does that not raise security issues?</A
 ></DT
 ><DT
 >3.7. <A
-HREF="configuration.html#AEN286"
+HREF="configuration.html#AEN281"
 >What is <SPAN
 CLASS="QUOTE"
 >"default.filter"</SPAN
@@ -351,7 +346,7 @@ CLASS="QUOTE"
 ></DT
 ><DT
 >3.8. <A
-HREF="configuration.html#AEN299"
+HREF="configuration.html#AEN294"
 >How can I set up <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
@@ -360,17 +355,17 @@ CLASS="APPLICATION"
 ></DT
 ><DT
 >3.9. <A
-HREF="configuration.html#AEN311"
+HREF="configuration.html#AEN306"
 >Instead of ads, now I get a checkerboard pattern. I don't want to see anything.</A
 ></DT
 ><DT
 >3.10. <A
-HREF="configuration.html#AEN330"
+HREF="configuration.html#AEN325"
 >Why would anybody want to see a checkerboard pattern?</A
 ></DT
 ><DT
 >3.11. <A
-HREF="configuration.html#AEN335"
+HREF="configuration.html#AEN330"
 >I see large red banners on some pages that say 
 <SPAN
 CLASS="QUOTE"
@@ -406,6 +401,17 @@ CLASS="APPLICATION"
 >Squid</SPAN
 >?</A
 ></DT
+><DT
+>3.15. <A
+HREF="configuration.html#TRANSPARENT"
+>Can <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> run as a <SPAN
+CLASS="QUOTE"
+>"transparent"</SPAN
+> proxy?</A
+></DT
 ></DL
 ></DD
 ><DT
@@ -417,7 +423,7 @@ HREF="misc.html"
 ><DL
 ><DT
 >4.1. <A
-HREF="misc.html#AEN388"
+HREF="misc.html#AEN394"
 >How much does <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
@@ -452,7 +458,7 @@ HREF="misc.html#IP"
 ></DT
 ><DT
 >4.7. <A
-HREF="misc.html#AEN439"
+HREF="misc.html#AEN445"
 >Can <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
@@ -460,13 +466,13 @@ CLASS="APPLICATION"
 ></DT
 ><DT
 >4.8. <A
-HREF="misc.html#AEN450"
+HREF="misc.html#AEN456"
 >Might some things break because header information is
 being altered?</A
 ></DT
 ><DT
 >4.9. <A
-HREF="misc.html#AEN460"
+HREF="misc.html#AEN466"
 >Can <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
@@ -478,7 +484,7 @@ speed up web browsing?</A
 ></DT
 ><DT
 >4.10. <A
-HREF="misc.html#AEN468"
+HREF="misc.html#AEN474"
 >What about as a firewall? Can <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
@@ -486,7 +492,7 @@ CLASS="APPLICATION"
 ></DT
 ><DT
 >4.11. <A
-HREF="misc.html#AEN473"
+HREF="misc.html#AEN479"
 >The <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
@@ -495,13 +501,13 @@ and ugly looking. Can't a better font be used?</A
 ></DT
 ><DT
 >4.12. <A
-HREF="misc.html#AEN482"
+HREF="misc.html#AEN488"
 >I have large empty spaces now where ads used to be. 
 Why?</A
 ></DT
 ><DT
 >4.13. <A
-HREF="misc.html#AEN485"
+HREF="misc.html#AEN491"
 >How can <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
@@ -509,7 +515,7 @@ CLASS="APPLICATION"
 ></DT
 ><DT
 >4.14. <A
-HREF="misc.html#AEN492"
+HREF="misc.html#AEN498"
 ><SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
@@ -547,7 +553,7 @@ HREF="trouble.html"
 ><DL
 ><DT
 >5.1. <A
-HREF="trouble.html#AEN551"
+HREF="trouble.html#AEN557"
 >I just upgraded and am getting <SPAN
 CLASS="QUOTE"
 >"connection refused"</SPAN
@@ -556,13 +562,13 @@ with every web page?</A
 ></DT
 ><DT
 >5.2. <A
-HREF="trouble.html#AEN564"
+HREF="trouble.html#AEN570"
 >I just added a new rule, but the steenkin ad is 
 still getting through. How?</A
 ></DT
 ><DT
 >5.3. <A
-HREF="trouble.html#AEN570"
+HREF="trouble.html#AEN576"
 >One of my favorite sites does not work with <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
@@ -572,71 +578,60 @@ What can I do?</A
 ></DL
 ></DD
 ><DT
->7. <A
+>6. <A
 HREF="contact.html"
 >Contacting the developers, Bug Reporting and Feature Requests</A
 ></DT
 ><DD
 ><DL
 ><DT
->7.1. <A
+>6.1. <A
 HREF="contact.html#CONTACT-SUPPORT"
 >Get Support</A
 ></DT
 ><DT
->7.2. <A
+>6.2. <A
 HREF="contact.html#CONTACT-BUGS"
 >Report bugs</A
 ></DT
 ><DT
->7.3. <A
+>6.3. <A
 HREF="contact.html#CONTACT-FEATURE"
 >Request new features</A
 ></DT
 ><DT
->7.4. <A
+>6.4. <A
 HREF="contact.html#CONTACT-ADS"
 >Report ads or other filter problems</A
 ></DT
 ><DT
->7.5. <A
+>6.5. <A
 HREF="contact.html#CONTACT-OTHER"
 >Other</A
 ></DT
 ></DL
 ></DD
 ><DT
->8. <A
+>7. <A
 HREF="copyright.html"
 >Copyright and History</A
 ></DT
 ><DD
 ><DL
 ><DT
->8.1. <A
-HREF="copyright.html#AEN631"
+>7.1. <A
+HREF="copyright.html#AEN637"
 >Copyright</A
 ></DT
 ><DT
->8.2. <A
-HREF="copyright.html#AEN638"
+>7.2. <A
+HREF="copyright.html#AEN644"
 >History</A
 ></DT
 ></DL
 ></DD
 ></DL
 ></DIV
-><DIV
-CLASS="SECT1"
-><H1
-CLASS="SECT1"
-><A
-NAME="INTRO"
-></A
-></H1
-><P
-> </P
-></DIV
 ></DIV
 ><DIV
 CLASS="NAVFOOTER"
index 6b7a009..c311e10 100644 (file)
@@ -176,7 +176,7 @@ CLASS="SECT2"
 ><H3
 CLASS="SECT2"
 ><A
-NAME="AEN194"
+NAME="AEN189"
 >2.4. I just installed <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
@@ -277,7 +277,7 @@ CLASS="SECT2"
 ><H3
 CLASS="SECT2"
 ><A
-NAME="AEN219"
+NAME="AEN214"
 >2.6. I just installed <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
index 5f686cc..5b5545a 100644 (file)
@@ -78,7 +78,7 @@ CLASS="SECT2"
 ><H3
 CLASS="SECT2"
 ><A
-NAME="AEN388"
+NAME="AEN394"
 >4.1. How much does <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
@@ -201,7 +201,7 @@ CLASS="APPLICATION"
 ><P
 > 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).</P
+ you should really consider upgrading to 2.9.15).</P
 ></DIV
 ><DIV
 CLASS="SECT2"
@@ -280,7 +280,7 @@ CLASS="SECT2"
 ><H3
 CLASS="SECT2"
 ><A
-NAME="AEN439"
+NAME="AEN445"
 >4.7. Can <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
@@ -326,7 +326,7 @@ CLASS="SECT2"
 ><H3
 CLASS="SECT2"
 ><A
-NAME="AEN450"
+NAME="AEN456"
 >4.8. Might some things break because header information is
 being altered?</A
 ></H3
@@ -372,7 +372,7 @@ CLASS="SECT2"
 ><H3
 CLASS="SECT2"
 ><A
-NAME="AEN460"
+NAME="AEN466"
 >4.9. Can <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
@@ -403,7 +403,7 @@ CLASS="SECT2"
 ><H3
 CLASS="SECT2"
 ><A
-NAME="AEN468"
+NAME="AEN474"
 >4.10. What about as a firewall? Can <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
@@ -422,7 +422,7 @@ CLASS="SECT2"
 ><H3
 CLASS="SECT2"
 ><A
-NAME="AEN473"
+NAME="AEN479"
 >4.11. The <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
@@ -458,7 +458,7 @@ CLASS="SECT2"
 ><H3
 CLASS="SECT2"
 ><A
-NAME="AEN482"
+NAME="AEN488"
 >4.12. I have large empty spaces now where ads used to be. 
 Why?</A
 ></H3
@@ -474,7 +474,7 @@ CLASS="SECT2"
 ><H3
 CLASS="SECT2"
 ><A
-NAME="AEN485"
+NAME="AEN491"
 >4.13. How can <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
@@ -504,7 +504,7 @@ CLASS="SECT2"
 ><H3
 CLASS="SECT2"
 ><A
-NAME="AEN492"
+NAME="AEN498"
 >4.14. <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
index af935ba..e6ef887 100644 (file)
@@ -78,7 +78,7 @@ CLASS="SECT2"
 ><H3
 CLASS="SECT2"
 ><A
-NAME="AEN551"
+NAME="AEN557"
 >5.1. I just upgraded and am getting <SPAN
 CLASS="QUOTE"
 >"connection refused"</SPAN
@@ -128,7 +128,7 @@ CLASS="SECT2"
 ><H3
 CLASS="SECT2"
 ><A
-NAME="AEN564"
+NAME="AEN570"
 >5.2. I just added a new rule, but the steenkin ad is 
 still getting through. How?</A
 ></H3
@@ -155,7 +155,7 @@ CLASS="SECT2"
 ><H3
 CLASS="SECT2"
 ><A
-NAME="AEN570"
+NAME="AEN576"
 >5.3. One of my favorite sites does not work with <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
index c9c8c91..9998abf 100644 (file)
@@ -71,14 +71,14 @@ CLASS="SECT1"
 CLASS="SECT1"
 ><A
 NAME="ACTIONS-FILE"
->9. Actions Files</A
+>8. Actions Files</A
 ></H1
 ><P
 > The actions files are used to define what actions
  <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
-> takes for which URLs, and thus determines
+> takes for which URLs, and thus determine
  how ad images, cookies and various other aspects of HTTP content and
  transactions are handled, and on which sites (or even parts thereof). There 
  are three such files included with <SPAN
@@ -102,7 +102,12 @@ CLASS="FILENAME"
 CLASS="FILENAME"
 >default.action</TT
 >. These have increasing levels of
-      aggressiveness. It is not recommend to edit this file.
+      aggressiveness <I
+CLASS="EMPHASIS"
+>and have no influence on your browsing unless
+      you select them explicitly in the editor</I
+>. It is not recommend
+      to edit this file.
     </P
 ></LI
 ><LI
@@ -145,31 +150,60 @@ TARGET="_top"
 >http://config.privoxy.org/show-status</A
 >.</P
 ><P
-> An actions file typically has sections. Near the top, <SPAN
+> An actions file typically has multiple sections. If you want to use
+ <SPAN
 CLASS="QUOTE"
 >"aliases"</SPAN
-> are 
optionally defined (discussed <A
+> in an actions file, you have to place the (optional)
+ <A
 HREF="actions-file.html#ALIASES"
-TARGET="_top"
->below</A
->), then the default set of rules
- which will apply universally to all sites and pages. And then below that,
- exceptions to the defined universal policies. </P
+>alias section</A
+> at the top of that file.
+ Then comes the default set of rules which will apply universally to all
+ sites and pages (be <I
+CLASS="EMPHASIS"
+>very careful</I
+> with using such a
+ universal set in <TT
+CLASS="FILENAME"
+>user.action</TT
+> or any other actions file after 
+ <TT
+CLASS="FILENAME"
+>default.action</TT
+>, because it will override the result
+ from consulting any previous file). And then below that,
+ exceptions to the defined universal policies. You can regard
+ <TT
+CLASS="FILENAME"
+>user.action</TT
+> as an appendix to <TT
+CLASS="FILENAME"
+>default.action</TT
+>,
+ with the advantage that is a separate file, which makes preserving your
+ personal settings across <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> upgrades easier.</P
 ><P
 > 
  Actions can be used to block anything you want, including ads, banners, or
  just some obnoxious URL that you would rather not see. Cookies can be accepted
  or rejected, or accepted only during the current browser session (i.e. not
  written to disk), content can be modified, JavaScripts tamed, user-tracking
- fooled, and much more. See below for a complete list of actions.</P
+ fooled, and much more. See below for a <A
+HREF="actions-file.html#ACTIONS"
+>complete list
+ of actions</A
+>.</P
 ><DIV
 CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="AEN1309"
->9.1. Finding the Right Mix</A
+NAME="AEN1378"
+>8.1. Finding the Right Mix</A
 ></H2
 ><P
 > Note that some <A
@@ -202,30 +236,43 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="AEN1316"
->9.2. How to Edit</A
+NAME="AEN1385"
+>8.2. How to Edit</A
 ></H2
 ><P
-> The easiest way to edit the <SPAN
-CLASS="QUOTE"
->"actions"</SPAN
-> files is with a browser by
+> The easiest way to edit the actions files is with a browser by
  using our browser-based editor, which can be reached from <A
 HREF="http://config.privoxy.org/show-status"
 TARGET="_top"
 >http://config.privoxy.org/show-status</A
+>.
+ The editor allows both fine-grained control over every single feature on a
+ per-URL basis, and easy choosing from wholesale sets of defaults like
+ <SPAN
+CLASS="QUOTE"
+>"Cautious"</SPAN
+>, <SPAN
+CLASS="QUOTE"
+>"Medium"</SPAN
+> or <SPAN
+CLASS="QUOTE"
+>"Advanced"</SPAN
 >.</P
 ><P
 > If you prefer plain text editing to GUIs, you can of course also directly edit the
- the actions files.</P
+ the actions files. Look at <TT
+CLASS="FILENAME"
+>default.action</TT
+> which is richly
+ commented.</P
 ></DIV
 ><DIV
 CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="AEN1322"
->9.3. How Actions are Applied to URLs</A
+NAME="AEN1394"
+>8.3. How Actions are Applied to URLs</A
 ></H2
 ><P
 > Actions files are divided into sections. There are special sections,
@@ -242,7 +289,7 @@ HREF="actions-file.html#ALIASES"
  is a list of URL patterns, each on a separate line.</P
 ><P
 > To determine which actions apply to a request, the URL of the request is
- compared to all patterns in this file. Every time it matches, the list of
+ compared to all patterns in each action file file. Every time it matches, the list of
  applicable actions for the URL is incrementally updated, using the heading
  of the section in which the pattern is located. If multiple matches for
  the same URL set the same action differently, the last match wins. If not, 
@@ -265,7 +312,7 @@ CLASS="QUOTE"
 > actions).
  </P
 ><P
-> You can trace this process by visiting <A
+> You can trace this process for any given URL by visiting <A
 HREF="http://config.privoxy.org/show-url-info"
 TARGET="_top"
 >http://config.privoxy.org/show-url-info</A
@@ -281,8 +328,8 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="AEN1336"
->9.4. Patterns</A
+NAME="AEN1408"
+>8.4. Patterns</A
 ></H2
 ><P
 > Generally, a pattern has the form <TT
@@ -388,8 +435,8 @@ CLASS="SECT3"
 ><H3
 CLASS="SECT3"
 ><A
-NAME="AEN1376"
->9.4.1. The Domain Pattern</A
+NAME="AEN1448"
+>8.4.1. The Domain Pattern</A
 ></H3
 ><P
 > The matching of the domain part offers some flexible options: if the
@@ -562,8 +609,8 @@ CLASS="SECT3"
 ><H3
 CLASS="SECT3"
 ><A
-NAME="AEN1438"
->9.4.2. The Path Pattern</A
+NAME="AEN1510"
+>8.4.2. The Path Pattern</A
 ></H3
 ><P
 > <SPAN
@@ -637,7 +684,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="ACTIONS"
->9.5. Actions</A
+>8.5. Actions</A
 ></H2
 ><P
 > All actions are disabled by default, until they are explicitly enabled
@@ -649,26 +696,46 @@ CLASS="QUOTE"
 CLASS="QUOTE"
 >"-"</SPAN
 >. So a
- <SPAN
-CLASS="QUOTE"
->"+action"</SPAN
+ <TT
+CLASS="LITERAL"
+>+action</TT
 > means <SPAN
 CLASS="QUOTE"
 >"do that action"</SPAN
 >, e.g.
- <SPAN
+ <TT
+CLASS="LITERAL"
+>+block</TT
+> means <SPAN
 CLASS="QUOTE"
->"+block"</SPAN
-> means please <SPAN
+>"please block URLs that match the
+ following patterns"</SPAN
+>, and <TT
+CLASS="LITERAL"
+>-block</TT
+> means <SPAN
 CLASS="QUOTE"
->"block the following URL
- patterns"</SPAN
->. </P
+>"don't
+ block URLs that match the following patterns, even if <TT
+CLASS="LITERAL"
+>+block</TT
+>
+ previously applied."</SPAN
+>&#13;</P
+><P
+> 
+ Again, actions are invoked by placing them on a line, enclosed in curly braces and
+ separated by whitespace, like in 
+ <TT
+CLASS="LITERAL"
+>{+some-action -some-other-action{some-parameter}}</TT
+>,
+ followed by a list of URL patterns, one per line, to which they apply.
+ Together, the actions line and the following pattern lines make up a section
+ of the actions file. </P
 ><P
 > 
- Actions are invoked by enclosing the action name in curly braces (e.g.
- {+some_action}), followed by a list of URLs (or patterns that match URLs) to
- which the action applies. There are three classes of actions: </P
+ There are three classes of actions:</P
 ><P
 > <P
 ></P
@@ -678,113 +745,190 @@ CLASS="QUOTE"
 >  
    Boolean, i.e the action can only be <SPAN
 CLASS="QUOTE"
->"on"</SPAN
+>"enabled"</SPAN
 > or
    <SPAN
 CLASS="QUOTE"
->"off"</SPAN
->. Examples: 
- </P
+>"disabled"</SPAN
+>. Syntax:
+  </P
+><P
+>   <TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="90%"
+><TR
+><TD
+><PRE
+CLASS="SCREEN"
+>  +<TT
+CLASS="REPLACEABLE"
+><I
+>name</I
+></TT
+>        # enable action <TT
+CLASS="REPLACEABLE"
+><I
+>name</I
+></TT
+>
+  -<TT
+CLASS="REPLACEABLE"
+><I
+>name</I
+></TT
+>        # disable action <TT
+CLASS="REPLACEABLE"
+><I
+>name</I
+></TT
+></PRE
+></TD
+></TR
+></TABLE
+>
+  </P
 ><P
->   <TT
+>  
+   Example: <TT
 CLASS="LITERAL"
->    <P
-CLASS="LITERALLAYOUT"
->&nbsp;&nbsp;<I
-CLASS="EMPHASIS"
->{+name}</I
->&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;enable&nbsp;this&nbsp;action<br>
-&nbsp;&nbsp;<I
-CLASS="EMPHASIS"
->{-name}</I
->&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;disable&nbsp;this&nbsp;action<br>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</P
-> 
-   </TT
+>+block</TT
 >
   </P
 ></LI
 ><LI
 ><P
 >  
-   Parameterized, e.g. <SPAN
-CLASS="QUOTE"
->"+/-hide-user-agent{ Mozilla 1.0 }"</SPAN
->, 
-   where some value is required in order to enable this type of action.
-   Examples:
+   Parameterized, where some value is required in order to enable this type of action.
+   Syntax:
+  </P
+><P
+>   <TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="90%"
+><TR
+><TD
+><PRE
+CLASS="SCREEN"
+>  +<TT
+CLASS="REPLACEABLE"
+><I
+>name</I
+></TT
+>{<TT
+CLASS="REPLACEABLE"
+><I
+>param</I
+></TT
+>}  # enable action and set parameter to <TT
+CLASS="REPLACEABLE"
+><I
+>param</I
+></TT
+>,
+               # overwriting parameter from previous match if necessary
+  -<TT
+CLASS="REPLACEABLE"
+><I
+>name</I
+></TT
+>         # disable action. The parameter can be omitted</PRE
+></TD
+></TR
+></TABLE
+>
+  </P
+><P
+>   Note that if the URL matches multiple positive forms of a parameterized action,
+   the last match wins, i.e. the params from earlier matches are simply ignored.
   </P
 ><P
->   <TT
+>  
+   Example: <TT
 CLASS="LITERAL"
->    <P
-CLASS="LITERALLAYOUT"
->&nbsp;&nbsp;<I
-CLASS="EMPHASIS"
->{+name{param}}</I
->&nbsp;&nbsp;#&nbsp;enable&nbsp;action&nbsp;and&nbsp;set&nbsp;parameter&nbsp;to&nbsp;<SPAN
-CLASS="QUOTE"
->"param"</SPAN
-><br>
-&nbsp;&nbsp;<I
-CLASS="EMPHASIS"
->{-name}</I
->&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;disable&nbsp;action&nbsp;(<SPAN
-CLASS="QUOTE"
->"parameter"</SPAN
->)&nbsp;can&nbsp;be&nbsp;omitted<br>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</P
-> 
-   </TT
+>+hide-user-agent{ Mozilla 1.0 }</TT
 >
   </P
 ></LI
 ><LI
 ><P
 >  
-  
-   Multi-value, e.g. <SPAN
-CLASS="QUOTE"
->"{+/-add-header{Name: value}}"</SPAN
-> or
-   <SPAN
-CLASS="QUOTE"
->"{+/-send-wafer{name=value}}"</SPAN
->), where some value needs to be defined
-   in addition to simply enabling the action. Examples:
+   Multi-value. These look exactly like parameterized actions,
+   but they behave differently: If the action applies multiple times to the
+   same URL, but with different parameters, <I
+CLASS="EMPHASIS"
+>all</I
+> the parameters
+   from <I
+CLASS="EMPHASIS"
+>all</I
+> matches are remembered. This is used for actions
+   that can be executed for the same request repeatedly, like adding multiple
+   headers, or filtering through multiple filters. Syntax:
+  </P
+><P
+>   <TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="90%"
+><TR
+><TD
+><PRE
+CLASS="SCREEN"
+>  +<TT
+CLASS="REPLACEABLE"
+><I
+>name</I
+></TT
+>{<TT
+CLASS="REPLACEABLE"
+><I
+>param</I
+></TT
+>}   # enable action and add <TT
+CLASS="REPLACEABLE"
+><I
+>param</I
+></TT
+> to the list of parameters
+  -<TT
+CLASS="REPLACEABLE"
+><I
+>name</I
+></TT
+>{<TT
+CLASS="REPLACEABLE"
+><I
+>param</I
+></TT
+>}   # remove the parameter <TT
+CLASS="REPLACEABLE"
+><I
+>param</I
+></TT
+> from the list of parameters
+                # If it was the last one left, disable the action.
+  <TT
+CLASS="REPLACEABLE"
+><I
+>-name</I
+></TT
+>          # disable this action completely and remove all parameters from the list</PRE
+></TD
+></TR
+></TABLE
+>
   </P
 ><P
->   <TT
+>  
+   Examples: <TT
 CLASS="LITERAL"
->    <P
-CLASS="LITERALLAYOUT"
->&nbsp;&nbsp;<I
-CLASS="EMPHASIS"
->{+name{param=value}}</I
->&nbsp;&nbsp;&nbsp;#&nbsp;enable&nbsp;action&nbsp;and&nbsp;set&nbsp;<SPAN
-CLASS="QUOTE"
->"param"</SPAN
->&nbsp;to&nbsp;<SPAN
-CLASS="QUOTE"
->"value"</SPAN
-><br>
-&nbsp;&nbsp;<I
-CLASS="EMPHASIS"
->{-name{param=value}}</I
->&nbsp;&nbsp;&nbsp;#&nbsp;remove&nbsp;the&nbsp;parameter&nbsp;<SPAN
-CLASS="QUOTE"
->"param"</SPAN
->&nbsp;completely<br>
-&nbsp;&nbsp;<I
-CLASS="EMPHASIS"
->{-name}</I
->&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;disable&nbsp;this&nbsp;action&nbsp;totally&nbsp;and&nbsp;remove&nbsp;<SPAN
-CLASS="APPLICATION"
->param</SPAN
->&nbsp;too<br>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</P
-> 
-   </TT
+>+add-header{X-Fun-Header: Some text}</TT
+> and
+   <TT
+CLASS="LITERAL"
+>+filter{html-annoyances}</TT
 >
   </P
 ></LI
@@ -813,22 +957,19 @@ CLASS="FILENAME"
 >config</TT
 > (the default installation has three actions
  files). It also quite possible for any given URL pattern to match more than
- one action!</P
+ one pattern and thus more than one set of actions!</P
 ><P
 > The list of valid <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
-> <SPAN
-CLASS="QUOTE"
->"actions"</SPAN
-> are:</P
+> actions are:</P
 ><DIV
 CLASS="SECT3"
 ><H4
 CLASS="SECT3"
 ><A
 NAME="ADD-HEADER"
->9.5.1. <I
+>8.5.1. <I
 CLASS="EMPHASIS"
 >+add-header</I
 ></A
@@ -845,10 +986,10 @@ CLASS="VARIABLELIST"
 >Multi-value.</P
 ></DD
 ><DT
->Typical uses:</DT
+>Purpose and typical uses:</DT
 ><DD
 ><P
->    Send a user defined HTTP header to the web server.
+>    Send a user defined HTTP header to the web server. Can be used to confuse log analysis.
    </P
 ></DD
 ><DT
@@ -856,6 +997,14 @@ CLASS="VARIABLELIST"
 ><DD
 ><P
 >    Any value is possible. Validity of the defined HTTP headers is not checked.
+    It is recommended that you use the <SPAN
+CLASS="QUOTE"
+>"<TT
+CLASS="LITERAL"
+>X-</TT
+>"</SPAN
+> prefix
+    for custom headers.
    </P
 ></DD
 ><DT
@@ -870,8 +1019,7 @@ CLASS="EMPHASIS"
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<I
 CLASS="EMPHASIS"
 >.example.com</I
-><br>
-&nbsp;&nbsp;&nbsp;&nbsp;</P
+></P
 ></DD
 ><DT
 >Notes:</DT
@@ -895,7 +1043,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="BLOCK"
->9.5.2. <I
+>8.5.2. <I
 CLASS="EMPHASIS"
 >+block</I
 ></A
@@ -912,12 +1060,20 @@ CLASS="VARIABLELIST"
 >Boolean.</P
 ></DD
 ><DT
->Typical uses:</DT
+>Purpose and typical uses:</DT
 ><DD
 ><P
->    Used to block a URL from reaching your browser. The URL may be 
-    anything, but is typically used to block ads or other obnoxious 
-    content.    
+>    Requests for URLs to which this action applies are blocked, i.e. the requests are not
+    forwarded to the remote server, but answered locally with a substitute page or image,
+    as determined by the <A
+HREF="actions-file.html#HANDLE-AS-IMAGE"
+>handle-as-image</A
+> and  
+    <A
+HREF="actions-file.html#SET-IMAGE-BLOCKER"
+>set-image-blocker</A
+> actions.
+    It is typically used to block ads or other obnoxious content.    
    </P
 ></DD
 ><DT
@@ -1035,7 +1191,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="DEANIMATE-GIFS"
->9.5.3. <I
+>8.5.3. <I
 CLASS="EMPHASIS"
 >+deanimate-gifs</I
 ></A
@@ -1114,7 +1270,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="DOWNGRADE-HTTP-VERSION"
->9.5.4. <I
+>8.5.4. <I
 CLASS="EMPHASIS"
 >+downgrade-http-version</I
 ></A
@@ -1185,7 +1341,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="FAST-REDIRECTS"
->9.5.5. <I
+>8.5.5. <I
 CLASS="EMPHASIS"
 >+fast-redirects</I
 ></A
@@ -1282,7 +1438,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="FILTER"
->9.5.6. <I
+>8.5.6. <I
 CLASS="EMPHASIS"
 >+filter</I
 ></A
@@ -1646,7 +1802,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="HIDE-FORWARDED-FOR-HEADERS"
->9.5.7. <I
+>8.5.7. <I
 CLASS="EMPHASIS"
 >+hide-forwarded-for-headers</I
 ></A
@@ -1707,7 +1863,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="HIDE-FROM-HEADER"
->9.5.8. <I
+>8.5.8. <I
 CLASS="EMPHASIS"
 >+hide-from-header</I
 ></A
@@ -1788,7 +1944,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="HIDE-REFERER"
->9.5.9. <I
+>8.5.9. <I
 CLASS="EMPHASIS"
 >+hide-referer</I
 ></A
@@ -1891,7 +2047,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="HIDE-USER-AGENT"
->9.5.10. <I
+>8.5.10. <I
 CLASS="EMPHASIS"
 >+hide-user-agent</I
 ></A
@@ -1958,7 +2114,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="HANDLE-AS-IMAGE"
->9.5.11. <I
+>8.5.11. <I
 CLASS="EMPHASIS"
 >+handle-as-image</I
 ></A
@@ -2059,7 +2215,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="SET-IMAGE-BLOCKER"
->9.5.12. <I
+>8.5.12. <I
 CLASS="EMPHASIS"
 >+set-image-blocker</I
 ></A
@@ -2202,7 +2358,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="LIMIT-CONNECT"
->9.5.13. <I
+>8.5.13. <I
 CLASS="EMPHASIS"
 >+limit-connect</I
 ></A
@@ -2295,7 +2451,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="PREVENT-COMPRESSION"
->9.5.14. <I
+>8.5.14. <I
 CLASS="EMPHASIS"
 >+prevent-compression</I
 ></A
@@ -2390,7 +2546,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="SESSION-COOKIES-ONLY"
->9.5.15. <I
+>8.5.15. <I
 CLASS="EMPHASIS"
 >+session-cookies-only</I
 ></A
@@ -2476,7 +2632,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="PREVENT-READING-COOKIES"
->9.5.16. <I
+>8.5.16. <I
 CLASS="EMPHASIS"
 >+prevent-reading-cookies</I
 ></A
@@ -2562,7 +2718,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="PREVENT-SETTING-COOKIES"
->9.5.17. <I
+>8.5.17. <I
 CLASS="EMPHASIS"
 >+prevent-setting-cookies</I
 ></A
@@ -2628,7 +2784,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="KILL-POPUP"
->9.5.18. <I
+>8.5.18. <I
 CLASS="EMPHASIS"
 >+kill-popups<A
 NAME="KILL-POPUPS"
@@ -2711,7 +2867,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="SEND-VANILLA-WAFER"
->9.5.19. <I
+>8.5.19. <I
 CLASS="EMPHASIS"
 >+send-vanilla-wafer</I
 ></A
@@ -2778,7 +2934,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="SEND-WAFER"
->9.5.20. <I
+>8.5.20. <I
 CLASS="EMPHASIS"
 >+send-wafer</I
 ></A
@@ -2839,8 +2995,8 @@ CLASS="SECT3"
 ><H3
 CLASS="SECT3"
 ><A
-NAME="AEN2206"
->9.5.21. Summary</A
+NAME="AEN2289"
+>8.5.21. Summary</A
 ></H3
 ><P
 > Note that many of these actions have the potential to cause a page to
@@ -2859,7 +3015,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="ACT-EXAMPLES"
->9.5.22. Sample Actions Files</A
+>8.5.22. Sample Actions Files</A
 ></H2
 ><P
 > Remember that the meaning of any of the above references is reversed by preceding
@@ -3350,7 +3506,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="ALIASES"
->9.6. Aliases</A
+>8.6. Aliases</A
 ></H2
 ><P
 > Custom <SPAN
index 1172917..e38d503 100644 (file)
@@ -65,7 +65,7 @@ CLASS="SECT1"
 CLASS="SECT1"
 ><A
 NAME="APPENDIX"
->15. Appendix</A
+>14. Appendix</A
 ></H1
 ><DIV
 CLASS="SECT2"
@@ -73,7 +73,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="REGEX"
->15.1. Regular Expressions</A
+>14.1. Regular Expressions</A
 ></H2
 ><P
 > <SPAN
@@ -751,8 +751,8 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="AEN2635"
->15.2. <SPAN
+NAME="AEN2718"
+>14.2. <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
 >'s Internal Pages</A
@@ -800,7 +800,7 @@ CLASS="APPLICATION"
    Privoxy main page: 
   </P
 ><A
-NAME="AEN2650"
+NAME="AEN2733"
 ></A
 ><BLOCKQUOTE
 CLASS="BLOCKQUOTE"
@@ -829,7 +829,7 @@ TARGET="_top"
     editing of actions files:
   </P
 ><A
-NAME="AEN2657"
+NAME="AEN2740"
 ></A
 ><BLOCKQUOTE
 CLASS="BLOCKQUOTE"
@@ -849,7 +849,7 @@ TARGET="_top"
     Show the source code version numbers:
   </P
 ><A
-NAME="AEN2662"
+NAME="AEN2745"
 ></A
 ><BLOCKQUOTE
 CLASS="BLOCKQUOTE"
@@ -869,7 +869,7 @@ TARGET="_top"
    Show the browser's request headers:
   </P
 ><A
-NAME="AEN2667"
+NAME="AEN2750"
 ></A
 ><BLOCKQUOTE
 CLASS="BLOCKQUOTE"
@@ -889,7 +889,7 @@ TARGET="_top"
    Show which actions apply to a URL and why:
   </P
 ><A
-NAME="AEN2672"
+NAME="AEN2755"
 ></A
 ><BLOCKQUOTE
 CLASS="BLOCKQUOTE"
@@ -913,7 +913,7 @@ CLASS="QUOTE"
    to run, but only as a pass-through proxy, with no actions taking place:
   </P
 ><A
-NAME="AEN2678"
+NAME="AEN2761"
 ></A
 ><BLOCKQUOTE
 CLASS="BLOCKQUOTE"
@@ -930,7 +930,7 @@ TARGET="_top"
 >   Short cuts. Turn off, then on: 
   </P
 ><A
-NAME="AEN2682"
+NAME="AEN2765"
 ></A
 ><BLOCKQUOTE
 CLASS="BLOCKQUOTE"
@@ -944,7 +944,7 @@ TARGET="_top"
    </P
 ></BLOCKQUOTE
 ><A
-NAME="AEN2685"
+NAME="AEN2768"
 ></A
 ><BLOCKQUOTE
 CLASS="BLOCKQUOTE"
@@ -968,7 +968,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="BOOKMARKLETS"
->15.2.1. Bookmarklets</A
+>14.2.1. Bookmarklets</A
 ></H3
 ><P
 > Below are some <SPAN
@@ -1075,7 +1075,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="CHAIN"
->15.3. Chain of Events</A
+>14.3. Chain of Events</A
 ></H2
 ><P
 > Let's take a quick look at the basic sequence of events when a web page is 
@@ -1314,7 +1314,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="ACTIONSANAT"
->15.4. Anatomy of an Action</A
+>14.4. Anatomy of an Action</A
 ></H2
 ><P
 > The way <SPAN
index bd5a9ef..8012aff 100644 (file)
@@ -71,7 +71,7 @@ CLASS="SECT1"
 CLASS="SECT1"
 ><A
 NAME="CONFIG"
->8. The Main Configuration File</A
+>7. The Main Configuration File</A
 ></H1
 ><P
 > Again, the main configuration file is named <TT
@@ -93,8 +93,7 @@ CLASS="LITERALLAYOUT"
 >&nbsp;&nbsp;<I
 CLASS="EMPHASIS"
 >confdir /etc/privoxy</I
-><br>
-&nbsp;&nbsp;&nbsp;</P
+></P
 >
  </TT
 > </P
@@ -134,7 +133,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="CONF-LOG-LOC"
->8.1. Configuration and Log File Locations</A
+>7.1. Configuration and Log File Locations</A
 ></H2
 ><P
 > <SPAN
@@ -147,13 +146,17 @@ CLASS="APPLICATION"
 >Privoxy</SPAN
 >
  where to find those other files. </P
+><P
+> The user running Privoxy, must have read permission for all 
+ configuration files, and write permission to any files that would 
+ be modified, such as log files.</P
 ><DIV
 CLASS="SECT3"
 ><H4
 CLASS="SECT3"
 ><A
 NAME="CONFDIR"
->8.1.1. confdir</A
+>7.1.1. confdir</A
 ></H4
 ><P
 ></P
@@ -231,7 +234,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="LOGDIR"
->8.1.2. logdir</A
+>7.1.2. logdir</A
 ></H4
 ><P
 ></P
@@ -301,7 +304,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="ACTIONSFILE"
->8.1.3. actionsfile</A
+>7.1.3. actionsfile</A
 ></H4
 ><A
 NAME="DEFAULT.ACTION"
@@ -322,9 +325,9 @@ CLASS="VARIABLELIST"
 ><DD
 ><P
 >    The <A
-HREF="actions-file.html#ACTIONS"
->actions</A
-> file(s) to use
+HREF="actions-file.html"
+>actions file(s)</A
+> to use
    </P
 ></DD
 ><DT
@@ -334,7 +337,10 @@ HREF="actions-file.html#ACTIONS"
 >File name, relative to <TT
 CLASS="LITERAL"
 >confdir</TT
-></P
+>, without the <TT
+CLASS="LITERAL"
+>.action</TT
+> suffix</P
 ></DD
 ><DT
 >Default value:</DT
@@ -348,7 +354,7 @@ BORDER="0"
 ><TD
 >     <P
 CLASS="LITERALLAYOUT"
->&nbsp;&nbsp;standard&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;Internal&nbsp;purposes,&nbsp;recommended&nbsp;not&nbsp;editing</P
+>&nbsp;&nbsp;standard&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;Internal&nbsp;purposes,&nbsp;no&nbsp;editing&nbsp;recommended</P
 >
     </TD
 ></TR
@@ -422,7 +428,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="FILTERFILE"
->8.1.4. filterfile</A
+>7.1.4. filterfile</A
 ></H4
 ><A
 NAME="DEFAULT.FILTER"
@@ -474,7 +480,7 @@ CLASS="REPLACEABLE"
 ></TT
 >}</TT
 >
-    actions in the actions files are turned off
+    actions in the actions files are turned neutral.
    </P
 ></DD
 ><DT
@@ -510,7 +516,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="LOGFILE"
->8.1.5. logfile</A
+>7.1.5. logfile</A
 ></H4
 ><P
 ></P
@@ -595,6 +601,16 @@ CLASS="FILENAME"
     the effect that cron.daily will automatically archive, gzip, and empty the
     log, when it exceeds 1M size.
    </P
+><P
+>    Any log files must be writable by whatever user <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+>
+    is being run as (default on UNIX, user id is <SPAN
+CLASS="QUOTE"
+>"privoxy"</SPAN
+>).
+   </P
 ></DD
 ></DL
 ></DIV
@@ -605,7 +621,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="JARFILE"
->8.1.6. jarfile</A
+>7.1.6. jarfile</A
 ></H4
 ><P
 ></P
@@ -660,7 +676,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="TRUSTFILE"
->8.1.7. trustfile</A
+>7.1.7. trustfile</A
 ></H4
 ><P
 ></P
@@ -740,13 +756,30 @@ CLASS="LITERAL"
 ></DL
 ></DIV
 ></DIV
+></DIV
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="LOCAL-SET-UP"
+>7.2. Local Set-up Documentation</A
+></H2
+><P
+>    If you intend to operate <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> for more users
+    that just yourself, it might be a good idea to let them know how to reach
+    you, what you block and why you do that, your policies etc.
+   </P
 ><DIV
 CLASS="SECT3"
 ><H4
 CLASS="SECT3"
 ><A
 NAME="USER-MANUAL"
->8.1.8. user-manual</A
+>7.2.1. user-manual</A
 ></H4
 ><P
 ></P
@@ -773,65 +806,127 @@ CLASS="APPLICATION"
 >Default value:</DT
 ><DD
 ><P
-><A
-HREF="http://www.privoxy.org/user-manual/"
-TARGET="_top"
->http://www.privoxy.org/user-manual/</A
+><I
+CLASS="EMPHASIS"
+>Unset</I
 ></P
 ></DD
 ><DT
 >Effect if unset:</DT
 ><DD
 ><P
->    The default will be used.
+>    <A
+HREF="http://www.privoxy.org/user-manual/"
+TARGET="_top"
+>http://www.privoxy.org/<TT
+CLASS="REPLACEABLE"
+><I
+>version</I
+></TT
+>/user-manual/</A
+>
+    will be used, where <TT
+CLASS="REPLACEABLE"
+><I
+>version</I
+></TT
+> is the <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> version.
    </P
 ></DD
 ><DT
 >Notes:</DT
 ><DD
 ><P
->    The User Manual is used for help hints from some of the internal CGI pages. 
-    It is normally packaged with the binary distributions, and would make more 
-    sense to have this pointed at a locally installed copy.
+>    The User Manual URI is used for help links from some of the internal CGI pages. 
+    The manual itself is normally packaged with the binary distributions, so you propably want
+    to set this to a locally installed copy. For multi-user setups, you could provide a copy on
+    a local webserver for all your users and use the corresponding URL here.
    </P
 ><P
->    A more useful example (Unix):
+>    Examples:
    </P
 ><P
-> 
-   Â Â <I
-CLASS="EMPHASIS"
->user-manual  file:///usr/share/doc/privoxy-2.9.14/user-manual/</I
+>   Unix, in local filesystem:
+  </P
+><P
+>   <TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="90%"
+><TR
+><TD
+><PRE
+CLASS="SCREEN"
+>user-manual  file:///usr/share/doc/privoxy-2.9.15/user-manual/</PRE
+></TD
+></TR
+></TABLE
+>
+  </P
+><P
+>   Any platform, on local webserver (called <SPAN
+CLASS="QUOTE"
+>"local-webserver"</SPAN
+>):
+  </P
+><P
+>   <TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="90%"
+><TR
+><TD
+><PRE
+CLASS="SCREEN"
+>user-manual  http://local-webserver/privoxy-user-manual/</PRE
+></TD
+></TR
+></TABLE
 >
   </P
+><DIV
+CLASS="WARNING"
+><P
+></P
+><TABLE
+CLASS="WARNING"
+BORDER="1"
+WIDTH="90%"
+><TR
+><TD
+ALIGN="CENTER"
+><B
+>Warning</B
+></TD
+></TR
+><TR
+><TD
+ALIGN="LEFT"
+><P
+>     If set, this option should be <I
+CLASS="EMPHASIS"
+>the first option in the config file</I
+>, because
+     it is used while the config file is being read.
+   </P
+></TD
+></TR
+></TABLE
+></DIV
 ></DD
 ></DL
 ></DIV
 ></DIV
-></DIV
-><DIV
-CLASS="SECT2"
-><H2
-CLASS="SECT2"
-><A
-NAME="LOCAL-SET-UP"
->8.2. Local Set-up Documentation</A
-></H2
-><P
->    If you intend to operate <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
-> for more users
-    that just yourself, it might be a good idea to let them know how to reach
-    you, what you block and why you do that, your policies etc.
-   </P
 ><DIV
 CLASS="SECT3"
 ><H4
 CLASS="SECT3"
 ><A
 NAME="TRUST-INFO-URL"
->8.2.1. trust-info-url</A
+>7.2.2. trust-info-url</A
 ></H4
 ><P
 ></P
@@ -893,7 +988,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="ADMIN-ADDRESS"
->8.2.2. admin-address</A
+>7.2.3. admin-address</A
 ></H4
 ><P
 ></P
@@ -953,7 +1048,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="PROXY-INFO-URL"
->8.2.3. proxy-info-url</A
+>7.2.4. proxy-info-url</A
 ></H4
 ><P
 ></P
@@ -1021,7 +1116,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="DEBUGGING"
->8.3. Debugging</A
+>7.3. Debugging</A
 ></H2
 ><P
 >  These options are mainly useful when tracing a problem.
@@ -1041,7 +1136,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="DEBUG"
->8.3.1. debug</A
+>7.3.1. debug</A
 ></H4
 ><P
 ></P
@@ -1155,7 +1250,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="SINGLE-THREADED"
->8.3.2. single-threaded</A
+>7.3.2. single-threaded</A
 ></H4
 ><P
 ></P
@@ -1216,7 +1311,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="ACCESS-CONTROL"
->8.4. Access Control and Security</A
+>7.4. Access Control and Security</A
 ></H2
 ><P
 >  This section of the config file controls the security-relevant aspects
@@ -1231,7 +1326,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="LISTEN-ADDRESS"
->8.4.1. listen-address</A
+>7.4.1. listen-address</A
 ></H4
 ><P
 ></P
@@ -1344,7 +1439,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="TOGGLE"
->8.4.2. toggle</A
+>7.4.2. toggle</A
 ></H4
 ><P
 ></P
@@ -1418,7 +1513,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="ENABLE-REMOTE-TOGGLE"
->8.4.3. enable-remote-toggle</A
+>7.4.3. enable-remote-toggle</A
 ></H4
 ><P
 ></P
@@ -1510,7 +1605,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="ENABLE-EDIT-ACTIONS"
->8.4.4. enable-edit-actions</A
+>7.4.4. enable-edit-actions</A
 ></H4
 ><P
 ></P
@@ -1594,7 +1689,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="ACLS"
->8.4.5. ACLs: permit-access and deny-access</A
+>7.4.5. ACLs: permit-access and deny-access</A
 ></H4
 ><A
 NAME="PERMIT-ACCES"
@@ -1861,7 +1956,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="BUFFER-LIMIT"
->8.4.6. buffer-limit</A
+>7.4.6. buffer-limit</A
 ></H4
 ><P
 ></P
@@ -1945,7 +2040,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="FORWARDING"
->8.5. Forwarding</A
+>7.5. Forwarding</A
 ></H2
 ><P
 > This feature allows routing of HTTP requests through a chain of
@@ -1975,7 +2070,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="FORWARD"
->8.5.1. forward</A
+>7.5.1. forward</A
 ></H4
 ><P
 ></P
@@ -2137,7 +2232,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="SOCKS"
->8.5.2. forward-socks4 and forward-socks4a</A
+>7.5.2. forward-socks4 and forward-socks4a</A
 ></H4
 ><A
 NAME="FORWARD-SOCKS4"
@@ -2341,7 +2436,7 @@ CLASS="SECT3"
 CLASS="SECT3"
 ><A
 NAME="ADVANCED-FORWARDING-EXAMPLES"
->8.5.3. Advanced Forwarding Examples</A
+>7.5.3. Advanced Forwarding Examples</A
 ></H4
 ><P
 > If you have links to multiple ISPs that provide various special content 
@@ -2465,7 +2560,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="WINDOWS-GUI"
->8.6. Windows GUI Options</A
+>7.6. Windows GUI Options</A
 ></H2
 ><P
 > <SPAN
index 7b77fcd..5082539 100644 (file)
@@ -71,7 +71,7 @@ CLASS="SECT1"
 CLASS="SECT1"
 ><A
 NAME="CONFIGURATION"
->7. <SPAN
+>6. <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
 > Configuration</A
@@ -93,8 +93,8 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="AEN305"
->7.1. Controlling <SPAN
+NAME="AEN346"
+>6.1. Controlling <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
 > with Your Web Browser</A
@@ -187,11 +187,11 @@ TARGET="_top"
 ></TABLE
 ><P
 > This should be self-explanatory. Note the first item leads to an editor for the
- <SPAN
-CLASS="QUOTE"
->"actions list"</SPAN
->, which is where the ad, banner, cookie,
- and URL blocking magic is configured as well as other advanced features of
+ <A
+HREF="actions-file.html"
+>actions files</A
+>, which is where the ad, banner,
cookie, and URL blocking magic is configured as well as other advanced features of
  <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
@@ -215,7 +215,11 @@ CLASS="APPLICATION"
 CLASS="APPLICATION"
 >Privoxy</SPAN
 > continues 
- to run as a proxy in this case, but all filtering is disabled. There
+ to run as a proxy in this case, but all manipulation is disabled, i.e.
+ <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> acts like a normal forwarding proxy. There
  is even a toggle <A
 HREF="appendix.html#BOOKMARKLETS"
 >Bookmarklet</A
@@ -232,7 +236,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="CONFOVERVIEW"
->7.2. Configuration Files Overview</A
+>6.2. Configuration Files Overview</A
 ></H2
 ><P
 > For Unix, *BSD and Linux, all configuration files are located in
@@ -257,9 +261,12 @@ CLASS="APPLICATION"
 ><UL
 ><LI
 ><P
->     The main configuration file is named <A
+>     The <A
 HREF="config.html"
->config</A
+>main configuration file</A
+> is named <TT
+CLASS="FILENAME"
+>config</TT
 >
      on Linux, Unix, BSD, OS/2, and AmigaOS and <TT
 CLASS="FILENAME"
@@ -276,12 +283,18 @@ CLASS="FILENAME"
 > (the main <A
 HREF="actions-file.html"
 >actions file</A
->) is used to define
-    the default settings for various <SPAN
+>)
+    is used to define which <SPAN
 CLASS="QUOTE"
 >"actions"</SPAN
-> relating to images, banners, 
-    pop-ups, access restrictions, banners and cookies.
+> relating to banner-blocking, images, pop-ups,
+    content modification, cookie handling etc should be applied by default. It also defines many
+    exceptions (both positive and negative) from this default set of actions that enable 
+    <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> to selectively eliminate the junk, and only the junk, on
+    as many websites as possible.
    </P
 ><P
 >    Multiple actions files may be defined in <TT
@@ -289,20 +302,21 @@ CLASS="FILENAME"
 >config</TT
 >. These 
     are processed in the order they are defined. Local customizations and locally 
-    preferred exceptions to the default policies as defined in
+    preferred exceptions to the default policies  as defined in
     <TT
 CLASS="FILENAME"
 >default.action</TT
-> are probably best applied in
+> (which you will most propably want
+    to define sooner or later) are probably best applied in
     <TT
 CLASS="FILENAME"
 >user.action</TT
->, which should be preserved across
+>, where you can preserve them across
     upgrades. <TT
 CLASS="FILENAME"
 >standard.action</TT
-> is also included. This is mostly 
-    for <SPAN
+> is for
+    <SPAN
 CLASS="APPLICATION"
 >Privoxy's</SPAN
 > internal use.
@@ -311,14 +325,14 @@ CLASS="APPLICATION"
 >    
     There is also a web based editor that can be accessed from
     <A
-HREF="http://config.privoxy.org/show-status/"
+HREF="http://config.privoxy.org/show-status"
 TARGET="_top"
->http://config.privoxy.org/show-status/</A
+>http://config.privoxy.org/show-status</A
 >
     (Shortcut: <A
-HREF="http://p.p/show-status/"
+HREF="http://p.p/show-status"
 TARGET="_top"
->http://p.p/show-status/</A
+>http://p.p/show-status</A
 >) for the
     various actions files. 
    </P
@@ -348,7 +362,7 @@ CLASS="LITERAL"
 >#</TT
 >"</SPAN
 > character to denote a
- comment (the rest of the line will be ignored) angd understand line continuation
+ comment (the rest of the line will be ignored) and understand line continuation
  through placing a backslash ("<TT
 CLASS="LITERAL"
 >\</TT
index 7e9f4c7..ce7e02f 100644 (file)
@@ -72,7 +72,7 @@ CLASS="SECT1"
 CLASS="SECT1"
 ><A
 NAME="CONTACT"
->12. Contacting the Developers, Bug Reporting and Feature
+>11. Contacting the Developers, Bug Reporting and Feature
 Requests</A
 ></H1
 ><P
@@ -84,7 +84,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="CONTACT-SUPPORT"
->12.1. Get Support</A
+>11.1. Get Support</A
 ></H2
 ><P
 >   <P
@@ -105,7 +105,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="CONTACT-BUGS"
->12.2. Report bugs</A
+>11.2. Report bugs</A
 ></H2
 ><P
 >   <P
@@ -143,7 +143,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="CONTACT-FEATURE"
->12.3. Request new features</A
+>11.3. Request new features</A
 ></H2
 ><P
 >   <P
@@ -164,7 +164,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="CONTACT-ADS"
->12.4. Report ads or other filter problems</A
+>11.4. Report ads or other filter problems</A
 ></H2
 ><P
 >You can also send feedback on websites that Privoxy has problems with. Please bookmark
@@ -196,7 +196,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="CONTACT-OTHER"
->12.5. Other</A
+>11.5. Other</A
 ></H2
 ><P
 >   <P
index f93543f..42a8af6 100644 (file)
@@ -72,15 +72,15 @@ CLASS="SECT1"
 CLASS="SECT1"
 ><A
 NAME="COPYRIGHT"
->13. Copyright and History</A
+>12. Copyright and History</A
 ></H1
 ><DIV
 CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="AEN2410"
->13.1. Copyright</A
+NAME="AEN2493"
+>12.1. Copyright</A
 ></H2
 ><P
 > <SPAN
@@ -114,7 +114,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="HISTORY"
->13.2. History</A
+>12.2. History</A
 ></H2
 ><P
 > <SPAN
index d90278b..56c70eb 100644 (file)
@@ -71,7 +71,7 @@ CLASS="SECT1"
 CLASS="SECT1"
 ><A
 NAME="FILTER-FILE"
->10. The Filter File</A
+>9. The Filter File</A
 ></H1
 ><P
 > Any web page can be dynamically modified with the filter file. This
@@ -189,8 +189,8 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="AEN2349"
->10.1. The <I
+NAME="AEN2432"
+>9.1. The <I
 CLASS="EMPHASIS"
 >+filter</I
 > Action</A
index 0b8ace4..3bf97fd 100644 (file)
@@ -49,7 +49,7 @@ CLASS="ORGNAME"
 ></DIV
 ><P
 CLASS="PUBDATE"
->$Id: user-manual.sgml,v 1.100 2002/04/29 03:05:55 hal9 Exp $<BR></P
+>$Id: user-manual.sgml,v 1.103 2002/05/04 00:40:53 hal9 Exp $<BR></P
 ><DIV
 ><DIV
 CLASS="ABSTRACT"
@@ -121,11 +121,6 @@ CLASS="TOC"
 >Table of Contents</B
 ></DT
 ><DT
-><A
-HREF="index.html#INTRO"
-></A
-></DT
-><DT
 >1. <A
 HREF="introduction.html"
 >Introduction</A
@@ -140,56 +135,70 @@ HREF="introduction.html#FEATURES"
 ></DL
 ></DD
 ><DT
->3. <A
+>2. <A
 HREF="installation.html"
 >Installation</A
 ></DT
 ><DD
 ><DL
 ><DT
->3.1. <A
+>2.1. <A
+HREF="installation.html#INSTALLATION-PACKAGES"
+>Binary Packages</A
+></DT
+><DD
+><DL
+><DT
+>2.1.1. <A
 HREF="installation.html#INSTALLATION-PACK-RPM"
 >Red Hat and SuSE RPMs</A
 ></DT
 ><DT
->3.2. <A
+>2.1.2. <A
 HREF="installation.html#INSTALLATION-DEB"
 >Debian</A
 ></DT
 ><DT
->3.3. <A
+>2.1.3. <A
 HREF="installation.html#INSTALLATION-PACK-WIN"
 >Windows</A
 ></DT
 ><DT
->3.4. <A
+>2.1.4. <A
 HREF="installation.html#INSTALLATION-PACK-BINTGZ"
 >Solaris, NetBSD, FreeBSD, HP-UX</A
 ></DT
 ><DT
->3.5. <A
+>2.1.5. <A
 HREF="installation.html#INSTALLATION-OS2"
 >OS/2</A
 ></DT
 ><DT
->3.6. <A
+>2.1.6. <A
 HREF="installation.html#INSTALLATION-MAC"
 >Max OSX</A
 ></DT
 ><DT
->3.7. <A
+>2.1.7. <A
 HREF="installation.html#INSTALLATION-AMIGA"
 >AmigaOS</A
 ></DT
 ></DL
 ></DD
 ><DT
->4. <A
+>2.2. <A
+HREF="installation.html#INSTALLATION-SOURCE"
+>Building from Source</A
+></DT
+></DL
+></DD
+><DT
+>3. <A
 HREF="upgradersnote.html"
 >Note to Upgraders</A
 ></DT
 ><DT
->5. <A
+>4. <A
 HREF="quickstart.html"
 >Quickstart to Using <SPAN
 CLASS="APPLICATION"
@@ -197,7 +206,7 @@ CLASS="APPLICATION"
 ></A
 ></DT
 ><DT
->6. <A
+>5. <A
 HREF="startup.html"
 >Starting <SPAN
 CLASS="APPLICATION"
@@ -207,49 +216,49 @@ CLASS="APPLICATION"
 ><DD
 ><DL
 ><DT
->6.1. <A
+>5.1. <A
 HREF="startup.html#START-REDHATDEBIAN"
 >RedHat and Debian</A
 ></DT
 ><DT
->6.2. <A
+>5.2. <A
 HREF="startup.html#START-SUSE"
 >SuSE</A
 ></DT
 ><DT
->6.3. <A
+>5.3. <A
 HREF="startup.html#START-WINDOWS"
 >Windows</A
 ></DT
 ><DT
->6.4. <A
+>5.4. <A
 HREF="startup.html#START-UNICES"
 >Solaris, NetBSD, FreeBSD, HP-UX and others</A
 ></DT
 ><DT
->6.5. <A
+>5.5. <A
 HREF="startup.html#START-OS2"
 >OS/2</A
 ></DT
 ><DT
->6.6. <A
+>5.6. <A
 HREF="startup.html#START-MACOSX"
 >MAX OSX</A
 ></DT
 ><DT
->6.7. <A
+>5.7. <A
 HREF="startup.html#START-AMIGAOS"
 >AmigaOS</A
 ></DT
 ><DT
->6.8. <A
+>5.8. <A
 HREF="startup.html#CMDOPTIONS"
 >Command Line Options</A
 ></DT
 ></DL
 ></DD
 ><DT
->7. <A
+>6. <A
 HREF="configuration.html"
 ><SPAN
 CLASS="APPLICATION"
@@ -259,239 +268,239 @@ CLASS="APPLICATION"
 ><DD
 ><DL
 ><DT
->7.1. <A
-HREF="configuration.html#AEN305"
+>6.1. <A
+HREF="configuration.html#AEN346"
 >Controlling <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
 > with Your Web Browser</A
 ></DT
 ><DT
->7.2. <A
+>6.2. <A
 HREF="configuration.html#CONFOVERVIEW"
 >Configuration Files Overview</A
 ></DT
 ></DL
 ></DD
 ><DT
->8. <A
+>7. <A
 HREF="config.html"
 >The Main Configuration File</A
 ></DT
 ><DD
 ><DL
 ><DT
->8.1. <A
+>7.1. <A
 HREF="config.html#CONF-LOG-LOC"
 >Configuration and Log File Locations</A
 ></DT
 ><DD
 ><DL
 ><DT
->8.1.1. <A
+>7.1.1. <A
 HREF="config.html#CONFDIR"
 >confdir</A
 ></DT
 ><DT
->8.1.2. <A
+>7.1.2. <A
 HREF="config.html#LOGDIR"
 >logdir</A
 ></DT
 ><DT
->8.1.3. <A
+>7.1.3. <A
 HREF="config.html#ACTIONSFILE"
 >actionsfile</A
 ></DT
 ><DT
->8.1.4. <A
+>7.1.4. <A
 HREF="config.html#FILTERFILE"
 >filterfile</A
 ></DT
 ><DT
->8.1.5. <A
+>7.1.5. <A
 HREF="config.html#LOGFILE"
 >logfile</A
 ></DT
 ><DT
->8.1.6. <A
+>7.1.6. <A
 HREF="config.html#JARFILE"
 >jarfile</A
 ></DT
 ><DT
->8.1.7. <A
+>7.1.7. <A
 HREF="config.html#TRUSTFILE"
 >trustfile</A
 ></DT
-><DT
->8.1.8. <A
-HREF="config.html#USER-MANUAL"
->user-manual</A
-></DT
 ></DL
 ></DD
 ><DT
->8.2. <A
+>7.2. <A
 HREF="config.html#LOCAL-SET-UP"
 >Local Set-up Documentation</A
 ></DT
 ><DD
 ><DL
 ><DT
->8.2.1. <A
+>7.2.1. <A
+HREF="config.html#USER-MANUAL"
+>user-manual</A
+></DT
+><DT
+>7.2.2. <A
 HREF="config.html#TRUST-INFO-URL"
 >trust-info-url</A
 ></DT
 ><DT
->8.2.2. <A
+>7.2.3. <A
 HREF="config.html#ADMIN-ADDRESS"
 >admin-address</A
 ></DT
 ><DT
->8.2.3. <A
+>7.2.4. <A
 HREF="config.html#PROXY-INFO-URL"
 >proxy-info-url</A
 ></DT
 ></DL
 ></DD
 ><DT
->8.3. <A
+>7.3. <A
 HREF="config.html#DEBUGGING"
 >Debugging</A
 ></DT
 ><DD
 ><DL
 ><DT
->8.3.1. <A
+>7.3.1. <A
 HREF="config.html#DEBUG"
 >debug</A
 ></DT
 ><DT
->8.3.2. <A
+>7.3.2. <A
 HREF="config.html#SINGLE-THREADED"
 >single-threaded</A
 ></DT
 ></DL
 ></DD
 ><DT
->8.4. <A
+>7.4. <A
 HREF="config.html#ACCESS-CONTROL"
 >Access Control and Security</A
 ></DT
 ><DD
 ><DL
 ><DT
->8.4.1. <A
+>7.4.1. <A
 HREF="config.html#LISTEN-ADDRESS"
 >listen-address</A
 ></DT
 ><DT
->8.4.2. <A
+>7.4.2. <A
 HREF="config.html#TOGGLE"
 >toggle</A
 ></DT
 ><DT
->8.4.3. <A
+>7.4.3. <A
 HREF="config.html#ENABLE-REMOTE-TOGGLE"
 >enable-remote-toggle</A
 ></DT
 ><DT
->8.4.4. <A
+>7.4.4. <A
 HREF="config.html#ENABLE-EDIT-ACTIONS"
 >enable-edit-actions</A
 ></DT
 ><DT
->8.4.5. <A
+>7.4.5. <A
 HREF="config.html#ACLS"
 >ACLs: permit-access and deny-access</A
 ></DT
 ><DT
->8.4.6. <A
+>7.4.6. <A
 HREF="config.html#BUFFER-LIMIT"
 >buffer-limit</A
 ></DT
 ></DL
 ></DD
 ><DT
->8.5. <A
+>7.5. <A
 HREF="config.html#FORWARDING"
 >Forwarding</A
 ></DT
 ><DD
 ><DL
 ><DT
->8.5.1. <A
+>7.5.1. <A
 HREF="config.html#FORWARD"
 >forward</A
 ></DT
 ><DT
->8.5.2. <A
+>7.5.2. <A
 HREF="config.html#SOCKS"
 >forward-socks4 and forward-socks4a</A
 ></DT
 ><DT
->8.5.3. <A
+>7.5.3. <A
 HREF="config.html#ADVANCED-FORWARDING-EXAMPLES"
 >Advanced Forwarding Examples</A
 ></DT
 ></DL
 ></DD
 ><DT
->8.6. <A
+>7.6. <A
 HREF="config.html#WINDOWS-GUI"
 >Windows GUI Options</A
 ></DT
 ></DL
 ></DD
 ><DT
->9. <A
+>8. <A
 HREF="actions-file.html"
 >Actions Files</A
 ></DT
 ><DD
 ><DL
 ><DT
->9.1. <A
-HREF="actions-file.html#AEN1309"
+>8.1. <A
+HREF="actions-file.html#AEN1378"
 >Finding the Right Mix</A
 ></DT
 ><DT
->9.2. <A
-HREF="actions-file.html#AEN1316"
+>8.2. <A
+HREF="actions-file.html#AEN1385"
 >How to Edit</A
 ></DT
 ><DT
->9.3. <A
-HREF="actions-file.html#AEN1322"
+>8.3. <A
+HREF="actions-file.html#AEN1394"
 >How Actions are Applied to URLs</A
 ></DT
 ><DT
->9.4. <A
-HREF="actions-file.html#AEN1336"
+>8.4. <A
+HREF="actions-file.html#AEN1408"
 >Patterns</A
 ></DT
 ><DD
 ><DL
 ><DT
->9.4.1. <A
-HREF="actions-file.html#AEN1376"
+>8.4.1. <A
+HREF="actions-file.html#AEN1448"
 >The Domain Pattern</A
 ></DT
 ><DT
->9.4.2. <A
-HREF="actions-file.html#AEN1438"
+>8.4.2. <A
+HREF="actions-file.html#AEN1510"
 >The Path Pattern</A
 ></DT
 ></DL
 ></DD
 ><DT
->9.5. <A
+>8.5. <A
 HREF="actions-file.html#ACTIONS"
 >Actions</A
 ></DT
 ><DD
 ><DL
 ><DT
->9.5.1. <A
+>8.5.1. <A
 HREF="actions-file.html#ADD-HEADER"
 ><I
 CLASS="EMPHASIS"
@@ -499,7 +508,7 @@ CLASS="EMPHASIS"
 ></A
 ></DT
 ><DT
->9.5.2. <A
+>8.5.2. <A
 HREF="actions-file.html#BLOCK"
 ><I
 CLASS="EMPHASIS"
@@ -507,7 +516,7 @@ CLASS="EMPHASIS"
 ></A
 ></DT
 ><DT
->9.5.3. <A
+>8.5.3. <A
 HREF="actions-file.html#DEANIMATE-GIFS"
 ><I
 CLASS="EMPHASIS"
@@ -515,7 +524,7 @@ CLASS="EMPHASIS"
 ></A
 ></DT
 ><DT
->9.5.4. <A
+>8.5.4. <A
 HREF="actions-file.html#DOWNGRADE-HTTP-VERSION"
 ><I
 CLASS="EMPHASIS"
@@ -523,7 +532,7 @@ CLASS="EMPHASIS"
 ></A
 ></DT
 ><DT
->9.5.5. <A
+>8.5.5. <A
 HREF="actions-file.html#FAST-REDIRECTS"
 ><I
 CLASS="EMPHASIS"
@@ -531,7 +540,7 @@ CLASS="EMPHASIS"
 ></A
 ></DT
 ><DT
->9.5.6. <A
+>8.5.6. <A
 HREF="actions-file.html#FILTER"
 ><I
 CLASS="EMPHASIS"
@@ -539,7 +548,7 @@ CLASS="EMPHASIS"
 ></A
 ></DT
 ><DT
->9.5.7. <A
+>8.5.7. <A
 HREF="actions-file.html#HIDE-FORWARDED-FOR-HEADERS"
 ><I
 CLASS="EMPHASIS"
@@ -547,7 +556,7 @@ CLASS="EMPHASIS"
 ></A
 ></DT
 ><DT
->9.5.8. <A
+>8.5.8. <A
 HREF="actions-file.html#HIDE-FROM-HEADER"
 ><I
 CLASS="EMPHASIS"
@@ -555,7 +564,7 @@ CLASS="EMPHASIS"
 ></A
 ></DT
 ><DT
->9.5.9. <A
+>8.5.9. <A
 HREF="actions-file.html#HIDE-REFERER"
 ><I
 CLASS="EMPHASIS"
@@ -563,7 +572,7 @@ CLASS="EMPHASIS"
 ></A
 ></DT
 ><DT
->9.5.10. <A
+>8.5.10. <A
 HREF="actions-file.html#HIDE-USER-AGENT"
 ><I
 CLASS="EMPHASIS"
@@ -571,7 +580,7 @@ CLASS="EMPHASIS"
 ></A
 ></DT
 ><DT
->9.5.11. <A
+>8.5.11. <A
 HREF="actions-file.html#HANDLE-AS-IMAGE"
 ><I
 CLASS="EMPHASIS"
@@ -579,7 +588,7 @@ CLASS="EMPHASIS"
 ></A
 ></DT
 ><DT
->9.5.12. <A
+>8.5.12. <A
 HREF="actions-file.html#SET-IMAGE-BLOCKER"
 ><I
 CLASS="EMPHASIS"
@@ -587,7 +596,7 @@ CLASS="EMPHASIS"
 ></A
 ></DT
 ><DT
->9.5.13. <A
+>8.5.13. <A
 HREF="actions-file.html#LIMIT-CONNECT"
 ><I
 CLASS="EMPHASIS"
@@ -595,7 +604,7 @@ CLASS="EMPHASIS"
 ></A
 ></DT
 ><DT
->9.5.14. <A
+>8.5.14. <A
 HREF="actions-file.html#PREVENT-COMPRESSION"
 ><I
 CLASS="EMPHASIS"
@@ -603,7 +612,7 @@ CLASS="EMPHASIS"
 ></A
 ></DT
 ><DT
->9.5.15. <A
+>8.5.15. <A
 HREF="actions-file.html#SESSION-COOKIES-ONLY"
 ><I
 CLASS="EMPHASIS"
@@ -611,7 +620,7 @@ CLASS="EMPHASIS"
 ></A
 ></DT
 ><DT
->9.5.16. <A
+>8.5.16. <A
 HREF="actions-file.html#PREVENT-READING-COOKIES"
 ><I
 CLASS="EMPHASIS"
@@ -619,7 +628,7 @@ CLASS="EMPHASIS"
 ></A
 ></DT
 ><DT
->9.5.17. <A
+>8.5.17. <A
 HREF="actions-file.html#PREVENT-SETTING-COOKIES"
 ><I
 CLASS="EMPHASIS"
@@ -627,7 +636,7 @@ CLASS="EMPHASIS"
 ></A
 ></DT
 ><DT
->9.5.18. <A
+>8.5.18. <A
 HREF="actions-file.html#KILL-POPUP"
 ><I
 CLASS="EMPHASIS"
@@ -638,7 +647,7 @@ NAME="KILL-POPUPS"
 ></A
 ></DT
 ><DT
->9.5.19. <A
+>8.5.19. <A
 HREF="actions-file.html#SEND-VANILLA-WAFER"
 ><I
 CLASS="EMPHASIS"
@@ -646,7 +655,7 @@ CLASS="EMPHASIS"
 ></A
 ></DT
 ><DT
->9.5.20. <A
+>8.5.20. <A
 HREF="actions-file.html#SEND-WAFER"
 ><I
 CLASS="EMPHASIS"
@@ -654,34 +663,34 @@ CLASS="EMPHASIS"
 ></A
 ></DT
 ><DT
->9.5.21. <A
-HREF="actions-file.html#AEN2206"
+>8.5.21. <A
+HREF="actions-file.html#AEN2289"
 >Summary</A
 ></DT
 ><DT
->9.5.22. <A
+>8.5.22. <A
 HREF="actions-file.html#ACT-EXAMPLES"
 >Sample Actions Files</A
 ></DT
 ></DL
 ></DD
 ><DT
->9.6. <A
+>8.6. <A
 HREF="actions-file.html#ALIASES"
 >Aliases</A
 ></DT
 ></DL
 ></DD
 ><DT
->10. <A
+>9. <A
 HREF="filter-file.html"
 >The Filter File</A
 ></DT
 ><DD
 ><DL
 ><DT
->10.1. <A
-HREF="filter-file.html#AEN2349"
+>9.1. <A
+HREF="filter-file.html#AEN2432"
 >The <I
 CLASS="EMPHASIS"
 >+filter</I
@@ -690,12 +699,12 @@ CLASS="EMPHASIS"
 ></DL
 ></DD
 ><DT
->11. <A
+>10. <A
 HREF="templates.html"
 >Templates</A
 ></DT
 ><DT
->12. <A
+>11. <A
 HREF="contact.html"
 >Contacting the Developers, Bug Reporting and Feature
 Requests</A
@@ -703,71 +712,71 @@ Requests</A
 ><DD
 ><DL
 ><DT
->12.1. <A
+>11.1. <A
 HREF="contact.html#CONTACT-SUPPORT"
 >Get Support</A
 ></DT
 ><DT
->12.2. <A
+>11.2. <A
 HREF="contact.html#CONTACT-BUGS"
 >Report bugs</A
 ></DT
 ><DT
->12.3. <A
+>11.3. <A
 HREF="contact.html#CONTACT-FEATURE"
 >Request new features</A
 ></DT
 ><DT
->12.4. <A
+>11.4. <A
 HREF="contact.html#CONTACT-ADS"
 >Report ads or other filter problems</A
 ></DT
 ><DT
->12.5. <A
+>11.5. <A
 HREF="contact.html#CONTACT-OTHER"
 >Other</A
 ></DT
 ></DL
 ></DD
 ><DT
->13. <A
+>12. <A
 HREF="copyright.html"
 >Copyright and History</A
 ></DT
 ><DD
 ><DL
 ><DT
->13.1. <A
-HREF="copyright.html#AEN2410"
+>12.1. <A
+HREF="copyright.html#AEN2493"
 >Copyright</A
 ></DT
 ><DT
->13.2. <A
+>12.2. <A
 HREF="copyright.html#HISTORY"
 >History</A
 ></DT
 ></DL
 ></DD
 ><DT
->14. <A
+>13. <A
 HREF="seealso.html"
 >See Also</A
 ></DT
 ><DT
->15. <A
+>14. <A
 HREF="appendix.html"
 >Appendix</A
 ></DT
 ><DD
 ><DL
 ><DT
->15.1. <A
+>14.1. <A
 HREF="appendix.html#REGEX"
 >Regular Expressions</A
 ></DT
 ><DT
->15.2. <A
-HREF="appendix.html#AEN2635"
+>14.2. <A
+HREF="appendix.html#AEN2718"
 ><SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
@@ -776,19 +785,19 @@ CLASS="APPLICATION"
 ><DD
 ><DL
 ><DT
->15.2.1. <A
+>14.2.1. <A
 HREF="appendix.html#BOOKMARKLETS"
 >Bookmarklets</A
 ></DT
 ></DL
 ></DD
 ><DT
->15.3. <A
+>14.3. <A
 HREF="appendix.html#CHAIN"
 >Chain of Events</A
 ></DT
 ><DT
->15.4. <A
+>14.4. <A
 HREF="appendix.html#ACTIONSANAT"
 >Anatomy of an Action</A
 ></DT
@@ -796,17 +805,6 @@ HREF="appendix.html#ACTIONSANAT"
 ></DD
 ></DL
 ></DIV
-><DIV
-CLASS="SECT1"
-><H1
-CLASS="SECT1"
-><A
-NAME="INTRO"
-></A
-></H1
-><P
-> </P
-></DIV
 ></DIV
 ><DIV
 CLASS="NAVFOOTER"
index 7c77555..adce89d 100644 (file)
@@ -71,7 +71,7 @@ CLASS="SECT1"
 CLASS="SECT1"
 ><A
 NAME="INSTALLATION"
->3. Installation</A
+>2. Installation</A
 ></H1
 ><P
 > <SPAN
@@ -85,29 +85,7 @@ HREF="http://sourceforge.net/projects/ijbswa/"
 TARGET="_top"
 >Privoxy Project
  Page</A
->. For installing and compiling the source code, please look 
- into our Developer Manual.</P
-><P
-> If you like to live on the bleeding edge and are not afraid of using
- possibly unstable development versions, you can check out the up-to-the-minute
- version directly from <A
-HREF="http://sourceforge.net/cvs/?group_id=11118"
-TARGET="_top"
->the
- CVS repository</A
-> or simply download <A
-HREF="http://cvs.sourceforge.net/cvstarballs/ijbswa-cvsroot.tar.gz"
-TARGET="_top"
->the nightly CVS
- tarball.</A
-> Again, we refer you to the Developer Manual.</P
-><P
-> At present, <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
-> is known to run on
- Windows(95, 98, ME, 2000, XP), Linux (RedHat, Suse, Debian), Mac OSX,
- OS/2, AmigaOS, FreeBSD, NetBSD, BeOS, and many more flavors of Unix.</P
+>.</P
 ><P
 > Note: If you have a previous <SPAN
 CLASS="APPLICATION"
@@ -118,9 +96,8 @@ CLASS="APPLICATION"
 >Privoxy</SPAN
 > installation on your system, you
  will need to remove it.  Some platforms do this for you as part 
- of their installation procedure. (See below for your platform).</P
-><P
-> In any case <I
+ of their installation procedure. (See below for your platform).
+ In any case <I
 CLASS="EMPHASIS"
 >be sure to backup your old configuration
  if it is valuable to you.</I
@@ -135,13 +112,23 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="INSTALLATION-PACK-RPM"
->3.1. Red Hat and SuSE RPMs</A
+NAME="INSTALLATION-PACKAGES"
+>2.1. Binary Packages</A
 ></H2
 ><P
+>How to install the binary packages depends on your operating system:</P
+><DIV
+CLASS="SECT3"
+><H3
+CLASS="SECT3"
+><A
+NAME="INSTALLATION-PACK-RPM"
+>2.1.1. Red Hat and SuSE RPMs</A
+></H3
+><P
 > RPMs can be installed with <TT
 CLASS="LITERAL"
->rpm -Uvh privoxy-2.9.14-1.rpm</TT
+>rpm -Uvh privoxy-2.9.15-1.rpm</TT
 >,
  and will use <TT
 CLASS="FILENAME"
@@ -170,7 +157,7 @@ automatically start Privoxy in the boot process.</P
 > If you have problems with failed dependencies, try rebuilding the SRC RPM: 
  <TT
 CLASS="LITERAL"
->rpm --rebuild privoxy-2.9.14-1.src.rpm;</TT
+>rpm --rebuild privoxy-2.9.15-1.src.rpm;</TT
 >. This 
  will use your locally installed libraries and RPM version. </P
 ><P
@@ -189,24 +176,24 @@ CLASS="APPLICATION"
 >.</P
 ></DIV
 ><DIV
-CLASS="SECT2"
-><H2
-CLASS="SECT2"
+CLASS="SECT3"
+><H3
+CLASS="SECT3"
 ><A
 NAME="INSTALLATION-DEB"
->3.2. Debian</A
-></H2
+>2.1.2. Debian</A
+></H3
 ><P
 > FIXME.</P
 ></DIV
 ><DIV
-CLASS="SECT2"
-><H2
-CLASS="SECT2"
+CLASS="SECT3"
+><H3
+CLASS="SECT3"
 ><A
 NAME="INSTALLATION-PACK-WIN"
->3.3. Windows</A
-></H2
+>2.1.3. Windows</A
+></H3
 ><P
 > Just double-click the installer, which will guide you through
  the installation process. You will find the configuration files
@@ -214,13 +201,13 @@ NAME="INSTALLATION-PACK-WIN"
  use the registry of Windows. </P
 ></DIV
 ><DIV
-CLASS="SECT2"
-><H2
-CLASS="SECT2"
+CLASS="SECT3"
+><H3
+CLASS="SECT3"
 ><A
 NAME="INSTALLATION-PACK-BINTGZ"
->3.4. Solaris, NetBSD, FreeBSD, HP-UX</A
-></H2
+>2.1.4. Solaris, NetBSD, FreeBSD, HP-UX</A
+></H3
 ><P
 > Create a new directory, <TT
 CLASS="LITERAL"
@@ -230,13 +217,13 @@ CLASS="LITERAL"
  things go. FIXME.</P
 ></DIV
 ><DIV
-CLASS="SECT2"
-><H2
-CLASS="SECT2"
+CLASS="SECT3"
+><H3
+CLASS="SECT3"
 ><A
 NAME="INSTALLATION-OS2"
->3.5. OS/2</A
-></H2
+>2.1.5. OS/2</A
+></H3
 ><P
 > First, make sure that no previous installations of
  <SPAN
@@ -264,13 +251,13 @@ CLASS="APPLICATION"
  into will contain all of the configuration files.</P
 ></DIV
 ><DIV
-CLASS="SECT2"
-><H2
-CLASS="SECT2"
+CLASS="SECT3"
+><H3
+CLASS="SECT3"
 ><A
 NAME="INSTALLATION-MAC"
->3.6. Max OSX</A
-></H2
+>2.1.6. Max OSX</A
+></H3
 ><P
 > Unzip the downloaded package (you can either double-click on the file
  in the finder, or on the desktop if you downloaded it there).  Then,
@@ -295,13 +282,13 @@ CLASS="LITERAL"
 >.</P
 ></DIV
 ><DIV
-CLASS="SECT2"
-><H2
-CLASS="SECT2"
+CLASS="SECT3"
+><H3
+CLASS="SECT3"
 ><A
 NAME="INSTALLATION-AMIGA"
->3.7. AmigaOS</A
-></H2
+>2.1.7. AmigaOS</A
+></H3
 ><P
 > Copy and then unpack the <TT
 CLASS="FILENAME"
@@ -339,6 +326,159 @@ CLASS="APPLICATION"
 ></DIV
 ></DIV
 ><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="INSTALLATION-SOURCE"
+>2.2. Building from Source</A
+></H2
+><P
+> The most convenient way to obtain the <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> sources
+ is to download the source tarball from our <A
+HREF="http://sf.net/projects/ijbswa/"
+TARGET="_top"
+>project
+ page</A
+>.</P
+><P
+> If you like to live on the bleeding edge and are not afraid of using
+ possibly unstable development versions, you can check out the up-to-the-minute
+ version directly from <A
+HREF="http://sourceforge.net/cvs/?group_id=11118"
+TARGET="_top"
+>the
+ CVS repository</A
+> or simply download <A
+HREF="http://cvs.sourceforge.net/cvstarballs/ijbswa-cvsroot.tar.gz"
+TARGET="_top"
+>the nightly CVS
+ tarball.</A
+></P
+><P
+> To build <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> from source, 
+ <A
+HREF="http://www.gnu.org/software/autoconf/autoconf.html"
+TARGET="_top"
+>autoconf</A
+>,
+ <A
+HREF="http://www.gnu.org/software/make/make.html"
+TARGET="_top"
+>GNU make
+ (gmake)</A
+>, and, of course, a C compiler like <A
+HREF="http://www.gnu.org/software/gcc/gcc.html"
+TARGET="_top"
+>gcc</A
+> are required.</P
+><P
+> When building from a source tarball (either release version or
+ <A
+HREF="http://cvs.sourceforge.net/cvstarballs/ijbswa-cvsroot.tar.gz"
+TARGET="_top"
+>nightly CVS
+ tarball</A
+>), first unpack the source: </P
+><P
+> <TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><PRE
+CLASS="SCREEN"
+> tar xzvf privoxy-2.9.15-beta-src* [.tgz or .tar.gz]
+ cd privoxy-2.9.15-beta</PRE
+></TD
+></TR
+></TABLE
+></P
+><P
+> For retrieving the current CVS sources, you'll need CVS installed.
+ Note that sources from CVS are development quality, and may not be
+ stable, or well tested. To download CVS source:</P
+><P
+> <TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><PRE
+CLASS="SCREEN"
+>  cvs -d:pserver:anonymous@cvs.ijbswa.sourceforge.net:/cvsroot/ijbswa login
+  cvs -z3 -d:pserver:anonymous@cvs.ijbswa.sourceforge.net:/cvsroot/ijbswa co current
+  cd current</PRE
+></TD
+></TR
+></TABLE
+></P
+><P
+> This will create a directory named <TT
+CLASS="FILENAME"
+>current/</TT
+>, which will 
+ contain the source tree.</P
+><P
+> Then, in either case, to build from unpacked tarball or CVS source:</P
+><P
+> <TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><PRE
+CLASS="SCREEN"
+> autoheader
+ autoconf
+ ./configure      # (--help to see options)
+ make             # (the make from gnu, gmake for *BSD) 
+ su 
+ make -n install  # (to see where all the files will go)
+ make install     # (to really install)</PRE
+></TD
+></TR
+></TABLE
+></P
+><P
+>  If you have gnu make, you can have the first four steps 
+  automatically done for you by just typing:</P
+><P
+> <TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="100%"
+><TR
+><TD
+><PRE
+CLASS="SCREEN"
+>  make</PRE
+></TD
+></TR
+></TABLE
+></P
+><P
+>  in the freshly downloaded or unpacked source directory.</P
+><P
+> For more detailed instructions on how to build Redhat and SuSE RPMs,
+ Windows self-extracting installers, building on platforms with
+ special requirements etc, please consult the <A
+HREF="../developer-manual/newrelease.html"
+TARGET="_top"
+>developer manual</A
+>.</P
+></DIV
+></DIV
+><DIV
 CLASS="NAVFOOTER"
 ><HR
 ALIGN="LEFT"
index 68b8dd8..1baca61 100644 (file)
@@ -78,7 +78,7 @@ NAME="INTRODUCTION"
  <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
->, v.2.9.14
+>, v.2.9.15
  and is mostly complete at this point. The most up to date reference for the
  time being is still the comments in the source files and in the individual
  configuration files. Development of version 3.0 is currently nearing
@@ -121,12 +121,6 @@ CLASS="APPLICATION"
 ><UL
 ><LI
 ><P
->  FIXME: complete the list of features. change the order: most important
-  features to the top of the list. prefix new features with "NEW".
-  </P
-></LI
-><LI
-><P
 >   Integrated browser based configuration and control utility at <A
 HREF="http://config.privoxy.org/"
 TARGET="_top"
@@ -142,7 +136,18 @@ TARGET="_top"
 ></LI
 ><LI
 ><P
->    Blocking of annoying pop-up browser windows.
+>   Web page content filtering (removes banners based on size,
+   invisible <SPAN
+CLASS="QUOTE"
+>"web-bugs"</SPAN
+>, JavaScript and HTML annoyances, pop-up windows, etc.)
+  </P
+></LI
+><LI
+><P
+>   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.
   </P
 ></LI
 ><LI
@@ -154,21 +159,17 @@ TARGET="_top"
 ><P
 >   Support for Perl Compatible Regular Expressions in the configuration files, and 
    generally a more sophisticated and flexible configuration syntax over
-   previous versions. 
+   previous versions.
   </P
 ></LI
 ><LI
 ><P
->   GIF de-animation. 
+>   Improved cookie management features (e.g. session based cookies).
   </P
 ></LI
 ><LI
 ><P
->   Web page content filtering (removes banners based on size,
-   invisible <SPAN
-CLASS="QUOTE"
->"web-bugs"</SPAN
->, JavaScript and HTML annoyances, pop-ups, etc.)
+>   GIF de-animation. 
   </P
 ></LI
 ><LI
@@ -183,17 +184,12 @@ CLASS="QUOTE"
 ></LI
 ><LI
 ><P
->   Auto-detection and re-reading of config file changes.
+>   User-customizable HTML templates for all proxy-generated pages (e.g. "blocked" page).
   </P
 ></LI
 ><LI
 ><P
->   User-customizable HTML templates (e.g. 404 error page).
-  </P
-></LI
-><LI
-><P
->   Improved cookie management features (e.g. session based cookies).
+>   Auto-detection and re-reading of config file changes.
   </P
 ></LI
 ><LI
index 17120a9..e3f8711 100644 (file)
@@ -71,7 +71,7 @@ CLASS="SECT1"
 CLASS="SECT1"
 ><A
 NAME="QUICKSTART"
->5. Quickstart to Using <SPAN
+>4. Quickstart to Using <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
 ></A
@@ -82,23 +82,35 @@ CLASS="APPLICATION"
 ><UL
 ><LI
 ><P
+>   If upgrading, please back up any configuration files. See 
+   the <A
+HREF="upgradersnote.html"
+>Note to Upgraders</A
+> Section.
+  </P
+></LI
+><LI
+><P
 >  Install <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
->. See the section <A
+>. See the <A
 HREF="installation.html"
->Installing</A
->.
-  </P
+>Installation Section</A
+> for platform specific
+  information. 
+ </P
 ></LI
 ><LI
 ><P
 >  Start <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
->. See the section <A
+>, if the installation program has
+  not done this already. See the section <A
 HREF="startup.html"
->Starting <SPAN
+>Starting
+  <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
 ></A
@@ -107,14 +119,26 @@ CLASS="APPLICATION"
 ></LI
 ><LI
 ><P
->  Change your browser's configuration to use the proxy <TT
+>  Set your browser to use <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> as HTTP and HTTPS
+  proxy by setting the proxy configuration for address of
+  <TT
 CLASS="LITERAL"
 >localhost</TT
-> on port
-  <TT
+> and port <TT
 CLASS="LITERAL"
 >8118</TT
->. See the section <A
+>.
+  (<SPAN
+CLASS="APPLICATION"
+>Junkbuster</SPAN
+> and earlier versions of
+  <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> used port 8000.) See the section <A
 HREF="startup.html"
 >Starting <SPAN
 CLASS="APPLICATION"
@@ -125,17 +149,47 @@ CLASS="APPLICATION"
 ></LI
 ><LI
 ><P
->  Enjoy surfing with enhanced comfort and privacy. Please see the section
+>    Flush your browser's caches, to remove any cached ad images.
+  </P
+></LI
+><LI
+><P
+>  Enjoy surfing with enhanced comfort and privacy.  You may want to customize the
   <A
-HREF="contact.html"
->Contacting the Developers</A
-> on how to report
-  bugs or problems with websites or to get help. You may want to change the
-  file <TT
+HREF="actions-file.html"
+><TT
 CLASS="FILENAME"
 >user.action</TT
-> to further tweak your new browsing
-  experience.
+></A
+> file to
+  personalize your new browsing experience. See the <A
+HREF="configuration.html"
+>Configuration section</A
+> for more configuration
+  options, and how to further customize your installation.
+  </P
+></LI
+><LI
+><P
+>   If you experience problems with sites that <SPAN
+CLASS="QUOTE"
+>"misbehave"</SPAN
+>, see
+   the <A
+HREF="appendix.html#ACTIONSANAT"
+>Anatomy of an Action</A
+> section in the
+   Appendix.
+  </P
+></LI
+><LI
+><P
+>   Please see the section <A
+HREF="contact.html"
+>Contacting the
+   Developers</A
+> on how to report bugs or problems with websites or to get
+   help. 
   </P
 ></LI
 ></UL
index 7c983c7..2ddf4c1 100644 (file)
@@ -71,7 +71,7 @@ CLASS="SECT1"
 CLASS="SECT1"
 ><A
 NAME="SEEALSO"
->14. See Also</A
+>13. See Also</A
 ></H1
 ><P
 > Other references and sites of interest to <SPAN
index 1fe9cc0..9193ffb 100644 (file)
@@ -71,7 +71,7 @@ CLASS="SECT1"
 CLASS="SECT1"
 ><A
 NAME="STARTUP"
->6. Starting <SPAN
+>5. Starting <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
 ></A
@@ -147,7 +147,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="START-REDHATDEBIAN"
->6.1. RedHat and Debian</A
+>5.1. RedHat and Debian</A
 ></H2
 ><P
 >We use a script. Note that RedHat does not start Privoxy upon booting per
@@ -177,7 +177,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="START-SUSE"
->6.2. SuSE</A
+>5.2. SuSE</A
 ></H2
 ><P
 >We use a script. It will use the file <TT
@@ -207,7 +207,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="START-WINDOWS"
->6.3. Windows</A
+>5.3. Windows</A
 ></H2
 ><P
 >Click on the Privoxy Icon to start Privoxy. If no configuration file is
@@ -227,7 +227,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="START-UNICES"
->6.4. Solaris, NetBSD, FreeBSD, HP-UX and others</A
+>5.4. Solaris, NetBSD, FreeBSD, HP-UX and others</A
 ></H2
 ><P
 >Example Unix startup command:</P
@@ -252,7 +252,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="START-OS2"
->6.5. OS/2</A
+>5.5. OS/2</A
 ></H2
 ><P
 >FIXME.</P
@@ -263,7 +263,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="START-MACOSX"
->6.6. MAX OSX</A
+>5.6. MAX OSX</A
 ></H2
 ><P
 >FIXME.</P
@@ -274,7 +274,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="START-AMIGAOS"
->6.7. AmigaOS</A
+>5.7. AmigaOS</A
 ></H2
 ><P
 >FIXME.</P
@@ -285,7 +285,7 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="CMDOPTIONS"
->6.8. Command Line Options</A
+>5.8. Command Line Options</A
 ></H2
 ><P
 > <SPAN
index db274f6..d4b24f1 100644 (file)
@@ -72,7 +72,7 @@ CLASS="SECT1"
 CLASS="SECT1"
 ><A
 NAME="TEMPLATES"
->11. Templates</A
+>10. Templates</A
 ></H1
 ><P
 > When <SPAN
index 097e850..56f71ea 100644 (file)
@@ -71,40 +71,49 @@ CLASS="SECT1"
 CLASS="SECT1"
 ><A
 NAME="UPGRADERSNOTE"
->4. Note to Upgraders</A
+>3. Note to Upgraders</A
 ></H1
 ><P
-> There are very significant changes from older versions of 
+> There are very significant changes from earlier 
  <SPAN
 CLASS="APPLICATION"
 >Junkbuster</SPAN
-> to the current
+> versions to the current
  <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
->. Configuration is substantially 
- changed. <SPAN
+>. The number, names, syntax, and
+ purposes of configuration files have substantially  changed.
+ <SPAN
 CLASS="APPLICATION"
 >Junkbuster 2.0.x</SPAN
-> and earlier 
- configuration files will not migrate. The functionality of the old
- <TT
+> configuration
+ files will not migrate, <SPAN
+CLASS="APPLICATION"
+>Junkbuster 2.9.x</SPAN
+>
+ and <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> configurations will need to be
+ ported. The functionalities of the old <TT
 CLASS="FILENAME"
 >blockfile</TT
->, <TT
+>,
+ <TT
 CLASS="FILENAME"
 >cookiefile</TT
-> and
- <TT
+> and <TT
 CLASS="FILENAME"
 >imagelist</TT
->, are now combined into the
- <A
+> 
are now combined into the <A
 HREF="actions-file.html"
 TARGET="_top"
 ><SPAN
 CLASS="QUOTE"
->"actions files"</SPAN
+>"actions
+ files"</SPAN
 ></A
 >.  
  <TT