# Sample Configuration file for Privoxy
-
#
-# $Id: config,v 1.33 2002/04/15 19:06:43 jongfoster Exp $
+# $Id: config,v 1.37 2002/04/27 21:05:27 hal9 Exp $
#
###################################################################
# #
# Privoxy can (and normally does) use a number of other files for
# additional configuration and logging. This section of the
# configuration file tells Privoxy where to find those other files.
+#
+# The user running Privoxy, must have read permission for all
+# configuration files, and write permission to any files that would
+# be modified, such as log files.
+
+# 1.1. user-manual
+# ================
+#
+# Specifies:
+#
+# Location of the Privoxy User Manual.
+#
+# Type of value:
+#
+# A fully qualified URI
+#
+# Default value:
+#
+# http://www.privoxy.org/user-manual/
+#
+# Effect if unset:
+#
+# The default will be used.
+#
+# Notes:
+#
+# The User Manual is used for help hints from some of the internal
+# CGI pages. It is normally packaged with the binary distributions,
+# and would make more sense to have this pointed at a locally
+# installed copy.
+#
+# A more useful example (Unix):
+#
+# user-manual file:///usr/share/doc/privoxy-2.9.14/user-manual/
+#
+# +-----------------------------------------------------------------+
+# | Warning |
+# |-----------------------------------------------------------------|
+# |If this option is defined, it must come first! It is needed |
+# |before the rest of config is read. |
+# +-----------------------------------------------------------------+
#
-# 1.1. confdir
+#
+#user-manual http://www.privoxy.org/user-manual/
+
+# 1.2. confdir
# ============
#
# Specifies:
confdir .
-# 1.2. logdir
+# 1.3. logdir
# ===========
#
# Specifies:
logdir .
-# 1.3. actionsfile
+# 1.4. actionsfile
# ================
#
# Specifies:
#
# Type of value:
#
-# File name, relative to confdir
-#
-# Default value:
+# File name, relative to confdir, without the .action (Unix)
+# or .action.txt (Windows) extension.
#
-# default.action (Unix) or default.action.txt (Windows)
+# Default values:
+# standard # Internal purpose, recommended
+# default # Main actions file
+# user # User customizations
#
# Effect if unset:
#
# No action is taken at all. Simple neutral proxying.
#
# Notes:
+# Multiple actionsfile lines are OK and are in fact recommended!
+#
+# The default values include standard.action, which is used for
+# internal purposes and should be loaded, default.action, which
+# is the "main" actions file maintained by the developers, and
+# user.action, where you can make your personal additions.
#
-# There is no point in using Privoxy without an actions file. There
-# are three different actions files included in the distribution,
-# with varying degrees of aggressiveness: default.action,
-# intermediate.action and advanced.action.
+# There is no point in using Privoxy without an actions file.
#
-actionsfile default.action
+actionsfile standard # Internal purpose, recommended
+actionsfile default # Main actions file
+actionsfile user # User customizations
-# 1.4. filterfile
+# 1.5. filterfile
# ===============
#
# Specifies:
filterfile default.filter
-# 1.5. logfile
+# 1.6. logfile
# ============
#
# Specifies:
# with the effect that cron.daily will automatically archive, gzip,
# and empty the log, when it exceeds 1M size.
#
+# Any log files must be writable by whatever user Privoxy is being
+# run as (default on UNIX, user id is "privoxy").
#
logfile logfile
-# 1.6. jarfile
+# 1.7. jarfile
# ============
#
# Specifies:
jarfile jarfile
-# 1.7. trustfile
+# 1.8. trustfile
# ==============
#
# Specifies: