X-Git-Url: http://www.privoxy.org/gitweb/?a=blobdiff_plain;f=doc%2Fsource%2Ffaq.sgml;h=852aa662b2e5025d6e9a21e69420325d9a2ba54d;hb=89f30d269f96d09a6b0041aeecd8224f85f5b393;hp=97e9eddc2b281b1a9825e41af2bcc76e06561212;hpb=6956ba51e2d97c18695d2fa5bf5e549ff4f75ca2;p=privoxy.git diff --git a/doc/source/faq.sgml b/doc/source/faq.sgml index 97e9eddc..852aa662 100644 --- a/doc/source/faq.sgml +++ b/doc/source/faq.sgml @@ -7,13 +7,15 @@ - + + + ]> @@ -60,8 +63,35 @@ Privoxy Frequently Asked Questions -$Id: faq.sgml,v 1.50 2002/04/26 05:25:23 hal9 Exp $ + + + + + Copyright &my-copy; 2001, 2002 by + Privoxy Developers + + + +$Id: faq.sgml,v 1.58 2002/05/10 01:48:20 hal9 Exp $ + + + + @@ -86,16 +116,6 @@ . - - - Test of text doc only. - - - -]]> - &p-intro; @@ -112,16 +132,10 @@ - - - - - - -General Information +General Information What is this new version of <application>Privoxy</application>? @@ -303,8 +317,10 @@ warranty? Registration? Privoxy is licensed under the GNU General Public License (GPL). It is free to use, copy, modify or distribute as you wish - under the terms of this license. Please see the Copyright section for more - information on the license and copyright. + under the terms of this license. Please see the Copyright section for more information on the + license and copyright. Or the LICENSE file + that should be included. @@ -348,7 +364,7 @@ warranty? Registration? -Installation +Installation Which browsers are supported by <application>Privoxy</application>? @@ -461,7 +477,7 @@ All the ads are there. What's wrong? -Configuration +Configuration Can I use my old config files? @@ -482,7 +498,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. @@ -494,6 +510,8 @@ All the ads are there. What's wrong? site, we would define this in our actions file. + @@ -509,7 +527,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. @@ -523,7 +541,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. @@ -531,13 +549,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. + + + + 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). @@ -831,23 +875,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. @@ -873,20 +921,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 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. + 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. + + + 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. + @@ -914,18 +968,39 @@ 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. + + + +Can <application>Privoxy</application> run as a <quote>transparent +</quote> proxy? + + No, Privoxy currently does not have this ability, + though it is planned for a future release. Transparent proxies require + special handling of the request headers beyond what + Privoxy is now capable of. + + + + Chaining Privoxy with another proxy that has + this ability should work though. + See the user + manual, which describes this, and also http://www.transproxy.nlc.net.au/. + + + -Miscellaneous +Miscellaneous How much does <application>Privoxy</application> slow my browsing down? This @@ -948,25 +1023,20 @@ 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. @@ -1030,7 +1100,7 @@ FIXME: commented out until we have data. HB 03/18/02. How can I submit new ads? -Please see the Contact section. +Please see the Contact section. @@ -1266,7 +1336,7 @@ and related issues? - + Troubleshooting @@ -1320,15 +1390,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, @@ -1338,7 +1409,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. @@ -1350,13 +1421,6 @@ What can I do? - -What time is it? - - Time for you to go! - - - - - Copyright and History - -Copyright - - ©right; - - + +Privoxy Copyright, License and History -History - - &history; - - + + ©right; + + + + Portions of this document are borrowed from the original + Junkbuster (tm) FAQ, and modified as + appropriate for Privoxy. + - + + License + + &license; + + + + + + History + + &history; + + + + + +