privoxy-log-parser: Update Privoxy man page reference now that the section is 8
[privoxy.git] / trust
diff --git a/trust b/trust
index d68ce7e..d1f58de 100644 (file)
--- a/trust
+++ b/trust
@@ -1,15 +1,13 @@
 ######################################################################
 # 
-#  File        :  $Source: /cvsroot/ijbswa/current/trust,v $
+#  File        :  trust
 # 
-#  $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"
+#  Purpose     :  Trustfiles are an experimental feature and can be used
+#                 to build "whitelists" (versus the usual "blacklists"
 #                 techniques).
 # 
 #  Copyright   :  Written by and Copyright
-#                 Privoxy team. http://www.privoxy.org/
+#                 Privoxy team. https://www.privoxy.org/
 #
 #                 Based on the Internet Junkbuster originally written
 #                 by and Copyright (C) 1997 Anonymous Coders and
 # please note:
 #  
 #  * Use the support forum to get help:
-#    http://sourceforge.net/tracker/?group_id=11118&atid=211118
+#    https://sourceforge.net/p/ijbswa/support-requests/
 #  * Submit bugs only thru our bug forum:
-#    http://sourceforge.net/tracker/?group_id=11118&atid=111118 
+#    https://sourceforge.net/p/ijbswa/bugs/
 #    Make sure that the bug has not already been submitted. Please try
-#    to verify that it is a Junkbuster bug, and not a browser or site
+#    to verify that it is a Privoxy bug, and not a browser or site
 #    bug first. If you are using your own custom configuration, please
 #    try the stock configs to see if the problem is a configuration
 #    related bug. And if not using the latest development snapshot,
-#    please try the latest one. Or even better, CVS sources.
-#  * Submit feature requests only thru our feature request forum:
-#    http://sourceforge.net/tracker/?atid=361118&group_id=11118&func=browse
+#    please try the latest one. Or even better, git sources.
+#  * Submit feature requests only thru our feature request tracker:
+#    https://sourceforge.net/p/ijbswa/feature-requests/
 #      
-# For any other issues, feel free to use the mailing lists:
-# http://sourceforge.net/mail/?group_id=11118
-#    
+# For any other issues, feel free to use the mailing lists.
 # Anyone interested in actively participating in development and related
 # discussions can join the appropriate mailing list here:
-# http://sourceforge.net/mail/?group_id=11118. Archives are available
+# https://lists.privoxy.org/mailman/listinfo. Archives are available
 # here too.
 # 
 ######################################################################
 #                      Sample Trustfile for Privoxy
 
 # 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
+# with "trustfile" must be uncommented, with the name of this file following the
 # word "trustfile".
 
 # Trustfiles are an experimental feature used for building "whitelists"
 # of "trusted" sites (versus the usual "blacklists" technique). For more
-# detail, see http://www.privoxy.org/user-manual/config.html#TRUSTFILE.
+# detail, see https://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!
+# 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 requests whose HTTP "Referer" headers
+# contain an URL from that domain will be allowed, and the previously untrusted
+# host will be dynamically added to this file. Thus, this builds a "white-list"
+# of hosts the user is allowed to visit.
+
+# Note this means that the file will grow with use!
+
+# Also note that you can only trust referrers if you control the user's
+# system and make sure that there are no programs available that allow
+# to set arbitrary headers.
 
 # Preceding the domain with '~' character allows access to that domain only
-# (including all paths within that domain). But does not allow access to links
+# (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 will include the '~' character, and thus do not become trusted
 # referrers themselves.
 
-# Example: to allow example.com and links that come from example.com,
-# uncomment this line:
+# Example: to allow example.com and to white-list domains that appear to
+# be reached through links from example.com, uncomment this line:
 
-#  +example.com 
+# +example.com 
 
-# and comment the last line (* alone), which would unblock everything:
+# The next two lines make sure that the user can access Privoxy's
+# CGI pages, without automatically trusting their links.
 
-# *
+~config.privoxy.org
+~p.p