From 04a7234f8b72d38913cc13a92c0706f070ca3f1b Mon Sep 17 00:00:00 2001 From: hal9 Date: Wed, 15 May 2002 03:57:14 +0000 Subject: [PATCH] Spell check. A few minor edits here and there for better syntax and clarification. --- doc/source/user-manual.sgml | 133 +++++++++++++++++++++--------------- 1 file changed, 77 insertions(+), 56 deletions(-) diff --git a/doc/source/user-manual.sgml b/doc/source/user-manual.sgml index 29ce5b1d..87f06d19 100644 --- a/doc/source/user-manual.sgml +++ b/doc/source/user-manual.sgml @@ -27,7 +27,7 @@ This file belongs into ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/ - $Id: user-manual.sgml,v 1.110 2002/05/14 19:10:45 oes Exp $ + $Id: user-manual.sgml,v 1.111 2002/05/14 23:01:36 oes Exp $ Copyright (C) 2001, 2002 Privoxy Developers See LICENSE. @@ -53,7 +53,7 @@ -$Id: user-manual.sgml,v 1.110 2002/05/14 19:10:45 oes Exp $ +$Id: user-manual.sgml,v 1.111 2002/05/14 23:01:36 oes Exp $ @@ -185,7 +184,7 @@ How to install the binary packages depends on your operating system: -Red Hat and SuSE RPMs +Red Hat, SuSE RPMs and Conectiva RPMs can be installed with rpm -Uvh privoxy-&p-version;-1.rpm, @@ -525,7 +524,7 @@ automatically start Privoxy in the boot process. -RedHat and Debian +RedHat, Conectiva and Debian We use a script. Note that RedHat does not start Privoxy upon booting per default. It will use the file /etc/privoxy/config as its @@ -899,7 +898,7 @@ must find a better place for this paragraph Multiple actions files may be defined in config. These are processed in the order they are defined. Local customizations and locally preferred exceptions to the default policies as defined in - default.action (which you will most propably want + default.action (which you will most probably want to define sooner or later) are probably best applied in user.action, where you can preserve them across upgrades. standard.action is for @@ -1405,8 +1404,8 @@ actionsfile If you intend to operate Privoxy for more users - that just yourself, it might be a good idea to let them know how to reach - you, what you block and why you do that, your policies etc. + than just yourself, it might be a good idea to let them know how to reach + you, what you block and why you do that, your policies, etc. user-manual @@ -1445,7 +1444,7 @@ actionsfile The User Manual URI is used for help links from some of the internal CGI pages. - The manual itself is normally packaged with the binary distributions, so you propably want + The manual itself is normally packaged with the binary distributions, so you probably want to set this to a locally installed copy. For multi-user setups, you could provide a copy on a local webserver for all your users and use the corresponding URL here. @@ -1511,7 +1510,7 @@ actionsfile The value of this option only matters if the experimental trust mechanism has been - activated. (See trustfile above.) + activated. (See trustfile above.) If you use the trust mechanism, it is a good idea to write up some on-line @@ -1641,7 +1640,8 @@ actionsfile Specifies: - Key values that determine what information gets logged. + Key values that determine what information gets logged to the + logfile. @@ -1879,10 +1879,11 @@ actionsfile If set to 0, Privoxy will start in toggled off mode, i.e. behave like a normal, content-neutral - proxy. See enable-remote-toggle - below. This is not really useful anymore, since toggling is much easier - via the web - interface than via editing the conf file. + proxy where all ad blocking, filtering, etc are disabled. See + enable-remote-toggle below. This is not really useful + anymore, since toggling is much easier via the web interface than via + editing the conf file. The windows version will only display the toggle icon in the system tray @@ -2056,7 +2057,8 @@ ACLs: permit-access and deny-access For a typical home user, it will normally suffice to ensure that Privoxy only listens on the localhost (127.0.0.1) or internal (home) network address by means of the - listen-address option. + listen-address + option. Please see the warnings in the FAQ that this proxy is not intended to be a substitute @@ -3233,7 +3235,7 @@ forward-socks4 and forward-socks4a for requests to blocked pages. This page contains links to find out why the request was blocked, and a click-through to the blocked content (the latter only if compiled with the force feature enabled). The BLOCKED page adapts to the available - screen space -- it displays full-blown if space allows, or minaturized and text-only + screen space -- it displays full-blown if space allows, or miniaturized and text-only if loaded into a small frame or window. If you are using Privoxy right now, you can take a look at the BLOCKED @@ -3609,8 +3611,10 @@ problem-host.example.com This feature is currently not very smart and is scheduled for improvement. - It is likely to break some sites. There is a bunch of exceptions to this action in - default.action, should you decide to turn it on by default. + It is likely to break some sites. You should expect to need possibly + many exceptions to this action, if it is enabled by default in + default.action. Some sites just don't work without + it. @@ -3644,7 +3648,7 @@ problem-host.example.com Effect: - Text documents, including HTML and JavaScript, to which this action applies, are filterd on-the-fly + Text documents, including HTML and JavaScript, to which this action applies, are filtered on-the-fly through the specified regular expression based substitutions. @@ -3694,7 +3698,7 @@ problem-host.example.com documents. If you want filtering to work on all documents, even those that would normally be sent compressed, use the prevent-compression - action in conjuction with filter. + action in conjunction with filter. Filtering can achieve some of the effects as the @@ -3741,7 +3745,7 @@ problem-host.example.com - +filter{frameset-borders} # Give frames a border and make them resizable + +filter{frameset-borders} # Give frames a border and make them resizeable @@ -4047,7 +4051,7 @@ ad.doubleclick.net forge is the preferred option here, since some servers will not send images back otherwise, in an attempt to prevent their valuable content from being embedded elsewhere (and hence, without being surrounded - by their banners. + by their banners). hide-referer is an alternate spelling of @@ -4114,20 +4118,27 @@ ad.doubleclick.net Notes: + + + This breaks many web sites that depend on looking at this header in order + to customize their content for different browsers (which, by the + way, is NOT a smart way to do + that!). + + - Warning! This breaks many web sites that in order to customize their - content for the different browser types depend on looking - at this header (which, btw, is NOT a smart way to - do that!). - - - Using this action in multi-user setups or wherever diffrerent types of + Using this action in multi-user setups or wherever different types of browsers will access the same Privoxy is not recommended. In single-user, single-browser setups, you might use it to delete your OS version information from the headers, because it is an invitation to exploit known bugs for your - OS. + OS. It is also occasionally useful to forge this in order to access + sites that won't let you in otherwise (though there may be a good + reason in some cases). Example of this: some MSN sites will not + let Mozilla enter, yet forging to a + Netscape 6.1 user-agent works just fine. + (Must be just a silly MS goof, I'm sure :-). This action is scheduled for improvement. @@ -4190,11 +4201,13 @@ ad.doubleclick.net Notes: - This action is easily confused with a built-in harwired filter + This action is easily confused with the built-in, hardwired filter action, but there are important differences: For kill-popups, the document need not be buffered, so it can be incrementally rendered while downloading. But kill-popups doesn't catch as many pop-ups as - filter{popups} does. + filter{popups} + does. Think of it as a fast and efficient replacement for a filter that you @@ -4207,11 +4220,13 @@ ad.doubleclick.net Killing all pop-ups is a dangerous business. Many shops and banks rely on pop-ups to display forms, shopping carts etc, and killing only the unwanted pop-ups - would require artificial intelligance in Privoxy. + would require artificial intelligence in Privoxy. If the only kind of pop-ups that you want to kill are exit consoles (those really nasty windows that appear when you close an other one), you might want to use - filter{js-annoyances} instead. + filter{js-annoyances} + instead. @@ -5877,7 +5895,7 @@ Requests First, the server headers are read and processed to determine, among other things, the MIME type (document type) and encoding. The headers are then - filtered as deterimed by the + filtered as determined by the +crunch-incoming-cookies, +session-cookies-only, and +downgrade-http-version @@ -6253,6 +6271,9 @@ Requests Temple Place - Suite 330, Boston, MA 02111-1307, USA. $Log: user-manual.sgml,v $ + Revision 1.111 2002/05/14 23:01:36 oes + Fixing the fixes + Revision 1.110 2002/05/14 19:10:45 oes Restored alphabetical order of actions -- 2.39.2