From: hal9 Date: Sun, 9 Jun 2002 00:30:30 +0000 (+0000) Subject: Syncing with minor additions on filtering. X-Git-Tag: v_2_9_16~43 X-Git-Url: http://www.privoxy.org/gitweb/?a=commitdiff_plain;h=1f4ad9c008c7a94159523577a10308393a1f01e0;p=privoxy.git Syncing with minor additions on filtering. --- diff --git a/doc/webserver/user-manual/actions-file.html b/doc/webserver/user-manual/actions-file.html index 88de3d04..64e36358 100644 --- a/doc/webserver/user-manual/actions-file.html +++ b/doc/webserver/user-manual/actions-file.html @@ -1741,8 +1741,9 @@ CLASS="VARIABLELIST" >Effect:

Text documents, including HTML and JavaScript, to which this action applies, are filtered on-the-fly - through the specified regular expression based substitutions. +> Text documents, including HTML and JavaScript, to which this action + applies, are filtered on-the-fly through the specified regular expression + based substitutions.

config file) +>). Filtering + can be completely disabled without the use of parameters. Example: + 

  { -filter }
+     .example.com
+

Disables filters for that site.

Notes:

For your convenience, there are a bunch of pre-defined filters available - in the distribution filter file that you can use. See the example below for +> For your convenience, there are a number of pre-defined filters available + in the distribution filter file that you can use. See the examples below for a list.

The amount of data that can be filtered is limited to the + buffer-limit + option in the main config file. The + default is 4096 KB (4 Megs). Once this limit is exceeded, the buffered + data, and all pending data, is passed through unfiltered. +

At this time, Privoxy.

Filtering can achieve some of the effects as the +> Filtering can achieve some of the same effects as the block - action, i.e. it can be used to block ads and banners. + action, i.e. it can be used to block ads and banners. But the mechanism + works quite differently. One effective use, is to block ad banners + based on their size (see below), since many of these seem to be somewhat + standardized.

Feedback with suggestions for new or improved filters is particularly - welcome! +> with suggestions for new or + improved filters is particularly welcome! 

+filter{banners-by-size}     # Kill banners by size (+filter{banners-by-size}     # Kill banners based on their size for this page (
8.5.21. Summary
8.5.21. Summary
 Note that many of these actions have the potential to cause a page to
  misbehave, possibly even not to display at all. There are many ways 
@@ -3872,7 +3912,7 @@ CLASS="SECT3"
 >
8.7.1. default.action
8.7.1. default.action
Every config file should start with a short comment stating its purpose:
8.7.2. user.action
8.7.2. user.action
 So far we are painting with a broad brush by setting general policies,
  which would be a reasonable starting point for many people. Now, 
diff --git a/doc/webserver/user-manual/appendix.html b/doc/webserver/user-manual/appendix.html
index 0a89f261..324cede4 100644
--- a/doc/webserver/user-manual/appendix.html
+++ b/doc/webserver/user-manual/appendix.html
@@ -740,7 +740,7 @@ CLASS="SECT2"
 >
14.2. 14.2. Privoxy's Internal Pages
 
@@ -818,7 +818,7 @@ CLASS="APPLICATION"
     editing of actions files:
   
 
@@ -836,7 +836,7 @@ TARGET="_top"
     Show the source code version numbers:
   
 
@@ -854,7 +854,7 @@ TARGET="_top"
    Show the browser's request headers:
   
 
@@ -872,7 +872,7 @@ TARGET="_top"
    Show which actions apply to a URL and why:
   
 
@@ -894,7 +894,7 @@ CLASS="QUOTE"
    to run, but only as a pass-through proxy, with no actions taking place:
   
 
@@ -909,7 +909,7 @@ TARGET="_top"
 >   Short cuts. Turn off, then on: 
   
 
@@ -921,7 +921,7 @@ TARGET="_top"
    
 
@@ -1326,7 +1326,8 @@ CLASS="APPLICATION"
 HREF="appendix.html#BOOKMARKLETS"
 >the Bookmarklets section on a quick 
- and easy way to do this (be sure to flush caches afterward!).
 "{+filter}" actions. Try 
- adding the URL for the site to one of aliases that turn off  actions. These 
+ tend to be harder to troubleshoot. Try adding the URL for the site to one of
+ aliases that turn off "+filter":
 This would probably be most appropriately put in  This would turn off all filtering for that site. This would probably be most
+ appropriately put in user.action, 
- for local site exceptions.
, for local site
+ exceptions.
 Images that are inexplicably being blocked, may well be hitting the 
+ "+filter{banners-by-size}" rule, which assumes 
+ that images of certain sizes are ad banners (works well most of the time 
+ since these tend to be standardized).
 
12.1. License
12.1. License
 
9.1. Filter File Tutorial
9.1. Filter File Tutorial
 Now, let's complete our "microsoft"
- in the page. This prevents links to microsoft.com from being messed, while
+ in the page. This prevents links to microsoft.com from being trashed, while
  still replacing the word everywhere else.
 
$Id: user-manual.sgml,v 1.123.2.5 2002/05/29 02:01:02 hal9 Exp $
$Id: user-manual.sgml,v 1.123.2.6 2002/06/06 23:11:03 hal9 Exp $