From 368c902fdd59356f93f21202797695664decef6b Mon Sep 17 00:00:00 2001 From: hal9 Date: Mon, 2 Oct 2006 22:43:53 +0000 Subject: [PATCH] Contains new filter definitions from Fabian, and few other miscellaneous touch-ups. --- doc/source/user-manual.sgml | 305 ++++++++++++++++++++++++++++-------- 1 file changed, 239 insertions(+), 66 deletions(-) diff --git a/doc/source/user-manual.sgml b/doc/source/user-manual.sgml index 0cadea86..be15be01 100644 --- a/doc/source/user-manual.sgml +++ b/doc/source/user-manual.sgml @@ -11,8 +11,8 @@ - - + + @@ -33,7 +33,7 @@ This file belongs into ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/ - $Id: user-manual.sgml,v 2.21 2006/09/20 03:21:36 david__schmidt Exp $ + $Id: user-manual.sgml,v 2.22 2006/09/22 01:27:55 hal9 Exp $ Copyright (C) 2001- 2006 Privoxy Developers http://www.privoxy.org See LICENSE. @@ -59,7 +59,7 @@ -$Id: user-manual.sgml,v 2.21 2006/09/20 03:21:36 david__schmidt Exp $ +$Id: user-manual.sgml,v 2.22 2006/09/22 01:27:55 hal9 Exp $ @@ -3407,7 +3410,8 @@ problem-host.example.com Typical use: - Get rid of HTML and JavaScript annoyances, banner advertisements (by size), do fun text replacements, etc. + Get rid of HTML and JavaScript annoyances, banner advertisements (by size), + do fun text replacements, add personalized effects, etc. @@ -3415,13 +3419,14 @@ problem-host.example.com Effect: - All files of text-based type, most notably HTML and JavaScript, to which this - action applies, are filtered on-the-fly through the specified regular expression - based substitutions. (Note: as of version 3.0.3 plain text documents - are exempted from filtering, because web servers often use the - text/plain MIME type for all files whose type they - don't know.) By default, filtering works only on the raw document content - itself (that which can be seen with View Source), + All files of text-based type, most notably HTML and + JavaScript, to which this action applies, can be filtered on-the-fly + through the specified regular expression based substitutions. (Note: as of + version 3.0.3 plain text documents are exempted from filtering, because + web servers often use the text/plain MIME type for all + files whose type they don't know.) By default, filtering works only on the + raw document content itself (that which can be seen with View + Source), not the headers. @@ -3475,8 +3480,9 @@ problem-host.example.com Regular Expressions and HTML. - This is very powerful feature, and potentially very intrusive. Use - with caution. + This is very powerful feature, and potentially very intrusive. + Filters should be used with caution, and where an equivalent + action is not available. The amount of data that can be filtered is limited to the @@ -3496,7 +3502,7 @@ problem-host.example.com At this time, Privoxy cannot uncompress compressed documents. If you want filtering to work on all documents, even those that - would normally be sent compressed, use the + would normally be sent compressed, you must use the prevent-compression action in conjunction with filter. @@ -3548,11 +3554,11 @@ problem-host.example.com - +filter{unsolicited-popups} # Disable only unsolicited pop-up windows + +filter{unsolicited-popups} # Disable only unsolicited pop-up windows. Useful if your browser lacks this ability. - +filter{all-popups} # Kill all popups in JavaScript and HTML + +filter{all-popups} # Kill all popups in JavaScript and HTML. Useful if your browser lacks this ability. @@ -3606,6 +3612,34 @@ problem-host.example.com +filter{ie-exploits} # Disable some known Internet Explorer bug exploits + + + +filter{site-specifics} # Custom filters for specific site related problems + + + + +filter{google} # Removes text ads and other Google specific improvements + + + + +filter{yahoo} # Removes text ads and other Yahoo specific improvements + + + + +filter{msn} # Removes text ads and other MSN specific improvements + + + + +filter{blogspot} # Cleans up Blogspot blogs + + + + +filter{html-to-xml} # Header filter to change the Content-Type from html to xml + + + + +filter{xml-to-html} # Header filter to change the Content-Type from xml to html + @@ -4760,7 +4794,7 @@ new action Killing all pop-ups unconditionally is problematic. Many shops and banks rely on pop-ups to display forms, shopping carts etc, and the filter{unsolicited-popups} - does a fairly good job of catching only the unwanted ones. + does a better job of catching only the unwanted ones. If the only kind of pop-ups that you want to kill are exit consoles (those @@ -4770,6 +4804,10 @@ new action linkend="filter">filter{js-annoyances} instead. + + This action is most appropriate for browsers that don't have any controls + for unwanted pop-ups. Not recommended for general usage. +