X-Git-Url: http://www.privoxy.org/gitweb/?p=privoxy.git;a=blobdiff_plain;f=doc%2Fsource%2Ffaq.sgml;h=066ca3224dbc67ba422560e81de119604e54455d;hp=80d8d265e3badcaf8e459305c960c3354ffb2658;hb=b7f24f5d58cdc64c42a385447d4e98b1ae5fee82;hpb=c33efae5172aec147d785c560648dd96084f6d94 diff --git a/doc/source/faq.sgml b/doc/source/faq.sgml index 80d8d265..066ca322 100644 --- a/doc/source/faq.sgml +++ b/doc/source/faq.sgml @@ -1,5 +1,5 @@ + @@ -22,7 +22,7 @@ This file belongs into ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/ - $Id: faq.sgml,v 1.48 2002/04/10 18:45:15 swa Exp $ + $Id: faq.sgml,v 1.52 2002/04/29 03:08:43 hal9 Exp $ Written by and Copyright (C) 2001 the SourceForge Privoxy team. http://www.privoxy.org/ @@ -60,7 +60,7 @@ Privoxy Frequently Asked Questions -$Id: faq.sgml,v 1.48 2002/04/10 18:45:15 swa Exp $ +$Id: faq.sgml,v 1.52 2002/04/29 03:08:43 hal9 Exp $ @@ -86,6 +86,16 @@ . + + + Test of text doc only. + + + +]]> + &p-intro; @@ -472,7 +482,7 @@ All the ads are there. What's wrong? actions files are where various actions that Privoxy might take, are configured. Typically, you would define a set of default actions that apply - to all URLs, then add exceptions to these defaults. + to all URLs, then add exceptions to these defaults where needed. @@ -484,6 +494,8 @@ All the ads are there. What's wrong? site, we would define this in our actions file. + @@ -499,7 +511,7 @@ All the ads are there. What's wrong? some of these actions. These are all explained in the - user-manual. + user-manual. Please refer to that. @@ -513,7 +525,7 @@ way to do this? The easiest way to do this, is to access Privoxy with your web browser at http://p.p/, and then select - "Edit the actions list" + "View & change the current configuration" from the selection list. You can also do this by editing the appropriate file with a text editor. @@ -521,13 +533,36 @@ way to do this? Please see the user-manual for a + url="../user-manual/actions-file.html">user-manual for a detailed explanation of these and other configuration files, and their various options and syntax. + + +There are several different <quote>actions</quote> files. What are +the differences? + + As of Privoxy v2.9.15, three actions files + are being included, to be used for + different purposes. These are + default.action, standard.action, + and user.action. Please see + the User Manual + for an explanation of each. + + + + Earlier versions included three different versions + default.action files. The new scheme allows for + greater flexibility of local configuration, and for browser based + configuration. + + + + + @@ -584,9 +620,9 @@ following table shows you, which features are enabled in each configuration. - + + ad-filtering ? @@ -594,7 +630,7 @@ following table shows you, which features are enabled in each configuration. x x - + blank image ? @@ -602,7 +638,7 @@ following table shows you, which features are enabled in each configuration. x x - + de-animate GIFs ? @@ -610,7 +646,7 @@ following table shows you, which features are enabled in each configuration. x x - + referer forging ? @@ -618,7 +654,7 @@ following table shows you, which features are enabled in each configuration. x x - + jon's +no-cookies-keep (i.e. session cookies only) ? @@ -626,7 +662,7 @@ following table shows you, which features are enabled in each configuration. x x - + no-popup windows ? @@ -634,7 +670,7 @@ following table shows you, which features are enabled in each configuration. x x - + fast redirects ? @@ -642,7 +678,7 @@ following table shows you, which features are enabled in each configuration. x x - + hide-referrer ? @@ -650,7 +686,7 @@ following table shows you, which features are enabled in each configuration. x x - + hide-useragent ? @@ -658,7 +694,7 @@ following table shows you, which features are enabled in each configuration. x x - + content-modification ? @@ -666,7 +702,7 @@ following table shows you, which features are enabled in each configuration. x - + feature-x ? @@ -674,7 +710,7 @@ following table shows you, which features are enabled in each configuration. - + feature-y ? @@ -682,7 +718,7 @@ following table shows you, which features are enabled in each configuration. - + feature-z ? @@ -690,13 +726,15 @@ following table shows you, which features are enabled in each configuration. - + + --> + Why can I change the configuration with a browser? Does that not raise security issues? @@ -727,7 +765,8 @@ problem. What is <quote>default.filter</quote>? - The default.filter file is used to filter any + The default.filter file is where filters + are defined, which are used to filter any web page content. By filtering we mean it can modify, remove, or change anything on the page, including HTML tags, and JavaScript. Regular expressions are used to accomplish this, and operate @@ -744,7 +783,8 @@ problem. Presently, there is no GUI editor option for this part of the configuration, but you can disable/enable various sections of the included default - file with the Actions List Editor from your browser. + file with the View & change the current configuration from + your browser. @@ -765,7 +805,7 @@ problem. listen-address 192.168.1.1:8118 - + @@ -780,21 +820,22 @@ problem. Instead of ads, now I get a checkerboard pattern. I don't want to see anything. This is a configuration option for images that - Privoxy is stopping. You have the choice of a checkerboard - pattern, a transparent 1x1 GIF image (aka blank), or a custom - URL of your choice. Note that to fit this category, the URL must match both - the +image and +block actions. + Privoxy is stopping. You have the choice of a + checkerboard pattern, a transparent 1x1 GIF image (aka blank), + or a custom URL of your choice. Note that to fit this category, the URL must + match both the +handle-as-image + and + +block actions. - - If you want to see nothing, then change the +image-blocker + If you want to see nothing, then change the + +set-image-blocker action to +image-blocker{blank}. This can be done from the - Edit Actions List selection at View & change the current configuration selection at http://p.p/. Or by hand editing the appropriate actions file. This will only effect what is defined as images though. Also, some URLs that generate the bright red Blocked - banner, can be moved to the +image-blocker section for the + banner, can be moved to the +set-image-blocker section for the same reason, but there are some limits and risks to this (see below). @@ -818,23 +859,27 @@ problem. Blocked. Why and how do I get rid of this? These are URLs that match something in one of - Privoxy's 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 images (e.g. ad banners). Depending on the - URL itself, it is sometimes hard for Privoxy to - really know whether there is indeed an ad image there or not. And there are - limitations as to what Privoxy can do to - fool the browser. + Privoxy's 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 images (e.g. ads that are GIF image + files). Depending on the URL itself, it is sometimes hard for + Privoxy to really know whether there is indeed an + ad image there or not. And there are limitations as to what + Privoxy can do to fool the + browser. 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 blank image), for an HTML + aribitrary image (like we would for a blank 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 - Privoxy will use the Blocked page. + for frames. Such situations can be a little trickier to deal with, and + Privoxy may show the Blocked page, + despite your best efforts. @@ -860,20 +905,26 @@ problem. Another way to deal with this is find why and where Privoxy is blocking the frame, and - diable this. Then let the +image-blocker action + diable this. Then let the +set-image-blocker action handle the ad that is embedded in the frame's HTML page. -I cannot see all of the <quote>Blocked</quote> page banner. All I -see is a bright red square. +I cannot see all of the <quote>Blocked</quote> page banner. Help. + + There is not enough available space to fit the entire Blocked page. Try right + clicking on the visible portion, and select Show Frame, + or equivalent. This will usually allow you to see the entire Privoxy + Blocked page, and from there you can see just what is being + blocked, and why. + - There is not enough space to fit the entire page. Try right clicking on the - visible, red portion, and select Show Frame, or equivalent. - This will usually allow you to see the entire Privoxy Blocked - page, and from there you can see just what is being blocked, and why. + 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. + @@ -901,7 +952,7 @@ on Win2K/NT? proxies like Squid? This can be done. See the user manual, + url="../user-manual/config.html#FORWARDING">user manual, which describes how to do this. @@ -939,21 +990,17 @@ has to add extra time to browsing. I noticed considerable delays in page requests compared to the old Junkbuster. What's wrong? -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". -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". - - -To modify the content of a page (i.e. make frames resizeable again, etc.) and -not just replace ads, Privoxy needs to download the -entire page first, do its content magic and then send the page to the browser. + To modify the content of a page (i.e. make frames resizeable again, etc.) and + not just replace ads, Privoxy needs to download + the entire page first, do its content magic and then send the page to the + browser. @@ -1017,10 +1064,7 @@ FIXME: commented out until we have data. HB 03/18/02. How can I submit new ads? - Beginning with Privoxy v2.9.14, missed ads and - banners and other actions file problems, can be submitted by accessing - actions file feedback system - from http://p.p/ +Please see the Contact section. @@ -1028,14 +1072,6 @@ FIXME: commented out until we have data. HB 03/18/02. or Junkbuster. - - There will soon be regularly updated actions files posted. These - will be announced on the - ijbswa-announce - list. - - How can I hide my IP address? @@ -1318,15 +1354,16 @@ What can I do? by disabling Privoxy filtering and blocking. Go to http://p.p/ and click on Toggle Privoxy On or Off, then disable it. Now try that - page again. It's probably a good idea to flush the browser cache as well. + page again. It's probably a good idea to flush the browser cache as well + with Shift+Reload to flush caches. If still a problem, go to Show which actions apply to a URL and why from http://p.p/ 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 Edit - the actions list. Here you should see various sections that have + being applied to the URL. Now, armed with this information, go to + View & change the current configuration. Here you should see various sections that have various Privoxy features disabled for specific sites. Most disabled actions will have a - (minus sign) in front of them. Some aliases are used just to disable other actions, @@ -1336,7 +1373,7 @@ What can I do? is causing the problem. Rember to flush your browser's caches when making such changes! As a last resort, try fragile 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 user-manual appendix. @@ -1348,24 +1385,6 @@ What can I do? - -Where can I get help? Report bugs? Feature Requests? Etc? - - Feedback is encouraged, whether good, bad or ugly. Please see the contact - page in the user-manual for - details. - - - - - - -What time is it? - - Time for you to go! - - - - Contacting the developers, Bug Reporting and Feature Requests + Contacting the developers, Bug Reporting and Feature Requests &contacting; - Copyright and History + Copyright and History Copyright @@ -1443,6 +1462,20 @@ FIXME: Commented out until we have something to put here. HB 03/18/02. Temple Place - Suite 330, Boston, MA 02111-1307, USA. $Log: faq.sgml,v $ +Revision 1.52 2002/04/29 03:08:43 hal9 +-Added new Q/A on new actions file set up (pointer to u-m) +-Fixed a few broken links and converted old actions as a result of + recent changes. + +Revision 1.51 2002/04/26 17:24:31 swa +bookmarks cleaned, changed structure of user manual, screen and programlisting cleanups, and numerous other changes that I forgot + +Revision 1.50 2002/04/26 05:25:23 hal9 +Mass commit to catch a few scattered fixes. + +Revision 1.49 2002/04/12 10:10:18 swa +version update + Revision 1.48 2002/04/10 18:45:15 swa generated