From 8855a031e62cf14ac96b06e773f8bad01d3a4e25 Mon Sep 17 00:00:00 2001 From: Fabian Keil Date: Fri, 9 Nov 2007 20:26:58 +0000 Subject: [PATCH] - Stop using example domains other than the ones from RFC 2606. - Minor rewordings and fixes. --- doc/source/p-config.sgml | 101 +++++++++++++++++++++------------------ 1 file changed, 54 insertions(+), 47 deletions(-) diff --git a/doc/source/p-config.sgml b/doc/source/p-config.sgml index b25860fe..8cef7970 100644 --- a/doc/source/p-config.sgml +++ b/doc/source/p-config.sgml @@ -3,7 +3,7 @@ Purpose : Used with other docs and files only. - $Id: p-config.sgml,v 2.20 2007/11/07 11:36:53 hal9 Exp $ + $Id: p-config.sgml,v 2.21 2007/11/07 18:50:39 fabiankeil Exp $ Copyright (C) 2001-2007 Privoxy Developers http://www.privoxy.org/ See LICENSE. @@ -95,7 +95,7 @@ Sample Configuration File for Privoxy v&p-version; - $Id: p-config.sgml,v 2.20 2007/11/07 11:36:53 hal9 Exp $ + $Id: p-config.sgml,v 2.21 2007/11/07 18:50:39 fabiankeil Exp $ Copyright (C) 2001-2007 Privoxy Developers http://www.privoxy.org/ @@ -354,7 +354,7 @@ II. FORMAT OF THE CONFIGURATION FILE The value of this option only matters if the experimental trust mechanism has been - activated. (See trustfile above.) + activated. (See trustfile below.) If you use the trust mechanism, it is a good idea to write up some on-line @@ -504,7 +504,7 @@ II. FORMAT OF THE CONFIGURATION FILE Specifies: - The directory where the other configuration files are located + The directory where the other configuration files are located. @@ -529,7 +529,7 @@ II. FORMAT OF THE CONFIGURATION FILE Notes: - No trailing /, please + No trailing /, please. + If you want to use CLF (Common Log Format), you should set debug 512 ONLY and not enable anything else. @@ -1138,7 +1145,7 @@ fk 2007-11-07 Specifies: - Whether to run only one server thread + Whether to run only one server thread. @@ -1167,8 +1174,8 @@ fk 2007-11-07 Notes: - This option is only there for debugging purposes and you should never - need to use it. It will drastically reduce performance. + This option is only there for debugging purposes. + It will drastically reduce performance. @@ -1390,7 +1397,7 @@ fk 2007-11-07 As a lot of Privoxy users don't read - documentation, this feature has been disabled by default. + documentation, this feature is disabled by default. Note that you must have compiled Privoxy with @@ -1451,7 +1458,7 @@ fk 2007-11-07 side code (e.g Java) is also capable of using this feature. - This option may be removed in future releases as it has been obsoleted + This option will be removed in future releases as it has been obsoleted by the more general header taggers. @@ -1506,7 +1513,9 @@ fk 2007-11-07 This option is not recommended for environments - with untrusted users and is therefore disabled by default. + with untrusted users and as a lot of Privoxy + users don't read documentation, this feature is disabled by default. + Note that malicious client side code (e.g Java) is also @@ -1514,10 +1523,6 @@ fk 2007-11-07 this options unless you understand the consequences and are sure your browser is configured correctly. - - As a lot of Privoxy users don't read - documentation, this feature has been disabled by default. - Note that you must have compiled Privoxy with support for this feature, otherwise this option has no effect. @@ -1663,9 +1668,9 @@ ACLs: permit-access and deny-access option. - Please see the warnings in the FAQ that this proxy is not intended to be a substitute - for a firewall or to encourage anyone to defer addressing basic security - weaknesses. + Please see the warnings in the FAQ that Privoxy + is not intended to be a substitute for a firewall or to encourage anyone + to defer addressing basic security weaknesses. Multiple ACL lines are OK. @@ -1899,8 +1904,8 @@ ACLs: permit-access and deny-access - forward / caching-proxy.example-isp.net:8000 - forward .example-isp.net . + forward / caching-proxy.isp.example.net:8000 + forward .isp.example.net . @@ -1986,7 +1991,7 @@ forward-socks4 and forward-socks4a - forward-socks4a / socks-gw.example.com:1080 www-cache.example-isp.net:8080 + forward-socks4a / socks-gw.example.com:1080 www-cache.isp.example.net:8080 forward .example.com . @@ -2000,8 +2005,8 @@ forward-socks4 and forward-socks4a - To chain Privoxy and Tor, both running on the same system, you should use - the rule: + To chain Privoxy and Tor, both running on the same system, you would use + something like: @@ -2025,7 +2030,8 @@ forward-socks4 and forward-socks4a Unencrypted connections to systems in these address ranges will be as (un)secure as the local network is, but the alternative is that you can't reach the local network through Privoxy - at all. + at all. Of course this may actually be desired and there is no reason + to make these exceptions if you aren't sure you need them. If you also want to be able to reach servers in your local network by @@ -2055,8 +2061,8 @@ forward-socks4 and forward-socks4a - Assume that host-a has a PPP connection to isp-a.net. And host-b has a PPP connection to - isp-b.net. Both run Privoxy. Their forwarding + Assume that host-a has a PPP connection to isp-a.example.net. And host-b has a PPP connection to + isp-b.example.org. Both run Privoxy. Their forwarding configuration can look like this: @@ -2067,7 +2073,7 @@ forward-socks4 and forward-socks4a forward / . - forward .isp-b.net host-b:8118 + forward .isp-b.example.net host-b:8118 @@ -2078,7 +2084,7 @@ forward-socks4 and forward-socks4a forward / . - forward .isp-a.net host-a:8118 + forward .isp-a.example.org host-a:8118 @@ -2090,7 +2096,7 @@ forward-socks4 and forward-socks4a If you intend to chain Privoxy and - squid locally, then chain as + squid locally, then chaining as browser -> squid -> privoxy is the recommended way. @@ -2120,8 +2126,9 @@ forward-socks4 and forward-socks4a - You could just as well decide to only forward requests for Windows executables through - a virus-scanning parent proxy, say, on antivir.example.com, port 8010: + You could just as well decide to only forward requests you suspect + of leading to Windows executables through a virus-scanning parent proxy, + say, on antivir.example.com, port 8010: @@ -2594,7 +2601,7 @@ forward-socks4 and forward-socks4a The hide-console option is specific to the MS-Win console version of Privoxy. If this option is used, - Privoxy will disconnect from and hide the + Privoxy will disconnect from and hide the command console. -- 2.39.2