Generated
[privoxy.git] / doc / webserver / user-manual / actions-file.html
index ce10812..75a718d 100644 (file)
@@ -4,10 +4,9 @@
 >Actions Files</TITLE
 ><META
 NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
-"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.60"><LINK
 REL="HOME"
-TITLE="Privoxy User Manual"
+TITLE="Privoxy 2.9.16 User Manual"
 HREF="index.html"><LINK
 REL="PREVIOUS"
 TITLE="The Main Configuration File"
@@ -28,7 +27,6 @@ ALINK="#0000FF"
 ><DIV
 CLASS="NAVHEADER"
 ><TABLE
-SUMMARY="Header navigation table"
 WIDTH="100%"
 BORDER="0"
 CELLPADDING="0"
@@ -37,7 +35,7 @@ CELLSPACING="0"
 ><TH
 COLSPAN="3"
 ALIGN="center"
->Privoxy User Manual</TH
+>Privoxy 2.9.16 User Manual</TH
 ></TR
 ><TR
 ><TD
@@ -46,7 +44,6 @@ ALIGN="left"
 VALIGN="bottom"
 ><A
 HREF="config.html"
-ACCESSKEY="P"
 >Prev</A
 ></TD
 ><TD
@@ -60,7 +57,6 @@ ALIGN="right"
 VALIGN="bottom"
 ><A
 HREF="filter-file.html"
-ACCESSKEY="N"
 >Next</A
 ></TD
 ></TR
@@ -73,7 +69,9 @@ CLASS="SECT1"
 ><H1
 CLASS="SECT1"
 ><A
-NAME="ACTIONS-FILE">8. Actions Files</H1
+NAME="ACTIONS-FILE"
+>8. Actions Files</A
+></H1
 ><P
 > The actions files are used to define what actions
  <SPAN
@@ -105,8 +103,10 @@ CLASS="APPLICATION"
 >Privoxy's</SPAN
 > 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 <A
+HREF="installation.html#INSTALLATION-KEEPUPDATED"
+>making available to users</A
+>.
     </P
 ></LI
 ><LI
@@ -131,13 +131,10 @@ CLASS="FILENAME"
 CLASS="FILENAME"
 >default.action</TT
 >. These have increasing levels of
-     aggressiveness <SPAN
-CLASS="emphasis"
-><I
+     aggressiveness <I
 CLASS="EMPHASIS"
 >and have no influence on your browsing unless
      you select them explicitly in the editor</I
-></SPAN
 >. It is not recommend
      to edit this file.
     </P
@@ -164,12 +161,9 @@ HREF="actions-file.html#ALIASES"
 >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 <SPAN
-CLASS="emphasis"
-><I
+ sites and pages (be <I
 CLASS="EMPHASIS"
 >very careful</I
-></SPAN
 > with using such a
  universal set in <TT
 CLASS="FILENAME"
@@ -209,7 +203,9 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="AEN1584">8.1. Finding the Right Mix</H2
+NAME="AEN1610"
+>8.1. Finding the Right Mix</A
+></H2
 ><P
 > Note that some <A
 HREF="actions-file.html#ACTIONS"
@@ -241,7 +237,9 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="AEN1591">8.2. How to Edit</H2
+NAME="AEN1617"
+>8.2. How to Edit</A
+></H2
 ><P
 > The easiest way to edit the actions files is with a browser by
  using our browser-based editor, which can be reached from <A
@@ -274,7 +272,9 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="ACTIONS-APPLY">8.3. How Actions are Applied to URLs</H2
+NAME="ACTIONS-APPLY"
+>8.3. How Actions are Applied to URLs</A
+></H2
 ><P
 > Actions files are divided into sections. There are special sections,
  like the <SPAN
@@ -313,12 +313,9 @@ TARGET="_top"
 >block</A
 > }</TT
 >, resulting
- in <SPAN
-CLASS="emphasis"
-><I
+ in <I
 CLASS="EMPHASIS"
 >both</I
-></SPAN
 > actions to apply.</P
 ><P
 > You can trace this process for any given URL by visiting <A
@@ -337,7 +334,9 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="AF-PATTERNS">8.4. Patterns</H2
+NAME="AF-PATTERNS"
+>8.4. Patterns</A
+></H2
 ><P
 > Generally, a pattern has the form <TT
 CLASS="LITERAL"
@@ -415,12 +414,9 @@ CLASS="LITERAL"
 CLASS="LITERAL"
 >/index.html</TT
 >, regardless of the domain,
-    i.e. on <SPAN
-CLASS="emphasis"
-><I
+    i.e. on <I
 CLASS="EMPHASIS"
 >any</I
-></SPAN
 > web server.
    </P
 ></DD
@@ -445,7 +441,9 @@ CLASS="SECT3"
 ><H3
 CLASS="SECT3"
 ><A
-NAME="AEN1655">8.4.1. The Domain Pattern</H3
+NAME="AEN1681"
+>8.4.1. The Domain Pattern</A
+></H3
 ><P
 > The matching of the domain part offers some flexible options: if the
  domain starts or ends with a dot, it becomes unanchored at that end. 
@@ -462,12 +460,9 @@ CLASS="LITERAL"
 ></DT
 ><DD
 ><P
->    matches any domain that <SPAN
-CLASS="emphasis"
-><I
+>    matches any domain that <I
 CLASS="EMPHASIS"
 >ENDS</I
-></SPAN
 > in
     <TT
 CLASS="LITERAL"
@@ -482,12 +477,9 @@ CLASS="LITERAL"
 ></DT
 ><DD
 ><P
->    matches any domain that <SPAN
-CLASS="emphasis"
-><I
+>    matches any domain that <I
 CLASS="EMPHASIS"
 >STARTS</I
-></SPAN
 > with
     <TT
 CLASS="LITERAL"
@@ -502,12 +494,9 @@ CLASS="LITERAL"
 ></DT
 ><DD
 ><P
->    matches any domain that <SPAN
-CLASS="emphasis"
-><I
+>    matches any domain that <I
 CLASS="EMPHASIS"
 >CONTAINS</I
-></SPAN
 > <TT
 CLASS="LITERAL"
 >.example.</TT
@@ -608,12 +597,9 @@ CLASS="LITERAL"
      <TT
 CLASS="LITERAL"
 >wwwz.example.com</TT
-> etc., but <SPAN
-CLASS="emphasis"
-><I
+> etc., but <I
 CLASS="EMPHASIS"
 >not</I
-></SPAN
 > 
      <TT
 CLASS="LITERAL"
@@ -629,7 +615,9 @@ CLASS="SECT3"
 ><H3
 CLASS="SECT3"
 ><A
-NAME="AEN1717">8.4.2. The Path Pattern</H3
+NAME="AEN1743"
+>8.4.2. The Path Pattern</A
+></H3
 ><P
 > <SPAN
 CLASS="APPLICATION"
@@ -672,12 +660,9 @@ CLASS="QUOTE"
 > (regular expression speak 
  for the beginning of a line).</P
 ><P
-> Please also note that matching in the path is <SPAN
-CLASS="emphasis"
-><I
+> Please also note that matching in the path is <I
 CLASS="EMPHASIS"
 >CASE INSENSITIVE</I
-></SPAN
 >
  by default, but you can switch to case sensitive at any point in the pattern by using the 
  <SPAN
@@ -691,12 +676,9 @@ CLASS="LITERAL"
 CLASS="LITERAL"
 >PaTtErN</TT
 > in
- <SPAN
-CLASS="emphasis"
-><I
+ <I
 CLASS="EMPHASIS"
 >exactly</I
-></SPAN
 > this capitalization.</P
 ></DIV
 ></DIV
@@ -705,7 +687,9 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="ACTIONS">8.5. Actions</H2
+NAME="ACTIONS"
+>8.5. Actions</A
+></H2
 ><P
 > All actions are disabled by default, until they are explicitly enabled
  somewhere in an actions file. Actions are turned on if preceded with a
@@ -876,19 +860,13 @@ CLASS="LITERAL"
 >  
    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, <SPAN
-CLASS="emphasis"
-><I
+   same URL, but with different parameters, <I
 CLASS="EMPHASIS"
 >all</I
-></SPAN
 > the parameters
-   from <SPAN
-CLASS="emphasis"
-><I
+   from <I
 CLASS="EMPHASIS"
 >all</I
-></SPAN
 > 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:
@@ -994,7 +972,9 @@ CLASS="SECT3"
 ><H4
 CLASS="SECT3"
 ><A
-NAME="ADD-HEADER">8.5.1. add-header</H4
+NAME="ADD-HEADER"
+>8.5.1. add-header</A
+></H4
 ><P
 ></P
 ><DIV
@@ -1074,7 +1054,9 @@ CLASS="SECT3"
 ><H4
 CLASS="SECT3"
 ><A
-NAME="BLOCK">8.5.2. block</H4
+NAME="BLOCK"
+>8.5.2. block</A
+></H4
 ><P
 ></P
 ><DIV
@@ -1155,12 +1137,9 @@ CLASS="QUOTE"
    </P
 ><P
 > 
-    A very important exception occurs if <SPAN
-CLASS="emphasis"
-><I
+    A very important exception occurs if <I
 CLASS="EMPHASIS"
 >both</I
-></SPAN
 > 
     <TT
 CLASS="LITERAL"
@@ -1240,7 +1219,9 @@ CLASS="SECT3"
 ><H4
 CLASS="SECT3"
 ><A
-NAME="CRUNCH-INCOMING-COOKIES">8.5.3. crunch-incoming-cookies</H4
+NAME="CRUNCH-INCOMING-COOKIES"
+>8.5.3. crunch-incoming-cookies</A
+></H4
 ><P
 ></P
 ><DIV
@@ -1280,19 +1261,13 @@ CLASS="QUOTE"
 >Notes:</DT
 ><DD
 ><P
->    This action is only concerned with <SPAN
-CLASS="emphasis"
-><I
+>    This action is only concerned with <I
 CLASS="EMPHASIS"
 >incoming</I
-></SPAN
 > cookies. For
-    <SPAN
-CLASS="emphasis"
-><I
+    <I
 CLASS="EMPHASIS"
 >outgoing</I
-></SPAN
 > cookies, use
     <TT
 CLASS="LITERAL"
@@ -1301,21 +1276,15 @@ HREF="actions-file.html#CRUNCH-OUTGOING-COOKIES"
 >crunch-outgoing-cookies</A
 ></TT
 >.
-    Use <SPAN
-CLASS="emphasis"
-><I
+    Use <I
 CLASS="EMPHASIS"
 >both</I
-></SPAN
 > to disable cookies completely.
    </P
 ><P
->    It makes <SPAN
-CLASS="emphasis"
-><I
+>    It makes <I
 CLASS="EMPHASIS"
 >no sense at all</I
-></SPAN
 > to use this action in conjunction
     with the <TT
 CLASS="LITERAL"
@@ -1354,7 +1323,9 @@ CLASS="SECT3"
 ><H4
 CLASS="SECT3"
 ><A
-NAME="CRUNCH-OUTGOING-COOKIES">8.5.4. crunch-outgoing-cookies</H4
+NAME="CRUNCH-OUTGOING-COOKIES"
+>8.5.4. crunch-outgoing-cookies</A
+></H4
 ><P
 ></P
 ><DIV
@@ -1394,19 +1365,13 @@ CLASS="QUOTE"
 >Notes:</DT
 ><DD
 ><P
->    This action is only concerned with <SPAN
-CLASS="emphasis"
-><I
+>    This action is only concerned with <I
 CLASS="EMPHASIS"
 >outgoing</I
-></SPAN
 > cookies. For
-    <SPAN
-CLASS="emphasis"
-><I
+    <I
 CLASS="EMPHASIS"
 >incoming</I
-></SPAN
 > cookies, use
     <TT
 CLASS="LITERAL"
@@ -1415,21 +1380,15 @@ HREF="actions-file.html#CRUNCH-INCOMING-COOKIES"
 >crunch-incoming-cookies</A
 ></TT
 >.
-    Use <SPAN
-CLASS="emphasis"
-><I
+    Use <I
 CLASS="EMPHASIS"
 >both</I
-></SPAN
 > to disable cookies completely.
    </P
 ><P
->    It makes <SPAN
-CLASS="emphasis"
-><I
+>    It makes <I
 CLASS="EMPHASIS"
 >no sense at all</I
-></SPAN
 > to use this action in conjunction
     with the <TT
 CLASS="LITERAL"
@@ -1468,7 +1427,9 @@ CLASS="SECT3"
 ><H4
 CLASS="SECT3"
 ><A
-NAME="DEANIMATE-GIFS">8.5.5. deanimate-gifs</H4
+NAME="DEANIMATE-GIFS"
+>8.5.5. deanimate-gifs</A
+></H4
 ><P
 ></P
 ><DIV
@@ -1556,7 +1517,9 @@ CLASS="SECT3"
 ><H4
 CLASS="SECT3"
 ><A
-NAME="DOWNGRADE-HTTP-VERSION">8.5.6. downgrade-http-version</H4
+NAME="DOWNGRADE-HTTP-VERSION"
+>8.5.6. downgrade-http-version</A
+></H4
 ><P
 ></P
 ><DIV
@@ -1630,7 +1593,9 @@ CLASS="SECT3"
 ><H4
 CLASS="SECT3"
 ><A
-NAME="FAST-REDIRECTS">8.5.7. fast-redirects</H4
+NAME="FAST-REDIRECTS"
+>8.5.7. fast-redirects</A
+></H4
 ><P
 ></P
 ><DIV
@@ -1671,12 +1636,9 @@ CLASS="VARIABLELIST"
     will link to some script on their own servers, giving the destination as a
     parameter, which will then redirect you to the final target. URLs
     resulting from this scheme typically look like:
-    <SPAN
-CLASS="emphasis"
-><I
+    <I
 CLASS="EMPHASIS"
 >http://some.place/click-tracker.cgi?target=http://some.where.else</I
-></SPAN
 >.
   </P
 ><P
@@ -1725,7 +1687,9 @@ CLASS="SECT3"
 ><H4
 CLASS="SECT3"
 ><A
-NAME="FILTER">8.5.8. filter</H4
+NAME="FILTER"
+>8.5.8. filter</A
+></H4
 ><P
 ></P
 ><DIV
@@ -1915,12 +1879,9 @@ WIDTH="90%"
 ><TD
 ><PRE
 CLASS="SCREEN"
->+filter{banners-by-size}     # Kill banners based on their size for this page (<SPAN
-CLASS="emphasis"
-><I
+>+filter{banners-by-size}     # Kill banners based on their size for this page (<I
 CLASS="EMPHASIS"
 >very</I
-></SPAN
 > efficient!)</PRE
 ></TD
 ></TR
@@ -1929,6 +1890,44 @@ CLASS="EMPHASIS"
    </P
 ><P
 >    <A
+NAME="FILTER-BANNERS-BY-LINK"
+></A
+>
+    <TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="90%"
+><TR
+><TD
+><PRE
+CLASS="SCREEN"
+>+filter{banners-by-link}     # Kill banners based on the link they are contained in (experimental)</PRE
+></TD
+></TR
+></TABLE
+>
+   </P
+><P
+>    <A
+NAME="FILTER-IMG-REORDER"
+></A
+>
+    <TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="90%"
+><TR
+><TD
+><PRE
+CLASS="SCREEN"
+>+filter{img-reorder}         # Reorder attributes in &#60;img&#62; tags to make the banners-by-* filters more effective</PRE
+></TD
+></TR
+></TABLE
+>
+   </P
+><P
+>    <A
 NAME="FILTER-CONTENT-COOKIES"
 ></A
 >
@@ -2096,6 +2095,28 @@ CLASS="SCREEN"
 ></TD
 ></TR
 ></TABLE
+>
+   </P
+><P
+>    <A
+NAME="FILTER-JS-EVENTS"
+></A
+>
+    <TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="90%"
+><TR
+><TD
+><PRE
+CLASS="SCREEN"
+>+filter{js-events}           # Kill all JS event bindings (<I
+CLASS="EMPHASIS"
+>Radically destructive!</I
+> Only for extra nasty sites) </PRE
+></TD
+></TR
+></TABLE
 >
    </P
 ></DD
@@ -2107,7 +2128,9 @@ CLASS="SECT3"
 ><H4
 CLASS="SECT3"
 ><A
-NAME="HANDLE-AS-IMAGE">8.5.9. handle-as-image</H4
+NAME="HANDLE-AS-IMAGE"
+>8.5.9. handle-as-image</A
+></H4
 ><P
 ></P
 ><DIV
@@ -2117,12 +2140,9 @@ CLASS="VARIABLELIST"
 >Typical use:</DT
 ><DD
 ><P
->Mark URLs as belonging to images (so they'll be replaced by images <SPAN
-CLASS="emphasis"
-><I
+>Mark URLs as belonging to images (so they'll be replaced by images <I
 CLASS="EMPHASIS"
 >if they get blocked</I
-></SPAN
 >)</P
 ></DD
 ><DT
@@ -2136,12 +2156,9 @@ CLASS="LITERAL"
 HREF="actions-file.html#BLOCK"
 >block</A
 ></TT
-> action <SPAN
-CLASS="emphasis"
-><I
+> action <I
 CLASS="EMPHASIS"
 >also applies</I
-></SPAN
 >,
     the presence or absence of this mark decides whether an HTML <SPAN
 CLASS="QUOTE"
@@ -2241,7 +2258,9 @@ CLASS="SECT3"
 ><H4
 CLASS="SECT3"
 ><A
-NAME="HIDE-FORWARDED-FOR-HEADERS">8.5.10. hide-forwarded-for-headers</H4
+NAME="HIDE-FORWARDED-FOR-HEADERS"
+>8.5.10. hide-forwarded-for-headers</A
+></H4
 ><P
 ></P
 ><DIV
@@ -2320,7 +2339,9 @@ CLASS="SECT3"
 ><H4
 CLASS="SECT3"
 ><A
-NAME="HIDE-FROM-HEADER">8.5.11. hide-from-header</H4
+NAME="HIDE-FROM-HEADER"
+>8.5.11. hide-from-header</A
+></H4
 ><P
 ></P
 ><DIV
@@ -2429,7 +2450,9 @@ CLASS="SECT3"
 ><H4
 CLASS="SECT3"
 ><A
-NAME="HIDE-REFERRER">8.5.12. hide-referrer</H4
+NAME="HIDE-REFERRER"
+>8.5.12. hide-referrer</A
+></H4
 ><A
 NAME="HIDE-REFERER"
 ></A
@@ -2497,12 +2520,9 @@ CLASS="QUOTE"
 > is the preferred option here, since some servers will
     not send images back otherwise, in an attempt to prevent their valuable
     content from being embedded elsewhere (and hence, without being surrounded
-    by <SPAN
-CLASS="emphasis"
-><I
+    by <I
 CLASS="EMPHASIS"
 >their</I
-></SPAN
 > banners).
    </P
 ><P
@@ -2566,7 +2586,9 @@ CLASS="SECT3"
 ><H4
 CLASS="SECT3"
 ><A
-NAME="HIDE-USER-AGENT">8.5.13. hide-user-agent</H4
+NAME="HIDE-USER-AGENT"
+>8.5.13. hide-user-agent</A
+></H4
 ><P
 ></P
 ><DIV
@@ -2626,12 +2648,9 @@ ALIGN="LEFT"
 ><P
 >     This breaks many web sites that depend on looking at this header in order
      to customize their content for different browsers (which, by the
-     way, is <SPAN
-CLASS="emphasis"
-><I
+     way, is <I
 CLASS="EMPHASIS"
 >NOT</I
-></SPAN
 > a <A
 HREF="http://www.javascriptkit.com/javaindex.shtml"
 TARGET="_top"
@@ -2649,12 +2668,9 @@ TARGET="_top"
 CLASS="APPLICATION"
 >Privoxy</SPAN
 > is
-    <SPAN
-CLASS="emphasis"
-><I
+    <I
 CLASS="EMPHASIS"
 >not recommended</I
-></SPAN
 >. In single-user, single-browser
     setups, you might use it to delete your OS version information from
     the headers, because it is an invitation to exploit known bugs for your
@@ -2702,9 +2718,11 @@ CLASS="SECT3"
 ><H4
 CLASS="SECT3"
 ><A
-NAME="KILL-POPUPS">8.5.14. kill-popups<A
+NAME="KILL-POPUPS"
+>8.5.14. kill-popups<A
 NAME="KILL-POPUP"
 ></A
+></A
 ></H4
 ><P
 ></P
@@ -2803,12 +2821,9 @@ CLASS="APPLICATION"
 >Privoxy</SPAN
 >.
     If the only kind of pop-ups that you want to kill are exit consoles (those
-    <SPAN
-CLASS="emphasis"
-><I
+    <I
 CLASS="EMPHASIS"
 >really nasty</I
-></SPAN
 > windows that appear when you close an other
     one), you might want to use
     <TT
@@ -2852,7 +2867,9 @@ CLASS="SECT3"
 ><H4
 CLASS="SECT3"
 ><A
-NAME="LIMIT-CONNECT">8.5.15. limit-connect</H4
+NAME="LIMIT-CONNECT"
+>8.5.15. limit-connect</A
+></H4
 ><P
 ></P
 ><DIV
@@ -2953,7 +2970,9 @@ CLASS="SECT3"
 ><H4
 CLASS="SECT3"
 ><A
-NAME="PREVENT-COMPRESSION">8.5.16. prevent-compression</H4
+NAME="PREVENT-COMPRESSION"
+>8.5.16. prevent-compression</A
+></H4
 ><P
 ></P
 ><DIV
@@ -3082,7 +3101,9 @@ CLASS="SECT3"
 ><H4
 CLASS="SECT3"
 ><A
-NAME="SEND-VANILLA-WAFER">8.5.17. send-vanilla-wafer</H4
+NAME="SEND-VANILLA-WAFER"
+>8.5.17. send-vanilla-wafer</A
+></H4
 ><P
 ></P
 ><DIV
@@ -3153,7 +3174,9 @@ CLASS="SECT3"
 ><H4
 CLASS="SECT3"
 ><A
-NAME="SEND-WAFER">8.5.18. send-wafer</H4
+NAME="SEND-WAFER"
+>8.5.18. send-wafer</A
+></H4
 ><P
 ></P
 ><DIV
@@ -3238,7 +3261,9 @@ CLASS="SECT3"
 ><H4
 CLASS="SECT3"
 ><A
-NAME="SESSION-COOKIES-ONLY">8.5.19. session-cookies-only</H4
+NAME="SESSION-COOKIES-ONLY"
+>8.5.19. session-cookies-only</A
+></H4
 ><P
 ></P
 ><DIV
@@ -3251,12 +3276,9 @@ CLASS="VARIABLELIST"
 >    Allow only temporary <SPAN
 CLASS="QUOTE"
 >"session"</SPAN
-> cookies (for the current browser session <SPAN
-CLASS="emphasis"
-><I
+> cookies (for the current browser session <I
 CLASS="EMPHASIS"
 >only</I
-></SPAN
 >).
    </P
 ></DD
@@ -3318,12 +3340,9 @@ CLASS="LITERAL"
     sites, and is the recommended setting.
    </P
 ><P
->    It makes <SPAN
-CLASS="emphasis"
-><I
+>    It makes <I
 CLASS="EMPHASIS"
 >no sense at all</I
-></SPAN
 > to use <TT
 CLASS="LITERAL"
 >session-cookies-only</TT
@@ -3379,7 +3398,9 @@ CLASS="SECT3"
 ><H4
 CLASS="SECT3"
 ><A
-NAME="SET-IMAGE-BLOCKER">8.5.20. set-image-blocker</H4
+NAME="SET-IMAGE-BLOCKER"
+>8.5.20. set-image-blocker</A
+></H4
 ><P
 ></P
 ><DIV
@@ -3395,12 +3416,9 @@ CLASS="VARIABLELIST"
 >Effect:</DT
 ><DD
 ><P
->     This action alone doesn't do anything noticeable. If <SPAN
-CLASS="emphasis"
-><I
+>     This action alone doesn't do anything noticeable. If <I
 CLASS="EMPHASIS"
 >both</I
-></SPAN
 >
      <TT
 CLASS="LITERAL"
@@ -3408,32 +3426,23 @@ CLASS="LITERAL"
 HREF="actions-file.html#BLOCK"
 >block</A
 ></TT
-> <SPAN
-CLASS="emphasis"
-><I
+> <I
 CLASS="EMPHASIS"
 >and</I
-></SPAN
 > <TT
 CLASS="LITERAL"
 ><A
 HREF="actions-file.html#HANDLE-AS-IMAGE"
 >handle-as-image</A
 ></TT
-> <SPAN
-CLASS="emphasis"
-><I
+> <I
 CLASS="EMPHASIS"
 >also</I
-></SPAN
 >
      apply, i.e. if the request is to be blocked as an image,
-     <SPAN
-CLASS="emphasis"
-><I
+     <I
 CLASS="EMPHASIS"
 >then</I
-></SPAN
 > the parameter of this action decides what will be
      sent as a replacement.
    </P
@@ -3552,12 +3561,9 @@ CLASS="QUOTE"
 >    There is a third (advanced) type, called <SPAN
 CLASS="QUOTE"
 >"auto"</SPAN
->. It is <SPAN
-CLASS="emphasis"
-><I
+>. It is <I
 CLASS="EMPHASIS"
 >NOT</I
-></SPAN
 > to be
     used in <TT
 CLASS="LITERAL"
@@ -3635,7 +3641,9 @@ CLASS="SECT3"
 ><H3
 CLASS="SECT3"
 ><A
-NAME="AEN2635">8.5.21. Summary</H3
+NAME="AEN2671"
+>8.5.21. Summary</A
+></H3
 ><P
 > 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 
@@ -3653,7 +3661,9 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="ALIASES">8.6. Aliases</H2
+NAME="ALIASES"
+>8.6. Aliases</A
+></H2
 ><P
 > Custom <SPAN
 CLASS="QUOTE"
@@ -3678,13 +3688,10 @@ CLASS="QUOTE"
 > and <SPAN
 CLASS="QUOTE"
 >"}"</SPAN
->, but we <SPAN
-CLASS="emphasis"
-><I
+>, but we <I
 CLASS="EMPHASIS"
 >strongly 
  recommend</I
-></SPAN
 > that you only use <SPAN
 CLASS="QUOTE"
 >"a"</SPAN
@@ -3715,13 +3722,10 @@ CLASS="QUOTE"
 > sign, since they are merely textually
  expanded.</P
 ><P
-> Aliases can be used throughout the actions file, but they <SPAN
-CLASS="emphasis"
-><I
+> Aliases can be used throughout the actions file, but they <I
 CLASS="EMPHASIS"
 >must be
  defined in a special section at the top of the file!</I
-></SPAN
 >
  And there can only be one such section per actions file. Each actions file may
  have its own alias section, and the aliases defined in it are only visible
@@ -3734,12 +3738,9 @@ CLASS="EMPHASIS"
 CLASS="QUOTE"
 >"shop"</SPAN
 >, you can later change your policy on shops in
- <SPAN
-CLASS="emphasis"
-><I
+ <I
 CLASS="EMPHASIS"
 >one</I
-></SPAN
 > place, and your changes will take effect everywhere
  in the actions file where the <SPAN
 CLASS="QUOTE"
@@ -3860,7 +3861,9 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="ACT-EXAMPLES">8.7. Actions Files Tutorial</H2
+NAME="ACT-EXAMPLES"
+>8.7. Actions Files Tutorial</A
+></H2
 ><P
 > The above chapters have shown <A
 HREF="actions-file.html"
@@ -3894,7 +3897,9 @@ CLASS="SECT3"
 ><H3
 CLASS="SECT3"
 ><A
-NAME="AEN2687">8.7.1. default.action</H3
+NAME="AEN2723"
+>8.7.1. default.action</A
+></H3
 ><P
 >Every config file should start with a short comment stating its purpose:</P
 ><P
@@ -3977,13 +3982,10 @@ shop        = mercy-for-cookies -filter{popups} -kill-popups</PRE
 ></P
 ><P
 > Now come the regular sections, i.e. sets of actions, accompanied
- by URL patterns to which they apply. Remember <SPAN
-CLASS="emphasis"
-><I
+ by URL patterns to which they apply. Remember <I
 CLASS="EMPHASIS"
 >all actions
  are disabled when matching starts</I
-></SPAN
 >, so we have to explicitly
  enable the ones we want.</P
 ><P
@@ -4002,13 +4004,10 @@ HREF="actions-file.html#AF-PATTERNS"
  set of actions used in this <SPAN
 CLASS="QUOTE"
 >"default"</SPAN
-> section <SPAN
-CLASS="emphasis"
-><I
+> section <I
 CLASS="EMPHASIS"
 >will
  be applied to all requests as a start</I
-></SPAN
 >. It can  be partly or
  wholly overridden by later matches further down this file, or in user.action,
  but it will still be largely responsible for your overall browsing
@@ -4102,6 +4101,14 @@ HREF="actions-file.html#FILTER-NIMDA"
  +<A
 HREF="actions-file.html#FILTER-BANNERS-BY-SIZE"
 >filter{banners-by-size}</A
+> \
+ -<A
+HREF="actions-file.html#FILTER-BANNERS-BY-LINK"
+>filter{banners-by-link}</A
+> \
+ -<A
+HREF="actions-file.html#FILTER-IMG-REORDER"
+>filter{img-reorder}</A
 > \
  -<A
 HREF="actions-file.html#FILTER-SHOCKWAVE-FLASH"
@@ -4110,6 +4117,10 @@ HREF="actions-file.html#FILTER-SHOCKWAVE-FLASH"
  -<A
 HREF="actions-file.html#FILTER-CRUDE-PARENTAL"
 >filter{crude-parental}</A
+> \
+ -<A
+HREF="actions-file.html#FILTER-JS-EVENTS"
+>filter{js-events}</A
 > \
  -<A
 HREF="actions-file.html#HANDLE-AS-IMAGE"
@@ -4172,12 +4183,9 @@ CLASS="QUOTE"
 >"general policy"</SPAN
 > that applies
  universally and won't get any exceptions defined later. Other choices,
- like not blocking (which is <SPAN
-CLASS="emphasis"
-><I
+ like not blocking (which is <I
 CLASS="EMPHASIS"
 >understandably</I
-></SPAN
 > the
  default!) need exceptions, i.e. we need to specify explicitly what we
  want to block in later sections.
@@ -4332,22 +4340,16 @@ edit.*.yahoo.com
 CLASS="APPLICATION"
 >Privoxy</SPAN
 > knows which
- URLs belong to images, so that <SPAN
-CLASS="emphasis"
-><I
+ URLs belong to images, so that <I
 CLASS="EMPHASIS"
 >if</I
-></SPAN
 > they are to
  be blocked, a substitute image can be sent, rather than an HTML page.
  Contacting the remote site to find out is not an option, since it
  would destroy the loading time advantage of banner blocking, and it
- would feed the advertisers (in terms of money <SPAN
-CLASS="emphasis"
-><I
+ would feed the advertisers (in terms of money <I
 CLASS="EMPHASIS"
 >and</I
-></SPAN
 >
  information). We can mark any URL as an image with the <TT
 CLASS="LITERAL"
@@ -4386,12 +4388,9 @@ HREF="actions-file.html#HANDLE-AS-IMAGE"
 ><P
 > And then there are known banner sources. They often use scripts to
  generate the banners, so it won't be visible from the URL that the
- request is for an image. Hence we block them <SPAN
-CLASS="emphasis"
-><I
+ request is for an image. Hence we block them <I
 CLASS="EMPHASIS"
 >and</I
-></SPAN
 >
  mark them as images in one go, with the help of our
  <TT
@@ -4537,32 +4536,23 @@ CLASS="LITERAL"
 > e.g. catches 
  <SPAN
 CLASS="QUOTE"
->"nasty-<SPAN
-CLASS="emphasis"
-><I
+>"nasty-<I
 CLASS="EMPHASIS"
 >ads</I
-></SPAN
 >.nasty-corp.com"</SPAN
 > as intended,
  but also <SPAN
 CLASS="QUOTE"
->"downlo<SPAN
-CLASS="emphasis"
-><I
+>"downlo<I
 CLASS="EMPHASIS"
 >ads</I
-></SPAN
 >.sourcefroge.net"</SPAN
 > or
  <SPAN
 CLASS="QUOTE"
->"<SPAN
-CLASS="emphasis"
-><I
+>"<I
 CLASS="EMPHASIS"
 >ads</I
-></SPAN
 >l.some-provider.net."</SPAN
 > So here come some
  well-known exceptions to the <TT
@@ -4609,12 +4599,9 @@ HREF="actions-file.html#BLOCK"
 >-block</A
 ></TT
 >
- applies, so (unless it matches <SPAN
-CLASS="emphasis"
-><I
+ applies, so (unless it matches <I
 CLASS="EMPHASIS"
 >again</I
-></SPAN
 > further down) it ends up
  with no <TT
 CLASS="LITERAL"
@@ -4674,12 +4661,9 @@ HREF="actions-file.html#FILTER"
 >filter</A
 ></TT
 >
- disables <SPAN
-CLASS="emphasis"
-><I
+ disables <I
 CLASS="EMPHASIS"
 >all</I
-></SPAN
 > filters in one fell swoop!</P
 ><P
 > <TABLE
@@ -4714,7 +4698,9 @@ CLASS="SECT3"
 ><H3
 CLASS="SECT3"
 ><A
-NAME="AEN2841">8.7.2. user.action</H3
+NAME="AEN2880"
+>8.7.2. user.action</A
+></H3
 ><P
 > So far we are painting with a broad brush by setting general policies,
  which would be a reasonable starting point for many people. Now, 
@@ -4730,12 +4716,9 @@ CLASS="FILENAME"
 CLASS="FILENAME"
 >user.action</TT
 > is also a 
- <SPAN
-CLASS="emphasis"
-><I
+ <I
 CLASS="EMPHASIS"
 >safe</I
-></SPAN
 > place for your personal settings, since
  <TT
 CLASS="FILENAME"
@@ -5018,7 +5001,6 @@ CLASS="NAVFOOTER"
 ><HR
 ALIGN="LEFT"
 WIDTH="100%"><TABLE
-SUMMARY="Footer navigation table"
 WIDTH="100%"
 BORDER="0"
 CELLPADDING="0"
@@ -5030,7 +5012,6 @@ ALIGN="left"
 VALIGN="top"
 ><A
 HREF="config.html"
-ACCESSKEY="P"
 >Prev</A
 ></TD
 ><TD
@@ -5039,7 +5020,6 @@ ALIGN="center"
 VALIGN="top"
 ><A
 HREF="index.html"
-ACCESSKEY="H"
 >Home</A
 ></TD
 ><TD
@@ -5048,7 +5028,6 @@ ALIGN="right"
 VALIGN="top"
 ><A
 HREF="filter-file.html"
-ACCESSKEY="N"
 >Next</A
 ></TD
 ></TR