All HTML docs for 3.0.6 release.
[privoxy.git] / doc / webserver / user-manual / actions-file.html
index 1630465..fcd1217 100644 (file)
@@ -160,7 +160,7 @@ CLASS="FILENAME"
 >     <TT
 CLASS="FILENAME"
 >standard.action</TT
-> - is used by the web based editor
+> - is used only by the web based editor
      at <A
 HREF="http://config.privoxy.org/edit-actions-list?f=default"
 TARGET="_top"
@@ -219,26 +219,27 @@ CLASS="GUIBUTTON"
 >Cautious</SPAN
 >
       button changes the actions list to low/safe settings which will activate 
-      a minimal set of <SPAN
+      ad blocking and a minimal set of <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
->'s features, and subsequently there will be
-      less of a chance for accidental problems. The <SPAN
+>'s features, and subsequently
+      there will be less of a chance for accidental problems. The
+      <SPAN
 CLASS="GUIBUTTON"
 >Medium</SPAN
->
-      button sets the list to a medium level of ad blocking and a low level set of
-      privacy features. The <SPAN
+> button sets the list to a medium level of
+      other features and a low level set of privacy features. The
+      <SPAN
 CLASS="GUIBUTTON"
 >Advanced</SPAN
-> button 
-      sets the list to a high level of ad blocking and medium level of
-      privacy. See the chart below. The latter three buttons over-ride 
-      any changes via with the <SPAN
+> button sets the list to a high level of
+      ad blocking and medium level of privacy. See the chart below. The latter
+      three buttons over-ride any changes via with the
+      <SPAN
 CLASS="GUIBUTTON"
 >Edit</SPAN
-> button. More 
-      fine-tuning can be done in the lower sections of this internal page.
+> button. More fine-tuning can be done in the
+      lower sections of this internal page.
      </P
 ><P
 >     It is not recommend to edit the <TT
@@ -258,7 +259,7 @@ CLASS="FILENAME"
 >    <DIV
 CLASS="TABLE"
 ><A
-NAME="AEN1970"
+NAME="AEN2003"
 ></A
 ><P
 ><B
@@ -685,7 +686,7 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="AEN2069"
+NAME="AEN2102"
 ></A
 >8.1. Finding the Right Mix</H2
 ><P
@@ -720,7 +721,7 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="AEN2076"
+NAME="AEN2109"
 ></A
 >8.2. How to Edit</H2
 ><P
@@ -1028,7 +1029,7 @@ CLASS="SECT3"
 ><H3
 CLASS="SECT3"
 ><A
-NAME="AEN2159"
+NAME="AEN2192"
 ></A
 >8.4.1. The Domain Pattern</H3
 ><P
@@ -1245,14 +1246,14 @@ CLASS="LITERAL"
 ></DL
 ></DIV
 ><P
-> While flexibile, this is not the sophistication of full regular expression based syntax.</P
+> While flexible, this is not the sophistication of full regular expression based syntax.</P
 ></DIV
 ><DIV
 CLASS="SECT3"
 ><H3
 CLASS="SECT3"
 ><A
-NAME="AEN2230"
+NAME="AEN2263"
 ></A
 >8.4.2. The Path Pattern</H3
 ><P
@@ -2198,7 +2199,7 @@ WIDTH="90%"
 ><PRE
 CLASS="SCREEN"
 ># Check if www.example.net/ really uses valid XHTML
-{+content-type-overwrite {application/xml}}
+{ +content-type-overwrite{application/xml} }
 www.example.net/
 
 # but leave the content type unmodified if the URL looks like a style sheet
@@ -2337,7 +2338,7 @@ WIDTH="90%"
 ><PRE
 CLASS="SCREEN"
 ># Block the non-existent "Privacy-Violation:" client header 
-{+crunch-client-header {Privacy-Violation:}}
+{ +crunch-client-header{Privacy-Violation:} }
 /
     </PRE
 ></TD
@@ -2453,9 +2454,9 @@ WIDTH="90%"
 ><PRE
 CLASS="SCREEN"
 ># Let the browser revalidate cached documents without being tracked across sessions
-{+hide-if-modified-since {-60} \
-+overwrite-last-modified {randomize} \
-+crunch-if-none-match}
+{ +hide-if-modified-since{-60} \
+ +overwrite-last-modified{randomize} \
+ +crunch-if-none-match}
 /   </PRE
 ></TD
 ></TR
@@ -2711,7 +2712,7 @@ WIDTH="90%"
 ><PRE
 CLASS="SCREEN"
 ># Crunch server headers that try to prevent caching
-{+crunch-server-header {no-cache}}
+{ +crunch-server-header{no-cache} }
 /   </PRE
 ></TD
 ></TR
@@ -3920,6 +3921,44 @@ CLASS="SCREEN"
 ></TD
 ></TR
 ></TABLE
+>
+   </P
+><P
+>    <A
+NAME="FILTER-NO-PING"
+></A
+>
+    <TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="90%"
+><TR
+><TD
+><PRE
+CLASS="SCREEN"
+>+filter{no-ping}             # Removes non-standard ping attributes from anchor and area tags</PRE
+></TD
+></TR
+></TABLE
+>
+   </P
+><P
+>    <A
+NAME="FILTER-HIDE-TOR-EXIT-NOTATION"
+></A
+>
+    <TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="90%"
+><TR
+><TD
+><PRE
+CLASS="SCREEN"
+>+filter{hide-tor-exit-notation} # Header filter to remove the Tor exit node notation in Host and Referer headers</PRE
+></TD
+></TR
+></TABLE
 >
    </P
 ></DD
@@ -4354,7 +4393,7 @@ CLASS="EMPHASIS"
 >,
     the presence or absence of this mark decides whether an HTML <SPAN
 CLASS="QUOTE"
->"blocked"</SPAN
+>"BLOCKED"</SPAN
 >
     page, or an empty document will be sent to the client as a substitute for the blocked content.
     The <SPAN
@@ -4389,6 +4428,11 @@ CLASS="APPLICATION"
 >Privoxy's</SPAN
 >
     default HTML page; this option can be used to silence them.
+    And of course this action can also be used to eliminate the <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+>
+    BLOCKED message in frames.
    </P
 ><P
 >    The content type for the empty document can be specified with
@@ -4785,10 +4829,10 @@ WIDTH="90%"
 ><PRE
 CLASS="SCREEN"
 ># Disarm the download link in Sourceforge's patch tracker
-{-filter\
-+content-type-overwrite {text/plain}\
-+hide-content-disposition {block} }
-.sourceforge.net/tracker/download.php</PRE
+{ -filter \
+ +content-type-overwrite{text/plain}\
+ +hide-content-disposition{block} }
+ .sourceforge.net/tracker/download.php</PRE
 ></TD
 ></TR
 ></TABLE
@@ -4910,9 +4954,9 @@ WIDTH="90%"
 ><PRE
 CLASS="SCREEN"
 ># Let the browser revalidate without being tracked across sessions
-{+hide-if-modified-since {-60}\
-+overwrite-last-modified {randomize}\
-+crunch-if-none-match}
+{ +hide-if-modified-since{-60} \
+ +overwrite-last-modified{randomize} \
+ +crunch-if-none-match}
 /</PRE
 ></TD
 ></TR
@@ -5894,16 +5938,24 @@ WIDTH="90%"
 ><TD
 ><PRE
 CLASS="SCREEN"
-># Set default:
+># Selectively turn off compression, and enable a filter
 #
-{+prevent-compression}
-/ # Match all sites
+{ +filter{tiny-textforms} +prevent-compression }
+# Match only these sites
+ .google.
+ sourceforge.net
+ sf.net
 
-# Make exceptions for ill sites:
+# Or instead, we could set a universal default:
 #
-{-prevent-compression}
-www.debianhelp.org
-www.pclinuxonline.com</PRE
+{ +prevent-compression }
+ / # Match all sites
+
+# Then maybe make exceptions for ill-behaved sites:
+#
+{ -prevent-compression }
+ .debianhelp.org
+ www.pclinuxonline.com</PRE
 ></TD
 ></TR
 ></TABLE
@@ -6064,9 +6116,9 @@ WIDTH="90%"
 ><PRE
 CLASS="SCREEN"
 ># Let the browser revalidate without being tracked across sessions
-{+hide-if-modified-since {-60}\
-+overwrite-last-modified {randomize}\
-+crunch-if-none-match}
+{ +hide-if-modified-since{-60} \
+ +overwrite-last-modified{randomize} \
+ +crunch-if-none-match}
 /</PRE
 ></TD
 ></TR
@@ -6904,7 +6956,7 @@ CLASS="SECT3"
 ><H3
 CLASS="SECT3"
 ><A
-NAME="AEN3912"
+NAME="AEN3952"
 ></A
 >8.5.36. Summary</H3
 ><P
@@ -7028,11 +7080,7 @@ CLASS="APPLICATION"
  editor honors aliases when reading the actions files, but it expands
  them before writing. So the effects of your aliases are of course preserved,
  but the aliases themselves are lost when you edit sections that use aliases
- with it.
- This is likely to change in future versions of <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
->.</P
+ with it.</P
 ><P
 > Now let's define some aliases...</P
 ><P
@@ -7069,7 +7117,7 @@ HREF="actions-file.html#CRUNCH-OUTGOING-COOKIES"
 >crunch-outgoing-cookies</A
 >
  +block-as-image      = +block +handle-as-image
mercy-for-cookies   = -crunch-all-cookies -<A
allow-all-cookies   = -crunch-all-cookies -<A
 HREF="actions-file.html#SESSION-COOKIES-ONLY"
 >session-cookies-only</A
 > -<A
@@ -7095,7 +7143,11 @@ HREF="actions-file.html#HIDE-REFERER"
 > -<A
 HREF="actions-file.html#KILL-POPUPS"
 >kill-popups</A
+> -<A
+HREF="actions-file.html#PREVENT-COMPRESSION"
+>prevent-compression</A
 >
+
  shop        = -crunch-all-cookies -<A
 HREF="actions-file.html#FILTER-ALL-POPUPS"
 >filter{all-popups}</A
@@ -7134,7 +7186,8 @@ CLASS="SCREEN"
  {fragile}
  .office.microsoft.com
  .windowsupdate.microsoft.com
- .nytimes.com
+ # Gmail is really mail.google.com, not gmail.com
+ mail.google.com
 
  # Shopping sites:
  # Allow cookies (for setting and retrieving your customer data)
@@ -7142,11 +7195,11 @@ CLASS="SCREEN"
  {shop}
  .quietpc.com
  .worldpay.com   # for quietpc.com
- .scan.co.uk
+ mybank.example.com
 
  # These shops require pop-ups:
  #
- {shop -kill-popups -filter{all-popups}}
+ {-kill-popups -filter{all-popups} -filter{unsolicited-popups}}
   .dabs.com
   .overclockers.co.uk</PRE
 ></TD
@@ -7160,11 +7213,11 @@ CLASS="QUOTE"
 > and <SPAN
 CLASS="QUOTE"
 >"fragile"</SPAN
-> are often used for 
+> are typically used for 
  <SPAN
 CLASS="QUOTE"
 >"problem"</SPAN
-> sites that require some actions to be disabled 
+> sites that require more than one action to be disabled 
  in order to function properly.</P
 ></DIV
 ><DIV
@@ -7208,7 +7261,7 @@ CLASS="SECT3"
 ><H3
 CLASS="SECT3"
 ><A
-NAME="AEN3977"
+NAME="AEN4017"
 ></A
 >8.7.1. default.action</H3
 ><P
@@ -7549,6 +7602,14 @@ HREF="actions-file.html#FILTER-XML-TO-HTML"
  -<A
 HREF="actions-file.html#FILTER-HTML-TO-XML"
 >filter-html-to-xml</A
+> \
+ -<A
+HREF="actions-file.html#FILTER-NO-PING"
+>filter-no-ping</A
+> \
+ -<A
+HREF="actions-file.html#FILTER-HIDE-TOR-EXIT-NOTATION"
+>filter-hide-tor-exit-notation</A
 > \
  -<A
 HREF="actions-file.html#FORCE-TEXT-MODE"
@@ -8139,7 +8200,7 @@ CLASS="SECT3"
 ><H3
 CLASS="SECT3"
 ><A
-NAME="AEN4164"
+NAME="AEN4206"
 ></A
 >8.7.2. user.action</H3
 ><P