><TD
><PRE
CLASS="PROGRAMLISTING"
->const char FILENAME_rcs[] = "$Id: developer-manual.sgml,v 1.37 2002/04/26 17:23:29 swa Exp $";
+>const char FILENAME_rcs[] = "$Id: developer-manual.sgml,v 1.38 2002/04/29 02:20:31 hal9 Exp $";
/*********************************************************************
*
* File : $Source$
CLASS="PROGRAMLISTING"
>#ifndef _FILENAME_H
#define _FILENAME_H
-#define FILENAME_H_VERSION "$Id: developer-manual.sgml,v 1.37 2002/04/26 17:23:29 swa Exp $"
+#define FILENAME_H_VERSION "$Id: developer-manual.sgml,v 1.38 2002/04/29 02:20:31 hal9 Exp $"
/*********************************************************************
*
* File : $Source$
><H2
CLASS="SECT2"
><A
-NAME="AEN995"
+NAME="AEN1022"
>11.1. Copyright</A
></H2
><P
><H2
CLASS="SECT2"
><A
-NAME="AEN1002"
+NAME="AEN1029"
>11.2. History</A
></H2
><P
></DIV
><P
CLASS="PUBDATE"
->$Id: developer-manual.sgml,v 1.37 2002/04/26 17:23:29 swa Exp $<BR></P
+>$Id: developer-manual.sgml,v 1.38 2002/04/29 02:20:31 hal9 Exp $<BR></P
><DIV
><DIV
CLASS="ABSTRACT"
></DD
><DT
>8.3. <A
+HREF="newrelease.html#RELEASING"
+>Uploading and Releasing Your Package</A
+></DT
+><DT
+>8.4. <A
HREF="newrelease.html#AFTERRELEASE"
>After the Release</A
></DT
><DL
><DT
>11.1. <A
-HREF="copyright.html#AEN995"
+HREF="copyright.html#AEN1022"
>Copyright</A
></DT
><DT
>11.2. <A
-HREF="copyright.html#AEN1002"
+HREF="copyright.html#AEN1029"
>History</A
></DT
></DL
><H2
CLASS="SECT2"
><A
+NAME="RELEASING"
+>8.3. Uploading and Releasing Your Package</A
+></H2
+><P
+> After the package is ready, it is time to upload it
+ to SourceForge, and go through the release steps. The upload
+ is done via FTP:
+ </P
+><P
+> <P
+></P
+><UL
+><LI
+><P
+> Upload to: <A
+HREF="ftp://upload.sourceforge.net/incoming"
+TARGET="_top"
+>ftp://upload.sourceforge.net/incoming</A
+>
+ </P
+></LI
+><LI
+><P
+> user: <TT
+CLASS="LITERAL"
+>anonymous</TT
+>
+ </P
+></LI
+><LI
+><P
+> password: <TT
+CLASS="LITERAL"
+>ijbswa-developers@lists.sourceforge.net</TT
+>
+ </P
+></LI
+></UL
+>
+ </P
+><P
+> Once this done go to <A
+HREF="http://sourceforge.net/project/admin/editpackages.php?group_id=11118"
+TARGET="_top"
+>http://sourceforge.net/project/admin/editpackages.php?group_id=11118</A
+>,
+ making sure you are logged in. Find your target platform in the
+ second column, and click <TT
+CLASS="LITERAL"
+>Add Release</TT
+>. You will
+ then need to create a new release for your package, using the format
+ of <TT
+CLASS="LITERAL"
+>$VERSION ($CODE_STATUS)</TT
+>, e.g. <I
+CLASS="EMPHASIS"
+>2.9.14
+ (beta)</I
+>.
+ </P
+><P
+> Now just follow the prompts. Be sure to add any appropriate Release
+ notes. You should see your freshly uploaded packages in
+ <SPAN
+CLASS="QUOTE"
+>"Step 2. Add Files To This Release"</SPAN
+>. Check the
+ appropriate box(es). Remember at each step to hit the
+ <SPAN
+CLASS="QUOTE"
+>"Refresh/Submit"</SPAN
+> buttons! You should now see your
+ file(s) listed in Step 3. Fill out the forms with the appropriate
+ information for your platform, being sure to hit <SPAN
+CLASS="QUOTE"
+>"Update"</SPAN
+>
+ for each file. If anyone is monitoring your platform, check the
+ <SPAN
+CLASS="QUOTE"
+>"email"</SPAN
+> box at the very bottom to notify them of
+ the new package. This should do it!
+ </P
+><P
+> If you have made errors, or need to make changes, you can go through
+ essentially the same steps, but select <TT
+CLASS="LITERAL"
+>Edit Release</TT
+>,
+ instead of <TT
+CLASS="LITERAL"
+>Add Release</TT
+>.
+ </P
+></DIV
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
NAME="AFTERRELEASE"
->8.3. After the Release</A
+>8.4. After the Release</A
></H2
><P
> When all (or: most of the) packages have been uploaded and made available,
>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
CLASS="QUOTE"
>"actions"</SPAN
> file. </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"
><P
> These are all explained in the
<A
-HREF="../user-manual/configuration.html#ACTIONS-FILE"
+HREF="../user-manual/actions-file.html"
TARGET="_top"
>user-manual</A
>.
><H3
CLASS="SECT2"
><A
-NAME="AEN255"
+NAME="AEN252"
>3.4. How are actions files configured? What is the easiest
way to do this?</A
></H3
"<A
HREF="http://config.privoxy.org"
TARGET="_top"
->Edit the actions list</A
+>View & 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#ACTIONS-FILE"
+HREF="../user-manual/actions-file.html"
TARGET="_top"
>user-manual</A
> for a
><H3
CLASS="SECT2"
><A
+NAME="AEN260"
+>3.5. There are several different <SPAN
+CLASS="QUOTE"
+>"actions"</SPAN
+> files. What are
+the differences?</A
+></H3
+><P
+> As of <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> 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
+> 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"
+><H3
+CLASS="SECT2"
+><A
NAME="BROWSECONFIG"
->3.5. Why can I change the configuration with a
+>3.6. Why can I change the configuration with a
browser? Does that not raise security issues?</A
></H3
><P
><H3
CLASS="SECT2"
><A
-NAME="AEN278"
->3.6. What is <SPAN
+NAME="AEN286"
+>3.7. What is <SPAN
CLASS="QUOTE"
>"default.filter"</SPAN
>?</A
> 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
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 & change the current configuration"</SPAN
+> from
+ your browser. </P
></DIV
><DIV
CLASS="SECT2"
><H3
CLASS="SECT2"
><A
-NAME="AEN290"
->3.7. How can I set up <SPAN
+NAME="AEN299"
+>3.8. How can I set up <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
> to act as a proxy for my
><H3
CLASS="SECT2"
><A
-NAME="AEN302"
->3.8. Instead of ads, now I get a checkerboard pattern. I don't want to see anything.</A
+NAME="AEN311"
+>3.9. Instead of ads, now I get a checkerboard pattern. I don't want to see anything.</A
></H3
><P
> This is a configuration option for images that
<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 & change the current configuration"</SPAN
> selection at <A
HREF="http://p.p/"
TARGET="_top"
>
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
><H3
CLASS="SECT2"
><A
-NAME="AEN317"
->3.9. Why would anybody want to see a checkerboard pattern?</A
+NAME="AEN330"
+>3.10. Why would anybody want to see a checkerboard pattern?</A
></H3
><P
> This can be helpful for troubleshooting problems. It might also be good
><H3
CLASS="SECT2"
><A
-NAME="AEN322"
->3.10. I see large red banners on some pages that say
+NAME="AEN335"
+>3.11. I see large red banners on some pages that say
<SPAN
CLASS="QUOTE"
>"Blocked"</SPAN
<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
> 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
CLASS="SECT2"
><A
NAME="ALLISEEISRED"
->3.11. I cannot see all of the <SPAN
+>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. </P
></DIV
><DIV
CLASS="SECT2"
CLASS="SECT2"
><A
NAME="SRVANY"
->3.12. Can <SPAN
+>3.13. Can <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
> run as a service
CLASS="SECT2"
><A
NAME="OTHERPROXY"
->3.13. How can I make <SPAN
+>3.14. How can I make <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
> work with other
></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
>,
><H2
CLASS="SECT2"
><A
-NAME="AEN618"
+NAME="AEN631"
>8.1. Copyright</A
></H2
><P
><H2
CLASS="SECT2"
><A
-NAME="AEN625"
+NAME="AEN638"
>8.2. History</A
></H2
><P
includes tools to help identify these types of situations so they can be
addressed as needed, allowing you to customize your installation.
(<A
-HREF="trouble.html#AEN555"
+HREF="trouble.html#AEN570"
>See the Troubleshooting section below</A
>.)</P
></DIV
></DIV
><P
CLASS="PUBDATE"
->$Id: faq.sgml,v 1.51 2002/04/26 17:24:31 swa Exp $<BR></P
+>$Id: faq.sgml,v 1.52 2002/04/29 03:08:43 hal9 Exp $<BR></P
><DIV
><DIV
CLASS="ABSTRACT"
></DT
><DT
>3.4. <A
-HREF="configuration.html#AEN255"
+HREF="configuration.html#AEN252"
>How are actions files configured? What is the easiest
way to do this?</A
></DT
><DT
>3.5. <A
+HREF="configuration.html#AEN260"
+>There are several different <SPAN
+CLASS="QUOTE"
+>"actions"</SPAN
+> files. What are
+the differences?</A
+></DT
+><DT
+>3.6. <A
HREF="configuration.html#BROWSECONFIG"
>Why can I change the configuration with a
browser? Does that not raise security issues?</A
></DT
><DT
-HREF="configuration.html#AEN278"
+HREF="configuration.html#AEN286"
>What is <SPAN
CLASS="QUOTE"
>"default.filter"</SPAN
>?</A
></DT
><DT
-HREF="configuration.html#AEN290"
+HREF="configuration.html#AEN299"
>How can I set up <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
LAN?</A
></DT
><DT
-HREF="configuration.html#AEN302"
+HREF="configuration.html#AEN311"
>Instead of ads, now I get a checkerboard pattern. I don't want to see anything.</A
></DT
><DT
-HREF="configuration.html#AEN317"
+HREF="configuration.html#AEN330"
>Why would anybody want to see a checkerboard pattern?</A
></DT
><DT
-HREF="configuration.html#AEN322"
+HREF="configuration.html#AEN335"
>I see large red banners on some pages that say
<SPAN
CLASS="QUOTE"
>. Why and how do I get rid of this?</A
></DT
><DT
HREF="configuration.html#ALLISEEISRED"
>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
></DT
><DT
HREF="configuration.html#SRVANY"
>Can <SPAN
CLASS="APPLICATION"
on Win2K/NT?</A
></DT
><DT
HREF="configuration.html#OTHERPROXY"
>How can I make <SPAN
CLASS="APPLICATION"
><DL
><DT
>4.1. <A
-HREF="misc.html#AEN372"
+HREF="misc.html#AEN388"
>How much does <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
></DT
><DT
>4.7. <A
-HREF="misc.html#AEN424"
+HREF="misc.html#AEN439"
>Can <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
></DT
><DT
>4.8. <A
-HREF="misc.html#AEN435"
+HREF="misc.html#AEN450"
>Might some things break because header information is
being altered?</A
></DT
><DT
>4.9. <A
-HREF="misc.html#AEN445"
+HREF="misc.html#AEN460"
>Can <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
></DT
><DT
>4.10. <A
-HREF="misc.html#AEN453"
+HREF="misc.html#AEN468"
>What about as a firewall? Can <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
></DT
><DT
>4.11. <A
-HREF="misc.html#AEN458"
+HREF="misc.html#AEN473"
>The <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
></DT
><DT
>4.12. <A
-HREF="misc.html#AEN467"
+HREF="misc.html#AEN482"
>I have large empty spaces now where ads used to be.
Why?</A
></DT
><DT
>4.13. <A
-HREF="misc.html#AEN470"
+HREF="misc.html#AEN485"
>How can <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
></DT
><DT
>4.14. <A
-HREF="misc.html#AEN477"
+HREF="misc.html#AEN492"
><SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
><DL
><DT
>5.1. <A
-HREF="trouble.html#AEN536"
+HREF="trouble.html#AEN551"
>I just upgraded and am getting <SPAN
CLASS="QUOTE"
>"connection refused"</SPAN
></DT
><DT
>5.2. <A
-HREF="trouble.html#AEN549"
+HREF="trouble.html#AEN564"
>I just added a new rule, but the steenkin ad is
still getting through. How?</A
></DT
><DT
>5.3. <A
-HREF="trouble.html#AEN555"
+HREF="trouble.html#AEN570"
>One of my favorite sites does not work with <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
>.
What can I do?</A
></DT
-><DT
->5.4. <A
-HREF="trouble.html#AEN578"
->What time is it?</A
-></DT
></DL
></DD
><DT
><DL
><DT
>8.1. <A
-HREF="copyright.html#AEN618"
+HREF="copyright.html#AEN631"
>Copyright</A
></DT
><DT
>8.2. <A
-HREF="copyright.html#AEN625"
+HREF="copyright.html#AEN638"
>History</A
></DT
></DL
><H3
CLASS="SECT2"
><A
-NAME="AEN372"
+NAME="AEN388"
>4.1. How much does <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
delays in page requests compared to the old Junkbuster. What's wrong?</A
></H3
><P
->Using the default filtering configuration, I noticed considerable delays in
-page requests compared to the old Junkbuster. Loading pages with large contents
-seemed to take forever, then suddenly delivering all the content at once.
+>The entire page content must be loaded into memory in order for the filtering
+mechanism to work, and nothing is sent to the browser during this time. The
+loading time does not really change in real numbers, but the feeling is
+different, because most browsers are able to start rendering incomplete
+content, giving the user a feeling of "it works".
</P
><P
->The whole content must be loaded in order to filter, and nothing is is
-sent to the browser during this time. The loading time does not really
-change in real numbers, but the feeling is different, because most
-browsers are able to start rendering incomplete content, giving the
-user a feeling of "it works".
- </P
-><P
->To modify the content of a page (i.e. make frames resizeable again, etc.) and
-not just replace ads, <SPAN
+> To modify the content of a page (i.e. make frames resizeable again, etc.) and
+ not just replace ads, <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
-> needs to download the
-entire page first, do its content magic and then send the page to the browser.</P
+> needs to download
+ the entire page first, do its content magic and then send the page to the
+ browser.</P
></DIV
><DIV
CLASS="SECT2"
><H3
CLASS="SECT2"
><A
-NAME="AEN424"
+NAME="AEN439"
>4.7. Can <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
><H3
CLASS="SECT2"
><A
-NAME="AEN435"
+NAME="AEN450"
>4.8. Might some things break because header information is
being altered?</A
></H3
><H3
CLASS="SECT2"
><A
-NAME="AEN445"
+NAME="AEN460"
>4.9. Can <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
><H3
CLASS="SECT2"
><A
-NAME="AEN453"
+NAME="AEN468"
>4.10. What about as a firewall? Can <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
><H3
CLASS="SECT2"
><A
-NAME="AEN458"
+NAME="AEN473"
>4.11. The <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
><H3
CLASS="SECT2"
><A
-NAME="AEN467"
+NAME="AEN482"
>4.12. I have large empty spaces now where ads used to be.
Why?</A
></H3
><H3
CLASS="SECT2"
><A
-NAME="AEN470"
+NAME="AEN485"
>4.13. How can <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
><H3
CLASS="SECT2"
><A
-NAME="AEN477"
+NAME="AEN492"
>4.14. <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
><H3
CLASS="SECT2"
><A
-NAME="AEN536"
+NAME="AEN551"
>5.1. I just upgraded and am getting <SPAN
CLASS="QUOTE"
>"connection refused"</SPAN
><H3
CLASS="SECT2"
><A
-NAME="AEN549"
+NAME="AEN564"
>5.2. I just added a new rule, but the steenkin ad is
still getting through. How?</A
></H3
><H3
CLASS="SECT2"
><A
-NAME="AEN555"
+NAME="AEN570"
>5.3. One of my favorite sites does not work with <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
CLASS="QUOTE"
>"Toggle Privoxy On or Off"</SPAN
>, then disable it. Now try that
- page again. It's probably a good idea to flush the browser cache as well.</P
+ page again. It's probably a good idea to flush the browser cache as well
+ with <TT
+CLASS="LITERAL"
+>Shift+Reload</TT
+> to flush caches.</P
><P
> If still a problem, go to <SPAN
CLASS="QUOTE"
>http://p.p/</A
> and paste
the full URL of the page in question into the prompt. See which actions are
- being applied to the URL. Now, armed with this information, go to <SPAN
+ being applied to the URL. Now, armed with this information, go to
+ <SPAN
CLASS="QUOTE"
->"Edit
- the actions list"</SPAN
+>"View & change the current configuration"</SPAN
>. Here you should see various sections that have
various <SPAN
CLASS="APPLICATION"
>"fragile"</SPAN
> which
disables most actions. Now re-try the page. There might be some trial and
- error involved. This is discussed in
a little more detail in the <A
+ error involved. This is discussed in more detail in the <A
HREF="../user-manual/appendix.html#ACTIONSANAT"
TARGET="_top"
>user-manual appendix</A
>"actions"</SPAN
> file.</P
></DIV
-><DIV
-CLASS="SECT2"
-><H3
-CLASS="SECT2"
-><A
-NAME="AEN578"
->5.4. What time is it?</A
-></H3
-><P
-> Time for you to go!</P
-></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
are three such files included with <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
->,
- with slightly different purposes. <TT
+> (as of
+ version 2.9.15), with differing purposes:
+ </P
+><P
+> <P
+></P
+><UL
+><LI
+><P
+> <TT
+CLASS="FILENAME"
+>standard.action</TT
+> - is used by the web based editor,
+ to set various pre-defined sets of rules for the default actions section
+ in <TT
CLASS="FILENAME"
>default.action</TT
-> sets
- the default policies. <TT
+>. These have increasing levels of
+ aggressiveness. It is not recommend to edit this file.
+ </P
+></LI
+><LI
+><P
+> <TT
CLASS="FILENAME"
->standard.action</TT
-> is used by
- <SPAN
+>default.action</TT
+> - is the primary action file
+ that sets the initial values for all actions. It is intended to
+ provide a base level of functionality for
+ <SPAN
CLASS="APPLICATION"
->Privoxy</SPAN
-> and the web based editor to set
- pre-defined values (and normally should not be edited). Local exceptions
- are best done in <TT
+>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.
+ </P
+></LI
+><LI
+><P
+> <TT
CLASS="FILENAME"
>user.action</TT
->. The content of these
+> - is intended to be for local site
+ preferences and exceptions. As an example, if your ISP or your bank
+ has specific requirements, and need special handling, this kind of
+ thing should go here. This file will not be upgraded.
+ </P
+></LI
+></UL
+>
+ </P
+><P
+> The list of actions files to be used are defined in the main configuration
+ file, and are processed in the order they are defined. The content of these
can all be viewed and edited from <A
HREF="http://config.privoxy.org/show-status"
TARGET="_top"
>http://config.privoxy.org/show-status</A
->.
- </P
-><P
->
- Anything you want can be blocked, including ads, banners, or just some obnoxious
- URL that you would rather not see is done here. Cookies can be accepted or rejected, or
- accepted only during the current browser session (i.e. not written to disk),
- content can be modified, JavaScripts tamed, user-tracking fooled, and much more.
- See below for a complete list of available actions.</P
+>.</P
><P
> An actions file typically has sections. Near the top, <SPAN
CLASS="QUOTE"
>), then the default set of rules
which will apply universally to all sites and pages. And then below that,
exceptions to the defined universal policies. </P
+><P
+>
+ Actions can be used to block anything you want, including ads, banners, or
+ just some obnoxious URL that you would rather not see. Cookies can be accepted
+ or rejected, or accepted only during the current browser session (i.e. not
+ written to disk), content can be modified, JavaScripts tamed, user-tracking
+ fooled, and much more. See below for a complete list of actions.</P
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
-NAME="AEN1299"
+NAME="AEN1309"
>9.1. Finding the Right Mix</A
></H2
><P
><H2
CLASS="SECT2"
><A
-NAME="AEN1306"
+NAME="AEN1316"
>9.2. How to Edit</A
></H2
><P
><H2
CLASS="SECT2"
><A
-NAME="AEN1312"
+NAME="AEN1322"
>9.3. How Actions are Applied to URLs</A
></H2
><P
><H2
CLASS="SECT2"
><A
-NAME="AEN1326"
+NAME="AEN1336"
>9.4. Patterns</A
></H2
><P
><H3
CLASS="SECT3"
><A
-NAME="AEN1366"
+NAME="AEN1376"
>9.4.1. The Domain Pattern</A
></H3
><P
><H3
CLASS="SECT3"
><A
-NAME="AEN1428"
+NAME="AEN1438"
>9.4.2. The Path Pattern</A
></H3
><P
><H3
CLASS="SECT3"
><A
-NAME="AEN2196"
+NAME="AEN2206"
>9.5.21. Summary</A
></H3
><P
> }<br>
www.my-isp-example.com/logo[0-9].gif<br>
<br>
+<br>
# Say the site where you do your homebanking needs to open<br>
# popup windows, but you have chosen to kill popups by<br>
# default. This will allow it for your-example-bank.com:<br>
> }<br>
.my-example-bank.com<br>
<br>
+<br>
# This site is delicate, and requires kid-glove <br>
# treatment.<br>
{ fragile }<br>
><H2
CLASS="SECT2"
><A
-NAME="AEN2625"
+NAME="AEN2635"
>15.2. <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
Privoxy main page:
</P
><A
-NAME="AEN2640"
+NAME="AEN2650"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
editing of actions files:
</P
><A
-NAME="AEN2647"
+NAME="AEN2657"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
Show the source code version numbers:
</P
><A
-NAME="AEN2652"
+NAME="AEN2662"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
Show the browser's request headers:
</P
><A
-NAME="AEN2657"
+NAME="AEN2667"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
Show which actions apply to a URL and why:
</P
><A
-NAME="AEN2662"
+NAME="AEN2672"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
to run, but only as a pass-through proxy, with no actions taking place:
</P
><A
-NAME="AEN2668"
+NAME="AEN2678"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
> Short cuts. Turn off, then on:
</P
><A
-NAME="AEN2672"
+NAME="AEN2682"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
</P
></BLOCKQUOTE
><A
-NAME="AEN2675"
+NAME="AEN2685"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
><H2
CLASS="SECT2"
><A
-NAME="AEN2400"
+NAME="AEN2410"
>13.1. Copyright</A
></H2
><P
><H2
CLASS="SECT2"
><A
-NAME="AEN2339"
+NAME="AEN2349"
>10.1. The <I
CLASS="EMPHASIS"
>+filter</I
></DIV
><P
CLASS="PUBDATE"
->$Id: user-manual.sgml,v 1.99 2002/04/28 16:59:05 swa Exp $<BR></P
+>$Id: user-manual.sgml,v 1.100 2002/04/29 03:05:55 hal9 Exp $<BR></P
><DIV
><DIV
CLASS="ABSTRACT"
><DL
><DT
>9.1. <A
-HREF="actions-file.html#AEN1299"
+HREF="actions-file.html#AEN1309"
>Finding the Right Mix</A
></DT
><DT
>9.2. <A
-HREF="actions-file.html#AEN1306"
+HREF="actions-file.html#AEN1316"
>How to Edit</A
></DT
><DT
>9.3. <A
-HREF="actions-file.html#AEN1312"
+HREF="actions-file.html#AEN1322"
>How Actions are Applied to URLs</A
></DT
><DT
>9.4. <A
-HREF="actions-file.html#AEN1326"
+HREF="actions-file.html#AEN1336"
>Patterns</A
></DT
><DD
><DL
><DT
>9.4.1. <A
-HREF="actions-file.html#AEN1366"
+HREF="actions-file.html#AEN1376"
>The Domain Pattern</A
></DT
><DT
>9.4.2. <A
-HREF="actions-file.html#AEN1428"
+HREF="actions-file.html#AEN1438"
>The Path Pattern</A
></DT
></DL
></DT
><DT
>9.5.21. <A
-HREF="actions-file.html#AEN2196"
+HREF="actions-file.html#AEN2206"
>Summary</A
></DT
><DT
><DL
><DT
>10.1. <A
-HREF="filter-file.html#AEN2339"
+HREF="filter-file.html#AEN2349"
>The <I
CLASS="EMPHASIS"
>+filter</I
><DL
><DT
>13.1. <A
-HREF="copyright.html#AEN2400"
+HREF="copyright.html#AEN2410"
>Copyright</A
></DT
><DT
></DT
><DT
>15.2. <A
-HREF="appendix.html#AEN2625"
+HREF="appendix.html#AEN2635"
><SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
projects / privoxy.git / commitdiff