From 8023259b48217910c1dd8038ffc16a57f9a10f37 Mon Sep 17 00:00:00 2001 From: hal9 Date: Sat, 6 Apr 2002 05:07:29 +0000 Subject: [PATCH] -Add privoxy-man-page.sgml, for man page. -Add authors.sgml for AUTHORS (and p-authors.sgml) -Reworked various aspects of various docs. -Added additional comments to sub-docs. --- doc/source/authors.sgml | 71 ++++++ doc/source/buildsource.sgml | 13 +- doc/source/contacting.sgml | 18 +- doc/source/copyright.sgml | 28 ++- doc/source/developer-manual.sgml | 20 +- doc/source/history.sgml | 18 +- doc/source/newfeatures.sgml | 17 +- doc/source/p-authors.sgml | 95 +++++++ doc/source/privoxy-man-page.sgml | 414 +++++++++++++++++++++++++++++++ doc/source/privoxy.sgml | 20 +- doc/source/readme.sgml | 19 +- doc/source/seealso.sgml | 32 ++- doc/source/supported.sgml | 10 +- doc/source/user-manual.sgml | 60 +++-- 14 files changed, 764 insertions(+), 71 deletions(-) create mode 100644 doc/source/authors.sgml create mode 100644 doc/source/p-authors.sgml create mode 100644 doc/source/privoxy-man-page.sgml diff --git a/doc/source/authors.sgml b/doc/source/authors.sgml new file mode 100644 index 00000000..d9161435 --- /dev/null +++ b/doc/source/authors.sgml @@ -0,0 +1,71 @@ + + + + + + + + + +]> + +
+ + + + This is here to keep vim syntax file from breaking :/ + If I knew enough to fix it, I would. + PLEASE DO NOT REMOVE! HB: hal@foobox.net + + +]]> + + + Authors of Privoxy v2.9.x and 3.x +=========================================================================== + + + + &authors; + + + + If we've missed you off this list, please let us know! + + + + Privoxy team. http://www.privoxy.org/ + ijbswa-developers@lists.sourceforge.net + + +
diff --git a/doc/source/buildsource.sgml b/doc/source/buildsource.sgml index bc439bac..d180c027 100644 --- a/doc/source/buildsource.sgml +++ b/doc/source/buildsource.sgml @@ -3,7 +3,7 @@ Purpose : Entity included in other project documents. - $Id: buildsource.sgml,v 1.0 2002/04/04 01:14:18 hal9 Exp $ + $Id: buildsource.sgml,v 1.1 2002/04/04 06:48:37 hal9 Exp $ Written by and Copyright (C) 2001 the SourceForge Privoxy team. http://www.privoxy.org/ @@ -17,7 +17,16 @@ This file used for inclusion with other documents only. ====================================================================== + If you make changes to this file, please verify the finished + docs all display as intended. + + This file is included into: + + user-manual + README + --> + There are several ways to install Privoxy. @@ -77,7 +86,7 @@ make suse-dist from unpacked sources. You will need to run autoconf; autoheader; ./configure beforehand. *BSD will require gmake (from - http://gnu.org). + http://www.gnu.org). diff --git a/doc/source/contacting.sgml b/doc/source/contacting.sgml index 0f173b3e..3c97b4fd 100644 --- a/doc/source/contacting.sgml +++ b/doc/source/contacting.sgml @@ -3,7 +3,7 @@ Purpose : Entity included in other project documents. - $Id: contacting.sgml,v 1.1 2002/04/04 01:14:18 hal9 Exp $ + $Id: contacting.sgml,v 1.2 2002/04/04 06:48:37 hal9 Exp $ Written by and Copyright (C) 2001 the SourceForge Privoxy team. http://www.privoxy.org/ @@ -11,21 +11,17 @@ Based on the Internet Junkbuster originally written by and Copyright (C) 1997 Anonymous Coders and Junkbusters Corporation. http://www.junkbusters.com ---> - diff --git a/doc/source/copyright.sgml b/doc/source/copyright.sgml index d3234259..6fe5fa97 100644 --- a/doc/source/copyright.sgml +++ b/doc/source/copyright.sgml @@ -1,9 +1,9 @@ @@ -34,10 +49,10 @@ 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. + 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. @@ -46,3 +61,4 @@ along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA. + diff --git a/doc/source/developer-manual.sgml b/doc/source/developer-manual.sgml index 66a07c4c..a8c8fa2c 100644 --- a/doc/source/developer-manual.sgml +++ b/doc/source/developer-manual.sgml @@ -21,7 +21,7 @@ This file belongs into ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/ - $Id: developer-manual.sgml,v 1.23 2002/04/04 18:46:47 swa Exp $ + $Id: developer-manual.sgml,v 1.24 2002/04/04 21:33:37 hal9 Exp $ Written by and Copyright (C) 2001 the SourceForge Privoxy team. http://www.privoxy.org/ @@ -44,7 +44,7 @@ Privoxy Developer Manual - $Id: developer-manual.sgml,v 1.23 2002/04/04 18:46:47 swa Exp $ + $Id: developer-manual.sgml,v 1.24 2002/04/04 21:33:37 hal9 Exp $ @@ -336,7 +336,7 @@ following guidelines for changing stuff in the code. If it is - Tags should be nested like: + Tags should be nested and step indented like: <para> <itemizedlist> @@ -371,6 +371,13 @@ following guidelines for changing stuff in the code. If it is idiosyncrasies (too many to list :). + + + Try to keep overall line lengths in source files to 80 characters or less + for obvious reasons. This is not always possible, with lenghty URLs for + instance. + + Our documents are available in differing formats. Right now, they @@ -1615,7 +1622,7 @@ static void unload_re_filterfile( void *f ) { ... } Example for file comments: -const char FILENAME_rcs[] = "$Id: developer-manual.sgml,v 1.23 2002/04/04 18:46:47 swa Exp $"; +const char FILENAME_rcs[] = "$Id: developer-manual.sgml,v 1.24 2002/04/04 21:33:37 hal9 Exp $"; /********************************************************************* * * File : $Source$ @@ -1675,7 +1682,7 @@ const char FILENAME_h_rcs[] = FILENAME_H_VERSION; #ifndef _FILENAME_H #define _FILENAME_H -#define FILENAME_H_VERSION "$Id: developer-manual.sgml,v 1.23 2002/04/04 18:46:47 swa Exp $" +#define FILENAME_H_VERSION "$Id: developer-manual.sgml,v 1.24 2002/04/04 21:33:37 hal9 Exp $" /********************************************************************* * * File : $Source$ @@ -2401,6 +2408,9 @@ zip -r privoxyosx_setup_x.y.z.zip Privoxy.pkg Temple Place - Suite 330, Boston, MA 02111-1307, USA. $Log: developer-manual.sgml,v $ + Revision 1.24 2002/04/04 21:33:37 hal9 + More on documenting the documents. + Revision 1.23 2002/04/04 18:46:47 swa consistent look. reuse of copyright, history et. al. diff --git a/doc/source/history.sgml b/doc/source/history.sgml index 2ed79fb1..f8a59bd0 100644 --- a/doc/source/history.sgml +++ b/doc/source/history.sgml @@ -1,9 +1,9 @@ diff --git a/doc/source/newfeatures.sgml b/doc/source/newfeatures.sgml index d9aa60fa..7624f2c0 100644 --- a/doc/source/newfeatures.sgml +++ b/doc/source/newfeatures.sgml @@ -1,9 +1,9 @@ diff --git a/doc/source/p-authors.sgml b/doc/source/p-authors.sgml new file mode 100644 index 00000000..afcc2087 --- /dev/null +++ b/doc/source/p-authors.sgml @@ -0,0 +1,95 @@ + + + Current Project Developers: + +]]> + + + Stefan Waldherr + Andreas Oesterhelt + Jon Foster + + Markus Breitenbach + Thomas Steudten + + + + Current Project Contributors: + + + +]]> + David Schmidt (OS/2, Mac OSX ports) + Gabriel L. Somlo + Hal Burgiss (docs) + Haroon Rafique + John Venvertloh + Joerg Strohmayer + Rodney Stromlund + Rodrigo Barbosa (RPM specfiles) + Sarantis Paskalis + Shamim Mohamed + Gábor Lipták + + + + Originally developed by: + + + + Junkbusters Corp. + Anonymous Coders + + + + Thanks to the many people who have tested Privoxy, reported bugs, or made + suggestions. These include (in alphabetical order): + + + + Aaron Hamid + Alexander Lazic (FreeBSD patch) + Andrew J. Caines + Bart Schelstraete + Clifford Caoile + Darren Wiebe + Gabor Liptak + Guy + Ken Arromdee + Magnus Holmgren + Paul Lieverse + Peter E + Reiner Buehl + +]]> diff --git a/doc/source/privoxy-man-page.sgml b/doc/source/privoxy-man-page.sgml new file mode 100644 index 00000000..8644ce0c --- /dev/null +++ b/doc/source/privoxy-man-page.sgml @@ -0,0 +1,414 @@ + + + + + + + + + + + + +]> + + + + 2002-04-04 + + + + privoxy + 1 + Privoxy &p-version; + + + + privoxy + Privacy Enhancing Proxy + + + + + privoxy + + + + pidfile + user[.group] + configfile + (UNIX) + + + + privoxy.exe + configfile + (Windows) + + + + + +Options + + Privoxy may be invoked with the following command line + options: + + + + + --help + + + Print brief usage info and exit. + + + + + + --version + + + Print version info and exit. + + + + + + --no-daemon + + + Don't become a daemon, i.e. don't fork and become process group + leader, don't detach from controlling tty, and do all logging there. + + + + + + --pidfile pidfile + + + After (optionally) writing the PID file, assume the user ID of user + and the GID of group, or, if the optional group was not given, the + default group of user. Exit if the privileges are not sufficient to + do so. + + + + + --user user[.group] + + + + + After (optionally) writing the PID file, assume the user ID of + user and the GID of + group, or, if the optional + group was not given, the default group of + user. Exit if the privileges are not + sufficient to do so. + + + + + + + If the configfile is not specified on the command line, + Privoxy will look for a file named + config in the current directory (except on Win32 where + it will try config.txt). If no + configfile is found, Privoxy will + fail to start. + + + + + + +Description + + &p-intro; + + + + + +Installation and Usage + + Browsers must be individually configured to use Privoxy as + a HTTP proxy. The default setting is for localhost, on port 8118 + (configurable in the main config file). To set the HTTP proxy in Netscape + and Mozilla, go through: Edit; + Preferences; Advanced; + Proxies; Manual Proxy Configuration; + View. + + + For Internet Explorer, go through: Tools; + Internet Properties; Connections; + LAN Settings. + + + The Secure (SSL) Proxy should also be set to the same values, otherwise + https: URLs will not be proxied. + + + For other browsers, check the documentation. + + + + + +Configuration + + Privoxy can be configured with the various configuration + files. The default configuration files are: config, + default.action, and + default.filter. These are well commented. On Unix and + Unix-like systems, these are located in /etc/privoxy/ by + default. On Windows, OS/2 and AmigaOS, these files are 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. In fact, the + configuration itself is changed and much more sophisticated. See the + user-manual for a + brief explanation of all configuration options. + + + The actions list (ad blocks, etc) can also be configured with your + web browser at http://ijbswa.sourceforge.net/config. + Privoxy's configuration parameters can also be viewed at + the same page. In addition, Privoxy can be toggled on/off. + This is an internal page. + + + + + +Sample Configuration + + A brief example of what a default.action configuration + might look like: + + + + + # Define a few useful custom aliases for later use + {{alias}} + + # Don't accept cookies + +no-cookies = +no-cookies-set +no-cookies-read + + # Do accept cookies + -no-cookies = -no-cookies-set -no-cookies-read + + # Treat these blocked URLs as images. + +imageblock = +block +image + + # Define page filters we want to use. + myfilters = +filter{html-annoyances} +filter{js-annoyances}\ + +filter{no-popups} +filter{webbugs} + + ## Default Policies (actions) ############################ + { \ + -block \ + -downgrade \ + +fast-redirects \ + myfilters \ + +no-compression \ + +hide-forwarded \ + +hide-from{block} \ + +hide-referer{forge} \ + -hide-user-agent \ + -image \ + +image-blocker{blank} \ + +no-cookies-keep \ + -no-cookies-read \ + -no-cookies-set \ + +no-popups \ + -vanilla-wafer \ + -wafer \ + } + / + + # Now set exceptions to the above defined policies ####### + + # Sites where we want persistant cookies + {-no-cookies -no-cookies-keep} + .redhat.com + .sun.com + .yahoo.com + .msdn.microsoft.com + + # This site requires cookies AND 'fast-redirects' on + {-no-cookies -no-cookies-keep -fast-redirects} + .nytimes.com + + # Add custom headers, and turn off filtering of page source + {+add-header{X-Privacy: Yes please} #-add-header{*} \ + +add-header{X-User-Tracking: No thanks!} -filter} + privacy.net + + # Block, and treat these URLs as 'images'. + {+imageblock} + .adforce.imgis.com + .ad.preferences.com/image.* + .ads.web.aol.com + .ad-adex3.flycast.com + .ad.doubleclick.net + .ln.doubleclick.net + .ad.de.doubleclick.net + /.*/count\.cgi\?.*df= + 194.221.183.22[1-7] + a196.g.akamai.net/7/196/2670/000[12]/images.gmx.net/i4/images/.*/ + + # Block any URLs that match these patterns + {+block} + /.*/(.*[-_.])?ads?[0-9]?(/|[-_.].*|\.(gif|jpe?g)) + /.*/(plain|live|rotate)[-_.]?ads?/ + /.*/(sponsor)s?[0-9]?/ + /.*/ad(server|stream|juggler)\.(cgi|pl|dll|exe) + /.*/adbanners/ + /.*/adv((er)?ts?|ertis(ing|ements?))?/ + /.*/banners?/ + /.*/popupads/ + /.*/advert[0-9]+\.jpg + /ad_images/ + /.*/ads/ + /images/.*/.*_anim\.gif + /rotations/ + /.*(ms)?backoff(ice)?.*\.(gif|jpe?g) + 195.63.104.*/(inbox|log|meld|folderlu|folderru|log(in|out)[lmr]u|) + .images.nytimes.com + .images.yahoo.com/adv/ + /.*cnnstore\.gif + + + + + See the comments in the configuration files themselves, or the + user-manual + for explanations of the above syntax, and other Privoxy + configuration options. + + + + + + +Files + + + /usr/sbin/privoxy + /etc/privoxy/config + /etc/privoxy/default.action + /etc/privoxy/advanced.action + /etc/privoxy/basic.action + /etc/privoxy/intermediate.action + /etc/privoxy/default.filter + /etc/privoxy/trust + /etc/privoxy/templates/* + /var/log/privoxy/logfile + + + + Various other files should be included, but may vary depending on platform + and build configuration. More documentation should be included in the local + documentation directory, though is not complete at this time. + + + + + + +Signals + + + Privoxy terminates on the SIGINT, + SIGTERM and SIGABRT signals. Log + rotation scripts may cause a re-opening of the logfile by sending a + SIGHUP to Privoxy. Note that unlike + other daemons, Privoxy does not need to be made aware of + config file changes by SIGHUP -- it will detect them + automatically. + + + + + +Notes + + This is a &p-status; version of Privoxy. Not + all features are well tested. +]]> + + Please see the user-manual on how to contact the + developers for feature requests, reporting problems, and other questions. + + + + + +See Also + + &seealso; + + + + +Development Team + + &authors; + + + + +Copyright and License + + ©right; + + + + diff --git a/doc/source/privoxy.sgml b/doc/source/privoxy.sgml index d6174e51..d4bfa3a0 100644 --- a/doc/source/privoxy.sgml +++ b/doc/source/privoxy.sgml @@ -3,7 +3,7 @@ Purpose : Entity included in other project documents. - $Id: privoxy.sgml,v 1.1 2002/04/02 00:54:19 hal9 Exp $ + $Id: privoxy.sgml,v 1.2 2002/04/04 06:48:37 hal9 Exp $ Written by and Copyright (C) 2001 the SourceForge Privoxy team. http://www.privoxy.org/ @@ -12,14 +12,22 @@ by and Copyright (C) 1997 Anonymous Coders and Junkbusters Corporation. http://www.junkbusters.com ---> - - @@ -34,7 +42,7 @@ Privoxy is based on the code of the - Internet Junkbuster. + Internet Junkbuster (tm). 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 @@ -44,6 +52,6 @@ Privoxy continues the Junkbuster tradition, but adds many - refinements and enhancements. + refinements, enhancements and new features. diff --git a/doc/source/readme.sgml b/doc/source/readme.sgml index 10a515ce..23810bfc 100644 --- a/doc/source/readme.sgml +++ b/doc/source/readme.sgml @@ -17,7 +17,7 @@ Purpose : README for Privoxy - $Id: readme.sgml,v 1.2 2002/04/04 06:48:37 hal9 Exp $ + $Id: readme.sgml,v 1.3 2002/04/04 07:06:18 hal9 Exp $ Written by and Copyright (C) 2001 the SourceForge Privoxy team. http://www.privoxy.org/ @@ -26,6 +26,14 @@ by and Copyright (C) 1997 Anonymous Coders and Junkbusters Corporation. http://www.junkbusters.com + + ======================================================================== + 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! + ======================================================================== + =================================================================== READ: Document Note: This file generates the README in the top level source directory. It is generated as only a plain text file. The @@ -39,7 +47,7 @@ NOTE: The left margin spacing is *important* when using 'literallayout' WYSISWYG!!! Don't mess this up!!! Careful with linebreaks too, ie the para tag forces a linebreak. Tags need to be carefully placed as a result - to avoid extra blank lines, etc. + to avoid extra blank lines, etc. ====================================================================== For stable releases, change @@ -51,7 +59,8 @@ entity % p-not-stable "IGNORE" in the DTD at the top. This will toggle various text 'off'. BOTH - MUST be toggled in this case. + MUST be toggled in this case or you will get both text referencing + stable and unstable versions. You only want one or the other! --> @@ -165,7 +174,7 @@ [--user USER[.GROUP]] [config_file] -See the man page or user-manual for a brief explanation of each option. + See the man page or user-manual for a brief explanation of each option. If no config_file is specified on the command line, Privoxy will look for a @@ -253,7 +262,7 @@ See the man page or user-manual for a brief explanation of each option. - $Id: readme.sgml,v 1.2 2002/04/04 06:48:37 hal9 Exp $ + $Id: readme.sgml,v 1.3 2002/04/04 07:06:18 hal9 Exp $ diff --git a/doc/source/seealso.sgml b/doc/source/seealso.sgml index fb5d226c..a2040ef4 100644 --- a/doc/source/seealso.sgml +++ b/doc/source/seealso.sgml @@ -3,7 +3,7 @@ Purpose : Entity included in other project documents. - $Id: seealso.sgml,v 1.0 2002/04/02 00:54:19 hal9 Exp $ + $Id: seealso.sgml,v 1.1 2002/04/02 01:48:33 hal9 Exp $ Written by and Copyright (C) 2001 the SourceForge Privoxy team. http://www.privoxy.org/ @@ -11,6 +11,22 @@ Based on the Internet Junkbuster originally written by and Copyright (C) 1997 Anonymous Coders and Junkbusters Corporation. http://www.junkbusters.com + + =========================================== + + If you make changes to this file, please verify the finished + docs all display as intended. + + This file is included into: + + privoxy-man-page + user-manual + faq + developer-manual + + NOTE: 04/05/02, HB Removed   tags. They were causing docbook2man + to barf. + --> @@ -21,21 +37,21 @@ -   http://www.privoxy.org/, The Privoxy Home page. -   http://sourceforge.net/projects/ijbswa, + http://sourceforge.net/projects/ijbswa, the Project Page for Privoxy on Sourceforge. -   http://p.p/, access + http://p.p/, access Privoxy from your browser. Alternately, http://config.privoxy.org may work in some situations where the first does not. @@ -43,22 +59,22 @@ -   http://www.junkbusters.com/ht/en/cookies.html + http://www.junkbusters.com/ht/en/cookies.html -   http://www.waldherr.org/junkbuster/ + http://www.waldherr.org/junkbuster/ -   http://privacy.net/analyze/ + http://privacy.net/analyze/ -  http://www.squid-cache.org/ + http://www.squid-cache.org/ diff --git a/doc/source/supported.sgml b/doc/source/supported.sgml index f45f48fe..9ce71c5d 100644 --- a/doc/source/supported.sgml +++ b/doc/source/supported.sgml @@ -3,7 +3,7 @@ Purpose : Entity included in other project documents. - $Id: supported.sgml,v 1.3 2002/04/04 06:48:37 hal9 Exp $ + $Id: supported.sgml,v 1.4 2002/04/04 14:59:13 swa Exp $ Written by and Copyright (C) 2001 the SourceForge Privoxy team. http://www.privoxy.org/ @@ -16,6 +16,14 @@ This file used for inclusion with other documents only. ====================================================================== + If you make changes to this file, please verify the finished + docs all display as intended. + + This file is included into: + + user-manual + faq + --> At present, Privoxy is known to run on Win32, Mac diff --git a/doc/source/user-manual.sgml b/doc/source/user-manual.sgml index bb790089..5510575c 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.67 2002/04/04 17:27:57 swa Exp $ + $Id: user-manual.sgml,v 1.68 2002/04/04 18:46:47 swa Exp $ Written by and Copyright (C) 2001 the SourceForge Privoxy team. http://www.privoxy.org/ @@ -33,13 +33,21 @@ by and Copyright (C) 1997 Anonymous Coders and Junkbusters Corporation. http://www.junkbusters.com + + ======================================================================== + 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! + ======================================================================== + -->
Privoxy User Manual -$Id: user-manual.sgml,v 1.67 2002/04/04 17:27:57 swa Exp $ +$Id: user-manual.sgml,v 1.68 2002/04/04 18:46:47 swa Exp $ @@ -95,12 +103,13 @@ This documentation is included with the current &p-status; 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 ;-) + Privoxy, v.&p-version;soon ;-)]]>. select() socket call. @@ -393,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 @@ -635,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): @@ -691,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. +]]> @@ -1102,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 @@ -2341,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 @@ -2572,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. @@ -2933,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. - @@ -2965,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 @@ -3663,7 +3676,7 @@ Requests actual URL that is pasted into the prompt area -- not any sub-URLs. If you want to know about embedded URLs like ads, you will have to dig those out of the HTML source. Use your browser's View Page Source option - for this. + for this. Or right click on the ad, and grab the URL. @@ -3847,13 +3860,11 @@ Requests 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: - @@ -3935,6 +3946,9 @@ Requests Temple Place - Suite 330, Boston, MA 02111-1307, USA. $Log: user-manual.sgml,v $ + Revision 1.68 2002/04/04 18:46:47 swa + consistent look. reuse of copyright, history et. al. + Revision 1.67 2002/04/04 17:27:57 swa more single file to be included at multiple points. make maintaining easier -- 2.39.2