X-Git-Url: http://www.privoxy.org/gitweb/?a=blobdiff_plain;f=doc%2Fsource%2Fuser-manual.sgml;h=5510575cef4b3256bad5c46864ca86046666155c;hb=e6e4fa04a6d7c852f266e65313f7a7d09318b846;hp=257524083500c11ac91b0aeddfd37510fc50d397;hpb=5e2c53186cd6a537069055bc3edc8e1aa95dfbd0;p=privoxy.git diff --git a/doc/source/user-manual.sgml b/doc/source/user-manual.sgml index 25752408..5510575c 100644 --- a/doc/source/user-manual.sgml +++ b/doc/source/user-manual.sgml @@ -4,6 +4,18 @@ + + + + + + + + + + + + ]> -
Privoxy User Manual -$Id: user-manual.sgml,v 1.63 2002/04/01 16:24:49 hal9 Exp $ +$Id: user-manual.sgml,v 1.68 2002/04/04 18:46:47 swa Exp $ @@ -57,18 +70,18 @@ Hal Burgiss The user manual gives users information on how to install, configure and use - 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. - + Privoxy. + + + + &p-intro; + -You can find the latest version of the user manual at http://www.privoxy.org/user-manual/. - + You can find the latest version of the user manual at http://www.privoxy.org/user-manual/. Please see the Contact section on how to contact the developers. + @@ -77,32 +90,37 @@ You can find the latest version of the user manual at + + + + -Introduction - -&p-intro; +Introduction - This documentation is included with the current BETA version of - Privoxy and is mostly complete at this - point. The most up to date reference for the time being is still the comments - in the source files and in the individual configuration files. Development - of version 3.0 is currently nearing completion, and includes many significant - changes and enhancements over earlier versions. The target release date for - stable v3.0 is soon ;-) + This documentation is included with the current &p-status; version of + Privoxy, v.&p-version;soon ;-)]]>. + - Since this is a BETA version, not all new features are well tested. This + Since this is a &p-status; version, not all new features are well tested. This documentation may be slightly out of sync as a result (especially with CVS sources). And there may be bugs, though hopefully not many! - +]]> @@ -110,15 +128,13 @@ You can find the latest version of the user manual at Installation - Privoxy is available as raw source code, or - pre-compiled binaries. See the Privoxy Home Page - for binaries and current release info. Privoxy - is also available via Privoxy is available as raw source code (tarball + or via CVS), or pre-compiled binaries for various platforms. See the Privoxy Project Page for + the most up to date release information. + Privoxy is also available via CVS. - This is the recommended approach at this time. But please be aware that CVS - is constantly changing, and it may break in mysterious ways. + But + please be aware that CVS is constantly changing, and it may break in + mysterious ways. + + &supported; + + Source - - For gzipped tar archives, unpack the source: - - - - tar xzvf privoxy-2.9.13-beta-src* [.tgz or .tar.gz] - cd privoxy-2.9.13-beta - - - - For retrieving the current CVS sources, you'll need the CVS - package installed first. To download CVS source: - - - - - cvs -d:pserver:anonymous@cvs.ijbswa.sourceforge.net:/cvsroot/ijbswa login - cvs -z3 -d:pserver:anonymous@cvs.ijbswa.sourceforge.net:/cvsroot/ijbswa co current - cd current - - - - - This will create a directory named current/, which will - contain the source tree. - - - - Then, in either case, to build from tarball/CVS source: - - - - - ./configure (--help to see options) - make (the make from gnu, gmake for *BSD) - su - make -n install (to see where all the files will go) - make install (to really install) - - + + &buildsource; + For Redhat and SuSE Linux RPM packages, see below. - - -Red Hat +Red Hat - To build Redhat RPM packages, install source as above. Then: + To build Redhat RPM packages from source, install source as above. Then: @@ -212,10 +194,10 @@ You can find the latest version of the user manual at - rpm -Uvv /usr/src/redhat/RPMS/i686/privoxy-2.9.11-1.i686.rpm + rpm -Uvv /usr/src/redhat/RPMS/i686/privoxy-&p-version;-1.i686.rpm This will place the Privoxy configuration files in /etc/privoxy/, and log files in - /var/log/privoxy/. + /var/log/privoxy/. Run + ckconfig privoxy on to have + Privoxy start automatically during init. + - + -SuSE +SuSE To build SuSE RPM packages, install source as above. Then: @@ -256,10 +241,10 @@ You can find the latest version of the user manual at - rpm -Uvv /usr/src/packages/RPMS/i686/privoxy-2.9.11-1.i686.rpm + rpm -Uvv /usr/src/packages/RPMS/i686/privoxy-&p-version;-1.i686.rpm This will place the Privoxy configuration files in /etc/privoxy/, and log files in - /var/log/privoxy/. + /var/log/privoxy/. - + -OS/2 +OS/2 -Windows +Windows Click-click. (I need help on this. Not a clue here. Also for configuration section below. HB.) - + -Other +Other Some quick notes on other Operating Systems. @@ -361,6 +346,7 @@ configuration section below. HB.) The rest should be the same as above for Linux/Unix. + @@ -416,11 +402,11 @@ configuration section below. HB.) -For for SuSE: /etc/rc.d/privoxy start + For for SuSE: /etc/rc.d/privoxy start -For RedHat: /etc/rc.d/init.d/privoxy start + For RedHat: /etc/rc.d/init.d/privoxy start @@ -658,15 +644,15 @@ Please choose from the following options: For Unix, *BSD and Linux, all configuration files are located in /etc/privoxy/ by default. For MS Windows, OS/2, and AmigaOS these are all in the same directory as the - Privoxy executable. The name and number of - configuration files has changed from previous versions, and is subject to - change as development progresses. + Privoxy executable. The installed defaults provide a reasonable starting point, though possibly aggressive by some standards. For the time being, there are only three - default configuration files (this will change in time): + default configuration files (this may change in time): @@ -714,12 +700,14 @@ Please choose from the following options: automatically. + While under development, the configuration content is subject to change. The below documentation may not be accurate by the time you read this. Also, what constitutes a default setting, may change, so please check all your configuration files on important issues. +]]> @@ -1125,10 +1113,12 @@ Please choose from the following options: + It is highly recommended that you enable ERROR reporting (debug 8192), at least until v3.0 is released. +]]> The reporting of FATAL errors (i.e. ones which crash @@ -1791,7 +1781,8 @@ Please choose from the following options: - Your squid configuration could then look like this: +Your squid configuration could then look like this (assuming that the IP +address of the box is 192.168.0.1 ): @@ -1802,7 +1793,16 @@ Please choose from the following options: - cache_peer 127.0.0.1 parent 8118 0 no-query + cache_peer 192.168.0.1 parent 8118 0 no-query + + # don't listen to the whole world + http_port 192.168.0.1:3128 + + # define the local lan + acl mylocallan src 192.168.0.1-192.168.0.5/255.255.255.255 + + # grant access for http to local lan + http_access allow mylocallan # Define ACL for protocol FTP acl FTP proto FTP @@ -2354,7 +2354,7 @@ Removed references to Win32. HB 09/23/01 will link to some script on their own server, giving the destination as a parameter, which will then redirect you to the final target. URLs resulting from this scheme typically look like: - http://some.place/some_script?http://some.where-else. + http://some.place/some_script?http://some.where-else. Sometimes, there are even multiple consecutive redirects encoded in the @@ -2585,7 +2585,8 @@ Removed references to Win32. HB 09/23/01 images and blocked. And also, image-blocker should be set to blank. Note you cannot treat HTML pages as images in most cases. For instance, frames - require an HTML page to display. Forcing an image in this + require an HTML page to display. So a frame that is an ad, cannot be + treated as an image. Forcing an image in this situation just will not work. @@ -2946,7 +2947,6 @@ icon being being cached by the browser, which will speed up the display. content he may depend on. There is no way to have hard and fast rules for all sites. See the Appendix for a brief example on troubleshooting actions. - @@ -2978,7 +2978,7 @@ icon being being cached by the browser, which will speed up the display. - # Useful customer aliases we can use later. These must come first! + # Useful custom aliases we can use later. These must come first! {{alias}} +no-cookies = +no-cookies-set +no-cookies-read -no-cookies = -no-cookies-set -no-cookies-read @@ -3177,50 +3177,12 @@ icon being being cached by the browser, which will speed up the display. Contacting the Developers, Bug Reporting and Feature Requests - -We value your feedback. However, to provide you with the best support, -please note: - - - - Use the Sourceforge support forum to get - help. - - Submit bugs only thru our Sourceforge bug - forum. - - - Make sure that the bug has not already been submitted. Please try to - verify that it is a Privoxy bug, and not a - browser or site bug first. If you are using your own custom configuration, - please try the stock configs to see if the problem is a configuration - related bug. And if not using the latest development snapshot, please try - the latest one. Or even better, CVS sources. Please be sure to include the - Privoxy/Junkbuster - version, platform, browser, any pertinent log data, any other relevant - details (please be specific) and, if possible, some way to reproduce the - bug. - - - - Submit feature requests only thru our Sourceforge feature request forum. - - - - + - -For any other issues, feel free to use the mailing lists. - + &contacting; - - Anyone interested in actively participating in development and related - discussions can join the appropriate mailing list - here. - Archives are available here too. - + @@ -3228,43 +3190,10 @@ For any other issues, feel free to use the Copyright and History - -License - - Privoxy is free software; you can - redistribute it and/or modify it under the terms of the GNU General Public - - License as published by the Free Software Foundation; either version 2 of the - License, or (at your option) any later version. - - - - - This program is distributed in the hope that it will be useful, but WITHOUT - ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS - FOR A PARTICULAR PURPOSE. See the GNU General Public License for more - details, which is available from the Free Software Foundation, - Inc, 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. - - - - You should have received a copy of the GNU General Public License - along with this program; if not, write to the Free Software Foundation, Inc., - 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA. - - +Copyright + + ©right; + @@ -3272,39 +3201,18 @@ For any other issues, feel free to use the -History - - Privoxy is evolved, and derived from, - the Internet Junkbuster, with many - improvments and enhancements over the original. - - - - Junkbuster was originally written by Anonymous - Coders and Junkbuster's - Corporation, and was released as free open-source software under the - GNU GPL. Stefan - Waldherr made many improvements, and started the SourceForge project - Privoxy to rekindle development. There are now several active - developers contributing. The last stable release of - Junkbuster was v2.0.2, which has now - grown whiskers ;-). - - +History + + &history; + - See Also - -&seealso; - + + &seealso; + @@ -3768,7 +3676,7 @@ For any other issues, feel free to use the Now the page displays ;-) Be sure to flush your browser's caches when making such changes. Or, try using Shift+Reload. - But now what about a situation where we get no explicit matches like we did with: - @@ -4040,6 +3946,25 @@ For any other issues, feel free to use the