projects / privoxy.git / blobdiff
? search:
summary | shortlog | log | commit | commitdiff | tree
raw | inline | side by side
Sync with source.
[privoxy.git] / doc / webserver / faq / configuration.html
diff --git a/doc/webserver/faq/configuration.html b/doc/webserver/faq/configuration.html
index 339b762..45bfeac 100644 (file)
--- a/doc/webserver/faq/configuration.html
+++ b/doc/webserver/faq/configuration.html
@@ -4,7 +4,8 @@
 >Configuration</TITLE
 ><META
 NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.60"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.64
+"><LINK
 REL="HOME"
 TITLE="Privoxy Frequently Asked Questions"
 HREF="index.html"><LINK
@@ -104,7 +105,7 @@ CLASS="SECT2"
 ><H3
 CLASS="SECT2"
 ><A
-NAME="AEN239"
+NAME="AEN237"
 >3.2. What is an <SPAN
 CLASS="QUOTE"
 >"actions"</SPAN
@@ -120,7 +121,7 @@ CLASS="APPLICATION"
 >Privoxy</SPAN
 > might take, are configured. 
  Typically, you would define a set of default actions that apply 
- to all URLs, then add exceptions to these defaults.</P
+ to all URLs, then add exceptions to these defaults where needed.</P
 ><P
 > Actions can be defined on a per site basis, or for groups of sites. Actions
  can also be grouped together and then applied to one or more sites. There
@@ -134,17 +135,6 @@ CLASS="APPLICATION"
 CLASS="QUOTE"
 >"actions"</SPAN
 > file.&#13;</P
-><P
-> <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
-> comes with several default
- <SPAN
-CLASS="APPLICATION"
->actions</SPAN
-> files, with varying degrees 
- of filtering and blocking, as starting points for your own 
- configuration (see below).</P
 ></DIV
 ><DIV
 CLASS="SECT2"
@@ -164,7 +154,7 @@ CLASS="QUOTE"
 ><P
 > These are all explained in the 
  <A
-HREF="../user-manual/configuration.html#ACTIONSFILE"
+HREF="../user-manual/actions-file.html"
 TARGET="_top"
 >user-manual</A
 >.
@@ -175,7 +165,7 @@ CLASS="SECT2"
 ><H3
 CLASS="SECT2"
 ><A
-NAME="AEN257"
+NAME="AEN252"
 >3.4. How are actions files configured? What is the easiest
 way to do this?</A
 ></H3
@@ -193,14 +183,14 @@ TARGET="_top"
  "<A
 HREF="http://config.privoxy.org"
 TARGET="_top"
->Edit the actions list</A
+>View &#38; change the current configuration</A
 >"
  from the selection list. You can also do this by editing the appropriate 
  file with a text editor.</P
 ><P
 > Please see the 
  <A
-HREF="../user-manual/configuration.html#ACTIONSFILE"
+HREF="../user-manual/actions-file.html"
 TARGET="_top"
 >user-manual</A
 > for a
@@ -212,416 +202,45 @@ CLASS="SECT2"
 ><H3
 CLASS="SECT2"
 ><A
-NAME="CONFIGFILES"
->3.5. What are the differences between
-intermediate.action, basic.action, etc.?</A
+NAME="AEN260"
+>3.5. There are several different <SPAN
+CLASS="QUOTE"
+>"actions"</SPAN
+> files. What are
+the differences?</A
 ></H3
 ><P
->Configuring <SPAN
+> As of <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
-> is not easy. To help you get
-started, we provide you with three different default configurations. The
-following table shows you, which features are enabled in each configuration.
- </P
-><P
-><DIV
-CLASS="TABLE"
-><A
-NAME="AEN270"
-></A
+> v2.9.15, three actions files 
+ are being included, to be used for 
+ different purposes. These are 
+ <TT
+CLASS="FILENAME"
+>default.action</TT
+>, <TT
+CLASS="FILENAME"
+>standard.action</TT
+>, 
+ and <TT
+CLASS="FILENAME"
+>user.action</TT
+>. Please see 
+ <A
+HREF="../user-manual/actions-file.html"
+TARGET="_top"
+>the User Manual</A
+> 
+ for an explanation of each.</P
 ><P
-><B
->Table 1. Default Configurations</B
-></P
-><TABLE
-BORDER="1"
-CLASS="CALSTABLE"
-><THEAD
-><TR
-><TH
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->Feature</TH
-><TH
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->default.action</TH
-><TH
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->basic.action</TH
-><TH
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->intermediate.action</TH
-><TH
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->advanced.action</TH
-></TR
-></THEAD
-><TBODY
-><TR
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->ad-filtering</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->?</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->x</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->x</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->x</TD
-></TR
-><TR
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->blank image</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->?</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->x</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->x</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->x</TD
-></TR
-><TR
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->de-animate GIFs</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->?</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->x</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->x</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->x</TD
-></TR
-><TR
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->referer forging</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->?</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->x</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->x</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->x</TD
-></TR
-><TR
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->jon's +no-cookies-keep (i.e. session cookies only)</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->?</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->x</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->x</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->x</TD
-></TR
-><TR
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->no-popup windows</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->?</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->&nbsp;</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->x</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->x</TD
-></TR
-><TR
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->fast redirects</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->?</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->&nbsp;</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->x</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->x</TD
-></TR
-><TR
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->hide-referrer</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->?</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->&nbsp;</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->x</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->x</TD
-></TR
-><TR
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->hide-useragent</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->?</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->&nbsp;</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->x</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->x</TD
-></TR
-><TR
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->content-modification</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->?</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->&nbsp;</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->&nbsp;</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->x</TD
-></TR
-><TR
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->feature-x</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->?</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->&nbsp;</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->&nbsp;</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->&nbsp;</TD
-></TR
-><TR
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->feature-y</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->?</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->&nbsp;</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->&nbsp;</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->&nbsp;</TD
-></TR
-><TR
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->feature-z</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->?</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->&nbsp;</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->&nbsp;</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->&nbsp;</TD
-></TR
-></TBODY
-></TABLE
-></DIV
-></P
+> Earlier versions included three different versions
+ <TT
+CLASS="FILENAME"
+>default.action</TT
+> files. The new scheme allows for 
+ greater flexibility of local configuration, and for browser based 
+ configuration.</P
 ></DIV
 ><DIV
 CLASS="SECT2"
@@ -687,7 +306,7 @@ CLASS="SECT2"
 ><H3
 CLASS="SECT2"
 ><A
-NAME="AEN379"
+NAME="AEN286"
 >3.7. What is <SPAN
 CLASS="QUOTE"
 >"default.filter"</SPAN
@@ -697,7 +316,11 @@ CLASS="QUOTE"
 > The <SPAN
 CLASS="QUOTE"
 >"default.filter"</SPAN
-> file is used to <SPAN
+> file is where <SPAN
+CLASS="QUOTE"
+>"filters"</SPAN
+>
+ are defined, which are used to <SPAN
 CLASS="QUOTE"
 >"filter"</SPAN
 > any
@@ -724,15 +347,16 @@ CLASS="FILENAME"
  but you can disable/enable various sections of the included default 
  file with the <SPAN
 CLASS="QUOTE"
->"Actions List Editor"</SPAN
-> from your browser.</P
+>"View &#38; change the current configuration"</SPAN
+> from
+ your browser. </P
 ></DIV
 ><DIV
 CLASS="SECT2"
 ><H3
 CLASS="SECT2"
 ><A
-NAME="AEN391"
+NAME="AEN299"
 >3.8. How can I set up <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
@@ -768,8 +392,7 @@ WIDTH="100%"
 ><TD
 ><PRE
 CLASS="SCREEN"
->  listen-address  192.168.1.1:8118
- </PRE
+>  listen-address  192.168.1.1:8118</PRE
 ></TD
 ></TR
 ></TABLE
@@ -786,7 +409,7 @@ CLASS="SECT2"
 ><H3
 CLASS="SECT2"
 ><A
-NAME="AEN403"
+NAME="AEN311"
 >3.9. Instead of ads, now I get a checkerboard pattern. I don't want to see anything.</A
 ></H3
 ><P
@@ -794,31 +417,49 @@ NAME="AEN403"
  <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
-> is stopping. You have the choice   of a checkerboard
- pattern, a transparent 1x1 GIF image (aka <SPAN
+> is stopping. You have the choice of a
+ checkerboard pattern, a transparent 1x1 GIF image (aka <SPAN
 CLASS="QUOTE"
 >"blank"</SPAN
->), or a custom
- URL of your choice. Note that to fit this category, the URL must match both 
- the <SPAN
+>),
+ or a custom URL of your choice. Note that to fit this category, the URL must
+ match both the <A
+HREF="../user-manual/actions-file.html#HANDLE-AS-IMAGE"
+TARGET="_top"
+><SPAN
 CLASS="QUOTE"
->"+image"</SPAN
-> and <SPAN
+>"+handle-as-image"</SPAN
+></A
+>
+ <I
+CLASS="EMPHASIS"
+>and</I
+> 
+ <A
+HREF="../user-manual/actions-file.html#BLOCK"
+TARGET="_top"
+><SPAN
 CLASS="QUOTE"
 >"+block"</SPAN
+></A
 > actions.</P
 ><P
-> If you want to see nothing, then change the <SPAN
+> If you want to see nothing, then change the 
+ <A
+HREF="../user-manual/actions-file.html#SET-IMAGE-BLOCKER"
+TARGET="_top"
+><SPAN
 CLASS="QUOTE"
->"+image-blocker"</SPAN
-> 
+>"+set-image-blocker"</SPAN
+></A
+>
  action to <SPAN
 CLASS="QUOTE"
 >"+image-blocker{blank}"</SPAN
 >. This can be done from the 
  <SPAN
 CLASS="QUOTE"
->"Edit Actions List"</SPAN
+>"View &#38; change the current configuration"</SPAN
 > selection at <A
 HREF="http://p.p/"
 TARGET="_top"
@@ -834,7 +475,7 @@ CLASS="QUOTE"
 >
  banner, can be moved to the <SPAN
 CLASS="QUOTE"
->"+image-blocker"</SPAN
+>"+set-image-blocker"</SPAN
 > section for the
  same reason, but there are some limits and risks to this (see below).</P
 ></DIV
@@ -843,7 +484,7 @@ CLASS="SECT2"
 ><H3
 CLASS="SECT2"
 ><A
-NAME="AEN418"
+NAME="AEN330"
 >3.10. Why would anybody want to see a checkerboard pattern?</A
 ></H3
 ><P
@@ -864,7 +505,7 @@ CLASS="SECT2"
 ><H3
 CLASS="SECT2"
 ><A
-NAME="AEN423"
+NAME="AEN335"
 >3.11. I see large red banners on some pages that say 
 <SPAN
 CLASS="QUOTE"
@@ -876,42 +517,52 @@ CLASS="QUOTE"
  <SPAN
 CLASS="APPLICATION"
 >Privoxy's</SPAN
-> block actions (+block). It is meant
- to be a warning so that you know something has been blocked and an easy way
- for you to see why. These are handled differently than what has been defined
- explicitly as <SPAN
+> block actions 
+ (<A
+HREF="../user-manual/actions-file.html#BLOCK"
+TARGET="_top"
+><SPAN
+CLASS="QUOTE"
+>"+block"</SPAN
+></A
+>).
+ It is meant to be a warning so that you know something has been blocked and
+ an easy way for you to see why. These are handled differently than what has
+ been defined explicitly as <SPAN
 CLASS="QUOTE"
 >"images"</SPAN
-> (e.g. ad banners). Depending on the 
- URL itself, it is sometimes hard for <SPAN
+> (e.g. ads that are GIF image
+ files). Depending on the URL itself, it is sometimes hard for
+ <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
-> to 
- really know whether there is indeed an ad image there or not. And there are
- limitations as to what <SPAN
+> to really know whether there is indeed an
+ ad image there or not. And there are limitations as to what
+ <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
-> can do to 
- <SPAN
+> can do to <SPAN
 CLASS="QUOTE"
 >"fool"</SPAN
-> the browser.</P
+> the
+ browser.</P
 ><P
 > For instance, if the ad is in a frame, then it is embedded in the separate
  HTML page used for the frame. In this case, you cannot just substitute an
- aribitray image (like we would for a <SPAN
+ aribitrary image (like we would for a <SPAN
 CLASS="QUOTE"
 >"blank"</SPAN
 > image), for an HTML
  page. The browser is expecting an HTML page, and that is what it must have
- for frames. So this situation can be a little trickier to deal with, and 
+ for frames. Such situations can be a little trickier to deal with, and 
  <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
-> will use the <SPAN
+> may show the <SPAN
 CLASS="QUOTE"
 >"Blocked"</SPAN
-> page.</P
+> page,
+ despite your best efforts.</P
 ><P
 > If you want these to be treated as if they were images, so that they can be
  made invisible, you can try moving the offending URL from the
@@ -968,7 +619,7 @@ CLASS="APPLICATION"
 > is blocking the frame, and 
  diable this. Then let the <SPAN
 CLASS="QUOTE"
->"+image-blocker"</SPAN
+>"+set-image-blocker"</SPAN
 > action 
  handle the ad that is embedded in the frame's HTML page. </P
 ></DIV
@@ -981,24 +632,28 @@ NAME="ALLISEEISRED"
 >3.12. I cannot see all of the <SPAN
 CLASS="QUOTE"
 >"Blocked"</SPAN
-> page banner. All I
-see is a bright red square.</A
+> page banner. Help.</A
 ></H3
 ><P
-> There is not enough space to fit the entire page. Try right clicking on the
- visible, red portion, and select <SPAN
+> There is not enough available space to fit the entire Blocked page. Try right
+ clicking on the visible portion, and select <SPAN
 CLASS="QUOTE"
 >"Show Frame"</SPAN
->, or equivalent.
- This will usually allow you to see the entire Privoxy <SPAN
+>,
+ or equivalent. This will usually allow you to see the entire Privoxy
+ <SPAN
 CLASS="QUOTE"
 >"Blocked"</SPAN
->
- page, and from there you can see just what is being blocked, and why.</P
+> page, and from there you can see just what is being
+ blocked, and why.</P
+><P
+> As of Privoxy 2.9.14, the Blocked banner page is re-sizeable, and tries
+ to adjust to the allotted space. There may be occassions where there 
+ just isn't enough room to display much of anything useful though. &#13;</P
 ></DIV
 ><DIV
 CLASS="SECT2"
-><H2
+><H3
 CLASS="SECT2"
 ><A
 NAME="SRVANY"
@@ -1007,7 +662,7 @@ CLASS="APPLICATION"
 >Privoxy</SPAN
 > run as a service 
 on Win2K/NT?</A
-></H2
+></H3
 ><P
 > Yes, it can run as a system service using <B
 CLASS="COMMAND"
@@ -1045,7 +700,7 @@ CLASS="APPLICATION"
 ></H3
 ><P
 > This can be done. See the <A
-HREF="../user-manual/configuration.html#FORWARDING"
+HREF="../user-manual/config.html#FORWARDING"
 TARGET="_top"
 >user manual</A
 >, 
The official Privoxy git repository