Purpose : Used with other docs and files only.
- $Id: p-config.sgml,v 1.1.2.8 2002/08/22 23:15:21 hal9 Exp $
+ $Id: p-config.sgml,v 2.2 2002/09/05 05:45:30 hal9 Exp $
Copyright (C) 2001, 2002 Privoxy Developers <developers@privoxy.org>
See LICENSE.
Sample Configuration File for Privoxy v&p-version;
</title>
<para>
- $Id: p-config.sgml,v 1.1.2.8 2002/08/22 23:15:21 hal9 Exp $
+ $Id: p-config.sgml,v 2.2 2002/09/05 05:45:30 hal9 Exp $
</para>
<para>
Copyright (C) 2001, 2002 Privoxy Developers http://privoxy.org
</para>
<para>
If you specify a trust file, <application>Privoxy</application> will only allow
- access to sites that are named in the trustfile.
- You can also mark sites as trusted referrers (with <literal>+</literal>), with
- the effect that access to untrusted sites will be granted, if a link from a
- trusted referrer was used.
- The link target will then be added to the <quote>trustfile</quote>.
- Possible applications include limiting Internet access for children.
+ access to sites that are specified in the trustfile. Sites can be listed
+ in one of two ways:
+ </para>
+ <para>
+ Prepending a <literal>~</literal> character limits access to this site
+ only (and any sub-paths within this site), e.g.
+ <literal>~www.example.com</literal>.
+ </para>
+ <para>
+ Or, you can designate sites as <emphasis>trusted referrers</emphasis>, by
+ prepending the name with a <literal>+</literal> character. The effect is that
+ access to untrusted sites will be granted -- but only if a link from this
+ trusted referrer was used. The link target will then be added to the
+ <quote>trustfile</quote> so that future, direct accesses will be granted.
+ Sites added via this mechanism do not become trusted referrers themselves
+ (i.e. they are added with a <literal>~</literal> designation).
+ </para>
+ <para>
+ If you use the <literal>+</literal> operator in the trust file, it may grow
+ considerably over time.
+ </para>
+ <para>
+ It is recommended that <application>Privoxy</application> be compiled with
+ the <literal>--disable-force</literal>, <literal>--disable-toggle</literal> and
+ <literal> --disable-editor</literal> options, if this feature is to be
+ used.
</para>
<para>
- If you use <literal>+</literal> operator in the trust file, it may grow considerably over time.
+ Possible applications include limiting Internet access for children.
</para>
</listitem>
</varlistentry>
<para>
Examples:
</para>
+ <!-- The below needs checking after a rebuild due to long file names -->
<para>
Unix, in local filesystem:
</para>
<para>
- <screen>user-manual file:///usr/share/doc/privoxy-&p-version;/user-manual/</screen>
+ <screen> user-manual file:///usr/share/doc/privoxy-&p-version;/user-manual/index.html</screen>
+ </para>
+ <para>
+ Windows, in local filesystem, <emphasis>must</emphasis> use forward slash notation, and <literal>%20</literal> to denote
+ spaces in path names:
+ </para>
+ <para>
+ <screen> user-manual file:///c:/some%20dir/privoxy/user-manual/index.html</screen>
+ </para>
+ <para>
+ Windows, UNC notation (forward slashes required again):
+ </para>
+ <para>
+ <screen> user-manual file://///some-server/some-path/privoxy/user-manual/index.html</screen>
</para>
<para>
Any platform, on local webserver (called <quote>local-webserver</quote>):
</para>
<para>
- <screen>user-manual http://local-webserver/privoxy-user-manual/</screen>
+ <screen> user-manual http://local-webserver/privoxy-user-manual/</screen>
</para>
<![%user-man;[
<!-- this gets hammered in conversion to config. Text repeated below. -->