X-Git-Url: http://www.privoxy.org/gitweb/?p=privoxy.git;a=blobdiff_plain;f=doc%2Fsource%2Ffaq.sgml;h=beb3504603e2f54e3ec0dd847a9add0f63fdc571;hp=5d74168202afa7d488b3ef8d8417c55947c2efbd;hb=51ae576dcda313326c2bb36bc8f05713683425d3;hpb=9cbdd42a4ad5c194ecd8571d7764110e72e2d942 diff --git a/doc/source/faq.sgml b/doc/source/faq.sgml index 5d741682..beb35046 100644 --- a/doc/source/faq.sgml +++ b/doc/source/faq.sgml @@ -1,5 +1,5 @@ + @@ -7,7 +7,7 @@ - + @@ -22,7 +22,7 @@ This file belongs into ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/ - $Id: faq.sgml,v 1.43 2002/04/04 21:59:53 hal9 Exp $ + $Id: faq.sgml,v 1.54 2002/05/03 05:06:44 hal9 Exp $ Written by and Copyright (C) 2001 the SourceForge Privoxy team. http://www.privoxy.org/ @@ -53,6 +53,7 @@ to live a peaceful existence! ======================================================================== + --> @@ -60,7 +61,7 @@ Privoxy Frequently Asked Questions -$Id: faq.sgml,v 1.43 2002/04/04 21:59:53 hal9 Exp $ +$Id: faq.sgml,v 1.54 2002/05/03 05:06:44 hal9 Exp $ @@ -102,16 +103,10 @@ - - - - - - -General Information +General Information What is this new version of <application>Privoxy</application>? @@ -338,7 +333,7 @@ warranty? Registration? -Installation +Installation Which browsers are supported by <application>Privoxy</application>? @@ -451,7 +446,7 @@ All the ads are there. What's wrong? -Configuration +Configuration Can I use my old config files? @@ -472,7 +467,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 +479,8 @@ All the ads are there. What's wrong? site, we would define this in our actions file. + @@ -499,7 +496,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 +510,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 +518,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 +605,9 @@ following table shows you, which features are enabled in each configuration. - + + ad-filtering ? @@ -594,7 +615,7 @@ following table shows you, which features are enabled in each configuration. x x - + blank image ? @@ -602,7 +623,7 @@ following table shows you, which features are enabled in each configuration. x x - + de-animate GIFs ? @@ -610,7 +631,7 @@ following table shows you, which features are enabled in each configuration. x x - + referer forging ? @@ -618,7 +639,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 +647,7 @@ following table shows you, which features are enabled in each configuration. x x - + no-popup windows ? @@ -634,7 +655,7 @@ following table shows you, which features are enabled in each configuration. x x - + fast redirects ? @@ -642,7 +663,7 @@ following table shows you, which features are enabled in each configuration. x x - + hide-referrer ? @@ -650,7 +671,7 @@ following table shows you, which features are enabled in each configuration. x x - + hide-useragent ? @@ -658,7 +679,7 @@ following table shows you, which features are enabled in each configuration. x x - + content-modification ? @@ -666,7 +687,7 @@ following table shows you, which features are enabled in each configuration. x - + feature-x ? @@ -674,7 +695,7 @@ following table shows you, which features are enabled in each configuration. - + feature-y ? @@ -682,7 +703,7 @@ following table shows you, which features are enabled in each configuration. - + feature-z ? @@ -690,13 +711,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 +750,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 +768,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 +790,7 @@ problem. listen-address 192.168.1.1:8118 - + @@ -780,21 +805,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 +844,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 +890,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. + @@ -901,18 +937,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 @@ -935,25 +992,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. @@ -965,32 +1017,34 @@ programmed to handle certain pages specially. -With recent versions of Privoxy (version 2.9.x), you can get some -information about Privoxy and change some settings by going to -http://p.p/ or, equivalently, http://config.privoxy.org/ -(Note that p.p is far easier to type but may not work in some -configurations. With the name change to Privoxy, -this is changed from the previous http://i.j.b/ or earlier 2.9.x versions). + With recent versions of Privoxy (version 2.9.x and + greater), you can get some information about + Privoxy and change some settings by going to + http://p.p/ or, equivalently, http://config.privoxy.org/ (Note + that p.p is far easier to type but may not work in some configurations. With + the name change to Privoxy, this is changed from + the previous http://i.j.b/ and earlier 2.9.x versions). -These pages are not forwarded to a server on the Internet -- instead they are handled by a special web server which is built in to -Privoxy. + These pages are not forwarded to a server on the + Internet - instead they are handled by a special web server which is built in to + Privoxy. -If you are not running Privoxy, then http://p.p/ will fail, and http://config.privoxy.org/ will -return a web page telling you you're not running -Privoxy. + If you are not running Privoxy, then http://p.p/ will fail, and http://config.privoxy.org/ will + return a web page telling you you're not running + Privoxy. -If you have version 2.0.2, then the equivalent is -http://example.com/show-proxy-args (but you get far less information, and you -should really consider upgrading to &p-version;). + If you have version 2.0.2, then the equivalent is + http://example.com/show-proxy-args (but you get far less information, and + you should really consider upgrading to &p-version;). @@ -1003,35 +1057,32 @@ FIXME: commented out until we have data. HB 03/18/02. -How do I chain <application>Privoxy</application> with other proxies -(e.g. squid)? - - Fillme. - - --> Do you still maintain the blocklists? - No. The format of the blocklists has changed significantly in versions - 2.9.x and later. + No, not by this name. The format of the blocklists has changed + significantly in versions 2.9.x and later. This functionality + is done by the actions file now. See next question ... How can I submit new ads? - As of now, please discontinue to submit new ad blocking infos. Once we - have released the new version, there will again be a form on the website, - which you can use to contribute new ads. +Please see the Contact section. + + + This process does not work with earlier versions of Privoxy + or Junkbuster. + + How can I hide my IP address? You cannot hide your IP address with Privoxy or any other software, since -the server needs to know your IP address to send the answer to you. +the server needs to know your IP address to send the answers back to you. Fortunately there are many publicly usable anonymous proxies out there, which @@ -1254,7 +1305,7 @@ and related issues? - + Troubleshooting @@ -1308,15 +1359,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, @@ -1326,7 +1378,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. @@ -1338,24 +1390,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! - - -