From: oes Date: Fri, 26 Jul 2002 15:20:31 +0000 (+0000) Subject: - Added version info to title X-Git-Tag: v_2_9_16~13 X-Git-Url: http://www.privoxy.org/gitweb/?a=commitdiff_plain;h=2b9e37dfcacebf3862b80096b9326e1c42bd4499;p=privoxy.git - Added version info to title - Added info on new filters - Revised parts of the filter file tutorial - Added info on where to get updated actions files --- diff --git a/doc/source/user-manual.sgml b/doc/source/user-manual.sgml index 3f90f39b..40a5b56e 100644 --- a/doc/source/user-manual.sgml +++ b/doc/source/user-manual.sgml @@ -11,7 +11,7 @@ - + @@ -32,7 +32,7 @@ This file belongs into ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/ - $Id: user-manual.sgml,v 1.123.2.9 2002/07/11 03:40:28 david__schmidt Exp $ + $Id: user-manual.sgml,v 1.123.2.10 2002/07/25 21:42:29 hal9 Exp $ Copyright (C) 2001, 2002 Privoxy Developers See LICENSE. @@ -47,18 +47,18 @@
-Privoxy User Manual +Privoxy &p-version; User Manual Copyright &my-copy; 2001, 2002 by - Privoxy Developers + Privoxy Developers -$Id: user-manual.sgml,v 1.123.2.9 2002/07/11 03:40:28 david__schmidt Exp $ +$Id: user-manual.sgml,v 1.123.2.10 2002/07/25 21:42:29 hal9 Exp $ + + +Keeping your Installation Up-to-Date + + As user feedback comes in and development continues, we will make updated versions + of both the software and the main actions file + (default.action) available for download. + + + + If you wish to receive an email notification whenever we release updates of + Privoxy or the actions file, subscribe + to our announce mailing list, ijbswa-announce@lists.sourceforge.net. + + + + Both can be downloaded from the files + section on SourceForge. + + + + In order not to loose your personal changes and adjustments when updating + to the latest default.action file we strongly + recommend that you use user.action for your + customization of Privoxy. See the Chapter on actions files for details. + + + @@ -1376,8 +1407,8 @@ must find a better place for this paragraph provide a base level of functionality for Privoxy's array of features. So it is a set of broad rules that should work reasonably well for users everywhere. - This is the file that the developers are keeping updated, and making - available to users. + This is the file that the developers are keeping updated, and making available to users. @@ -2441,6 +2472,14 @@ problem-host.example.com +filter{banners-by-size} # Kill banners based on their size for this page (very efficient!) + + + +filter{banners-by-link} # Kill banners based on the link they are contained in (experimental) + + + + +filter{img-reorder} # Reorder attributes in <img> tags to make the banners-by-* filters more effective + +filter{content-cookies} # Kill cookies that come sneaking in the HTML or JS content @@ -2477,6 +2516,10 @@ problem-host.example.com +filter{crude-parental} # Kill all web pages that contain the words "sex" or "warez" + + + +filter{js-events} # Kill all JS event bindings (Radically destructive! Only for extra nasty sites) + @@ -3702,8 +3745,11 @@ shop = mercy-for-cookies -filter{popups} -kill-popups -filter{fun} \ +filter{nimda} \ +filter{banners-by-size} \ + -filter{banners-by-link} \ + -filter{img-reorder} \ -filter{shockwave-flash} \ -filter{crude-parental} \ + -filter{js-events} \ -handle-as-image \ +hide-forwarded-for-headers \ +hide-from-header{block} \ @@ -4368,7 +4414,7 @@ s|(<script.*)document\.referrer(.*</script>)|$1"Not Your Business!"$2|U # The status bar is for displaying link targets, not pointless blahblah # -s/window\.status\s*=\s*['"].*?['"]/dUmMy=1/ig +s/window\.status\s*=\s*(['"]).*?\1/dUmMy=1/ig @@ -4377,7 +4423,10 @@ s/window\.status\s*=\s*['"].*?['"]/dUmMy=1/ig or more whitespace. The ? in .*? makes this matching of arbitrary text ungreedy. (Note that the U option is not set). The ['"] construct means: a single - or a double quote. + or a double quote. Finally, \1 is + a backreference to the first parenthesis just like $1 above, + with the difference that in the pattern, a backslash indicates + a backreference, whereas in the substitute, it's the dollar. @@ -4393,7 +4442,7 @@ s/window\.status\s*=\s*['"].*?['"]/dUmMy=1/ig # Kill OnUnload popups. Yummy. Test: http://www.zdnet.com/zdsubs/yahoo/tree/yfs.html # -s/(<body .*)onunload(.*>)/$1never$2/iU +s/(<body [^>]*)onunload(.*>)/$1never$2/iU @@ -4404,7 +4453,11 @@ s/(<body .*)onunload(.*>)/$1never$2/iU This job replaces the onunload attribute in <body> tags with the dummy word never. Note that the i option makes the pattern matching - case-insensitive. + case-insensitive. Also note that ungreedy matching alone doesn't always guarantee + a minimal match: In the first parenthesis, we had to use [^>]* + instead of .* to prevent the match from exceeding the + <body> tag if it doesn't contain OnUnload, but the page's + content does. @@ -4434,6 +4487,8 @@ s/microsoft(?!\.com)/MicroSuck/ig # s* industry[ -]leading \ | cutting[ -]edge \ +| customer[ -]focused \ +| market[ -]driven \ | award[ -]winning # Comments are OK, too! \ | high[ -]performance \ | solutions[ -]based \ @@ -4446,7 +4501,7 @@ s* industry[ -]leading \ The x option in this job turns on extended syntax, and allows for - e.g. the liberal use of (non-interpreted!) whitespace for nicer formatting. + e.g. the liberal use of (non-interpreted!) whitespace for nicer formatting. @@ -5548,6 +5603,9 @@ In file: user.action [ View ] [ Edit ]