From: hal9 Date: Tue, 16 Apr 2002 04:25:51 +0000 (+0000) Subject: -Added 'Note to Upgraders' and re-ordered the 'Quickstart' section. X-Git-Tag: v_2_9_14~15 X-Git-Url: http://www.privoxy.org/gitweb/?a=commitdiff_plain;h=46adfc8e72b8874fa6e5a9c61535f5137871cbeb;p=privoxy.git -Added 'Note to Upgraders' and re-ordered the 'Quickstart' section. -Note about proxy may need requests to re-read config files. --- diff --git a/doc/source/user-manual.sgml b/doc/source/user-manual.sgml index 9697b449..88a7e411 100644 --- a/doc/source/user-manual.sgml +++ b/doc/source/user-manual.sgml @@ -24,7 +24,7 @@ This file belongs into ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/ - $Id: user-manual.sgml,v 1.74 2002/04/11 00:54:38 hal9 Exp $ + $Id: user-manual.sgml,v 1.75 2002/04/12 02:08:48 david__schmidt Exp $ Written by and Copyright (C) 2001 the SourceForge Privoxy team. http://www.privoxy.org/ @@ -36,9 +36,7 @@ ======================================================================== NOTE: Please read developer-manual/documentation.html before touching - anything in this, or other Privoxy documentation. You have been warned! - Failure to abide by this rule will result in the revocation of your license - to live a peaceful existence! + anything in this, or other Privoxy documentation. ======================================================================== --> @@ -47,7 +45,7 @@ Privoxy User Manual -$Id: user-manual.sgml,v 1.74 2002/04/11 00:54:38 hal9 Exp $ +$Id: user-manual.sgml,v 1.75 2002/04/12 02:08:48 david__schmidt Exp $ @@ -70,13 +68,13 @@ The user manual gives users information on how to install, configure and use - Privoxy. + Privoxy. - + &p-intro; + You can find the latest version of the user manual at - + New Features In addition to Internet Junkbuster's traditional feature of ad and banner blocking and cookie management, Privoxy provides new features: + &newfeatures; - @@ -325,11 +323,93 @@ configuration section below. HB.) Quickstart to Using <application>Privoxy</application> + + + + +Note to Upgraders + + There are very significant changes from older versions of + Junkbuster to the current + Privoxy. Configuration is substantially + changed. Junkbuster 2.0.x and earlier + configuration files will not migrate. The functionality of the old + blockfile, cookiefile and + imagelist, are now combined into the + actions file + (default.action for most installations). + + + A filterfile (typically + default.filter) is new with + Privoxy 2.9.x, and provides some of the new + sophisticaton (explained below). config is + much the same. + + + If upgrading from a 2.0.x version, you will have to use the new config + files, and possibly adapt any personal rules from your older files. + If upgrading from 2.9.x development versions, it is still recommended + to use the new configuration files. + + + A quick list of things to be aware of before upgrading: + + + + + + + + The default listening port is now 8118 due to a conflict with another + service (NAS). + + + + + Some installers may remove earlier versions completely. Save any + important configuration files! + + + + + Privoxy is reachable with a web browser + at the special URL: http://p.p/. Many + aspects of configuration can be done here, including temporarily disabling + Privoxy. Alternately, + http://config.privoxy.org + may work in some rare cases where the former does not. + + + + + The primary configuration file for cookie management, ad and banner + blocking, and many other aspects of Privoxy + configuration is default.action. + + + + + + + Some installers may not automatically start + Privoxy after installation. + + + + + + + + + + +Starting <application>Privoxy</application> Before launching Privoxy for the first time, you will want to configure your browser(s) to use Privoxy as a HTTP and HTTPS proxy. The default is localhost for the proxy address, - and port 8118 (earlier versions used port 800). This is the one required + and port 8118 (earlier versions used port 8000). This is the one required configuration that must be done! @@ -390,23 +470,23 @@ configuration section below. HB.) The included default configuration files should give a reasonable starting - point, though may be somewhat aggressive in blocking junk. Most of the - per site configuration is done in the actions files. These - are where various cookie actions are defined, ad and banner blocking, - and other aspects of Privoxy configuration. There - are several such files included, with varying levels of aggressiveness. + point. Most of the per site configuration is done in the + actions files. These are where various cookie actions are + defined, ad and banner blocking, and other aspects of + Privoxy configuration. There are several such + files included, with varying levels of aggressiveness. You will probably want to keep an eye out for sites that require persistent cookies, and add these to default.action as needed. By default, most of these will be accepted only during the current browser - session, until you add them to the configuration. If you want the browser to - handle this instead, you will need to edit - default.action and disable this feature. If you use more - than one browser, it would make more sense to let - Privoxy handle this. In which case, the browser(s) - should be set to accept all cookies. + session (aka session cookies), until you add them to the + configuration. If you want the browser to handle this instead, you will need + to edit default.action and disable this feature. If you + use more than one browser, it would make more sense to let + Privoxy handle this. In which case, the + browser(s) should be set to accept all cookies. @@ -455,9 +535,10 @@ configuration section below. HB.) to the developers (see below). + + - Command Line Options @@ -567,9 +648,10 @@ configuration section below. HB.) Please choose from the following options: + * Privoxy main page * Show information about the current configuration * Show the source code version numbers - * Show the client's request headers. + * Show the request headers. * Show which actions apply to a URL and why * Toggle Privoxy on or off * Edit the actions list @@ -585,7 +667,10 @@ Please choose from the following options: aspects of Privoxy configuration. The actions file, and other configuration files, are explained in detail below. Privoxy will automatically detect any changes - to these files. + to these files. Note: one or two requests to the proxy might required to + wake up Privoxy, + and force a re-reading of the configuration. It is not necessarily + instantaneous. @@ -1207,7 +1292,7 @@ Please choose from the following options: - buffer-limit 4069 + buffer-limit 4096 @@ -3951,6 +4036,9 @@ Requests Temple Place - Suite 330, Boston, MA 02111-1307, USA. $Log: user-manual.sgml,v $ + Revision 1.75 2002/04/12 02:08:48 david__schmidt + Remove OS/2 building info... it is already in the developer-manual + Revision 1.74 2002/04/11 00:54:38 hal9 Add small section on submitting actions.