Rewrite comments, improve grammar, update help link.

[privoxy.git] / trust

diff --git a/trust b/trust
index 8a40dcc..d68ce7e 100644 (file)
--- a/trust
+++ b/trust
@@ -1,12 +1,12 @@
 ######################################################################
 # 
-#  File        :  $Source: /cvsroot/ijbswa/current/basic.action,v $
+#  File        :  $Source: /cvsroot/ijbswa/current/trust,v $
 # 
-#  $Id: basic.action,v 1.3 2002/03/26 22:29:54 swa Exp $
+#  $Id: trust,v 1.2.2.1 2002/10/01 04:57:15 hal9 Exp $
 #
 #  Purpose     :  Trustfiles are an experimental feature used for
 #                 building "whitelists" (versus the usual "blacklists"
-#                 in a blockfile).
+#                 techniques).
 # 
 #  Copyright   :  Written by and Copyright
 #                 Privoxy team. http://www.privoxy.org/
@@ -41,26 +41,35 @@
 # 
 ######################################################################
 #
-#  Illustrative Trustfile for Privoxy
+#                      Sample Trustfile for Privoxy
 
-# For this file to have any effect, the line beginning "trustfile" must
-# be commented in, with the name of this file following the word "trustfile"
+# For this file to have any effect, the line in the main config file beginning
+# "trustfile" must be uncommented, with the name of this file following the
+# word "trustfile".
 
 # Trustfiles are an experimental feature used for building "whitelists"
-# (versus the usual "blacklists" in a blockfile). Most people don't use it.
-# For more detail, see http://www.junkbusters.com/ht/en/ijbman.html#trustfile
-#
-# This is like parsed exactly like a blockfile, except that a '+'
-# in column one is treated like a '~' (i.e. doesn't block) and
-# it adds the spec to the trusted-referer list.
-#
-# Also, the default is to block any URL that is NOT mentioned on this list.
-#
-# While browsing, the domains for URLs that are referred by a trusted referer
-# are added to this list.  Thus this acts as a "white-list" of OK places
-# to browse. Note this means that the file will grow longer with use.
-#
-# Example: to allow only links that came from yahooligans, uncomment this line
-# +yahooligans.com
-# and remove the last line (* alone), which unblock everything:
-*
+# of "trusted" sites (versus the usual "blacklists" technique). For more
+# detail, see http://www.privoxy.org/user-manual/config.html#TRUSTFILE.
+
+# List trusted domains here. The default is to block any URL that is NOT
+# referenced. Access to trusted domains, includes all paths within that
+# domain. Preceding a domain with a '+' character, will designate that domain
+# as a "trusted referrer", meaning any pages linked from that site will be
+# allowed, and then added dynamically to this file. Thus, this builds a
+# "white-list" of safe places to browse. Note this means that the file will
+# grow with use!
+
+# Preceding the domain with '~' character allows access to that domain only
+# (including all paths within that domain). But does not allow access to links
+# to other, outside domains. Sites that are added dynamically by trusted 
+# referrers, will include the '~' character, as thus do not become trusted
+# referrers themselves.
+
+# Example: to allow example.com and links that come from example.com,
+# uncomment this line:
+
+#  +example.com 
+
+# and comment the last line (* alone), which would unblock everything:
+
+# *