X-Git-Url: http://www.privoxy.org/gitweb/?a=blobdiff_plain;f=doc%2Fsource%2Ffaq.sgml;h=bbbf493e7f748ed0a12e063415ea717d7ac755d8;hb=b333057dc421a6757160d0e05b935a80ff7a5d1c;hp=b19a2be9c4e6dd8b0a434cc2dee3d47f709987aa;hpb=0981554c94fbb1ef7e71b00a42e76354b8a9e86b;p=privoxy.git diff --git a/doc/source/faq.sgml b/doc/source/faq.sgml index b19a2be9..bbbf493e 100644 --- a/doc/source/faq.sgml +++ b/doc/source/faq.sgml @@ -6,10 +6,10 @@ This file belongs into ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/ - $Id: faq.sgml,v 1.22 2002/03/24 11:51:00 swa Exp $ + $Id: faq.sgml,v 1.31 2002/03/26 22:29:55 swa Exp $ Written by and Copyright (C) 2001 the SourceForge - PRIVOXY team. http://ijbswa.sourceforge.net + Privoxy team. http://www.privoxy.org/ Based on the Internet Junkbuster originally written by and Copyright (C) 1997 Anonymous Coders and @@ -20,7 +20,7 @@ Privoxy Frequently Asked Questions -$Id: faq.sgml,v 1.22 2002/03/24 11:51:00 swa Exp $ +$Id: faq.sgml,v 1.31 2002/03/26 22:29:55 swa Exp $ @@ -32,21 +32,32 @@ -The FAQ document gives users and developers alike answers to frequently asked -questions about -Privoxy. Privoxy is a web -proxy with advanced filtering capabilities for protecting privacy, filtering -web page content, managing cookies, controlling access, and removing ads, -banners, pop-ups and other obnoxious Internet -Junk. Privoxy has a very flexible configuration and -can be customized to suit individual needs and -tastes. Privoxy has application for both stand-alone -systems and multi-user networks. + This FAQ gives users and developers alike answers to frequently asked + questions about Privoxy. -You can find the latest version of the document at http://ijbswa.sourceforge.net/faq/. + Privoxy is a web proxy with advanced filtering + capabilities for protecting privacy, filtering web page content, managing + cookies, controlling access, and removing ads, banners, pop-ups and other + obnoxious Internet junk. Privoxy has a very + flexible configuration and can be customized to suit individual needs and + tastes. Privoxy has application for both + stand-alone systems and multi-user networks. + + + Privoxy is based on the code of the + Internet Junkbuster. + Junkbuster was originally written by JunkBusters + Corporation, and was released as free open-source software under the GNU GPL. + Stefan Waldherr made many improvements, and started the SourceForge project + to continue development. + + + + +You can find the latest version of the document at http://www.privoxy.org/faq/. Please see the Contact section in the -user-manual if you want to contact the developers. +user-manual if you want to contact the developers. @@ -76,7 +87,7 @@ Please see the Contact section in the What is this new version of <application>Privoxy</application>? The original Internet Junkbuster (tm) is a - coyrighted product of Junkbusters + copyrighted product of Junkbusters Corporation. Development of this effort stopped some time ago as of version 2.0.2. Stefan Waldherr started the ijbswa project on Sourceforge to rekindle @@ -85,11 +96,35 @@ Please see the Contact section in the The new Privoxy started with the same - code base, but has changed significantly at this point. + Junkbuster code base, but has changed + significantly at this point. + + +Why <quote>Privoxy</quote>? Why a name change at all? + + Privoxy is for Privacy Enhancing Proxy. + There are possible legal complications from the continued use of the + Junkbuster name, which is a trademark of + Junkbusters Corporation. + (There are no objections from Junkbusters Corporation to the + Privoxy project itself though, and they + in fact still share our ideals and goals.) + + + + The developers also believed that there so many changes from the original + code, that it was time to make a clean break from the past and make + a name in their own right, especially now with the pending release of + version 3.0. + + + + + How does it differ from the old <application>Junkbuster?</application> All the old features remain. The new Privoxy @@ -109,7 +144,7 @@ Please see the Contact section in the What are some of the new features? @@ -117,7 +152,7 @@ Please see the Contact section in the Integrated browser based configuration and control utility (http://i.j.b). Browser-based tracing of rule + url="http://p.p">http://p.p). Browser-based tracing of rule and filter effects. @@ -249,7 +284,7 @@ Please see the Contact section in the Modern browsers do indeed have some of the same functionality as Privoxy. Maybe this is adequate for you. But Privoxy is much more - verstatile and powerful, and can do a number of things that browsers just can't. + versatile and powerful, and can do a number of things that browsers just can't. In addition, a proxy is good choice if you use multiple browsers, or @@ -313,17 +348,41 @@ repository, and together we'll find a suitable task for you. Installation -Can I install the new - <application>Privoxy</application> over the old one? + +Which browsers are supported by <application>Privoxy</application>? + + Any browser that can be configured to use a proxy, which + is probably almost all browsers. Direct browser support is not necessary + since Privoxy runs as a separate application and + just exchanges standard HTML data with your browser. + + + + +Which operating systems are supported? + + Right now Win32, Mac OSX, OS/2, AmigaOS, Linux, and many + flavors of Unix. + + + + Source code is available, so porting to other operating systems, + is always a possibility. + + + + +Can I install + <application>Privoxy</application> over <application>Junkbuster</application>? - We recommend you uninstall the old Junkbuster + We recommend you uninstall Junkbuster first to minimize conflicts and confusion. You may want to save your old configuration files for future reference. The configuration is substantially changed. See the user-manual for + url="http://www.privoxy.org/user-manual/">user-manual for platform specific installation instructions. [FIXME: This is meant for after the name change for 3.0!] @@ -359,7 +418,7 @@ special I have to do now? and Secure (HTTPS) and then the number 8118 for port. This tells your browser to send all web requests to Privoxy instead of directly to the - Interenet. + Internet. Privoxy can also be used to proxy for @@ -385,7 +444,7 @@ All the ads are there. What's wrong? the browser's caches to force a full re-reading of pages. You can verify that Privoxy is running, and your browser is correctly configured by entering the special URL: - http://i.j.b/. This should give you + http://p.p/. This should give you a banner that says This is Privoxy and access to Privoxy's internal configuration. If you see this, then you are good to go. If not, the browser or @@ -447,7 +506,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. @@ -459,9 +518,9 @@ way to do this? The easiest way to do this, is to access Privoxy - with your web browser at http://i.j.b/, + with your web browser at http://p.p/, and then select - "Edit the actions list" + "Edit the actions list" from the selection list. You can also do this by editing the appropriate file with a text editor. @@ -469,7 +528,7 @@ way to do this? Please see the user-manual for a + url="../user-manual/configuration.html#ACTIONSFILE">user-manual for a detailed explanation of these and other configuration files, and their various options and syntax. @@ -670,6 +729,32 @@ Note that normally only local users can connect to Privoxy + + +What is a <quote>default.filter</quote>? + + The default.filter file is 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 + on a line by line basis. This is potentially a very powerful feature, but + requires some expertise. + + + + If you are familiar with regular expressions, and HTML, you can look at + the provided default.filter with a text editor and see + some of things it can be used for. + + + + 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. + + + + How can I set up <application>Privoxy</application> to act as a proxy for my LAN? @@ -698,20 +783,20 @@ Note that normally only local users can connect to Privoxy -Instead of ads, now I get a Privoxy logo [or -checkerboard]. I don't want to see anything. +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 the - Privoxy logo, a checkerboard pattern (this - scales better), a transparent 1x1 GIF image, or a custom URL or your choice. + Privoxy is stopping. You have the choice a checkerboard + pattern, a transparent 1x1 GIF image (aka blank), or a custom + URL or your choice. If you want to see nothing, then change the +image-blocker action to +image-blocker{blank}. This can be done from the Edit Actions List selection at http://i.j.b/. Or by hand editing the appropriate + url="http://p.p/">http://p.p/. Or by hand editing the appropriate actions file. This will only effect what is defined as images though. @@ -721,12 +806,12 @@ checkerboard]. I don't want to see anything. -Why would anybody want to see the logo or checkerboard? +Why would anybody want to see a checkerboard pattern? This can be helpful for troubleshooting problems. It might also be good for anyone new to Privoxy so that they can see if their favorite pages are displaying correctly, and - Privoxy is not inadvertantly removing something + Privoxy is not inadvertently removing something important. @@ -741,7 +826,7 @@ checkerboard]. I don't want to see anything. 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 as images (e.g. ad banners). If you want them to be treated - as if they were images, so that they can be invisible, then move the + as if they were images, so that they can be made invisible, then move the offending URL from the +block section to the +imageblock section of your actions file. Alternately, you could modify the block HTML template that @@ -751,11 +836,23 @@ checkerboard]. I don't want to see anything. + +How can I make <application>Privoxy</application> work with other +proxies like <application>Squid</application>? + + This can be done. See the user manual, + which describes how to do this. + + + + + -Misc +Miscellaneous How much does <application>Privoxy</application> slow my browsing down? This @@ -801,7 +898,7 @@ entire page first, do its content magic and then send the page to the browser. </sect3> -<sect3 id="configurl"><title>What is the "http://i.j.b/"? +What is the "http://p.p/"? Since Privoxy sits between your web browser and the Internet, it can be programmed to handle certain pages specially. @@ -810,19 +907,19 @@ 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://i.j.b/ or, equivalently, http://ijbswa.sourceforge.net/config/ -(Note that i.j.b is far easier to type but may not work in some +http://p.p/ or, equivalently, http://www.privoxy.org/config/ +(Note that p.p is far easier to type but may not work in some configurations). -These pages are *not* forwarded to a server on the internet - instead they are +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://i.j.b/ will fail, and -http://ijbswa.sourceforge.net/config/ will return a web page telling you +If you are not running Privoxy, then http://p.p/ will fail, and +http://www.privoxy.org/config/ will return a web page telling you you're not running Privoxy. @@ -1001,7 +1098,11 @@ and ugly looking. Can't a better font be used? image is scaled to fill a largish area. There is not much to be done about this, other than to use one of the other imageblock directives: pattern, - blank, or a URL of your chosing. + blank, or a URL of your choosing. + + +Given the above problem, we have decided to remove the logo option entirely +[as of v2.9.13]. @@ -1057,27 +1158,16 @@ secure is it? Do I need to take any special precautions? - -What is a <quote>default.filter</quote>? - - The default.filter is used to filter any - 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. This is - potentially a very powerful feature, but requires some expertise. - - + +How can I temporarily disable <application>Privoxy</application>? - If you are familiar with regular expressions, and HTML, you can look at - the provided default.filter with a text editor and see - some of things it can be used for. - + The easiest way is to access Privoxy with your + browser by using the special URL: http://p.p/ + and select "Toggle Privoxy on or off" from that page. - - Presently, there is no GUI editor option for this part of the configuration. - + @@ -1096,7 +1186,8 @@ with every web page? - The old Privoxy used port 8000 by + The old Privoxy (and also + Junkbuster) used port 8000 by default. This has been changed to port 8118 now, due to a conflict with NAS (Network Audio Service), which uses port 8000. If you haven't, you need to change your browser to the new port number, or alternately @@ -1114,14 +1205,14 @@ still getting through. How? If the ad had been displayed before you added its URL, it will probably be held in the browser's cache for some time, so it will be displayed without the need for any request to the server, and Privoxy - will not be in the picture. The best thing to do is try flusing the browser's + will not be in the picture. The best thing to do is try flushing the browser's caches. And then try again. If this doesn't help, you probably have an error in the rule you applied. Try pasting the full URL of the offending ad into http://ijbswa.sourceforge.net/config/show-url-info + url="http://www.privoxy.org/config/show-url-info">http://www.privoxy.org/config/show-url-info and see if any actions match your new rule. @@ -1134,14 +1225,14 @@ What can I do? First verify that it is indeed a Privoxy problem, by disabling Privoxy filtering and blocking. - Go to http://i.j.b/ and click on + Go to http://p.p/ and click on Toggle Privoxy On or Off, then disable it. Now try that page again. If still a problem, go to Show which actions apply to a URL and - why from http://i.j.b/ and paste + 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 @@ -1151,7 +1242,7 @@ What can I do? that looks like it is disabling the feature that is causing the problem. Re-try the page. There might be some trial and error involved. This is discussed in a little more detail in the user-manual + url="../user-manual/appendix.html#ACTIONSANAT">user-manual appendix. @@ -1184,12 +1275,17 @@ FIXME: Commented out until we have something to put here. HB 03/18/02. --> + + Copyright and History Please see the user manual for information on Copyright and History. @@ -1227,6 +1323,28 @@ 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.31 2002/03/26 22:29:55 swa +we have a new homepage! + +Revision 1.30 2002/03/25 16:39:22 hal9 +A few new sections. Made all links relative to user-manual. + +Revision 1.29 2002/03/25 05:23:57 hal9 +Moved section, and touch ups. + +Revision 1.28 2002/03/25 04:27:33 hal9 +New section related to name change. + +Revision 1.25 2002/03/24 16:08:08 swa +we are too lazy to make a block-built +privoxy logo. hence removed the option. + +Revision 1.24 2002/03/24 15:46:20 swa +name change related issue. + +Revision 1.23 2002/03/24 12:33:01 swa +more additions. + Revision 1.22 2002/03/24 11:51:00 swa name change. changed filenames.