current/doc/webserver/user-manual actions-file.html, 1.101, 1.102 appendix.html, 1.110, 1.111 config.html, 1.76, 1.77 configuration.html, 1.93, 1.94 contact.html, 1.67, 1.68 copyright.html, 1.102, 1.103 filter-file.html, 1.94, 1.95 index.html, 1.122, 1.123 installation.html, 1.75, 1.76 introduction.html, 1.63, 1.64 quickstart.html, 1.83, 1.84 seealso.html, 1.56, 1.57 startup.html, 1.85, 1.86 templates.html, 1.43, 1.44 whatsnew.html, 1.81, 1.82
Lee <[email protected]> Fri, 26 Aug 2016 03:45:39 +0000
| Newsgroups | gmane.comp.web.privoxy.cvs |
|---|---|
| Message-ID | <[email protected]> |
Update of /cvsroot/ijbswa/current/doc/webserver/user-manual
In directory sfp-cvs-1.v30.ch3.sourceforge.com:/tmp/cvs-serv6440/current/doc/webserver/user-manual
Modified Files:
actions-file.html appendix.html config.html configuration.html
contact.html copyright.html filter-file.html index.html
installation.html introduction.html quickstart.html
seealso.html startup.html templates.html whatsnew.html
Log Message:
rebuilt .html docs for privoxy version 3.0.26
Index: whatsnew.html
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/whatsnew.html,v
retrieving revision 1.81
retrieving revision 1.82
diff -C2 -d -r1.81 -r1.82
*** whatsnew.html 28 Jul 2016 08:25:50 -0000 1.81
--- whatsnew.html 26 Aug 2016 03:45:37 -0000 1.82
***************
*** 1,566 ****
! <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01
! Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
<html>
! <head>
! <title>
! What's New in this Release
! </title>
! <meta name="GENERATOR" content=
! "Modular DocBook HTML Stylesheet Version 1.79">
! <link rel="HOME" title="Privoxy 3.0.26 User Manual" href="index.html">
[...1126 lines suppressed...]
+
+ <td width="34%" align="center" valign="top"><a href="index.html"
+ accesskey="H">Home</a></td>
+
+ <td width="33%" align="right" valign="top"><a href="quickstart.html"
+ accesskey="N">Next</a></td>
+ </tr>
+
+ <tr>
+ <td width="33%" align="left" valign="top">Installation</td>
+
+ <td width="34%" align="center" valign="top"> </td>
+
+ <td width="33%" align="right" valign="top">Quickstart to Using
+ Privoxy</td>
+ </tr>
+ </table>
+ </div>
+ </body>
+ </html>
Index: installation.html
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/installation.html,v
retrieving revision 1.75
retrieving revision 1.76
diff -C2 -d -r1.75 -r1.76
*** installation.html 28 Jul 2016 08:25:50 -0000 1.75
--- installation.html 26 Aug 2016 03:45:37 -0000 1.76
***************
*** 1,384 ****
! <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01
! Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
<html>
! <head>
! <title>
! Installation
! </title>
! <meta name="GENERATOR" content=
! "Modular DocBook HTML Stylesheet Version 1.79">
! <link rel="HOME" title="Privoxy 3.0.26 User Manual" href="index.html">
[...1090 lines suppressed...]
+
+ <td width="34%" align="center" valign="top"><a href="index.html"
+ accesskey="H">Home</a></td>
+
+ <td width="33%" align="right" valign="top"><a href="whatsnew.html"
+ accesskey="N">Next</a></td>
+ </tr>
+
+ <tr>
+ <td width="33%" align="left" valign="top">Introduction</td>
+
+ <td width="34%" align="center" valign="top"> </td>
+
+ <td width="33%" align="right" valign="top">What's New in this
+ Release</td>
+ </tr>
+ </table>
+ </div>
+ </body>
+ </html>
Index: appendix.html
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/appendix.html,v
retrieving revision 1.110
retrieving revision 1.111
diff -C2 -d -r1.110 -r1.111
*** appendix.html 28 Jul 2016 08:25:50 -0000 1.110
--- appendix.html 26 Aug 2016 03:45:37 -0000 1.111
***************
*** 1,676 ****
! <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01
! Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
<html>
! <head>
! <title>
! Appendix
! </title>
! <meta name="GENERATOR" content=
! "Modular DocBook HTML Stylesheet Version 1.79">
! <link rel="HOME" title="Privoxy 3.0.26 User Manual" href="index.html">
[...1878 lines suppressed...]
! <td width="33%" align="left" valign="top"><a href="seealso.html"
! accesskey="P">Prev</a></td>
+ <td width="34%" align="center" valign="top"><a href="index.html"
+ accesskey="H">Home</a></td>
+
+ <td width="33%" align="right" valign="top"> </td>
+ </tr>
+
+ <tr>
+ <td width="33%" align="left" valign="top">See Also</td>
+
+ <td width="34%" align="center" valign="top"> </td>
+
+ <td width="33%" align="right" valign="top"> </td>
+ </tr>
+ </table>
+ </div>
+ </body>
+ </html>
Index: seealso.html
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/seealso.html,v
retrieving revision 1.56
retrieving revision 1.57
diff -C2 -d -r1.56 -r1.57
*** seealso.html 28 Jul 2016 08:25:50 -0000 1.56
--- seealso.html 26 Aug 2016 03:45:37 -0000 1.57
***************
*** 1,195 ****
! <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01
! Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
<html>
! <head>
! <title>
! See Also
! </title>
! <meta name="GENERATOR" content=
! "Modular DocBook HTML Stylesheet Version 1.79">
! <link rel="HOME" title="Privoxy 3.0.26 User Manual" href="index.html">
! <link rel="PREVIOUS" title="Privoxy Copyright, License and History" href=
! "copyright.html">
! <link rel="NEXT" title="Appendix" href="appendix.html">
! <link rel="STYLESHEET" type="text/css" href="../p_doc.css">
! <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
! <link rel="STYLESHEET" type="text/css" href="p_doc.css">
! </head>
! <body class="SECT1" bgcolor="#EEEEEE" text="#000000" link="#0000FF" vlink=
! "#840084" alink="#0000FF">
! <div class="NAVHEADER">
! <table summary="Header navigation table" width="100%" border="0"
! cellpadding="0" cellspacing="0">
<tr>
! <th colspan="3" align="center">
! Privoxy 3.0.26 User Manual
! </th>
</tr>
<tr>
! <td width="10%" align="left" valign="bottom">
! <a href="copyright.html" accesskey="P">Prev</a>
! </td>
! <td width="80%" align="center" valign="bottom">
! </td>
! <td width="10%" align="right" valign="bottom">
! <a href="appendix.html" accesskey="N">Next</a>
! </td>
</tr>
! </table>
! <hr align="LEFT" width="100%">
! </div>
! <div class="SECT1">
! <h1 class="SECT1">
! <a name="SEEALSO">13. See Also</a>
! </h1>
! <p>
! Other references and sites of interest to <span class=
! "APPLICATION">Privoxy</span> users:
! </p>
! <p>
! </p>
! <table border="0">
! <tbody>
! <tr>
! <td>
! <a href="https://www.privoxy.org/" target=
! "_top">https://www.privoxy.org/</a>, the <span class=
! "APPLICATION">Privoxy</span> Home page.
! </td>
! </tr>
! </tbody>
! </table>
! <table border="0">
! <tbody>
! <tr>
! <td>
! <a href="https://www.privoxy.org/faq/" target=
! "_top">https://www.privoxy.org/faq/</a>, the <span class=
! "APPLICATION">Privoxy</span> FAQ.
! </td>
! </tr>
! </tbody>
! </table>
! <table border="0">
! <tbody>
! <tr>
! <td>
! <a href="https://www.privoxy.org/developer-manual/" target=
! "_top">https://www.privoxy.org/developer-manual/</a>, the <span
! class="APPLICATION">Privoxy</span> developer manual.
! </td>
! </tr>
! </tbody>
! </table>
! <table border="0">
! <tbody>
! <tr>
! <td>
! <a href="https://sourceforge.net/projects/ijbswa/" target=
! "_top">https://sourceforge.net/projects/ijbswa/</a>, the
! Project Page for <span class="APPLICATION">Privoxy</span> on <a
! href="http://sourceforge.net" target="_top">SourceForge</a>.
! </td>
! </tr>
! </tbody>
! </table>
! <table border="0">
! <tbody>
! <tr>
! <td>
! <a href="http://config.privoxy.org/" target=
! "_top">http://config.privoxy.org/</a>, the web-based user
! interface. <span class="APPLICATION">Privoxy</span> must be
! running for this to work. Shortcut: <a href="http://p.p/"
! target="_top">http://p.p/</a>
! </td>
! </tr>
! </tbody>
! </table>
! <table border="0">
! <tbody>
! <tr>
! <td>
! <a href=
! "https://sourceforge.net/tracker/?group_id=11118&atid=460288"
! target=
! "_top">https://sourceforge.net/tracker/?group_id=11118&atid=460288</a>,
! to submit <span class="QUOTE">"misses"</span> and other
! configuration related suggestions to the developers.
! </td>
! </tr>
! </tbody>
! </table>
! <table border="0">
! <tbody>
! <tr>
! <td>
! <a href="http://www.squid-cache.org/" target=
! "_top">http://www.squid-cache.org/</a>, a popular caching
! proxy, which is often used together with <span class=
! "APPLICATION">Privoxy</span>.
! </td>
! </tr>
! </tbody>
! </table>
! <table border="0">
! <tbody>
! <tr>
! <td>
! <a href=
! "http://www.pps.univ-paris-diderot.fr/~jch/software/polipo/"
! target=
! "_top">http://www.pps.univ-paris-diderot.fr/~jch/software/polipo/</a>,
! <span class="APPLICATION">Polipo</span> is a caching proxy with
! advanced features like pipelining, multiplexing and caching of
! partial instances. In many setups it can be used as <span
! class="APPLICATION">Squid</span> replacement.
! </td>
! </tr>
! </tbody>
! </table>
! <table border="0">
! <tbody>
! <tr>
! <td>
! <a href="https://www.torproject.org/" target=
! "_top">https://www.torproject.org/</a>, <span class=
! "APPLICATION">Tor</span> can help anonymize web browsing, web
! publishing, instant messaging, IRC, SSH, and other
! applications.
! </td>
! </tr>
! </tbody>
! </table>
! </div>
! <div class="NAVFOOTER">
! <hr align="LEFT" width="100%">
! <table summary="Footer navigation table" width="100%" border="0"
! cellpadding="0" cellspacing="0">
<tr>
! <td width="33%" align="left" valign="top">
! <a href="copyright.html" accesskey="P">Prev</a>
! </td>
! <td width="34%" align="center" valign="top">
! <a href="index.html" accesskey="H">Home</a>
! </td>
! <td width="33%" align="right" valign="top">
! <a href="appendix.html" accesskey="N">Next</a>
! </td>
</tr>
<tr>
! <td width="33%" align="left" valign="top">
! Privoxy Copyright, License and History
! </td>
! <td width="34%" align="center" valign="top">
!
! </td>
! <td width="33%" align="right" valign="top">
! Appendix
! </td>
</tr>
! </table>
! </div>
! </body>
! </html>
--- 1,177 ----
! <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
! "http://www.w3.org/TR/html4/loose.dtd">
!
<html>
! <head>
! <title>See Also</title>
! <meta name="GENERATOR" content=
! "Modular DocBook HTML Stylesheet Version 1.79">
! <link rel="HOME" title="Privoxy 3.0.26 User Manual" href="index.html">
! <link rel="PREVIOUS" title="Privoxy Copyright, License and History" href=
! "copyright.html">
! <link rel="NEXT" title="Appendix" href="appendix.html">
! <link rel="STYLESHEET" type="text/css" href="../p_doc.css">
! <meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
! <link rel="STYLESHEET" type="text/css" href="p_doc.css">
! </head>
!
! <body class="SECT1" bgcolor="#EEEEEE" text="#000000" link="#0000FF" vlink=
! "#840084" alink="#0000FF">
! <div class="NAVHEADER">
! <table summary="Header navigation table" width="100%" border="0"
! cellpadding="0" cellspacing="0">
! <tr>
! <th colspan="3" align="center">Privoxy 3.0.26 User Manual</th>
! </tr>
!
! <tr>
! <td width="10%" align="left" valign="bottom"><a href="copyright.html"
! accesskey="P">Prev</a></td>
!
! <td width="80%" align="center" valign="bottom"></td>
!
! <td width="10%" align="right" valign="bottom"><a href="appendix.html"
! accesskey="N">Next</a></td>
! </tr>
! </table>
! <hr align="left" width="100%">
! </div>
!
! <div class="SECT1">
! <h1 class="SECT1"><a name="SEEALSO" id="SEEALSO">13. See Also</a></h1>
!
! <p>Other references and sites of interest to <span class=
! "APPLICATION">Privoxy</span> users:</p>
!
! <table border="0">
! <tbody>
<tr>
! <td><a href="https://www.privoxy.org/" target=
! "_top">https://www.privoxy.org/</a>, the <span class=
! "APPLICATION">Privoxy</span> Home page.</td>
</tr>
+ </tbody>
+ </table>
+
+ <table border="0">
+ <tbody>
<tr>
! <td><a href="https://www.privoxy.org/faq/" target=
! "_top">https://www.privoxy.org/faq/</a>, the <span class=
! "APPLICATION">Privoxy</span> FAQ.</td>
</tr>
! </tbody>
! </table>
!
! <table border="0">
! <tbody>
<tr>
! <td><a href="https://www.privoxy.org/developer-manual/" target=
! "_top">https://www.privoxy.org/developer-manual/</a>, the
! <span class="APPLICATION">Privoxy</span> developer manual.</td>
</tr>
+ </tbody>
+ </table>
+
+ <table border="0">
+ <tbody>
<tr>
! <td><a href="https://sourceforge.net/projects/ijbswa/" target=
! "_top">https://sourceforge.net/projects/ijbswa/</a>, the Project
! Page for <span class="APPLICATION">Privoxy</span> on <a href=
! "http://sourceforge.net" target="_top">SourceForge</a>.</td>
</tr>
! </tbody>
! </table>
!
! <table border="0">
! <tbody>
! <tr>
! <td><a href="http://config.privoxy.org/" target=
! "_top">http://config.privoxy.org/</a>, the web-based user
! interface. <span class="APPLICATION">Privoxy</span> must be running
! for this to work. Shortcut: <a href="http://p.p/" target=
! "_top">http://p.p/</a></td>
! </tr>
! </tbody>
! </table>
!
! <table border="0">
! <tbody>
! <tr>
! <td><a href=
! "https://sourceforge.net/tracker/?group_id=11118&atid=460288"
! target=
! "_top">https://sourceforge.net/tracker/?group_id=11118&atid=460288</a>,
! to submit <span class="QUOTE">"misses"</span> and other
! configuration related suggestions to the developers.</td>
! </tr>
! </tbody>
! </table>
!
! <table border="0">
! <tbody>
! <tr>
! <td><a href="http://www.squid-cache.org/" target=
! "_top">http://www.squid-cache.org/</a>, a popular caching proxy,
! which is often used together with <span class=
! "APPLICATION">Privoxy</span>.</td>
! </tr>
! </tbody>
! </table>
!
! <table border="0">
! <tbody>
! <tr>
! <td><a href=
! "http://www.pps.univ-paris-diderot.fr/~jch/software/polipo/"
! target="_top">http://www.pps.univ-paris-diderot.fr/~jch/software/polipo/</a>,
! <span class="APPLICATION">Polipo</span> is a caching proxy with
! advanced features like pipelining, multiplexing and caching of
! partial instances. In many setups it can be used as <span class=
! "APPLICATION">Squid</span> replacement.</td>
! </tr>
! </tbody>
! </table>
!
! <table border="0">
! <tbody>
! <tr>
! <td><a href="https://www.torproject.org/" target=
! "_top">https://www.torproject.org/</a>, <span class=
! "APPLICATION">Tor</span> can help anonymize web browsing, web
! publishing, instant messaging, IRC, SSH, and other
! applications.</td>
! </tr>
! </tbody>
! </table>
! </div>
!
! <div class="NAVFOOTER">
! <hr align="left" width="100%">
!
! <table summary="Footer navigation table" width="100%" border="0"
! cellpadding="0" cellspacing="0">
! <tr>
! <td width="33%" align="left" valign="top"><a href="copyright.html"
! accesskey="P">Prev</a></td>
!
! <td width="34%" align="center" valign="top"><a href="index.html"
! accesskey="H">Home</a></td>
!
! <td width="33%" align="right" valign="top"><a href="appendix.html"
! accesskey="N">Next</a></td>
! </tr>
!
! <tr>
! <td width="33%" align="left" valign="top">Privoxy Copyright, License
! and History</td>
+ <td width="34%" align="center" valign="top"> </td>
+
+ <td width="33%" align="right" valign="top">Appendix</td>
+ </tr>
+ </table>
+ </div>
+ </body>
+ </html>
Index: actions-file.html
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/actions-file.html,v
retrieving revision 1.101
retrieving revision 1.102
diff -C2 -d -r1.101 -r1.102
*** actions-file.html 28 Jul 2016 08:25:50 -0000 1.101
--- actions-file.html 26 Aug 2016 03:45:37 -0000 1.102
***************
*** 1,492 ****
! <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01
! Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
<html>
! <head>
! <title>
! Actions Files
! </title>
! <meta name="GENERATOR" content=
! "Modular DocBook HTML Stylesheet Version 1.79">
! <link rel="HOME" title="Privoxy 3.0.26 User Manual" href="index.html">
[...11249 lines suppressed...]
!
! <td width="34%" align="center" valign="top"><a href="index.html"
! accesskey="H">Home</a></td>
!
! <td width="33%" align="right" valign="top"><a href="filter-file.html"
! accesskey="N">Next</a></td>
! </tr>
!
! <tr>
! <td width="33%" align="left" valign="top">The Main Configuration
! File</td>
+ <td width="34%" align="center" valign="top"> </td>
+
+ <td width="33%" align="right" valign="top">Filter Files</td>
+ </tr>
+ </table>
+ </div>
+ </body>
+ </html>
Index: introduction.html
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/introduction.html,v
retrieving revision 1.63
retrieving revision 1.64
diff -C2 -d -r1.63 -r1.64
*** introduction.html 28 Jul 2016 08:25:50 -0000 1.63
--- introduction.html 26 Aug 2016 03:45:37 -0000 1.64
***************
*** 1,205 ****
! <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01
! Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
<html>
! <head>
! <title>
! Introduction
! </title>
! <meta name="GENERATOR" content=
! "Modular DocBook HTML Stylesheet Version 1.79">
! <link rel="HOME" title="Privoxy 3.0.26 User Manual" href="index.html">
! <link rel="PREVIOUS" title="Privoxy 3.0.26 User Manual" href=
! "index.html">
! <link rel="NEXT" title="Installation" href="installation.html">
! <link rel="STYLESHEET" type="text/css" href="../p_doc.css">
! <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
! <link rel="STYLESHEET" type="text/css" href="p_doc.css">
! </head>
! <body class="SECT1" bgcolor="#EEEEEE" text="#000000" link="#0000FF" vlink=
! "#840084" alink="#0000FF">
! <div class="NAVHEADER">
! <table summary="Header navigation table" width="100%" border="0"
! cellpadding="0" cellspacing="0">
! <tr>
! <th colspan="3" align="center">
! Privoxy 3.0.26 User Manual
! </th>
! </tr>
! <tr>
! <td width="10%" align="left" valign="bottom">
! <a href="index.html" accesskey="P">Prev</a>
! </td>
! <td width="80%" align="center" valign="bottom">
! </td>
! <td width="10%" align="right" valign="bottom">
! <a href="installation.html" accesskey="N">Next</a>
! </td>
! </tr>
! </table>
! <hr align="LEFT" width="100%">
! </div>
! <div class="SECT1">
! <h1 class="SECT1">
! <a name="INTRODUCTION">1. Introduction</a>
! </h1>
! <p>
! This documentation is included with the current UNRELEASED version of
! <span class="APPLICATION">Privoxy</span>, 3.0.26, and is mostly
! complete at this point. The most up to date reference for the time
! being is still the comments in the source files and in the individual
! configuration files. Development of a new version is currently
! nearing completion, and includes significant changes and enhancements
! over earlier versions.
! </p>
! <p>
! Since this is a UNRELEASED version, not all new features are well
! tested. This documentation may be slightly out of sync as a result
! (especially with CVS sources). And there <span class="emphasis"><i
! class="EMPHASIS">may be</i></span> bugs, though hopefully not many!
! </p>
! <div class="SECT2">
! <h2 class="SECT2">
! <a name="FEATURES">1.1. Features</a>
! </h2>
! <p>
! In addition to the core features of ad blocking and <a href=
! "http://en.wikipedia.org/wiki/Browser_cookie" target=
! "_top">cookie</a> management, <span class=
! "APPLICATION">Privoxy</span> provides many supplemental features,
! some of them currently under development, that give the end-user
! more control, more privacy and more freedom:
! </p>
! <p>
! </p>
! <ul>
! <li>
! <p>
! Supports "Connection: keep-alive". Outgoing connections can be
! kept alive independently from the client.
! </p>
! </li>
! <li>
! <p>
! Supports IPv6, provided the operating system does so too, and
! the configure script detects it.
! </p>
! </li>
! <li>
! <p>
! Supports tagging which allows to change the behaviour based on
! client and server headers.
! </p>
! </li>
! <li>
! <p>
! Can be run as an "intercepting" proxy, which obviates the need
! to configure browsers individually.
! </p>
! </li>
! <li>
! <p>
! Sophisticated actions and filters for manipulating both server
! and client headers.
! </p>
! </li>
! <li>
! <p>
! Can be chained with other proxies.
! </p>
! </li>
! <li>
! <p>
! Integrated browser-based configuration and control utility at
! <a href="http://config.privoxy.org/" target=
! "_top">http://config.privoxy.org/</a> (shortcut: <a href=
! "http://p.p/" target="_top">http://p.p/</a>). Browser-based
! tracing of rule and filter effects. Remote toggling.
! </p>
! </li>
! <li>
! <p>
! Web page filtering (text replacements, removes banners based on
! size, invisible <span class="QUOTE">"web-bugs"</span> and HTML
! annoyances, etc.)
! </p>
! </li>
! <li>
! <p>
! Modularized configuration that allows for standard settings and
! user settings to reside in separate files, so that installing
! updated actions files won't overwrite individual user settings.
! </p>
! </li>
! <li>
! <p>
! Support for Perl Compatible Regular Expressions in the
! configuration files, and a more sophisticated and flexible
! configuration syntax.
! </p>
! </li>
! <li>
! <p>
! GIF de-animation.
! </p>
! </li>
! <li>
! <p>
! Bypass many click-tracking scripts (avoids script redirection).
! </p>
! </li>
! <li>
! <p>
! User-customizable HTML templates for most proxy-generated pages
! (e.g. "blocked" page).
! </p>
! </li>
! <li>
! <p>
! Auto-detection and re-reading of config file changes.
! </p>
! </li>
! <li>
! <p>
! Most features are controllable on a per-site or per-location
! basis.
! </p>
! </li>
! <li>
! <p>
! Many smaller new features added, limitations and bugs removed.
! </p>
! </li>
! </ul>
! </div>
! </div>
! <div class="NAVFOOTER">
! <hr align="LEFT" width="100%">
! <table summary="Footer navigation table" width="100%" border="0"
! cellpadding="0" cellspacing="0">
! <tr>
! <td width="33%" align="left" valign="top">
! <a href="index.html" accesskey="P">Prev</a>
! </td>
! <td width="34%" align="center" valign="top">
! <a href="index.html" accesskey="H">Home</a>
! </td>
! <td width="33%" align="right" valign="top">
! <a href="installation.html" accesskey="N">Next</a>
! </td>
! </tr>
! <tr>
! <td width="33%" align="left" valign="top">
! Privoxy 3.0.26 User Manual
! </td>
! <td width="34%" align="center" valign="top">
!
! </td>
! <td width="33%" align="right" valign="top">
! Installation
! </td>
! </tr>
! </table>
</div>
! </body>
! </html>
--- 1,170 ----
! <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
! "http://www.w3.org/TR/html4/loose.dtd">
!
<html>
! <head>
! <title>Introduction</title>
! <meta name="GENERATOR" content=
! "Modular DocBook HTML Stylesheet Version 1.79">
! <link rel="HOME" title="Privoxy 3.0.26 User Manual" href="index.html">
! <link rel="PREVIOUS" title="Privoxy 3.0.26 User Manual" href="index.html">
! <link rel="NEXT" title="Installation" href="installation.html">
! <link rel="STYLESHEET" type="text/css" href="../p_doc.css">
! <meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
! <link rel="STYLESHEET" type="text/css" href="p_doc.css">
! </head>
!
! <body class="SECT1" bgcolor="#EEEEEE" text="#000000" link="#0000FF" vlink=
! "#840084" alink="#0000FF">
! <div class="NAVHEADER">
! <table summary="Header navigation table" width="100%" border="0"
! cellpadding="0" cellspacing="0">
! <tr>
! <th colspan="3" align="center">Privoxy 3.0.26 User Manual</th>
! </tr>
!
! <tr>
! <td width="10%" align="left" valign="bottom"><a href="index.html"
! accesskey="P">Prev</a></td>
!
! <td width="80%" align="center" valign="bottom"></td>
!
! <td width="10%" align="right" valign="bottom"><a href=
! "installation.html" accesskey="N">Next</a></td>
! </tr>
! </table>
! <hr align="left" width="100%">
! </div>
!
! <div class="SECT1">
! <h1 class="SECT1"><a name="INTRODUCTION" id="INTRODUCTION">1.
! Introduction</a></h1>
!
! <p>This documentation is included with the current stable version of
! <span class="APPLICATION">Privoxy</span>, 3.0.26.</p>
!
! <div class="SECT2">
! <h2 class="SECT2"><a name="FEATURES" id="FEATURES">1.1.
! Features</a></h2>
!
! <p>In addition to the core features of ad blocking and <a href=
! "http://en.wikipedia.org/wiki/Browser_cookie" target="_top">cookie</a>
! management, <span class="APPLICATION">Privoxy</span> provides many
! supplemental features, that give the end-user more control, more
! privacy and more freedom:</p>
!
! <ul>
! <li>
! <p>Supports "Connection: keep-alive". Outgoing connections can be
! kept alive independently from the client.</p>
! </li>
!
! <li>
! <p>Supports IPv6, provided the operating system does so too, and
! the configure script detects it.</p>
! </li>
!
! <li>
! <p>Supports tagging which allows to change the behaviour based on
! client and server headers.</p>
! </li>
!
! <li>
! <p>Can be run as an "intercepting" proxy, which obviates the need
! to configure browsers individually.</p>
! </li>
!
! <li>
! <p>Sophisticated actions and filters for manipulating both server
! and client headers.</p>
! </li>
!
! <li>
! <p>Can be chained with other proxies.</p>
! </li>
!
! <li>
! <p>Integrated browser-based configuration and control utility at
! <a href="http://config.privoxy.org/" target=
! "_top">http://config.privoxy.org/</a> (shortcut: <a href=
! "http://p.p/" target="_top">http://p.p/</a>). Browser-based tracing
! of rule and filter effects. Remote toggling.</p>
! </li>
!
! <li>
! <p>Web page filtering (text replacements, removes banners based on
! size, invisible <span class="QUOTE">"web-bugs"</span> and HTML
! annoyances, etc.)</p>
! </li>
!
! <li>
! <p>Modularized configuration that allows for standard settings and
! user settings to reside in separate files, so that installing
! updated actions files won't overwrite individual user settings.</p>
! </li>
!
! <li>
! <p>Support for Perl Compatible Regular Expressions in the
! configuration files, and a more sophisticated and flexible
! configuration syntax.</p>
! </li>
!
! <li>
! <p>GIF de-animation.</p>
! </li>
!
! <li>
! <p>Bypass many click-tracking scripts (avoids script
! redirection).</p>
! </li>
!
! <li>
! <p>User-customizable HTML templates for most proxy-generated pages
! (e.g. "blocked" page).</p>
! </li>
!
! <li>
! <p>Auto-detection and re-reading of config file changes.</p>
! </li>
!
! <li>
! <p>Most features are controllable on a per-site or per-location
! basis.</p>
! </li>
!
! <li>
! <p>Many smaller new features added, limitations and bugs
! removed.</p>
! </li>
! </ul>
</div>
! </div>
!
! <div class="NAVFOOTER">
! <hr align="left" width="100%">
!
! <table summary="Footer navigation table" width="100%" border="0"
! cellpadding="0" cellspacing="0">
! <tr>
! <td width="33%" align="left" valign="top"><a href="index.html"
! accesskey="P">Prev</a></td>
!
! <td width="34%" align="center" valign="top"><a href="index.html"
! accesskey="H">Home</a></td>
!
! <td width="33%" align="right" valign="top"><a href=
! "installation.html" accesskey="N">Next</a></td>
! </tr>
+ <tr>
+ <td width="33%" align="left" valign="top">Privoxy 3.0.26 User
+ Manual</td>
+
+ <td width="34%" align="center" valign="top"> </td>
+
+ <td width="33%" align="right" valign="top">Installation</td>
+ </tr>
+ </table>
+ </div>
+ </body>
+ </html>
Index: index.html
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/index.html,v
retrieving revision 1.122
retrieving revision 1.123
diff -C2 -d -r1.122 -r1.123
*** index.html 28 Jul 2016 08:25:50 -0000 1.122
--- index.html 26 Aug 2016 03:45:37 -0000 1.123
***************
*** 1,803 ****
! <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01
! Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
<html>
! <head>
! <title>
! Privoxy 3.0.26 User Manual
! </title>
! <meta name="GENERATOR" content=
! "Modular DocBook HTML Stylesheet Version 1.79">
! <link rel="NEXT" title="Introduction" href="introduction.html">
[...1415 lines suppressed...]
+ <tr>
+ <td width="33%" align="left" valign="top"> </td>
+
+ <td width="34%" align="center" valign="top"> </td>
+
+ <td width="33%" align="right" valign="top"><a href=
+ "introduction.html" accesskey="N">Next</a></td>
+ </tr>
+
+ <tr>
+ <td width="33%" align="left" valign="top"> </td>
+
+ <td width="34%" align="center" valign="top"> </td>
+
+ <td width="33%" align="right" valign="top">Introduction</td>
+ </tr>
+ </table>
+ </div>
+ </body>
+ </html>
Index: startup.html
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/startup.html,v
retrieving revision 1.85
retrieving revision 1.86
diff -C2 -d -r1.85 -r1.86
*** startup.html 28 Jul 2016 08:25:50 -0000 1.85
--- startup.html 26 Aug 2016 03:45:37 -0000 1.86
***************
*** 1,484 ****
! <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01
! Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
<html>
! <head>
! <title>
! Starting Privoxy
! </title>
! <meta name="GENERATOR" content=
! "Modular DocBook HTML Stylesheet Version 1.79">
! <link rel="HOME" title="Privoxy 3.0.26 User Manual" href="index.html">
! <link rel="PREVIOUS" title="Quickstart to Using Privoxy" href=
! "quickstart.html">
! <link rel="NEXT" title="Privoxy Configuration" href="configuration.html">
! <link rel="STYLESHEET" type="text/css" href="../p_doc.css">
! <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
! <link rel="STYLESHEET" type="text/css" href="p_doc.css">
! </head>
! <body class="SECT1" bgcolor="#EEEEEE" text="#000000" link="#0000FF" vlink=
! "#840084" alink="#0000FF">
! <div class="NAVHEADER">
! <table summary="Header navigation table" width="100%" border="0"
! cellpadding="0" cellspacing="0">
! <tr>
! <th colspan="3" align="center">
! Privoxy 3.0.26 User Manual
! </th>
! </tr>
<tr>
! <td width="10%" align="left" valign="bottom">
! <a href="quickstart.html" accesskey="P">Prev</a>
! </td>
! <td width="80%" align="center" valign="bottom">
! </td>
! <td width="10%" align="right" valign="bottom">
! <a href="configuration.html" accesskey="N">Next</a>
</td>
</tr>
</table>
- <hr align="LEFT" width="100%">
</div>
- <div class="SECT1">
- <h1 class="SECT1">
- <a name="STARTUP">5. Starting Privoxy</a>
- </h1>
- <p>
- Before launching <span class="APPLICATION">Privoxy</span> for the
- first time, you will want to configure your browser(s) to use <span
- class="APPLICATION">Privoxy</span> as a HTTP and HTTPS (SSL) <a href=
- "http://en.wikipedia.org/wiki/Proxy_server" target="_top">proxy</a>.
- The default is 127.0.0.1 (or localhost) for the proxy address, and
- port 8118 (earlier versions used port 8000). This is the one
- configuration step <span class="emphasis"><i class="EMPHASIS">that
- must be done</i></span>!
- </p>
- <p>
- Please note that <span class="APPLICATION">Privoxy</span> can only
- proxy HTTP and HTTPS traffic. It will not work with FTP or other
- protocols.
- </p>
- <p>
- </p>
- <div class="FIGURE">
- <a name="AEN667"></a>
- <p>
- <b>Figure 2. Proxy Configuration Showing Mozilla/Netscape HTTP and
- HTTPS (SSL) Settings</b>
- </p>
- <div class="MEDIAOBJECT">
- <p>
- <img src="proxy_setup.jpg">
- </p>
- </div>
- </div>
! <p>
! With <span class="APPLICATION">Firefox</span>, this is typically set
! under:
! </p>
! <p class="LITERALLAYOUT">
! <span class="GUIBUTTON">Tools</span> -> <span
! class="GUIBUTTON">Options</span> -> <span class=
! "GUIBUTTON">Advanced</span> -> <span class=
! "GUIBUTTON">Network</span> -><span class=
! "GUIBUTTON">Connection</span> -> <span class=
! "GUIBUTTON">Settings</span><br>
!
! </p>
! <p>
! Or optionally on some platforms:
! </p>
! <p class="LITERALLAYOUT">
! <span class="GUIBUTTON">Edit</span> -> <span
! class="GUIBUTTON">Preferences</span> -> <span class=
! "GUIBUTTON">General</span> -> <span class=
! "GUIBUTTON">Connection Settings</span> -> <span class=
! "GUIBUTTON">Manual Proxy Configuration</span><br>
!
! </p>
! <p>
! With <span class="APPLICATION">Netscape</span> (and <span class=
! "APPLICATION">Mozilla</span>), this can be set under:
! </p>
! <p class="LITERALLAYOUT">
! <span class="GUIBUTTON">Edit</span> -> <span
! class="GUIBUTTON">Preferences</span> -> <span class=
! "GUIBUTTON">Advanced</span> -> <span class=
! "GUIBUTTON">Proxies</span> -> <span class=
! "GUIBUTTON">HTTP Proxy</span><br>
!
! </p>
! <p>
! For <span class="APPLICATION">Internet Explorer v.5-7</span>:
! </p>
! <p class="LITERALLAYOUT">
! <span class="GUIBUTTON">Tools</span> -> <span
! class="GUIBUTTON">Internet Options</span> -> <span
! class="GUIBUTTON">Connections</span> -> <span class=
! "GUIBUTTON">LAN Settings</span>
! </p>
! <p>
! Then, check <span class="QUOTE">"Use Proxy"</span> and fill in the
! appropriate info (Address: 127.0.0.1, Port: 8118). Include HTTPS
! (SSL), if you want HTTPS proxy support too (sometimes labeled <span
! class="QUOTE">"Secure"</span>). Make sure any checkboxes like <span
! class="QUOTE">"Use the same proxy server for all protocols"</span> is
! <span class="emphasis"><i class="EMPHASIS">UNCHECKED</i></span>. You
! want only HTTP and HTTPS (SSL)!
! </p>
! <p>
! </p>
! <div class="FIGURE">
! <a name="AEN712"></a>
! <p>
! <b>Figure 3. Proxy Configuration Showing Internet Explorer HTTP and
! HTTPS (Secure) Settings</b>
! </p>
! <div class="MEDIAOBJECT">
! <p>
! <img src="proxy2.jpg">
! </p>
! </div>
! </div>
! <p>
! After doing this, flush your browser's disk and memory caches to
! force a re-reading of all pages and to get rid of any ads that may be
! cached. Remove any <a href=
! "http://en.wikipedia.org/wiki/Browser_cookie" target=
! "_top">cookies</a>, if you want <span class=
! "APPLICATION">Privoxy</span> to manage that. You are now ready to
! start enjoying the benefits of using <span class=
! "APPLICATION">Privoxy</span>!
! </p>
! <p>
! <span class="APPLICATION">Privoxy</span> itself is typically started
! by specifying the main configuration file to be used on the command
! line. If no configuration file is specified on the command line,
! <span class="APPLICATION">Privoxy</span> will look for a file named
! <tt class="FILENAME">config</tt> in the current directory. Except on
! Win32 where it will try <tt class="FILENAME">config.txt</tt>.
! </p>
! <div class="SECT2">
! <h2 class="SECT2">
! <a name="START-DEBIAN">5.1. Debian</a>
! </h2>
! <p>
! We use a script. Note that Debian typically starts <span class=
! "APPLICATION">Privoxy</span> upon booting per default. It will use
! the file <tt class="FILENAME">/etc/privoxy/config</tt> as its main
! configuration file.
! </p>
! <p>
! </p>
! <table border="0" bgcolor="#E0E0E0" width="100%">
! <tr>
! <td>
! <pre class="SCREEN">
! # /etc/init.d/privoxy start
! </pre>
! </td>
! </tr>
! </table>
! </div>
! <div class="SECT2">
! <h2 class="SECT2">
! <a name="START-FREEBSD">5.2. FreeBSD and ElectroBSD</a>
! </h2>
! <p>
! To start <span class="APPLICATION">Privoxy</span> upon booting, add
! "privoxy_enable='YES'" to <tt class="FILENAME">/etc/rc.conf</tt>.
! <span class="APPLICATION">Privoxy</span> will use <tt class=
! "FILENAME">/usr/local/etc/privoxy/config</tt> as its main
! configuration file.
! </p>
! <p>
! If you installed <span class="APPLICATION">Privoxy</span> into a
! jail, the paths above are relative to the jail root.
! </p>
! <p>
! To start <span class="APPLICATION">Privoxy</span> manually, run:
! </p>
! <p>
! </p>
! <table border="0" bgcolor="#E0E0E0" width="100%">
! <tr>
! <td>
! <pre class="SCREEN">
! # service privoxy onestart
! </pre>
! </td>
! </tr>
! </table>
! </div>
! <div class="SECT2">
! <h2 class="SECT2">
! <a name="START-WINDOWS">5.3. Windows</a>
! </h2>
! <p>
! Click on the <span class="APPLICATION">Privoxy</span> Icon to start
! <span class="APPLICATION">Privoxy</span>. If no configuration file
! is specified on the command line, <span class=
! "APPLICATION">Privoxy</span> will look for a file named <tt class=
! "FILENAME">config.txt</tt>. Note that Windows will automatically
! start <span class="APPLICATION">Privoxy</span> when the system
! starts if you chose that option when installing.
! </p>
! <p>
! <span class="APPLICATION">Privoxy</span> can run with full Windows
! service functionality. On Windows only, the <span class=
! "APPLICATION">Privoxy</span> program has two new command line
! arguments to install and uninstall <span class=
! "APPLICATION">Privoxy</span> as a service. See the <a href=
! "installation.html#INSTALLATION-PACK-WIN">Windows Installation
! instructions</a> for details.
! </p>
! </div>
! <div class="SECT2">
! <h2 class="SECT2">
! <a name="START-UNICES">5.4. Generic instructions for Unix derivates
! (Solaris, NetBSD, HP-UX etc.)</a>
! </h2>
! <p>
! Example Unix startup command:
! </p>
! <p>
! </p>
! <table border="0" bgcolor="#E0E0E0" width="100%">
! <tr>
! <td>
! <pre class="SCREEN">
! # /usr/sbin/privoxy --user privoxy /etc/privoxy/config
! </pre>
! </td>
! </tr>
! </table>
! <p>
! Note that if you installed <span class="APPLICATION">Privoxy</span>
! through a package manager, the package will probably contain a
! platform-specific script or configuration file to start <span
! class="APPLICATION">Privoxy</span> upon boot.
! </p>
! </div>
! <div class="SECT2">
! <h2 class="SECT2">
! <a name="START-OS2">5.5. OS/2</a>
! </h2>
! <p>
! During installation, <span class="APPLICATION">Privoxy</span> is
! configured to start automatically when the system restarts. You can
! start it manually by double-clicking on the <span class=
! "APPLICATION">Privoxy</span> icon in the <span class=
! "APPLICATION">Privoxy</span> folder.
! </p>
! </div>
! <div class="SECT2">
! <h2 class="SECT2">
! <a name="START-MACOSX">5.6. Mac OS X</a>
! </h2>
! <p>
! The privoxy service will automatically start after a successful
! installation (and thereafter every time your computer starts up)
! however you will need to configure your web browser(s) to use it.
! To do so, configure them to use a proxy for HTTP and HTTPS at the
! address 127.0.0.1:8118.
! </p>
! <p>
! To prevent the privoxy service from automatically starting when
! your computer starts up, remove or rename the file <tt class=
! "LITERAL">/Library/LaunchDaemons/org.ijbswa.privoxy.plist</tt> (on
! OS X 10.5 and higher) or the folder named <tt class=
! "LITERAL">/Library/StartupItems/Privoxy</tt> (on OS X 10.4
! 'Tiger').
! </p>
! <p>
! To manually start or stop the privoxy service, use the scripts
! startPrivoxy.sh and stopPrivoxy.sh supplied in
! /Applications/Privoxy. They must be run from an administrator
! account, using sudo.
! </p>
! </div>
! <div class="SECT2">
! <h2 class="SECT2">
! <a name="CMDOPTIONS">5.7. Command Line Options</a>
! </h2>
! <p>
! <span class="APPLICATION">Privoxy</span> may be invoked with the
! following command-line options:
! </p>
! <p>
! </p>
! <ul>
! <li>
! <p>
! <span class="emphasis"><i class=
! "EMPHASIS">--config-test</i></span>
! </p>
! <p>
! Exit after loading the configuration files before binding to
! the listen address. The exit code signals whether or not the
! configuration files have been successfully loaded.
! </p>
! <p>
! If the exit code is 1, at least one of the configuration files
! is invalid, if it is 0, all the configuration files have been
! successfully loaded (but may still contain errors that can
! currently only be detected at run time).
! </p>
! <p>
! This option doesn't affect the log setting, combination with
! <span class="emphasis"><i class=
! "EMPHASIS">--no-daemon</i></span> is recommended if a
! configured log file shouldn't be used.
! </p>
! </li>
! <li>
! <p>
! <span class="emphasis"><i class="EMPHASIS">--version</i></span>
! </p>
! <p>
! Print version info and exit. Unix only.
! </p>
! </li>
! <li>
! <p>
! <span class="emphasis"><i class="EMPHASIS">--help</i></span>
! </p>
! <p>
! Print short usage info and exit. Unix only.
! </p>
! </li>
! <li>
! <p>
! <span class="emphasis"><i class=
! "EMPHASIS">--no-daemon</i></span>
! </p>
! <p>
! Don't become a daemon, i.e. don't fork and become process group
! leader, and don't detach from controlling tty. Unix only.
! </p>
! </li>
! <li>
! <p>
! <span class="emphasis"><i class="EMPHASIS">--pidfile
! FILE</i></span>
! </p>
! <p>
! On startup, write the process ID to <span class="emphasis"><i
! class="EMPHASIS">FILE</i></span>. Delete the <span class=
! "emphasis"><i class="EMPHASIS">FILE</i></span> on exit. Failure
! to create or delete the <span class="emphasis"><i class=
! "EMPHASIS">FILE</i></span> is non-fatal. If no <span class=
! "emphasis"><i class="EMPHASIS">FILE</i></span> option is given,
! no PID file will be used. Unix only.
! </p>
! </li>
! <li>
! <p>
! <span class="emphasis"><i class="EMPHASIS">--user
! USER[.GROUP]</i></span>
! </p>
! <p>
! After (optionally) writing the PID file, assume the user ID of
! <span class="emphasis"><i class="EMPHASIS">USER</i></span>, and
! if included the GID of GROUP. Exit if the privileges are not
! sufficient to do so. Unix only.
! </p>
! </li>
! <li>
! <p>
! <span class="emphasis"><i class="EMPHASIS">--chroot</i></span>
! </p>
! <p>
! Before changing to the user ID given in the <span class=
! "emphasis"><i class="EMPHASIS">--user</i></span> option, chroot
! to that user's home directory, i.e. make the kernel pretend to
! the <span class="APPLICATION">Privoxy</span> process that the
! directory tree starts there. If set up carefully, this can
! limit the impact of possible vulnerabilities in <span class=
! "APPLICATION">Privoxy</span> to the files contained in that
! hierarchy. Unix only.
! </p>
! </li>
! <li>
! <p>
! <span class="emphasis"><i class=
! "EMPHASIS">--pre-chroot-nslookup hostname</i></span>
! </p>
! <p>
! Specifies a hostname (for example www.privoxy.org) to look up
! before doing a chroot. On some systems, initializing the
! resolver library involves reading config files from /etc and/or
! loading additional shared libraries from /lib. On these
! systems, doing a hostname lookup before the chroot reduces the
! number of files that must be copied into the chroot tree.
! </p>
! <p>
! For fastest startup speed, a good value is a hostname that is
! not in /etc/hosts but that your local name server (listed in
! /etc/resolv.conf) can resolve without recursion (that is,
! without having to ask any other name servers). The hostname
! need not exist, but if it doesn't, an error message (which can
! be ignored) will be output.
! </p>
! </li>
! <li>
! <p>
! <span class="emphasis"><i class=
! "EMPHASIS">configfile</i></span>
! </p>
! <p>
! If no <span class="emphasis"><i class=
! "EMPHASIS">configfile</i></span> is included on the command
! line, <span class="APPLICATION">Privoxy</span> will look for a
! file named <span class="QUOTE">"config"</span> in the current
! directory (except on Win32 where it will look for <span class=
! "QUOTE">"config.txt"</span> instead). Specify full path to
! avoid confusion. If no config file is found, <span class=
! "APPLICATION">Privoxy</span> will fail to start.
! </p>
! </li>
! </ul>
! <p>
! On <span class="APPLICATION">MS Windows</span> only there are two
! additional command-line options to allow <span class=
! "APPLICATION">Privoxy</span> to install and run as a <span class=
! "emphasis"><i class="EMPHASIS">service</i></span>. See the <a href=
! "installation.html#INSTALLATION-PACK-WIN">Window Installation
! section</a> for details.
! </p>
! </div>
! </div>
! <div class="NAVFOOTER">
! <hr align="LEFT" width="100%">
! <table summary="Footer navigation table" width="100%" border="0"
! cellpadding="0" cellspacing="0">
<tr>
! <td width="33%" align="left" valign="top">
! <a href="quickstart.html" accesskey="P">Prev</a>
! </td>
! <td width="34%" align="center" valign="top">
! <a href="index.html" accesskey="H">Home</a>
! </td>
! <td width="33%" align="right" valign="top">
! <a href="configuration.html" accesskey="N">Next</a>
</td>
</tr>
<tr>
! <td width="33%" align="left" valign="top">
! Quickstart to Using Privoxy
! </td>
! <td width="34%" align="center" valign="top">
!
! </td>
! <td width="33%" align="right" valign="top">
! Privoxy Configuration
</td>
</tr>
</table>
</div>
- </body>
- </html>
--- 1,414 ----
! <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
! "http://www.w3.org/TR/html4/loose.dtd">
!
<html>
! <head>
! <title>Starting Privoxy</title>
! <meta name="GENERATOR" content=
! "Modular DocBook HTML Stylesheet Version 1.79">
! <link rel="HOME" title="Privoxy 3.0.26 User Manual" href="index.html">
! <link rel="PREVIOUS" title="Quickstart to Using Privoxy" href=
! "quickstart.html">
! <link rel="NEXT" title="Privoxy Configuration" href="configuration.html">
! <link rel="STYLESHEET" type="text/css" href="../p_doc.css">
! <meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
! <link rel="STYLESHEET" type="text/css" href="p_doc.css">
! </head>
!
! <body class="SECT1" bgcolor="#EEEEEE" text="#000000" link="#0000FF" vlink=
! "#840084" alink="#0000FF">
! <div class="NAVHEADER">
! <table summary="Header navigation table" width="100%" border="0"
! cellpadding="0" cellspacing="0">
! <tr>
! <th colspan="3" align="center">Privoxy 3.0.26 User Manual</th>
! </tr>
!
! <tr>
! <td width="10%" align="left" valign="bottom"><a href=
! "quickstart.html" accesskey="P">Prev</a></td>
!
! <td width="80%" align="center" valign="bottom"></td>
!
! <td width="10%" align="right" valign="bottom"><a href=
! "configuration.html" accesskey="N">Next</a></td>
! </tr>
! </table>
! <hr align="left" width="100%">
! </div>
!
! <div class="SECT1">
! <h1 class="SECT1"><a name="STARTUP" id="STARTUP">5. Starting
! Privoxy</a></h1>
!
! <p>Before launching <span class="APPLICATION">Privoxy</span> for the
! first time, you will want to configure your browser(s) to use
! <span class="APPLICATION">Privoxy</span> as a HTTP and HTTPS (SSL)
! <a href="http://en.wikipedia.org/wiki/Proxy_server" target=
! "_top">proxy</a>. The default is 127.0.0.1 (or localhost) for the proxy
! address, and port 8118 (earlier versions used port 8000). This is the one
! configuration step <span class="emphasis"><i class="EMPHASIS">that must
! be done</i></span>!</p>
!
! <p>Please note that <span class="APPLICATION">Privoxy</span> can only
! proxy HTTP and HTTPS traffic. It will not work with FTP or other
! protocols.</p>
!
! <div class="FIGURE">
! <a name="AEN712" id="AEN712"></a>
!
! <p><b>Figure 2. Proxy Configuration Showing Mozilla/Netscape HTTP and
! HTTPS (SSL) Settings</b></p>
!
! <div class="MEDIAOBJECT">
! <p><img src="proxy_setup.jpg"></p>
! </div>
! </div>
!
! <p>With <span class="APPLICATION">Firefox</span>, this is typically set
! under:</p>
!
! <p class="LITERALLAYOUT"> <span class=
! "GUIBUTTON">Tools</span> -> <span class=
! "GUIBUTTON">Options</span> -> <span class=
! "GUIBUTTON">Advanced</span> -> <span class=
! "GUIBUTTON">Network</span> -><span class=
! "GUIBUTTON">Connection</span> -> <span class=
! "GUIBUTTON">Settings</span><br></p>
!
! <p>Or optionally on some platforms:</p>
!
! <p class="LITERALLAYOUT"> <span class=
! "GUIBUTTON">Edit</span> -> <span class=
! "GUIBUTTON">Preferences</span> -> <span class=
! "GUIBUTTON">General</span> -> <span class=
! "GUIBUTTON">Connection Settings</span> -> <span class=
! "GUIBUTTON">Manual Proxy Configuration</span><br></p>
!
! <p>With <span class="APPLICATION">Netscape</span> (and <span class=
! "APPLICATION">Mozilla</span>), this can be set under:</p>
!
! <p class="LITERALLAYOUT"> <span class=
! "GUIBUTTON">Edit</span> -> <span class=
! "GUIBUTTON">Preferences</span> -> <span class=
! "GUIBUTTON">Advanced</span> -> <span class=
! "GUIBUTTON">Proxies</span> -> <span class="GUIBUTTON">HTTP
! Proxy</span><br></p>
!
! <p>For <span class="APPLICATION">Internet Explorer v.5-7</span>:</p>
!
! <p class="LITERALLAYOUT"> <span class=
! "GUIBUTTON">Tools</span> -> <span class="GUIBUTTON">Internet
! Options</span> -> <span class=
! "GUIBUTTON">Connections</span> -> <span class=
! "GUIBUTTON">LAN Settings</span></p>
!
! <p>Then, check <span class="QUOTE">"Use Proxy"</span> and fill in the
! appropriate info (Address: 127.0.0.1, Port: 8118). Include HTTPS (SSL),
! if you want HTTPS proxy support too (sometimes labeled <span class=
! "QUOTE">"Secure"</span>). Make sure any checkboxes like <span class=
! "QUOTE">"Use the same proxy server for all protocols"</span> is
! <span class="emphasis"><i class="EMPHASIS">UNCHECKED</i></span>. You want
! only HTTP and HTTPS (SSL)!</p>
!
! <div class="FIGURE">
! <a name="AEN757" id="AEN757"></a>
!
! <p><b>Figure 3. Proxy Configuration Showing Internet Explorer HTTP and
! HTTPS (Secure) Settings</b></p>
!
! <div class="MEDIAOBJECT">
! <p><img src="proxy2.jpg"></p>
! </div>
! </div>
!
! <p>After doing this, flush your browser's disk and memory caches to force
! a re-reading of all pages and to get rid of any ads that may be cached.
! Remove any <a href="http://en.wikipedia.org/wiki/Browser_cookie" target=
! "_top">cookies</a>, if you want <span class="APPLICATION">Privoxy</span>
! to manage that. You are now ready to start enjoying the benefits of using
! <span class="APPLICATION">Privoxy</span>!</p>
!
! <p><span class="APPLICATION">Privoxy</span> itself is typically started
! by specifying the main configuration file to be used on the command line.
! If no configuration file is specified on the command line, <span class=
! "APPLICATION">Privoxy</span> will look for a file named <tt class=
! "FILENAME">config</tt> in the current directory. Except on Win32 where it
! will try <tt class="FILENAME">config.txt</tt>.</p>
!
! <div class="SECT2">
! <h2 class="SECT2"><a name="START-DEBIAN" id="START-DEBIAN">5.1.
! Debian</a></h2>
!
! <p>We use a script. Note that Debian typically starts <span class=
! "APPLICATION">Privoxy</span> upon booting per default. It will use the
! file <tt class="FILENAME">/etc/privoxy/config</tt> as its main
! configuration file.</p>
!
! <table border="0" bgcolor="#E0E0E0" width="100%">
<tr>
! <td>
! <pre class="SCREEN">
! # /etc/init.d/privoxy start
! </pre>
</td>
</tr>
</table>
</div>
! <div class="SECT2">
! <h2 class="SECT2"><a name="START-FREEBSD" id="START-FREEBSD">5.2.
! FreeBSD and ElectroBSD</a></h2>
! <p>To start <span class="APPLICATION">Privoxy</span> upon booting, add
! "privoxy_enable='YES'" to <tt class="FILENAME">/etc/rc.conf</tt>.
! <span class="APPLICATION">Privoxy</span> will use <tt class=
! "FILENAME">/usr/local/etc/privoxy/config</tt> as its main configuration
! file.</p>
! <p>If you installed <span class="APPLICATION">Privoxy</span> into a
! jail, the paths above are relative to the jail root.</p>
! <p>To start <span class="APPLICATION">Privoxy</span> manually, run:</p>
!
! <table border="0" bgcolor="#E0E0E0" width="100%">
<tr>
! <td>
! <pre class="SCREEN">
! # service privoxy onestart
! </pre>
</td>
</tr>
+ </table>
+ </div>
+
+ <div class="SECT2">
+ <h2 class="SECT2"><a name="START-WINDOWS" id="START-WINDOWS">5.3.
+ Windows</a></h2>
+
+ <p>Click on the <span class="APPLICATION">Privoxy</span> Icon to start
+ <span class="APPLICATION">Privoxy</span>. If no configuration file is
+ specified on the command line, <span class="APPLICATION">Privoxy</span>
+ will look for a file named <tt class="FILENAME">config.txt</tt>. Note
+ that Windows will automatically start <span class=
+ "APPLICATION">Privoxy</span> when the system starts if you chose that
+ option when installing.</p>
+
+ <p><span class="APPLICATION">Privoxy</span> can run with full Windows
+ service functionality. On Windows only, the <span class=
+ "APPLICATION">Privoxy</span> program has two new command line arguments
+ to install and uninstall <span class="APPLICATION">Privoxy</span> as a
+ service. See the <a href=
+ "installation.html#INSTALLATION-PACK-WIN">Windows Installation
+ instructions</a> for details.</p>
+ </div>
+
+ <div class="SECT2">
+ <h2 class="SECT2"><a name="START-UNICES" id="START-UNICES">5.4. Generic
+ instructions for Unix derivates (Solaris, NetBSD, HP-UX etc.)</a></h2>
+
+ <p>Example Unix startup command:</p>
+
+ <table border="0" bgcolor="#E0E0E0" width="100%">
<tr>
! <td>
! <pre class="SCREEN">
! # /usr/sbin/privoxy --user privoxy /etc/privoxy/config
! </pre>
</td>
</tr>
</table>
+
+ <p>Note that if you installed <span class="APPLICATION">Privoxy</span>
+ through a package manager, the package will probably contain a
+ platform-specific script or configuration file to start <span class=
+ "APPLICATION">Privoxy</span> upon boot.</p>
</div>
+ <div class="SECT2">
+ <h2 class="SECT2"><a name="START-OS2" id="START-OS2">5.5. OS/2</a></h2>
+
+ <p>During installation, <span class="APPLICATION">Privoxy</span> is
+ configured to start automatically when the system restarts. You can
+ start it manually by double-clicking on the <span class=
+ "APPLICATION">Privoxy</span> icon in the <span class=
+ "APPLICATION">Privoxy</span> folder.</p>
+ </div>
+
+ <div class="SECT2">
+ <h2 class="SECT2"><a name="START-MACOSX" id="START-MACOSX">5.6. Mac OS
+ X</a></h2>
+
+ <p>The privoxy service will automatically start after a successful
+ installation (and thereafter every time your computer starts up)
+ however you will need to configure your web browser(s) to use it. To do
+ so, configure them to use a proxy for HTTP and HTTPS at the address
+ 127.0.0.1:8118.</p>
+
+ <p>To prevent the privoxy service from automatically starting when your
+ computer starts up, remove or rename the file <tt class=
+ "LITERAL">/Library/LaunchDaemons/org.ijbswa.privoxy.plist</tt> (on OS X
+ 10.5 and higher) or the folder named <tt class=
+ "LITERAL">/Library/StartupItems/Privoxy</tt> (on OS X 10.4
+ 'Tiger').</p>
+
+ <p>To manually start or stop the privoxy service, use the scripts
+ startPrivoxy.sh and stopPrivoxy.sh supplied in /Applications/Privoxy.
+ They must be run from an administrator account, using sudo.</p>
+ </div>
+
+ <div class="SECT2">
+ <h2 class="SECT2"><a name="CMDOPTIONS" id="CMDOPTIONS">5.7. Command
+ Line Options</a></h2>
+
+ <p><span class="APPLICATION">Privoxy</span> may be invoked with the
+ following command-line options:</p>
+
+ <ul>
+ <li>
+ <p><span class="emphasis"><i class=
+ "EMPHASIS">--config-test</i></span></p>
+
+ <p>Exit after loading the configuration files before binding to the
+ listen address. The exit code signals whether or not the
+ configuration files have been successfully loaded.</p>
+
+ <p>If the exit code is 1, at least one of the configuration files
+ is invalid, if it is 0, all the configuration files have been
+ successfully loaded (but may still contain errors that can
+ currently only be detected at run time).</p>
+
+ <p>This option doesn't affect the log setting, combination with
+ <span class="emphasis"><i class="EMPHASIS">--no-daemon</i></span>
+ is recommended if a configured log file shouldn't be used.</p>
+ </li>
+
+ <li>
+ <p><span class="emphasis"><i class=
+ "EMPHASIS">--version</i></span></p>
+
+ <p>Print version info and exit. Unix only.</p>
+ </li>
+
+ <li>
+ <p><span class="emphasis"><i class="EMPHASIS">--help</i></span></p>
+
+ <p>Print short usage info and exit. Unix only.</p>
+ </li>
+
+ <li>
+ <p><span class="emphasis"><i class=
+ "EMPHASIS">--no-daemon</i></span></p>
+
+ <p>Don't become a daemon, i.e. don't fork and become process group
+ leader, and don't detach from controlling tty. Unix only.</p>
+ </li>
+
+ <li>
+ <p><span class="emphasis"><i class="EMPHASIS">--pidfile
+ FILE</i></span></p>
+
+ <p>On startup, write the process ID to <span class=
+ "emphasis"><i class="EMPHASIS">FILE</i></span>. Delete the
+ <span class="emphasis"><i class="EMPHASIS">FILE</i></span> on exit.
+ Failure to create or delete the <span class="emphasis"><i class=
+ "EMPHASIS">FILE</i></span> is non-fatal. If no <span class=
+ "emphasis"><i class="EMPHASIS">FILE</i></span> option is given, no
+ PID file will be used. Unix only.</p>
+ </li>
+
+ <li>
+ <p><span class="emphasis"><i class="EMPHASIS">--user
+ USER[.GROUP]</i></span></p>
+
+ <p>After (optionally) writing the PID file, assume the user ID of
+ <span class="emphasis"><i class="EMPHASIS">USER</i></span>, and if
+ included the GID of GROUP. Exit if the privileges are not
+ sufficient to do so. Unix only.</p>
+ </li>
+
+ <li>
+ <p><span class="emphasis"><i class=
+ "EMPHASIS">--chroot</i></span></p>
+
+ <p>Before changing to the user ID given in the <span class=
+ "emphasis"><i class="EMPHASIS">--user</i></span> option, chroot to
+ that user's home directory, i.e. make the kernel pretend to the
+ <span class="APPLICATION">Privoxy</span> process that the directory
+ tree starts there. If set up carefully, this can limit the impact
+ of possible vulnerabilities in <span class=
+ "APPLICATION">Privoxy</span> to the files contained in that
+ hierarchy. Unix only.</p>
+ </li>
+
+ <li>
+ <p><span class="emphasis"><i class="EMPHASIS">--pre-chroot-nslookup
+ hostname</i></span></p>
+
+ <p>Specifies a hostname (for example www.privoxy.org) to look up
+ before doing a chroot. On some systems, initializing the resolver
+ library involves reading config files from /etc and/or loading
+ additional shared libraries from /lib. On these systems, doing a
+ hostname lookup before the chroot reduces the number of files that
+ must be copied into the chroot tree.</p>
+
+ <p>For fastest startup speed, a good value is a hostname that is
+ not in /etc/hosts but that your local name server (listed in
+ /etc/resolv.conf) can resolve without recursion (that is, without
+ having to ask any other name servers). The hostname need not exist,
+ but if it doesn't, an error message (which can be ignored) will be
+ output.</p>
+ </li>
+
+ <li>
+ <p><span class="emphasis"><i class=
+ "EMPHASIS">configfile</i></span></p>
+
+ <p>If no <span class="emphasis"><i class=
+ "EMPHASIS">configfile</i></span> is included on the command line,
+ <span class="APPLICATION">Privoxy</span> will look for a file named
+ <span class="QUOTE">"config"</span> in the current directory
+ (except on Win32 where it will look for <span class=
+ "QUOTE">"config.txt"</span> instead). Specify full path to avoid
+ confusion. If no config file is found, <span class=
+ "APPLICATION">Privoxy</span> will fail to start.</p>
+ </li>
+ </ul>
+
+ <p>On <span class="APPLICATION">MS Windows</span> only there are two
+ additional command-line options to allow <span class=
+ "APPLICATION">Privoxy</span> to install and run as a <span class=
+ "emphasis"><i class="EMPHASIS">service</i></span>. See the <a href=
+ "installation.html#INSTALLATION-PACK-WIN">Window Installation
+ section</a> for details.</p>
+ </div>
+ </div>
+
+ <div class="NAVFOOTER">
+ <hr align="left" width="100%">
+
+ <table summary="Footer navigation table" width="100%" border="0"
+ cellpadding="0" cellspacing="0">
+ <tr>
+ <td width="33%" align="left" valign="top"><a href="quickstart.html"
+ accesskey="P">Prev</a></td>
+
+ <td width="34%" align="center" valign="top"><a href="index.html"
+ accesskey="H">Home</a></td>
+
+ <td width="33%" align="right" valign="top"><a href=
+ "configuration.html" accesskey="N">Next</a></td>
+ </tr>
+
+ <tr>
+ <td width="33%" align="left" valign="top">Quickstart to Using
+ Privoxy</td>
+
+ <td width="34%" align="center" valign="top"> </td>
+
+ <td width="33%" align="right" valign="top">Privoxy Configuration</td>
+ </tr>
+ </table>
+ </div>
+ </body>
+ </html>
Index: contact.html
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/contact.html,v
retrieving revision 1.67
retrieving revision 1.68
diff -C2 -d -r1.67 -r1.68
*** contact.html 28 Jul 2016 08:25:50 -0000 1.67
--- contact.html 26 Aug 2016 03:45:37 -0000 1.68
***************
*** 1,417 ****
! <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01
! Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
<html>
! <head>
! <title>
! Contacting the Developers, Bug Reporting and Feature Requests
! </title>
! <meta name="GENERATOR" content=
! "Modular DocBook HTML Stylesheet Version 1.79">
! <link rel="HOME" title="Privoxy 3.0.26 User Manual" href="index.html">
! <link rel="PREVIOUS" title="Privoxy's Template Files" href=
! "templates.html">
! <link rel="NEXT" title="Privoxy Copyright, License and History" href=
! "copyright.html">
! <link rel="STYLESHEET" type="text/css" href="../p_doc.css">
! <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
! <link rel="STYLESHEET" type="text/css" href="p_doc.css">
! </head>
! <body class="SECT1" bgcolor="#EEEEEE" text="#000000" link="#0000FF" vlink=
! "#840084" alink="#0000FF">
! <div class="NAVHEADER">
! <table summary="Header navigation table" width="100%" border="0"
! cellpadding="0" cellspacing="0">
! <tr>
! <th colspan="3" align="center">
! Privoxy 3.0.26 User Manual
! </th>
! </tr>
! <tr>
! <td width="10%" align="left" valign="bottom">
! <a href="templates.html" accesskey="P">Prev</a>
! </td>
! <td width="80%" align="center" valign="bottom">
! </td>
! <td width="10%" align="right" valign="bottom">
! <a href="copyright.html" accesskey="N">Next</a>
! </td>
! </tr>
! </table>
! <hr align="LEFT" width="100%">
! </div>
! <div class="SECT1">
! <h1 class="SECT1">
! <a name="CONTACT">11. Contacting the Developers, Bug Reporting and
! Feature Requests</a>
! </h1>
! <p>
! We value your feedback. In fact, we rely on it to improve <span
! class="APPLICATION">Privoxy</span> and its configuration. However,
! please note the following hints, so we can provide you with the best
! support.
! </p>
! <div class="SECT2">
! <h2 class="SECT2">
! <a name="SUFFICIENT-INFORMATION">11.1. Please provide sufficient
! information</a>
! </h2>
! <p>
! A lot of support requests don't contain enough information and
! can't be solved without a lot of back and forth which causes
! unnecessary delays. Reading this section should help to prevent
! that.
! </p>
! <p>
! Before contacting us to report a problem, please try to verify that
! it is a <span class="APPLICATION">Privoxy</span> problem, and not a
! browser or site problem or documented behaviour that just happens
! to be different than what you expected. If unsure, try <a href=
! "http://config.privoxy.org/toggle?set=disable" target=
! "_top">toggling off</a> <span class="APPLICATION">Privoxy</span>,
! and see if the problem persists.
! </p>
! <p>
! If you are using your own custom configuration, please try the
! default configuration to see if the problem is configuration
! related. If you're having problems with a feature that is disabled
! by default, please ask around on the mailing list if others can
! reproduce the problem.
! </p>
! <p>
! If you aren't using the latest Privoxy version, the problem may
! have been found and fixed in the meantime. We would appreciate if
! you could take the time to <a href=
! "https://www.privoxy.org/user-manual/installation.html" target=
! "_top">upgrade to the latest version</a> and verify that the
! problem still exists.
! </p>
! <p>
! Please be sure to provide the following information when reporting
! problems or requesting support:
! </p>
! <p>
! </p>
! <ul>
! <li>
! <p>
! The exact <span class="APPLICATION">Privoxy</span> version you
! are using.
! </p>
! </li>
! <li>
! <p>
! The operating system and versions you run <span class=
! "APPLICATION">Privoxy</span> on, e.g. <span class=
! "APPLICATION">Windows XP SP2</span>.
! </p>
! </li>
! <li>
! <p>
! The name, platform, and version of the <span class=
! "APPLICATION">browser</span> you were using (e.g. <span class=
! "APPLICATION">Internet Explorer v5.5</span> for Mac).
! </p>
! </li>
! <li>
! <p>
! The URL where the problem occurred, or some way for us to
! duplicate the problem (e.g. <tt class=
! "LITERAL">http://somesite.example.com/?somethingelse=123</tt>).
! </p>
! </li>
! <li>
! <p>
! Whether your version of <span class=
! "APPLICATION">Privoxy</span> is one supplied by the <span
! class="APPLICATION">Privoxy</span> developers via SourceForge,
! or if you got your copy somewhere else.
! </p>
! </li>
! <li>
! <p>
! Whether you are using <span class="APPLICATION">Privoxy</span>
! together with another proxy such as <span class=
! "APPLICATION">Tor</span>. If so, please temporary disable the
! other proxy to see if the symptoms change.
! </p>
! </li>
! <li>
! <p>
! Whether you are using a personal firewall product. If so, does
! <span class="APPLICATION">Privoxy</span> work without it?
! </p>
! </li>
! <li>
! <p>
! Any other pertinent information to help identify the problem
! such as config or log file excerpts (yes, you should have log
! file entries for each action taken). To get a meaningful
! logfile, please make sure that the <a href=
! "../user-manual/config.html#LOGFILE" target="_top">logfile
! directive</a> is being used and the following <a href=
! "../user-manual/config.html#DEBUG" target="_top">debug
! options</a> are enabled (all of them):
! </p>
! <p class="LITERALLAYOUT">
! debug 1 # Log the destination for each request Privoxy let through. See also debug 1024.<br>
! debug 2 # show each connection status<br>
! debug 4 # show I/O status<br>
! debug 8 # show header parsing<br>
! debug 128 # debug redirects<br>
! debug 256 # debug GIF de-animation<br>
! debug 512 # Common Log Format<br>
! debug 1024 # Log the destination for requests Privoxy didn't let through, and the reason why.<br>
! debug 4096 # Startup banner and warnings.<br>
! debug 8192 # Non-fatal errors
! </p>
! <p>
! If you are having trouble with a filter, please additionally
! enable
! </p>
! <p class="LITERALLAYOUT">
! debug 64 # debug regular expression filters
! </p>
! If you are using Privoxy 3.0.17 or later and suspect that it
! interprets the request or the response incorrectly, please enable
! <p class="LITERALLAYOUT">
! debug 32768 # log all data read from the network
! </p>
! <p>
! It's easy for us to ignore log messages that aren't relevant
! but missing log messages may make it impossible to investigate
! a problem. If you aren't sure which of the debug directives are
! relevant, please just enable all of them and let us worry about
! it.
! </p>
! <p>
! Note that Privoxy log files may contain sensitive information
! so please don't submit any logfiles you didn't read first. You
! can mask sensitive information as long as it's clear that you
! removed something.
! </p>
! </li>
! </ul>
! <p>
! You don't have to tell us your actual name when filing a problem
! report, but if you don't, please use a nickname so we can
! differentiate between your messages and the ones entered by other
! "anonymous" users that may respond to your request if they have the
! same problem or already found a solution. Note that due to spam the
! trackers may not always allow to post without being logged into
! SourceForge. If that's the case, you are still free to create a
! login that isn't directly linked to your name, though.
! </p>
! <p>
! Please also check the status of your request a few days after
! submitting it, as we may request additional information. If you use
! a SF id, you should automatically get a mail when someone responds
! to your request. Please don't bother to add an email address when
! using the tracker. If you prefer to communicate through email, just
! use one of the mailing lists directly.
! </p>
! <p>
! If you are new to reporting problems, you might be interested in <a
! href="http://www.chiark.greenend.org.uk/~sgtatham/bugs.html"
! target="_top">How to Report Bugs Effectively</a>.
! </p>
! <p>
! The <a href=
! "https://www.privoxy.org/user-manual/appendix.html#ACTIONSANAT"
! target="_top">appendix of the Privoxy User Manual</a> also has
! helpful information on understanding <tt class=
! "LITERAL">actions</tt>, and <tt class="LITERAL">action</tt>
! debugging.
! </p>
! </div>
! <div class="SECT2">
! <h2 class="SECT2">
! <a name="CONTACT-SUPPORT">11.2. Get Support</a>
! </h2>
! <p>
! All users are welcome to discuss their issues on the <a href=
! "https://lists.privoxy.org/mailman/listinfo/privoxy-users" target=
! "_top">users mailing list</a>, where the developers also hang
! around.
! </p>
! <p>
! Please don't send private support requests to individual Privoxy
! developers, either use the mailing lists or the support trackers.
! </p>
! <p>
! If you have to contact a Privoxy developer directly for other
! reasons, please send a real mail and do not bother with
! SourceForge's messaging system. Answers to SourceForge messages are
! usually bounced by SourceForge's mail server in which case the
! developer wasted time writing a response you don't get. From your
! point of view it will look like your message has been completely
! ignored, so this is frustrating for all parties involved.
! </p>
! <p>
! Note that the Privoxy mailing lists are moderated. Posts from
! unsubscribed addresses have to be accepted manually by a moderator.
! This may cause a delay of several days and if you use a subject
! that doesn't clearly mention Privoxy or one of its features, your
! message may be accidentally discarded as spam.
! </p>
! <p>
! If you aren't subscribed, you should therefore spend a few seconds
! to come up with a proper subject. Additionally you should make it
! clear that you want to get CC'd. Otherwise some responses will be
! directed to the mailing list only, and you won't see them.
! </p>
! </div>
! <div class="SECT2">
! <h2 class="SECT2">
! <a name="REPORTING">11.3. Reporting Problems</a>
! </h2>
! <p>
! <span class="QUOTE">"Problems"</span> for our purposes, come in two
! forms:
! </p>
! <ul>
! <li>
! <p>
! Configuration issues, such as ads that slip through, or sites
! that don't function properly due to one <span class=
! "APPLICATION">Privoxy</span> <span class=
! "QUOTE">"action"</span> or another being turned <span class=
! "QUOTE">"on"</span>.
! </p>
! </li>
! <li>
! <p>
! <span class="QUOTE">"Bugs"</span> in the programming code that
! makes up <span class="APPLICATION">Privoxy</span>, such as that
! might cause a crash. Documentation issues, for example spelling
! errors and unclear descriptions, are bugs, too.
! </p>
! </li>
! </ul>
! <div class="SECT3">
! <h3 class="SECT3">
! <a name="CONTACT-ADS">11.3.1. Reporting Ads or Other
! Configuration Problems</a>
! </h3>
! <p>
! Please send feedback on ads that slipped through, innocent images
! that were blocked, sites that don't work properly, and other
! configuration related problem of <tt class=
! "FILENAME">default.action</tt> file, to <a href=
! "https://sourceforge.net/tracker/?group_id=11118&atid=460288"
! target=
! "_top">https://sourceforge.net/tracker/?group_id=11118&atid=460288</a>,
! the Actions File Tracker.
! </p>
! </div>
! <div class="SECT3">
! <h3 class="SECT3">
! <a name="CONTACT-BUGS">11.3.2. Reporting Bugs</a>
! </h3>
! <p>
! Before reporting bugs, please make sure that the bug has <span
! class="emphasis"><i class="EMPHASIS">not already been
! submitted</i></span> and observe the additional hints at the top
! of the <a href=
! "https://sourceforge.net/tracker/?func=add&group_id=11118&atid=111118"
! target="_top">submit form</a>. If already submitted, please feel
! free to add any info to the original report that might help to
! solve the issue.
! </p>
! </div>
! </div>
! <div class="SECT2">
! <h2 class="SECT2">
! <a name="SECURITY-CONTACT">11.4. Reporting security problems</a>
! </h2>
! <p>
! If you discovered a security problem or merely suspect that a bug
! might be a security issue, please mail Fabian Keil
! <[email protected]> (OpenPGP fingerprint: 4F36 C17F 3816 9136
! 54A1 E850 6918 2291 8BA2 371C).
! </p>
! <p>
! Usually you should get a response within a day, otherwise it's
! likely that either your mail or the response didn't make it. If
! that happens, please mail to the developer list to request a status
! update.
! </p>
! </div>
! <div class="SECT2">
! <h2 class="SECT2">
! <a name="MAILING-LISTS">11.5. Mailing Lists</a>
! </h2>
! <p>
! If you prefer to communicate through email, instead of using a web
! interface, feel free to use one of the mailing lists. To discuss
! issues that haven't been completely diagnosed yet, please use the
! Privoxy users list. Technically interested users and people who
! wish to contribute to the project are always welcome on the
! developers list. You can find an overview of all <span class=
! "APPLICATION">Privoxy</span>-related mailing lists, including list
! archives, at: <a href="https://lists.privoxy.org/mailman/listinfo"
! target="_top">https://lists.privoxy.org/mailman/listinfo</a>. The
! lists hosted on privoxy.org have been created in 2016, the
! previously-used lists hosted at SourceForge are deprecated but the
! archives may still be useful: <a href=
! "https://sourceforge.net/mail/?group_id=11118" target=
! "_top">https://sourceforge.net/mail/?group_id=11118</a>.
! </p>
</div>
! <div class="SECT2">
! <h2 class="SECT2">
! <a name="SF-TRACKERS">11.6. SourceForge support trackers</a>
! </h2>
! <p>
! The <a href=
! "https://sourceforge.net/tracker/?group_id=11118&atid=211118"
! target="_top">SourceForge support trackers</a> may be used as well,
! but have various technical problems that are unlikely to be fixed
! anytime soon. If you don't get a timely response, please try the
! mailing list as well.
! </p>
</div>
</div>
! <div class="NAVFOOTER">
! <hr align="LEFT" width="100%">
! <table summary="Footer navigation table" width="100%" border="0"
! cellpadding="0" cellspacing="0">
! <tr>
! <td width="33%" align="left" valign="top">
! <a href="templates.html" accesskey="P">Prev</a>
! </td>
! <td width="34%" align="center" valign="top">
! <a href="index.html" accesskey="H">Home</a>
! </td>
! <td width="33%" align="right" valign="top">
! <a href="copyright.html" accesskey="N">Next</a>
! </td>
! </tr>
! <tr>
! <td width="33%" align="left" valign="top">
! Privoxy's Template Files
! </td>
! <td width="34%" align="center" valign="top">
!
! </td>
! <td width="33%" align="right" valign="top">
! Privoxy Copyright, License and History
! </td>
! </tr>
! </table>
</div>
- </body>
- </html>
--- 1,365 ----
! <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
! "http://www.w3.org/TR/html4/loose.dtd">
!
<html>
! <head>
! <title>Contacting the Developers, Bug Reporting and Feature
! Requests</title>
! <meta name="GENERATOR" content=
! "Modular DocBook HTML Stylesheet Version 1.79">
! <link rel="HOME" title="Privoxy 3.0.26 User Manual" href="index.html">
! <link rel="PREVIOUS" title="Privoxy's Template Files" href=
! "templates.html">
! <link rel="NEXT" title="Privoxy Copyright, License and History" href=
! "copyright.html">
! <link rel="STYLESHEET" type="text/css" href="../p_doc.css">
! <meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
! <link rel="STYLESHEET" type="text/css" href="p_doc.css">
! </head>
! <body class="SECT1" bgcolor="#EEEEEE" text="#000000" link="#0000FF" vlink=
! "#840084" alink="#0000FF">
! <div class="NAVHEADER">
! <table summary="Header navigation table" width="100%" border="0"
! cellpadding="0" cellspacing="0">
! <tr>
! <th colspan="3" align="center">Privoxy 3.0.26 User Manual</th>
! </tr>
! <tr>
! <td width="10%" align="left" valign="bottom"><a href="templates.html"
! accesskey="P">Prev</a></td>
! <td width="80%" align="center" valign="bottom"></td>
! <td width="10%" align="right" valign="bottom"><a href=
! "copyright.html" accesskey="N">Next</a></td>
! </tr>
! </table>
! <hr align="left" width="100%">
! </div>
! <div class="SECT1">
! <h1 class="SECT1"><a name="CONTACT" id="CONTACT">11. Contacting the
! Developers, Bug Reporting and Feature Requests</a></h1>
! <p>We value your feedback. In fact, we rely on it to improve <span class=
! "APPLICATION">Privoxy</span> and its configuration. However, please note
! the following hints, so we can provide you with the best support.</p>
! <div class="SECT2">
! <h2 class="SECT2"><a name="SUFFICIENT-INFORMATION" id=
! "SUFFICIENT-INFORMATION">11.1. Please provide sufficient
! information</a></h2>
! <p>A lot of support requests don't contain enough information and can't
! be solved without a lot of back and forth which causes unnecessary
! delays. Reading this section should help to prevent that.</p>
! <p>Before contacting us to report a problem, please try to verify that
! it is a <span class="APPLICATION">Privoxy</span> problem, and not a
! browser or site problem or documented behaviour that just happens to be
! different than what you expected. If unsure, try <a href=
! "http://config.privoxy.org/toggle?set=disable" target="_top">toggling
! off</a> <span class="APPLICATION">Privoxy</span>, and see if the
! problem persists.</p>
! <p>If you are using your own custom configuration, please try the
! default configuration to see if the problem is configuration related.
! If you're having problems with a feature that is disabled by default,
! please ask around on the mailing list if others can reproduce the
! problem.</p>
! <p>If you aren't using the latest Privoxy version, the problem may have
! been found and fixed in the meantime. We would appreciate if you could
! take the time to <a href=
! "https://www.privoxy.org/user-manual/installation.html" target=
! "_top">upgrade to the latest version</a> and verify that the problem
! still exists.</p>
! <p>Please be sure to provide the following information when reporting
! problems or requesting support:</p>
! <ul>
! <li>
! <p>The exact <span class="APPLICATION">Privoxy</span> version you
! are using.</p>
! </li>
!
! <li>
! <p>The operating system and versions you run <span class=
! "APPLICATION">Privoxy</span> on, e.g. <span class=
! "APPLICATION">Windows XP SP2</span>.</p>
! </li>
!
! <li>
! <p>The name, platform, and version of the <span class=
! "APPLICATION">browser</span> you were using (e.g. <span class=
! "APPLICATION">Internet Explorer v5.5</span> for Mac).</p>
! </li>
!
! <li>
! <p>The URL where the problem occurred, or some way for us to
! duplicate the problem (e.g. <tt class=
! "LITERAL">http://somesite.example.com/?somethingelse=123</tt>).</p>
! </li>
!
! <li>
! <p>Whether your version of <span class="APPLICATION">Privoxy</span>
! is one supplied by the <span class="APPLICATION">Privoxy</span>
! developers via SourceForge, or if you got your copy somewhere
! else.</p>
! </li>
!
! <li>
! <p>Whether you are using <span class="APPLICATION">Privoxy</span>
! together with another proxy such as <span class=
! "APPLICATION">Tor</span>. If so, please temporary disable the other
! proxy to see if the symptoms change.</p>
! </li>
!
! <li>
! <p>Whether you are using a personal firewall product. If so, does
! <span class="APPLICATION">Privoxy</span> work without it?</p>
! </li>
!
! <li>
! <p>Any other pertinent information to help identify the problem
! such as config or log file excerpts (yes, you should have log file
! entries for each action taken). To get a meaningful logfile, please
! make sure that the <a href="../user-manual/config.html#LOGFILE"
! target="_top">logfile directive</a> is being used and the following
! <a href="../user-manual/config.html#DEBUG" target="_top">debug
! options</a> are enabled (all of them):</p>
!
! <p class="LITERALLAYOUT">
! debug 1 # Log the destination for each request Privoxy let through. See also debug 1024.<br>
!
! debug 2 # show each connection status<br>
!
! debug 4 # show I/O status<br>
!
! debug 8 # show header parsing<br>
!
! debug 128 # debug redirects<br>
! debug 256 # debug GIF de-animation<br>
!
! debug 512 # Common Log Format<br>
!
! debug 1024 # Log the destination for requests Privoxy didn't let through, and the reason why.<br>
!
! debug 4096 # Startup banner and warnings.<br>
!
! debug 8192 # Non-fatal errors</p>
!
! <p>If you are having trouble with a filter, please additionally
! enable</p>
!
! <p class="LITERALLAYOUT">
! debug 64 # debug regular expression filters</p>If
! you are using Privoxy 3.0.17 or later and suspect that it
! interprets the request or the response incorrectly, please enable
!
! <p class="LITERALLAYOUT">
! debug 32768 # log all data read from the network</p>
!
! <p>It's easy for us to ignore log messages that aren't relevant but
! missing log messages may make it impossible to investigate a
! problem. If you aren't sure which of the debug directives are
! relevant, please just enable all of them and let us worry about
! it.</p>
!
! <p>Note that Privoxy log files may contain sensitive information so
! please don't submit any logfiles you didn't read first. You can
! mask sensitive information as long as it's clear that you removed
! something.</p>
! </li>
! </ul>
!
! <p>You don't have to tell us your actual name when filing a problem
! report, but if you don't, please use a nickname so we can differentiate
! between your messages and the ones entered by other "anonymous" users
! that may respond to your request if they have the same problem or
! already found a solution. Note that due to spam the trackers may not
! always allow to post without being logged into SourceForge. If that's
! the case, you are still free to create a login that isn't directly
! linked to your name, though.</p>
!
! <p>Please also check the status of your request a few days after
! submitting it, as we may request additional information. If you use a
! SF id, you should automatically get a mail when someone responds to
! your request. Please don't bother to add an email address when using
! the tracker. If you prefer to communicate through email, just use one
! of the mailing lists directly.</p>
!
! <p>If you are new to reporting problems, you might be interested in
! <a href="http://www.chiark.greenend.org.uk/~sgtatham/bugs.html" target=
! "_top">How to Report Bugs Effectively</a>.</p>
!
! <p>The <a href=
! "https://www.privoxy.org/user-manual/appendix.html#ACTIONSANAT" target=
! "_top">appendix of the Privoxy User Manual</a> also has helpful
! information on understanding <tt class="LITERAL">actions</tt>, and
! <tt class="LITERAL">action</tt> debugging.</p>
! </div>
!
! <div class="SECT2">
! <h2 class="SECT2"><a name="CONTACT-SUPPORT" id="CONTACT-SUPPORT">11.2.
! Get Support</a></h2>
!
! <p>All users are welcome to discuss their issues on the <a href=
! "https://lists.privoxy.org/mailman/listinfo/privoxy-users" target=
! "_top">users mailing list</a>, where the developers also hang
! around.</p>
!
! <p>Please don't send private support requests to individual Privoxy
! developers, either use the mailing lists or the support trackers.</p>
!
! <p>If you have to contact a Privoxy developer directly for other
! reasons, please send a real mail and do not bother with SourceForge's
! messaging system. Answers to SourceForge messages are usually bounced
! by SourceForge's mail server in which case the developer wasted time
! writing a response you don't get. From your point of view it will look
! like your message has been completely ignored, so this is frustrating
! for all parties involved.</p>
!
! <p>Note that the Privoxy mailing lists are moderated. Posts from
! unsubscribed addresses have to be accepted manually by a moderator.
! This may cause a delay of several days and if you use a subject that
! doesn't clearly mention Privoxy or one of its features, your message
! may be accidentally discarded as spam.</p>
!
! <p>If you aren't subscribed, you should therefore spend a few seconds
! to come up with a proper subject. Additionally you should make it clear
! that you want to get CC'd. Otherwise some responses will be directed to
! the mailing list only, and you won't see them.</p>
! </div>
!
! <div class="SECT2">
! <h2 class="SECT2"><a name="REPORTING" id="REPORTING">11.3. Reporting
! Problems</a></h2>
!
! <p><span class="QUOTE">"Problems"</span> for our purposes, come in two
! forms:</p>
!
! <ul>
! <li>
! <p>Configuration issues, such as ads that slip through, or sites
! that don't function properly due to one <span class=
! "APPLICATION">Privoxy</span> <span class="QUOTE">"action"</span> or
! another being turned <span class="QUOTE">"on"</span>.</p>
! </li>
!
! <li>
! <p><span class="QUOTE">"Bugs"</span> in the programming code that
! makes up <span class="APPLICATION">Privoxy</span>, such as that
! might cause a crash. Documentation issues, for example spelling
! errors and unclear descriptions, are bugs, too.</p>
! </li>
! </ul>
!
! <div class="SECT3">
! <h3 class="SECT3"><a name="CONTACT-ADS" id="CONTACT-ADS">11.3.1.
! Reporting Ads or Other Configuration Problems</a></h3>
!
! <p>Please send feedback on ads that slipped through, innocent images
! that were blocked, sites that don't work properly, and other
! configuration related problem of <tt class=
! "FILENAME">default.action</tt> file, to <a href=
! "https://sourceforge.net/tracker/?group_id=11118&atid=460288"
! target=
! "_top">https://sourceforge.net/tracker/?group_id=11118&atid=460288</a>,
! the Actions File Tracker.</p>
</div>
!
! <div class="SECT3">
! <h3 class="SECT3"><a name="CONTACT-BUGS" id="CONTACT-BUGS">11.3.2.
! Reporting Bugs</a></h3>
!
! <p>Before reporting bugs, please make sure that the bug has
! <span class="emphasis"><i class="EMPHASIS">not already been
! submitted</i></span> and observe the additional hints at the top of
! the <a href=
! "https://sourceforge.net/tracker/?func=add&group_id=11118&atid=111118"
! target="_top">submit form</a>. If already submitted, please feel free
! to add any info to the original report that might help to solve the
! issue.</p>
</div>
</div>
!
! <div class="SECT2">
! <h2 class="SECT2"><a name="SECURITY-CONTACT" id=
! "SECURITY-CONTACT">11.4. Reporting security problems</a></h2>
!
! <p>If you discovered a security problem or merely suspect that a bug
! might be a security issue, please mail Fabian Keil
! <[email protected]> (OpenPGP fingerprint: 4F36 C17F 3816 9136 54A1
! E850 6918 2291 8BA2 371C).</p>
!
! <p>Usually you should get a response within a day, otherwise it's
! likely that either your mail or the response didn't make it. If that
! happens, please mail to the developer list to request a status
! update.</p>
</div>
+ <div class="SECT2">
+ <h2 class="SECT2"><a name="MAILING-LISTS" id="MAILING-LISTS">11.5.
+ Mailing Lists</a></h2>
+
+ <p>If you prefer to communicate through email, instead of using a web
+ interface, feel free to use one of the mailing lists. To discuss issues
+ that haven't been completely diagnosed yet, please use the Privoxy
+ users list. Technically interested users and people who wish to
+ contribute to the project are always welcome on the developers list.
+ You can find an overview of all <span class=
+ "APPLICATION">Privoxy</span>-related mailing lists, including list
+ archives, at: <a href="https://lists.privoxy.org/mailman/listinfo"
+ target="_top">https://lists.privoxy.org/mailman/listinfo</a>. The lists
+ hosted on privoxy.org have been created in 2016, the previously-used
+ lists hosted at SourceForge are deprecated but the archives may still
+ be useful: <a href="https://sourceforge.net/mail/?group_id=11118"
+ target="_top">https://sourceforge.net/mail/?group_id=11118</a>.</p>
+ </div>
+
+ <div class="SECT2">
+ <h2 class="SECT2"><a name="SF-TRACKERS" id="SF-TRACKERS">11.6.
+ SourceForge support trackers</a></h2>
+
+ <p>The <a href=
+ "https://sourceforge.net/tracker/?group_id=11118&atid=211118"
+ target="_top">SourceForge support trackers</a> may be used as well, but
+ have various technical problems that are unlikely to be fixed anytime
+ soon. If you don't get a timely response, please try the mailing list
+ as well.</p>
+ </div>
+ </div>
+
+ <div class="NAVFOOTER">
+ <hr align="left" width="100%">
+
+ <table summary="Footer navigation table" width="100%" border="0"
+ cellpadding="0" cellspacing="0">
+ <tr>
+ <td width="33%" align="left" valign="top"><a href="templates.html"
+ accesskey="P">Prev</a></td>
+
+ <td width="34%" align="center" valign="top"><a href="index.html"
+ accesskey="H">Home</a></td>
+
+ <td width="33%" align="right" valign="top"><a href="copyright.html"
+ accesskey="N">Next</a></td>
+ </tr>
+
+ <tr>
+ <td width="33%" align="left" valign="top">Privoxy's Template
+ Files</td>
+
+ <td width="34%" align="center" valign="top"> </td>
+
+ <td width="33%" align="right" valign="top">Privoxy Copyright, License
+ and History</td>
+ </tr>
+ </table>
+ </div>
+ </body>
+ </html>
Index: filter-file.html
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/filter-file.html,v
retrieving revision 1.94
retrieving revision 1.95
diff -C2 -d -r1.94 -r1.95
*** filter-file.html 28 Jul 2016 08:25:50 -0000 1.94
--- filter-file.html 26 Aug 2016 03:45:37 -0000 1.95
***************
*** 1,149 ****
! <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01
! Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
<html>
! <head>
! <title>
! Filter Files
! </title>
! <meta name="GENERATOR" content=
! "Modular DocBook HTML Stylesheet Version 1.79">
! <link rel="HOME" title="Privoxy 3.0.26 User Manual" href="index.html">
[...2003 lines suppressed...]
+
+ <td width="34%" align="center" valign="top"><a href="index.html"
+ accesskey="H">Home</a></td>
+
+ <td width="33%" align="right" valign="top"><a href="templates.html"
+ accesskey="N">Next</a></td>
+ </tr>
+
+ <tr>
+ <td width="33%" align="left" valign="top">Actions Files</td>
+
+ <td width="34%" align="center" valign="top"> </td>
+
+ <td width="33%" align="right" valign="top">Privoxy's Template
+ Files</td>
+ </tr>
+ </table>
+ </div>
+ </body>
+ </html>
Index: configuration.html
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/configuration.html,v
retrieving revision 1.93
retrieving revision 1.94
diff -C2 -d -r1.93 -r1.94
*** configuration.html 28 Jul 2016 08:25:50 -0000 1.93
--- configuration.html 26 Aug 2016 03:45:37 -0000 1.94
***************
*** 1,308 ****
! <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01
! Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
<html>
! <head>
! <title>
! Privoxy Configuration
! </title>
! <meta name="GENERATOR" content=
! "Modular DocBook HTML Stylesheet Version 1.79">
! <link rel="HOME" title="Privoxy 3.0.26 User Manual" href="index.html">
! <link rel="PREVIOUS" title="Starting Privoxy" href="startup.html">
! <link rel="NEXT" title="The Main Configuration File" href="config.html">
! <link rel="STYLESHEET" type="text/css" href="../p_doc.css">
! <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
! <link rel="STYLESHEET" type="text/css" href="p_doc.css">
! </head>
! <body class="SECT1" bgcolor="#EEEEEE" text="#000000" link="#0000FF" vlink=
! "#840084" alink="#0000FF">
! <div class="NAVHEADER">
! <table summary="Header navigation table" width="100%" border="0"
! cellpadding="0" cellspacing="0">
! <tr>
! <th colspan="3" align="center">
! Privoxy 3.0.26 User Manual
! </th>
! </tr>
<tr>
! <td width="10%" align="left" valign="bottom">
! <a href="startup.html" accesskey="P">Prev</a>
! </td>
! <td width="80%" align="center" valign="bottom">
! </td>
! <td width="10%" align="right" valign="bottom">
! <a href="config.html" accesskey="N">Next</a>
! </td>
! </tr>
! </table>
! <hr align="LEFT" width="100%">
! </div>
! <div class="SECT1">
! <h1 class="SECT1">
! <a name="CONFIGURATION">6. Privoxy Configuration</a>
! </h1>
! <p>
! All <span class="APPLICATION">Privoxy</span> configuration is stored
! in text files. These files can be edited with a text editor. Many
! important aspects of <span class="APPLICATION">Privoxy</span> can
! also be controlled easily with a web browser.
! </p>
! <div class="SECT2">
! <h2 class="SECT2">
! <a name="CONTROL-WITH-WEBBROWSER">6.1. Controlling Privoxy with
! Your Web Browser</a>
! </h2>
! <p>
! <span class="APPLICATION">Privoxy</span>'s user interface can be
! reached through the special URL <a href=
! "http://config.privoxy.org/" target=
! "_top">http://config.privoxy.org/</a> (shortcut: <a href=
! "http://p.p/" target="_top">http://p.p/</a>), which is a built-in
! page and works without Internet access. You will see the following
! section:
! </p>
! <table border="0" bgcolor="#E0E0E0" width="100%">
! <tr>
! <td>
! <pre class="SCREEN">
</pre>
- <h2 class="BRIDGEHEAD">
- <a name="AEN859"></a> Privoxy Menu
- </h2>
- <pre>
- </pre>
- <table border="0">
- <tbody>
- <tr>
- <td>
- ▪ <a
- href="http://config.privoxy.org/show-status" target=
- "_top">View & change the current configuration</a>
- </td>
- </tr>
- <tr>
- <td>
- ▪ <a
- href="http://config.privoxy.org/show-version" target=
- "_top">View the source code version numbers</a>
- </td>
- </tr>
- <tr>
- <td>
- ▪ <a
- href="http://config.privoxy.org/show-request" target=
- "_top">View the request headers.</a>
- </td>
- </tr>
- <tr>
- <td>
- ▪ <a
- href="http://config.privoxy.org/show-url-info" target=
- "_top">Look up which actions apply to a URL and why</a>
! </td>
! </tr>
! <tr>
! <td>
! ▪ <a
! href="http://config.privoxy.org/toggle" target=
! "_top">Toggle Privoxy on or off</a>
! </td>
! </tr>
! <tr>
! <td>
! ▪ <a
! href="https://www.privoxy.org/3.0.26/user-manual/"
! target="_top">Documentation</a>
! </td>
! </tr>
! </tbody>
! </table>
! <pre>
</pre>
- </td>
- </tr>
- </table>
- <p>
- This should be self-explanatory. Note the first item leads to an
- editor for the <a href="actions-file.html">actions files</a>, which
- is where the ad, banner, cookie, and URL blocking magic is
- configured as well as other advanced features of <span class=
- "APPLICATION">Privoxy</span>. This is an easy way to adjust various
- aspects of <span class="APPLICATION">Privoxy</span> configuration.
- The actions file, and other configuration files, are explained in
- detail below.
- </p>
- <p>
- <span class="QUOTE">"Toggle Privoxy On or Off"</span> is handy for
- sites that might have problems with your current actions and
- filters. You can in fact use it as a test to see whether it is
- <span class="APPLICATION">Privoxy</span> causing the problem or
- not. <span class="APPLICATION">Privoxy</span> continues to run as a
- proxy in this case, but all manipulation is disabled, i.e. <span
- class="APPLICATION">Privoxy</span> acts like a normal forwarding
- proxy.
- </p>
- <p>
- Note that several of the features described above are disabled by
- default in <span class="APPLICATION">Privoxy</span> 3.0.7 beta and
- later. Check the <a href="config.html" target="_top">configuration
- file</a> to learn why and in which cases it's safe to enable them
- again.
- </p>
- </div>
- <div class="SECT2">
- <h2 class="SECT2">
- <a name="CONFOVERVIEW">6.2. Configuration Files Overview</a>
- </h2>
- <p>
- For Unix, *BSD and Linux, all configuration files are located in
- <tt class="FILENAME">/etc/privoxy/</tt> by default. For MS Windows,
- OS/2, and AmigaOS these are all in the same directory as the <span
- class="APPLICATION">Privoxy</span> executable. The name and number
- of configuration files has changed from previous versions, and is
- subject to change as development progresses.
- </p>
- <p>
- The installed defaults provide a reasonable starting point, though
- some settings may be aggressive by some standards. For the time
- being, the principle configuration files are:
- </p>
- <p>
- </p>
- <ul>
- <li>
- <p>
- The <a href="config.html">main configuration file</a> is named
- <tt class="FILENAME">config</tt> on Linux, Unix, BSD, OS/2, and
- AmigaOS and <tt class="FILENAME">config.txt</tt> on Windows.
- This is a required file.
- </p>
- </li>
- <li>
- <p>
- <tt class="FILENAME">match-all.action</tt> is used to define
- which <span class="QUOTE">"actions"</span> relating to
- banner-blocking, images, pop-ups, content modification, cookie
- handling etc should be applied by default. It should be the
- first actions file loaded.
- </p>
- <p>
- <tt class="FILENAME">default.action</tt> defines many
- exceptions (both positive and negative) from the default set of
- actions that's configured in <tt class=
- "FILENAME">match-all.action</tt>. It should be the second
- actions file loaded and shouldn't be edited by the user.
- </p>
- <p>
- Multiple actions files may be defined in <tt class=
- "FILENAME">config</tt>. These are processed in the order they
- are defined. Local customizations and locally preferred
- exceptions to the default policies as defined in <tt class=
- "FILENAME">match-all.action</tt> (which you will most probably
- want to define sooner or later) are best applied in <tt class=
- "FILENAME">user.action</tt>, where you can preserve them across
- upgrades. The file isn't installed by all installers, but you
- can easily create it yourself with a text editor.
- </p>
- <p>
- There is also a web based editor that can be accessed from <a
- href="http://config.privoxy.org/show-status" target=
- "_top">http://config.privoxy.org/show-status</a> (Shortcut: <a
- href="http://p.p/show-status" target=
- "_top">http://p.p/show-status</a>) for the various actions
- files.
- </p>
- </li>
- <li>
- <p>
- <span class="QUOTE">"Filter files"</span> (the <a href=
- "filter-file.html">filter file</a>) can be used to re-write the
- raw page content, including viewable text as well as embedded
- HTML and JavaScript, and whatever else lurks on any given web
- page. The filtering jobs are only pre-defined here; whether to
- apply them or not is up to the actions files. <tt class=
- "FILENAME">default.filter</tt> includes various filters made
- available for use by the developers. Some are much more
- intrusive than others, and all should be used with caution. You
- may define additional filter files in <tt class=
- "FILENAME">config</tt> as you can with actions files. We
- suggest <tt class="FILENAME">user.filter</tt> for any locally
- defined filters or customizations.
- </p>
- </li>
- </ul>
! <p>
! The syntax of the configuration and filter files may change between
! different Privoxy versions, unfortunately some enhancements cost
! backwards compatibility.
! </p>
! <p>
! All files use the <span class="QUOTE">"<tt class=
! "LITERAL">#</tt>"</span> character to denote a comment (the rest of
! the line will be ignored) and understand line continuation through
! placing a backslash ("<tt class="LITERAL">\</tt>") as the very last
! character in a line. If the <tt class="LITERAL">#</tt> is preceded
! by a backslash, it looses its special function. Placing a <tt
! class="LITERAL">#</tt> in front of an otherwise valid configuration
! line to prevent it from being interpreted is called "commenting
! out" that line. Blank lines are ignored.
! </p>
! <p>
! The actions files and filter files can use Perl style <a href=
! "appendix.html#REGEX">regular expressions</a> for maximum
! flexibility.
! </p>
! <p>
! After making any changes, there is no need to restart <span class=
! "APPLICATION">Privoxy</span> in order for the changes to take
! effect. <span class="APPLICATION">Privoxy</span> detects such
! changes automatically. Note, however, that it may take one or two
! additional requests for the change to take effect. When changing
! the listening address of <span class="APPLICATION">Privoxy</span>,
! these <span class="QUOTE">"wake up"</span> requests must obviously
! be sent to the <span class="emphasis"><i class=
! "EMPHASIS">old</i></span> listening address.
! </p>
! <p>
! While under development, the configuration content is subject to
! change. The below documentation may not be accurate by the time you
! read this. Also, what constitutes a <span class=
! "QUOTE">"default"</span> setting, may change, so please check all
! your configuration files on important issues.
! </p>
! </div>
! </div>
! <div class="NAVFOOTER">
! <hr align="LEFT" width="100%">
! <table summary="Footer navigation table" width="100%" border="0"
! cellpadding="0" cellspacing="0">
! <tr>
! <td width="33%" align="left" valign="top">
! <a href="startup.html" accesskey="P">Prev</a>
! </td>
! <td width="34%" align="center" valign="top">
! <a href="index.html" accesskey="H">Home</a>
! </td>
! <td width="33%" align="right" valign="top">
! <a href="config.html" accesskey="N">Next</a>
! </td>
! </tr>
! <tr>
! <td width="33%" align="left" valign="top">
! Starting Privoxy
! </td>
! <td width="34%" align="center" valign="top">
!
! </td>
! <td width="33%" align="right" valign="top">
! The Main Configuration File
</td>
</tr>
</table>
</div>
- </body>
- </html>
--- 1,267 ----
! <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
! "http://www.w3.org/TR/html4/loose.dtd">
!
<html>
! <head>
! <title>Privoxy Configuration</title>
! <meta name="GENERATOR" content=
! "Modular DocBook HTML Stylesheet Version 1.79">
! <link rel="HOME" title="Privoxy 3.0.26 User Manual" href="index.html">
! <link rel="PREVIOUS" title="Starting Privoxy" href="startup.html">
! <link rel="NEXT" title="The Main Configuration File" href="config.html">
! <link rel="STYLESHEET" type="text/css" href="../p_doc.css">
! <meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
! <link rel="STYLESHEET" type="text/css" href="p_doc.css">
! </head>
!
! <body class="SECT1" bgcolor="#EEEEEE" text="#000000" link="#0000FF" vlink=
! "#840084" alink="#0000FF">
! <div class="NAVHEADER">
! <table summary="Header navigation table" width="100%" border="0"
! cellpadding="0" cellspacing="0">
! <tr>
! <th colspan="3" align="center">Privoxy 3.0.26 User Manual</th>
! </tr>
!
! <tr>
! <td width="10%" align="left" valign="bottom"><a href="startup.html"
! accesskey="P">Prev</a></td>
!
! <td width="80%" align="center" valign="bottom"></td>
!
! <td width="10%" align="right" valign="bottom"><a href="config.html"
! accesskey="N">Next</a></td>
! </tr>
! </table>
! <hr align="left" width="100%">
! </div>
!
! <div class="SECT1">
! <h1 class="SECT1"><a name="CONFIGURATION" id="CONFIGURATION">6. Privoxy
! Configuration</a></h1>
!
! <p>All <span class="APPLICATION">Privoxy</span> configuration is stored
! in text files. These files can be edited with a text editor. Many
! important aspects of <span class="APPLICATION">Privoxy</span> can also be
! controlled easily with a web browser.</p>
!
! <div class="SECT2">
! <h2 class="SECT2"><a name="CONTROL-WITH-WEBBROWSER" id=
! "CONTROL-WITH-WEBBROWSER">6.1. Controlling Privoxy with Your Web
! Browser</a></h2>
!
! <p><span class="APPLICATION">Privoxy</span>'s user interface can be
! reached through the special URL <a href="http://config.privoxy.org/"
! target="_top">http://config.privoxy.org/</a> (shortcut: <a href=
! "http://p.p/" target="_top">http://p.p/</a>), which is a built-in page
! and works without Internet access. You will see the following
! section:</p>
!
! <table border="0" bgcolor="#E0E0E0" width="100%">
<tr>
! <td>
! <pre class="SCREEN">
</pre>
! <h2 class="BRIDGEHEAD"><a name="AEN904" id=
! "AEN904"></a> Privoxy Menu</h2>
! <pre>
</pre>
! <table border="0">
! <tbody>
! <tr>
! <td>
! ▪ <a href="http://config.privoxy.org/show-status"
! target="_top">View & change the current
! configuration</a></td>
! </tr>
!
! <tr>
! <td>
! ▪ <a href="http://config.privoxy.org/show-version"
! target="_top">View the source code version numbers</a></td>
! </tr>
!
! <tr>
! <td>
! ▪ <a href="http://config.privoxy.org/show-request"
! target="_top">View the request headers.</a></td>
! </tr>
!
! <tr>
! <td>
! ▪ <a href="http://config.privoxy.org/show-url-info"
! target="_top">Look up which actions apply to a URL and
! why</a></td>
! </tr>
!
! <tr>
! <td>
! ▪ <a href="http://config.privoxy.org/toggle"
! target="_top">Toggle Privoxy on or off</a></td>
! </tr>
!
! <tr>
! <td>
! ▪ <a href="https://www.privoxy.org/3.0.26/user-manual/"
! target="_top">Documentation</a></td>
! </tr>
! </tbody>
! </table>
</td>
</tr>
</table>
+
+ <p>This should be self-explanatory. Note the first item leads to an
+ editor for the <a href="actions-file.html">actions files</a>, which is
+ where the ad, banner, cookie, and URL blocking magic is configured as
+ well as other advanced features of <span class=
+ "APPLICATION">Privoxy</span>. This is an easy way to adjust various
+ aspects of <span class="APPLICATION">Privoxy</span> configuration. The
+ actions file, and other configuration files, are explained in detail
+ below.</p>
+
+ <p><span class="QUOTE">"Toggle Privoxy On or Off"</span> is handy for
+ sites that might have problems with your current actions and filters.
+ You can in fact use it as a test to see whether it is <span class=
+ "APPLICATION">Privoxy</span> causing the problem or not. <span class=
+ "APPLICATION">Privoxy</span> continues to run as a proxy in this case,
+ but all manipulation is disabled, i.e. <span class=
+ "APPLICATION">Privoxy</span> acts like a normal forwarding proxy.</p>
+
+ <p>Note that several of the features described above are disabled by
+ default in <span class="APPLICATION">Privoxy</span> 3.0.7 beta and
+ later. Check the <a href="config.html" target="_top">configuration
+ file</a> to learn why and in which cases it's safe to enable them
+ again.</p>
</div>
+ <div class="SECT2">
+ <h2 class="SECT2"><a name="CONFOVERVIEW" id="CONFOVERVIEW">6.2.
+ Configuration Files Overview</a></h2>
+
+ <p>For Unix, *BSD and Linux, all configuration files are located in
+ <tt class="FILENAME">/etc/privoxy/</tt> by default. For MS Windows,
+ OS/2, and AmigaOS these are all in the same directory as the
+ <span class="APPLICATION">Privoxy</span> executable.</p>
+
+ <p>The installed defaults provide a reasonable starting point, though
+ some settings may be aggressive by some standards. For the time being,
+ the principle configuration files are:</p>
+
+ <ul>
+ <li>
+ <p>The <a href="config.html">main configuration file</a> is named
+ <tt class="FILENAME">config</tt> on Linux, Unix, BSD, OS/2, and
+ AmigaOS and <tt class="FILENAME">config.txt</tt> on Windows. This
+ is a required file.</p>
+ </li>
+
+ <li>
+ <p><tt class="FILENAME">match-all.action</tt> is used to define
+ which <span class="QUOTE">"actions"</span> relating to
+ banner-blocking, images, pop-ups, content modification, cookie
+ handling etc should be applied by default. It should be the first
+ actions file loaded.</p>
+
+ <p><tt class="FILENAME">default.action</tt> defines many exceptions
+ (both positive and negative) from the default set of actions that's
+ configured in <tt class="FILENAME">match-all.action</tt>. It should
+ be the second actions file loaded and shouldn't be edited by the
+ user.</p>
+
+ <p>Multiple actions files may be defined in <tt class=
+ "FILENAME">config</tt>. These are processed in the order they are
+ defined. Local customizations and locally preferred exceptions to
+ the default policies as defined in <tt class=
+ "FILENAME">match-all.action</tt> (which you will most probably want
+ to define sooner or later) are best applied in <tt class=
+ "FILENAME">user.action</tt>, where you can preserve them across
+ upgrades. The file isn't installed by all installers, but you can
+ easily create it yourself with a text editor.</p>
+
+ <p>There is also a web based editor that can be accessed from
+ <a href="http://config.privoxy.org/show-status" target=
+ "_top">http://config.privoxy.org/show-status</a> (Shortcut:
+ <a href="http://p.p/show-status" target=
+ "_top">http://p.p/show-status</a>) for the various actions
+ files.</p>
+ </li>
+
+ <li>
+ <p><span class="QUOTE">"Filter files"</span> (the <a href=
+ "filter-file.html">filter file</a>) can be used to re-write the raw
+ page content, including viewable text as well as embedded HTML and
+ JavaScript, and whatever else lurks on any given web page. The
+ filtering jobs are only pre-defined here; whether to apply them or
+ not is up to the actions files. <tt class=
+ "FILENAME">default.filter</tt> includes various filters made
+ available for use by the developers. Some are much more intrusive
+ than others, and all should be used with caution. You may define
+ additional filter files in <tt class="FILENAME">config</tt> as you
+ can with actions files. We suggest <tt class=
+ "FILENAME">user.filter</tt> for any locally defined filters or
+ customizations.</p>
+ </li>
+ </ul>
+
+ <p>The syntax of the configuration and filter files may change between
+ different Privoxy versions, unfortunately some enhancements cost
+ backwards compatibility.</p>
+
+ <p>All files use the <span class="QUOTE">"<tt class=
+ "LITERAL">#</tt>"</span> character to denote a comment (the rest of the
+ line will be ignored) and understand line continuation through placing
+ a backslash ("<tt class="LITERAL">\</tt>") as the very last character
+ in a line. If the <tt class="LITERAL">#</tt> is preceded by a
+ backslash, it looses its special function. Placing a <tt class=
+ "LITERAL">#</tt> in front of an otherwise valid configuration line to
+ prevent it from being interpreted is called "commenting out" that line.
+ Blank lines are ignored.</p>
+
+ <p>The actions files and filter files can use Perl style <a href=
+ "appendix.html#REGEX">regular expressions</a> for maximum
+ flexibility.</p>
+
+ <p>After making any changes, there is no need to restart <span class=
+ "APPLICATION">Privoxy</span> in order for the changes to take effect.
+ <span class="APPLICATION">Privoxy</span> detects such changes
+ automatically. Note, however, that it may take one or two additional
+ requests for the change to take effect. When changing the listening
+ address of <span class="APPLICATION">Privoxy</span>, these <span class=
+ "QUOTE">"wake up"</span> requests must obviously be sent to the
+ <span class="emphasis"><i class="EMPHASIS">old</i></span> listening
+ address.</p>
+ </div>
+ </div>
+
+ <div class="NAVFOOTER">
+ <hr align="left" width="100%">
+
+ <table summary="Footer navigation table" width="100%" border="0"
+ cellpadding="0" cellspacing="0">
+ <tr>
+ <td width="33%" align="left" valign="top"><a href="startup.html"
+ accesskey="P">Prev</a></td>
+
+ <td width="34%" align="center" valign="top"><a href="index.html"
+ accesskey="H">Home</a></td>
+
+ <td width="33%" align="right" valign="top"><a href="config.html"
+ accesskey="N">Next</a></td>
+ </tr>
+
+ <tr>
+ <td width="33%" align="left" valign="top">Starting Privoxy</td>
+
+ <td width="34%" align="center" valign="top"> </td>
+
+ <td width="33%" align="right" valign="top">The Main Configuration
+ File</td>
+ </tr>
+ </table>
+ </div>
+ </body>
+ </html>
Index: templates.html
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/templates.html,v
retrieving revision 1.43
retrieving revision 1.44
diff -C2 -d -r1.43 -r1.44
*** templates.html 28 Jul 2016 08:25:50 -0000 1.43
--- templates.html 26 Aug 2016 03:45:37 -0000 1.44
***************
*** 1,105 ****
! <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01
! Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
<html>
! <head>
! <title>
! Privoxy's Template Files
! </title>
! <meta name="GENERATOR" content=
! "Modular DocBook HTML Stylesheet Version 1.79">
! <link rel="HOME" title="Privoxy 3.0.26 User Manual" href="index.html">
! <link rel="PREVIOUS" title="Filter Files" href="filter-file.html">
! <link rel="NEXT" title=
! "Contacting the Developers, Bug Reporting and Feature Requests" href=
! "contact.html">
! <link rel="STYLESHEET" type="text/css" href="../p_doc.css">
! <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
! <link rel="STYLESHEET" type="text/css" href="p_doc.css">
! </head>
! <body class="SECT1" bgcolor="#EEEEEE" text="#000000" link="#0000FF" vlink=
! "#840084" alink="#0000FF">
! <div class="NAVHEADER">
! <table summary="Header navigation table" width="100%" border="0"
! cellpadding="0" cellspacing="0">
! <tr>
! <th colspan="3" align="center">
! Privoxy 3.0.26 User Manual
! </th>
! </tr>
! <tr>
! <td width="10%" align="left" valign="bottom">
! <a href="filter-file.html" accesskey="P">Prev</a>
! </td>
! <td width="80%" align="center" valign="bottom">
! </td>
! <td width="10%" align="right" valign="bottom">
! <a href="contact.html" accesskey="N">Next</a>
! </td>
! </tr>
! </table>
! <hr align="LEFT" width="100%">
! </div>
! <div class="SECT1">
! <h1 class="SECT1">
! <a name="TEMPLATES">10. Privoxy's Template Files</a>
! </h1>
! <p>
! All <span class="APPLICATION">Privoxy</span> built-in pages, i.e.
! error pages such as the <a href="http://show-the-404-error.page"
! target="_top"><span class="QUOTE">"404 - No Such Domain"</span> error
! page</a>, the <a href=
! "http://ads.bannerserver.example.com/nasty-ads/sponsor.html" target=
! "_top"><span class="QUOTE">"BLOCKED"</span> page</a> and all pages of
! its <a href="http://config.privoxy.org/" target="_top">web-based user
! interface</a>, are generated from <span class="emphasis"><i class=
! "EMPHASIS">templates</i></span>. (<span class=
! "APPLICATION">Privoxy</span> must be running for the above links to
! work as intended.)
! </p>
! <p>
! These templates are stored in a subdirectory of the <a href=
! "config.html#CONFDIR">configuration directory</a> called <tt class=
! "FILENAME">templates</tt>. On Unixish platforms, this is typically <a
! href="file:///etc/privoxy/templates/" target="_top"><tt class=
! "FILENAME">/etc/privoxy/templates/</tt></a>.
! </p>
! <p>
! The templates are basically normal HTML files, but with place-holders
! (called symbols or exports), which <span class=
! "APPLICATION">Privoxy</span> fills at run time. It is possible to
! edit the templates with a normal text editor, should you want to
! customize them. (<span class="emphasis"><i class="EMPHASIS">Not
! recommended for the casual user</i></span>). Should you create your
! own custom templates, you should use the <tt class=
! "FILENAME">config</tt> setting <a href=
! "config.html#TEMPLDIR">templdir</a> to specify an alternate location,
! so your templates do not get overwritten during upgrades.
! </p>
! <p>
! Note that just like in configuration files, lines starting with <tt
! class="LITERAL">#</tt> are ignored when the templates are filled in.
! </p>
! <p>
! The place-holders are of the form <tt class="LITERAL">@name@</tt>,
! and you will find a list of available symbols, which vary from
! template to template, in the comments at the start of each file. Note
! that these comments are not always accurate, and that it's probably
! best to look at the existing HTML code to find out which symbols are
! supported and what they are filled in with.
! </p>
! <p>
! A special application of this substitution mechanism is to make whole
! blocks of HTML code disappear when a specific symbol is set. We use
! this for many purposes, one of them being to include the beta warning
! in all our user interface (CGI) pages when <span class=
! "APPLICATION">Privoxy</span> is in an alpha or beta development
! stage:
! </p>
! <p>
! </p>
! <table border="0" bgcolor="#E0E0E0" width="100%">
! <tr>
! <td>
! <pre class="SCREEN">
<!-- @if-unstable-start -->
--- 1,95 ----
! <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
! "http://www.w3.org/TR/html4/loose.dtd">
!
<html>
! <head>
! <title>Privoxy's Template Files</title>
! <meta name="GENERATOR" content=
! "Modular DocBook HTML Stylesheet Version 1.79">
! <link rel="HOME" title="Privoxy 3.0.26 User Manual" href="index.html">
! <link rel="PREVIOUS" title="Filter Files" href="filter-file.html">
! <link rel="NEXT" title=
! "Contacting the Developers, Bug Reporting and Feature Requests" href=
! "contact.html">
! <link rel="STYLESHEET" type="text/css" href="../p_doc.css">
! <meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
! <link rel="STYLESHEET" type="text/css" href="p_doc.css">
! </head>
!
! <body class="SECT1" bgcolor="#EEEEEE" text="#000000" link="#0000FF" vlink=
! "#840084" alink="#0000FF">
! <div class="NAVHEADER">
! <table summary="Header navigation table" width="100%" border="0"
! cellpadding="0" cellspacing="0">
! <tr>
! <th colspan="3" align="center">Privoxy 3.0.26 User Manual</th>
! </tr>
!
! <tr>
! <td width="10%" align="left" valign="bottom"><a href=
! "filter-file.html" accesskey="P">Prev</a></td>
!
! <td width="80%" align="center" valign="bottom"></td>
!
! <td width="10%" align="right" valign="bottom"><a href="contact.html"
! accesskey="N">Next</a></td>
! </tr>
! </table>
! <hr align="left" width="100%">
! </div>
!
! <div class="SECT1">
! <h1 class="SECT1"><a name="TEMPLATES" id="TEMPLATES">10. Privoxy's
! Template Files</a></h1>
!
! <p>All <span class="APPLICATION">Privoxy</span> built-in pages, i.e.
! error pages such as the <a href="http://show-the-404-error.page" target=
! "_top"><span class="QUOTE">"404 - No Such Domain"</span> error page</a>,
! the <a href="http://ads.bannerserver.example.com/nasty-ads/sponsor.html"
! target="_top"><span class="QUOTE">"BLOCKED"</span> page</a> and all pages
! of its <a href="http://config.privoxy.org/" target="_top">web-based user
! interface</a>, are generated from <span class="emphasis"><i class=
! "EMPHASIS">templates</i></span>. (<span class=
! "APPLICATION">Privoxy</span> must be running for the above links to work
! as intended.)</p>
!
! <p>These templates are stored in a subdirectory of the <a href=
! "config.html#CONFDIR">configuration directory</a> called <tt class=
! "FILENAME">templates</tt>. On Unixish platforms, this is typically
! <a href="file:///etc/privoxy/templates/" target="_top"><tt class=
! "FILENAME">/etc/privoxy/templates/</tt></a>.</p>
!
! <p>The templates are basically normal HTML files, but with place-holders
! (called symbols or exports), which <span class=
! "APPLICATION">Privoxy</span> fills at run time. It is possible to edit
! the templates with a normal text editor, should you want to customize
! them. (<span class="emphasis"><i class="EMPHASIS">Not recommended for the
! casual user</i></span>). Should you create your own custom templates, you
! should use the <tt class="FILENAME">config</tt> setting <a href=
! "config.html#TEMPLDIR">templdir</a> to specify an alternate location, so
! your templates do not get overwritten during upgrades.</p>
!
! <p>Note that just like in configuration files, lines starting with
! <tt class="LITERAL">#</tt> are ignored when the templates are filled
! in.</p>
!
! <p>The place-holders are of the form <tt class="LITERAL">@name@</tt>, and
! you will find a list of available symbols, which vary from template to
! template, in the comments at the start of each file. Note that these
! comments are not always accurate, and that it's probably best to look at
! the existing HTML code to find out which symbols are supported and what
! they are filled in with.</p>
!
! <p>A special application of this substitution mechanism is to make whole
! blocks of HTML code disappear when a specific symbol is set. We use this
! for many purposes, one of them being to include the beta warning in all
! our user interface (CGI) pages when <span class=
! "APPLICATION">Privoxy</span> is in an alpha or beta development
! stage:</p>
!
! <table border="0" bgcolor="#E0E0E0" width="100%">
! <tr>
! <td>
! <pre class="SCREEN">
<!-- @if-unstable-start -->
***************
*** 108,176 ****
<!-- if-unstable-end@ -->
</pre>
! </td>
! </tr>
! </table>
! <p>
! If the "unstable" symbol is set, everything in between and including
! <tt class="LITERAL">@if-unstable-start</tt> and <tt class=
! "LITERAL">if-unstable-end@</tt> will disappear, leaving nothing but
! an empty comment:
! </p>
! <p>
! </p>
! <table border="0" bgcolor="#E0E0E0" width="100%">
! <tr>
! <td>
! <pre class="SCREEN">
<!-- -->
</pre>
! </td>
! </tr>
! </table>
! <p>
! There's also an if-then-else construct and an <tt class=
! "LITERAL">#include</tt> mechanism, but you'll sure find out if you
! are inclined to edit the templates ;-)
! </p>
! <p>
! All templates refer to a style located at <a href=
! "http://config.privoxy.org/send-stylesheet" target="_top"><tt class=
! "LITERAL">http://config.privoxy.org/send-stylesheet</tt></a>. This
! is, of course, locally served by <span class=
! "APPLICATION">Privoxy</span> and the source for it can be found and
! edited in the <tt class="FILENAME">cgi-style.css</tt> template.
! </p>
! </div>
! <div class="NAVFOOTER">
! <hr align="LEFT" width="100%">
! <table summary="Footer navigation table" width="100%" border="0"
! cellpadding="0" cellspacing="0">
! <tr>
! <td width="33%" align="left" valign="top">
! <a href="filter-file.html" accesskey="P">Prev</a>
! </td>
! <td width="34%" align="center" valign="top">
! <a href="index.html" accesskey="H">Home</a>
! </td>
! <td width="33%" align="right" valign="top">
! <a href="contact.html" accesskey="N">Next</a>
! </td>
! </tr>
! <tr>
! <td width="33%" align="left" valign="top">
! Filter Files
! </td>
! <td width="34%" align="center" valign="top">
!
! </td>
! <td width="33%" align="right" valign="top">
! Contacting the Developers, Bug Reporting and Feature Requests
! </td>
! </tr>
! </table>
! </div>
! </body>
! </html>
--- 98,158 ----
<!-- if-unstable-end@ -->
</pre>
! </td>
! </tr>
! </table>
! <p>If the "unstable" symbol is set, everything in between and including
! <tt class="LITERAL">@if-unstable-start</tt> and <tt class=
! "LITERAL">if-unstable-end@</tt> will disappear, leaving nothing but an
! empty comment:</p>
!
! <table border="0" bgcolor="#E0E0E0" width="100%">
! <tr>
! <td>
! <pre class="SCREEN">
<!-- -->
</pre>
! </td>
! </tr>
! </table>
! <p>There's also an if-then-else construct and an <tt class=
! "LITERAL">#include</tt> mechanism, but you'll sure find out if you are
! inclined to edit the templates ;-)</p>
!
! <p>All templates refer to a style located at <a href=
! "http://config.privoxy.org/send-stylesheet" target="_top"><tt class=
! "LITERAL">http://config.privoxy.org/send-stylesheet</tt></a>. This is, of
! course, locally served by <span class="APPLICATION">Privoxy</span> and
! the source for it can be found and edited in the <tt class=
! "FILENAME">cgi-style.css</tt> template.</p>
! </div>
!
! <div class="NAVFOOTER">
! <hr align="left" width="100%">
!
! <table summary="Footer navigation table" width="100%" border="0"
! cellpadding="0" cellspacing="0">
! <tr>
! <td width="33%" align="left" valign="top"><a href="filter-file.html"
! accesskey="P">Prev</a></td>
+ <td width="34%" align="center" valign="top"><a href="index.html"
+ accesskey="H">Home</a></td>
+
+ <td width="33%" align="right" valign="top"><a href="contact.html"
+ accesskey="N">Next</a></td>
+ </tr>
+
+ <tr>
+ <td width="33%" align="left" valign="top">Filter Files</td>
+
+ <td width="34%" align="center" valign="top"> </td>
+
+ <td width="33%" align="right" valign="top">Contacting the Developers,
+ Bug Reporting and Feature Requests</td>
+ </tr>
+ </table>
+ </div>
+ </body>
+ </html>
Index: copyright.html
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/copyright.html,v
retrieving revision 1.102
retrieving revision 1.103
diff -C2 -d -r1.102 -r1.103
*** copyright.html 28 Jul 2016 08:25:50 -0000 1.102
--- copyright.html 26 Aug 2016 03:45:37 -0000 1.103
***************
*** 1,73 ****
! <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01
! Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
<html>
! <head>
! <title>
! Privoxy Copyright, License and History
! </title>
! <meta name="GENERATOR" content=
! "Modular DocBook HTML Stylesheet Version 1.79">
! <link rel="HOME" title="Privoxy 3.0.26 User Manual" href="index.html">
! <link rel="PREVIOUS" title=
! "Contacting the Developers, Bug Reporting and Feature Requests" href=
! "contact.html">
! <link rel="NEXT" title="See Also" href="seealso.html">
! <link rel="STYLESHEET" type="text/css" href="../p_doc.css">
! <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
! <link rel="STYLESHEET" type="text/css" href="p_doc.css">
! </head>
! <body class="SECT1" bgcolor="#EEEEEE" text="#000000" link="#0000FF" vlink=
! "#840084" alink="#0000FF">
! <div class="NAVHEADER">
! <table summary="Header navigation table" width="100%" border="0"
! cellpadding="0" cellspacing="0">
! <tr>
! <th colspan="3" align="center">
! Privoxy 3.0.26 User Manual
! </th>
! </tr>
<tr>
! <td width="10%" align="left" valign="bottom">
! <a href="contact.html" accesskey="P">Prev</a>
! </td>
! <td width="80%" align="center" valign="bottom">
! </td>
! <td width="10%" align="right" valign="bottom">
! <a href="seealso.html" accesskey="N">Next</a>
! </td>
! </tr>
! </table>
! <hr align="LEFT" width="100%">
! </div>
! <div class="SECT1">
! <h1 class="SECT1">
! <a name="COPYRIGHT">12. Privoxy Copyright, License and History</a>
! </h1>
! <p>
! Copyright © 2001-2016 by Privoxy Developers <code class=
! "EMAIL"><<a href=
! "mailto:[email protected]">[email protected]</a>></code>
! </p>
! <p>
! Some source code is based on code Copyright © 1997 by Anonymous
! Coders and Junkbusters, Inc. and licensed under the <i class=
! "CITETITLE">GNU General Public License</i>.
! </p>
! <p>
! <span class="APPLICATION">Privoxy</span> is free software; you can
! redistribute it and/or modify it under the terms of the <i class=
! "CITETITLE">GNU General Public License</i>, version 2, as published
! by the Free Software Foundation and included in the next section.
! </p>
! <div class="SECT2">
! <h2 class="SECT2">
! <a name="LICENSE">12.1. License</a>
! </h2>
! <p>
! </p>
! <table border="0" bgcolor="#E0E0E0" width="100%">
! <tr>
! <td>
! <pre class="SCREEN">
GNU GENERAL PUBLIC LICENSE
Version 2, June 1991
--- 1,66 ----
! <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
! "http://www.w3.org/TR/html4/loose.dtd">
!
<html>
! <head>
! <title>Privoxy Copyright, License and History</title>
! <meta name="GENERATOR" content=
! "Modular DocBook HTML Stylesheet Version 1.79">
! <link rel="HOME" title="Privoxy 3.0.26 User Manual" href="index.html">
! <link rel="PREVIOUS" title=
! "Contacting the Developers, Bug Reporting and Feature Requests" href=
! "contact.html">
! <link rel="NEXT" title="See Also" href="seealso.html">
! <link rel="STYLESHEET" type="text/css" href="../p_doc.css">
! <meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
! <link rel="STYLESHEET" type="text/css" href="p_doc.css">
! </head>
!
! <body class="SECT1" bgcolor="#EEEEEE" text="#000000" link="#0000FF" vlink=
! "#840084" alink="#0000FF">
! <div class="NAVHEADER">
! <table summary="Header navigation table" width="100%" border="0"
! cellpadding="0" cellspacing="0">
! <tr>
! <th colspan="3" align="center">Privoxy 3.0.26 User Manual</th>
! </tr>
!
! <tr>
! <td width="10%" align="left" valign="bottom"><a href="contact.html"
! accesskey="P">Prev</a></td>
!
! <td width="80%" align="center" valign="bottom"></td>
!
! <td width="10%" align="right" valign="bottom"><a href="seealso.html"
! accesskey="N">Next</a></td>
! </tr>
! </table>
! <hr align="left" width="100%">
! </div>
!
! <div class="SECT1">
! <h1 class="SECT1"><a name="COPYRIGHT" id="COPYRIGHT">12. Privoxy
! Copyright, License and History</a></h1>
!
! <p>Copyright © 2001-2016 by Privoxy Developers <code class=
! "EMAIL"><<a href=
! "mailto:[email protected]">[email protected]</a>></code></p>
!
! <p>Some source code is based on code Copyright © 1997 by Anonymous
! Coders and Junkbusters, Inc. and licensed under the <i class=
! "CITETITLE">GNU General Public License</i>.</p>
!
! <p><span class="APPLICATION">Privoxy</span> is free software; you can
! redistribute it and/or modify it under the terms of the <i class=
! "CITETITLE">GNU General Public License</i>, version 2, as published by
! the Free Software Foundation and included in the next section.</p>
!
! <div class="SECT2">
! <h2 class="SECT2"><a name="LICENSE" id="LICENSE">12.1. License</a></h2>
!
! <table border="0" bgcolor="#E0E0E0" width="100%">
<tr>
! <td>
! <pre class="SCREEN">
GNU GENERAL PUBLIC LICENSE
Version 2, June 1991
***************
*** 409,676 ****
library. If this is what you want to do, use the GNU Lesser General
Public License instead of this License.
</pre>
- </td>
- </tr>
- </table>
- </div>
- <div class="SECT2">
- <h2 class="SECT2">
- <a name="HISTORY">12.2. History</a>
- </h2>
- <p>
- A long time ago, there was the <span class="APPLICATION">Internet
- Junkbuster</span>, by Anonymous Coders and Junkbusters Corporation.
- This saved many users a lot of pain in the early days of web
- advertising and user tracking.
- </p>
- <p>
- But the web, its protocols and standards, and with it, the
- techniques for forcing ads on users, give up autonomy over their
- browsing, and for tracking them, keeps evolving. Unfortunately, the
- <span class="APPLICATION">Internet Junkbuster</span> did not.
- Version 2.0.2, published in 1998, was the last official release,
- available from Junkbusters Corporation. Fortunately, it had been
- released under the GNU <a href=
- "http://www.gnu.org/licenses/old-licenses/gpl-2.0.html" target=
- "_top">GPL</a>, which allowed further development by others.
- </p>
- <p>
- So Stefan Waldherr started maintaining an improved version of the
- software, to which eventually a number of people contributed
- patches. It could already replace banners with a transparent image,
- and had a first version of pop-up killing, but it was still very
- closely based on the original, with all its limitations, such as
- the lack of HTTP/1.1 support, flexible per-site configuration, or
- content modification. The last release from this effort was version
- 2.0.2-10, published in 2000.
- </p>
- <p>
- Then, some <a href=
- "https://www.privoxy.org/user-manual/copyright.html#AUTHORS"
- target="_top">developers</a> picked up the thread, and started
- turning the software inside out, upside down, and then reassembled
- it, adding many <a href=
- "https://www.privoxy.org/user-manual/introduction.html#FEATURES"
- target="_top">new features</a> along the way.
- </p>
- <p>
- The result of this is <span class="APPLICATION">Privoxy</span>,
- whose first stable version, 3.0, was released August, 2002.
- </p>
- <p>
- As of 2012 the Junkbusters Corporation's website
- (http://www.junkbusters.com/) has been shut down, but Privoxy is
- still actively maintained.
- </p>
- </div>
- <div class="SECT2">
- <h2 class="SECT2">
- <a name="AUTHORS">12.3. Authors</a>
- </h2>
- <p>
- Current Privoxy Team:
- </p>
- <p class="LITERALLAYOUT">
- Fabian Keil, lead developer<br>
- David Schmidt<br>
- Hal Burgiss<br>
- Lee Rian<br>
- Roland Rosenfeld<br>
- Ian Silvester
- </p>
- <p>
- Former Privoxy Team Members:
- </p>
- <p class="LITERALLAYOUT">
- Johny Agotnes<br>
- Rodrigo Barbosa<br>
- Moritz Barsnick<br>
- Ian Cummings<br>
- Brian Dessent<br>
- Jon Foster<br>
- Karsten Hopp<br>
- Alexander Lazic<br>
- Daniel Leite<br>
- Gábor Lipták<br>
- Adam Lock<br>
- Guy Laroche<br>
- Justin McMurtry<br>
- Mark Miller<br>
- Gerry Murphy<br>
- Andreas Oesterhelt<br>
- Haroon Rafique<br>
- Georg Sauthoff<br>
- Thomas Steudten<br>
- Jörg Strohmayer<br>
- Rodney Stromlund<br>
- Sviatoslav Sviridov<br>
- Sarantis Paskalis<br>
- Stefan Waldherr
- </p>
- <p>
- Thanks to the many people who have tested Privoxy, reported bugs,
- provided patches, made suggestions, donated or contributed in some
- other way. These include (in alphabetical order):
- </p>
- <p class="LITERALLAYOUT">
- Rustam Abdullaev<br>
- Anatoly Arzhnikov<br>
- Ken Arromdee<br>
- Natxo Asenjo<br>
- Devin Bayer<br>
- Havard Berland<br>
- David Bo<br>
- Gergely Bor<br>
- Francois Botha<br>
- Reiner Buehl<br>
- Andrew J. Caines<br>
- Clifford Caoile<br>
- Edward Carrel<br>
- Pak Chan<br>
- Wan-Teh Chang<br>
- Sam Chen<br>
- Ramkumar Chinchani<br>
- Billy Crook<br>
- Frédéric Crozat<br>
- Matthew Daley<br>
- Michael T. Davis<br>
- Markus Dittrich<br>
- Mattes Dolak<br>
- Matthias Drochner<br>
- Peter E.<br>
- Florian Effenberger<br>
- Markus Elfring<br>
- Ryan Farmer<br>
- Matthew Fischer<br>
- Dean Gaudet<br>
- Stephen Gildea<br>
- John McGowan<br>
- Lizik Grelier<br>
- Daniel Griscom<br>
- Felix Gröbert<br>
- Bernard Guillot<br>
- Jeff H.<br>
- Tim H.<br>
- Aaron Hamid<br>
- Basil Hussain<br>
- Darel Henman<br>
- Magnus Holmgren<br>
- Eric M. Hopper<br>
- Ralf Horstmann<br>
- Stefan Huehner<br>
- Peter Hyman<br>
- Derek Jennings<br>
- Andrew Jones<br>
- Julien Joubert<br>
- Ralf Jungblut<br>
- Petr Kadlec<br>
- Robert Klemme<br>
- Steven Kolins<br>
- Korda<br>
- Stefan Kurtz<br>
- Zeno Kugy<br>
- David Laight<br>
- Bert van Leeuwen<br>
- Don Libes<br>
- Paul Lieverse<br>
- Han Liu<br>
- Toby Lyward<br>
- Wil Mahan<br>
- Jindrich Makovicka<br>
- Raphael Marichez<br>
- Francois Marier<br>
- Angelina Matson<br>
- Jonathan McKenzie<br>
- David Mediavilla<br>
- J. Momberger<br>
- Raphael Moll<br>
- Mathew Murphy<br>
- Amuro Namie<br>
- Mark Nelson<br>
- Adam Piggott<br>
- Petr Písar<br>
- Dan Price<br>
- Kai Raven<br>
- Roberto Ragusa<br>
- Félix Rauch<br>
- Chris John Riley<br>
- Maynard Riley<br>
- Andreas Rutkauskas<br>
- Bart Schelstraete<br>
- Gregory Seidman<br>
- Atman Sense<br>
- Chung-chieh Shan<br>
- Benjamin C. Wiley Sittler<br>
- Simon South<br>
- Dan Stahlke<br>
- Oliver Stoeneberg<br>
- Rick Sykes<br>
- Spinor S.<br>
- Peter Thoenen<br>
- Martin Thomas<br>
- Reuben Thomas<br>
- Guybrush Threepwood<br>
- Joel Verhagen<br>
- Bobby G. Vinyard<br>
- Jochen Voss<br>
- David Wagner<br>
- Glenn Washburn<br>
- Song Weijia<br>
- Jörg Weinmann<br>
- Darren Wiebe<br>
- Anduin Withers<br>
- Yang Xia<br>
- Jarry Xu<br>
- Oliver Yeoh<br>
- Jamie Zawinski<br>
- Eduard Wulff
- </p>
- <p>
- Privoxy is based in part on code originally developed by
- Junkbusters Corp. and Anonymous Coders.
- </p>
- <p>
- Privoxy heavily relies on Philip Hazel's PCRE.
- </p>
- <p>
- The code to filter compressed content makes use of zlib which is
- written by Jean-loup Gailly and Mark Adler.
- </p>
- <p>
- On systems that lack snprintf(), Privoxy is using a version written
- by Mark Martinec. On systems that lack strptime(), Privoxy is using
- the one from the GNU C Library written by Ulrich Drepper.
- </p>
- </div>
- </div>
- <div class="NAVFOOTER">
- <hr align="LEFT" width="100%">
- <table summary="Footer navigation table" width="100%" border="0"
- cellpadding="0" cellspacing="0">
- <tr>
- <td width="33%" align="left" valign="top">
- <a href="contact.html" accesskey="P">Prev</a>
- </td>
- <td width="34%" align="center" valign="top">
- <a href="index.html" accesskey="H">Home</a>
- </td>
- <td width="33%" align="right" valign="top">
- <a href="seealso.html" accesskey="N">Next</a>
- </td>
- </tr>
- <tr>
- <td width="33%" align="left" valign="top">
- Contacting the Developers, Bug Reporting and Feature Requests
- </td>
- <td width="34%" align="center" valign="top">
-
- </td>
- <td width="33%" align="right" valign="top">
- See Also
</td>
</tr>
</table>
</div>
- </body>
- </html>
--- 402,651 ----
library. If this is what you want to do, use the GNU Lesser General
Public License instead of this License.
+
</pre>
</td>
</tr>
</table>
</div>
+ <div class="SECT2">
+ <h2 class="SECT2"><a name="HISTORY" id="HISTORY">12.2. History</a></h2>
+
+ <p>A long time ago, there was the <span class="APPLICATION">Internet
+ Junkbuster</span>, by Anonymous Coders and Junkbusters Corporation.
+ This saved many users a lot of pain in the early days of web
+ advertising and user tracking.</p>
+
+ <p>But the web, its protocols and standards, and with it, the
+ techniques for forcing ads on users, give up autonomy over their
+ browsing, and for tracking them, keeps evolving. Unfortunately, the
+ <span class="APPLICATION">Internet Junkbuster</span> did not. Version
+ 2.0.2, published in 1998, was the last official release, available from
+ Junkbusters Corporation. Fortunately, it had been released under the
+ GNU <a href="http://www.gnu.org/licenses/old-licenses/gpl-2.0.html"
+ target="_top">GPL</a>, which allowed further development by others.</p>
+
+ <p>So Stefan Waldherr started maintaining an improved version of the
+ software, to which eventually a number of people contributed patches.
+ It could already replace banners with a transparent image, and had a
+ first version of pop-up killing, but it was still very closely based on
+ the original, with all its limitations, such as the lack of HTTP/1.1
+ support, flexible per-site configuration, or content modification. The
+ last release from this effort was version 2.0.2-10, published in
+ 2000.</p>
+
+ <p>Then, some <a href=
+ "https://www.privoxy.org/user-manual/copyright.html#AUTHORS" target=
+ "_top">developers</a> picked up the thread, and started turning the
+ software inside out, upside down, and then reassembled it, adding many
+ <a href=
+ "https://www.privoxy.org/user-manual/introduction.html#FEATURES"
+ target="_top">new features</a> along the way.</p>
+
+ <p>The result of this is <span class="APPLICATION">Privoxy</span>,
+ whose first stable version, 3.0, was released August, 2002.</p>
+
+ <p>As of 2012 the Junkbusters Corporation's website
+ (http://www.junkbusters.com/) has been shut down, but Privoxy is still
+ actively maintained.</p>
+ </div>
+
+ <div class="SECT2">
+ <h2 class="SECT2"><a name="AUTHORS" id="AUTHORS">12.3. Authors</a></h2>
+
+ <p>Current Privoxy Team:</p>
+
+ <p class="LITERALLAYOUT">
+ Fabian Keil, lead developer<br>
+ David Schmidt<br>
+ Hal Burgiss<br>
+ Lee Rian<br>
+ Roland Rosenfeld<br>
+ Ian Silvester</p>
+
+ <p>Former Privoxy Team Members:</p>
+
+ <p class="LITERALLAYOUT"> Johny Agotnes<br>
+ Rodrigo Barbosa<br>
+ Moritz Barsnick<br>
+ Ian Cummings<br>
+ Brian Dessent<br>
+ Jon Foster<br>
+ Karsten Hopp<br>
+ Alexander Lazic<br>
+ Daniel Leite<br>
+ Gábor Lipták<br>
+ Adam Lock<br>
+ Guy Laroche<br>
+ Justin McMurtry<br>
+ Mark Miller<br>
+ Gerry Murphy<br>
+ Andreas Oesterhelt<br>
+ Haroon Rafique<br>
+ Georg Sauthoff<br>
+ Thomas Steudten<br>
+ Jörg Strohmayer<br>
+ Rodney Stromlund<br>
+ Sviatoslav Sviridov<br>
+ Sarantis Paskalis<br>
+ Stefan Waldherr</p>
+
+ <p>Thanks to the many people who have tested Privoxy, reported bugs,
+ provided patches, made suggestions, donated or contributed in some
+ other way. These include (in alphabetical order):</p>
+
+ <p class="LITERALLAYOUT"> Rustam Abdullaev<br>
+ Anatoly Arzhnikov<br>
+ Ken Arromdee<br>
+ Natxo Asenjo<br>
+ Devin Bayer<br>
+ Havard Berland<br>
+ David Bo<br>
+ Gergely Bor<br>
+ Francois Botha<br>
+ Reiner Buehl<br>
+ Andrew J. Caines<br>
+ Clifford Caoile<br>
+ Edward Carrel<br>
+ Pak Chan<br>
+ Wan-Teh Chang<br>
+ Sam Chen<br>
+ Ramkumar Chinchani<br>
+ Billy Crook<br>
+ Frédéric Crozat<br>
+ Matthew Daley<br>
+ Michael T. Davis<br>
+ Markus Dittrich<br>
+ Mattes Dolak<br>
+ Matthias Drochner<br>
+ Peter E.<br>
+ Florian Effenberger<br>
+ Markus Elfring<br>
+ Ryan Farmer<br>
+ Matthew Fischer<br>
+ Dean Gaudet<br>
+ Stephen Gildea<br>
+ John McGowan<br>
+ Lizik Grelier<br>
+ Daniel Griscom<br>
+ Felix Gröbert<br>
+ Bernard Guillot<br>
+ Jeff H.<br>
+ Tim H.<br>
+ Aaron Hamid<br>
+ Basil Hussain<br>
+ Darel Henman<br>
+ Magnus Holmgren<br>
+ Eric M. Hopper<br>
+ Ralf Horstmann<br>
+ Stefan Huehner<br>
+ Peter Hyman<br>
+ Derek Jennings<br>
+ Andrew Jones<br>
+ Julien Joubert<br>
+ Ralf Jungblut<br>
+ Petr Kadlec<br>
+ Robert Klemme<br>
+ Steven Kolins<br>
+ Korda<br>
+ Stefan Kurtz<br>
+ Zeno Kugy<br>
+ David Laight<br>
+ Bert van Leeuwen<br>
+ Don Libes<br>
+ Paul Lieverse<br>
+ Han Liu<br>
+ Toby Lyward<br>
+ Wil Mahan<br>
+ Jindrich Makovicka<br>
+ Raphael Marichez<br>
+ Francois Marier<br>
+ Angelina Matson<br>
+ Jonathan McKenzie<br>
+ David Mediavilla<br>
+ J. Momberger<br>
+ Raphael Moll<br>
+ Mathew Murphy<br>
+ Amuro Namie<br>
+ Mark Nelson<br>
+ Adam Piggott<br>
+ Petr Písar<br>
+ Dan Price<br>
+ Kai Raven<br>
+ Roberto Ragusa<br>
+ Félix Rauch<br>
+ Marvin Renich<br>
+ Chris John Riley<br>
+ Maynard Riley<br>
+ Andreas Rutkauskas<br>
+ Bart Schelstraete<br>
+ Gregory Seidman<br>
+ Atman Sense<br>
+ Chung-chieh Shan<br>
+ Benjamin C. Wiley Sittler<br>
+ Simon South<br>
+ Dan Stahlke<br>
+ Oliver Stoeneberg<br>
+ Rick Sykes<br>
+ Spinor S.<br>
+ Peter Thoenen<br>
+ Martin Thomas<br>
+ Reuben Thomas<br>
+ Guybrush Threepwood<br>
+ Joel Verhagen<br>
+ Bobby G. Vinyard<br>
+ Jochen Voss<br>
+ David Wagner<br>
+ Glenn Washburn<br>
+ Song Weijia<br>
+ Jörg Weinmann<br>
+ Darren Wiebe<br>
+ Anduin Withers<br>
+ Yang Xia<br>
+ Jarry Xu<br>
+ Oliver Yeoh<br>
+ Jamie Zawinski<br>
+ Eduard Wulff</p>
+
+ <p>Privoxy is based in part on code originally developed by Junkbusters
+ Corp. and Anonymous Coders.</p>
+
+ <p>Privoxy heavily relies on Philip Hazel's PCRE.</p>
+
+ <p>The code to filter compressed content makes use of zlib which is
+ written by Jean-loup Gailly and Mark Adler.</p>
+
+ <p>On systems that lack snprintf(), Privoxy is using a version written
+ by Mark Martinec. On systems that lack strptime(), Privoxy is using the
+ one from the GNU C Library written by Ulrich Drepper.</p>
+ </div>
+ </div>
+
+ <div class="NAVFOOTER">
+ <hr align="left" width="100%">
+
+ <table summary="Footer navigation table" width="100%" border="0"
+ cellpadding="0" cellspacing="0">
+ <tr>
+ <td width="33%" align="left" valign="top"><a href="contact.html"
+ accesskey="P">Prev</a></td>
+
+ <td width="34%" align="center" valign="top"><a href="index.html"
+ accesskey="H">Home</a></td>
+
+ <td width="33%" align="right" valign="top"><a href="seealso.html"
+ accesskey="N">Next</a></td>
+ </tr>
+
+ <tr>
+ <td width="33%" align="left" valign="top">Contacting the Developers,
+ Bug Reporting and Feature Requests</td>
+
+ <td width="34%" align="center" valign="top"> </td>
+
+ <td width="33%" align="right" valign="top">See Also</td>
+ </tr>
+ </table>
+ </div>
+ </body>
+ </html>
Index: quickstart.html
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/quickstart.html,v
retrieving revision 1.83
retrieving revision 1.84
diff -C2 -d -r1.83 -r1.84
*** quickstart.html 28 Jul 2016 08:25:50 -0000 1.83
--- quickstart.html 26 Aug 2016 03:45:37 -0000 1.84
***************
*** 1,505 ****
! <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01
! Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
<html>
! <head>
! <title>
! Quickstart to Using Privoxy
! </title>
! <meta name="GENERATOR" content=
! "Modular DocBook HTML Stylesheet Version 1.79">
! <link rel="HOME" title="Privoxy 3.0.26 User Manual" href="index.html">
! <link rel="PREVIOUS" title="What's New in this Release" href=
! "whatsnew.html">
! <link rel="NEXT" title="Starting Privoxy" href="startup.html">
! <link rel="STYLESHEET" type="text/css" href="../p_doc.css">
! <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
! <link rel="STYLESHEET" type="text/css" href="p_doc.css">
! </head>
! <body class="SECT1" bgcolor="#EEEEEE" text="#000000" link="#0000FF" vlink=
! "#840084" alink="#0000FF">
! <div class="NAVHEADER">
! <table summary="Header navigation table" width="100%" border="0"
! cellpadding="0" cellspacing="0">
! <tr>
! <th colspan="3" align="center">
! Privoxy 3.0.26 User Manual
! </th>
! </tr>
! <tr>
! <td width="10%" align="left" valign="bottom">
! <a href="whatsnew.html" accesskey="P">Prev</a>
! </td>
! <td width="80%" align="center" valign="bottom">
! </td>
! <td width="10%" align="right" valign="bottom">
! <a href="startup.html" accesskey="N">Next</a>
! </td>
! </tr>
! </table>
! <hr align="LEFT" width="100%">
! </div>
! <div class="SECT1">
! <h1 class="SECT1">
! <a name="QUICKSTART">4. Quickstart to Using Privoxy</a>
! </h1>
! <p>
! </p>
<ul>
<li>
! <p>
! Install <span class="APPLICATION">Privoxy</span>. See the <a
! href="installation.html">Installation Section</a> below for
! platform specific information.
! </p>
</li>
<li>
! <p>
! Advanced users and those who want to offer <span class=
! "APPLICATION">Privoxy</span> service to more than just their
! local machine should check the <a href="config.html">main config
! file</a>, especially the <a href=
! "config.html#ACCESS-CONTROL">security-relevant</a> options. These
! are off by default.
! </p>
</li>
<li>
! <p>
! Start <span class="APPLICATION">Privoxy</span>, if the
! installation program has not done this already (may vary
! according to platform). See the section <a href=
! "startup.html">Starting <span class=
! "APPLICATION">Privoxy</span></a>.
! </p>
</li>
<li>
! <p>
! Set your browser to use <span class="APPLICATION">Privoxy</span>
! as HTTP and HTTPS (SSL) <a href=
! "http://en.wikipedia.org/wiki/Proxy_server" target=
! "_top">proxy</a> by setting the proxy configuration for address
! of <tt class="LITERAL">127.0.0.1</tt> and port <tt class=
! "LITERAL">8118</tt>. <span class="emphasis"><i class=
! "EMPHASIS">DO NOT</i></span> activate proxying for <tt class=
! "LITERAL">FTP</tt> or any protocols besides HTTP and HTTPS (SSL)
! unless you intend to prevent your browser from using these
! protocols.
! </p>
</li>
<li>
! <p>
! Flush your browser's disk and memory caches, to remove any cached
! ad images. If using <span class="APPLICATION">Privoxy</span> to
! manage <a href="http://en.wikipedia.org/wiki/Browser_cookie"
! target="_top">cookies</a>, you should remove any currently stored
! cookies too.
! </p>
</li>
<li>
! <p>
! A default installation should provide a reasonable starting point
! for most. There will undoubtedly be occasions where you will want
! to adjust the configuration, but that can be dealt with as the
! need arises. Little to no initial configuration is required in
! most cases, you may want to enable the <a href=
! "config.html#ENABLE-EDIT-ACTIONS" target="_top">web-based action
! editor</a> though. Be sure to read the warnings first.
! </p>
! <p>
! See the <a href="configuration.html">Configuration section</a>
! for more configuration options, and how to customize your
! installation. You might also want to look at the <a href=
! "quickstart.html#QUICKSTART-AD-BLOCKING">next section</a> for a
! quick introduction to how <span class=
! "APPLICATION">Privoxy</span> blocks ads and banners.
! </p>
</li>
<li>
! <p>
! If you experience ads that slip through, innocent images that are
! blocked, or otherwise feel the need to fine-tune <span class=
! "APPLICATION">Privoxy's</span> behavior, take a look at the <a
! href="actions-file.html">actions files</a>. As a quick start, you
! might find the <a href="actions-file.html#ACT-EXAMPLES">richly
! commented examples</a> helpful. You can also view and edit the
! actions files through the <a href="http://config.privoxy.org"
! target="_top">web-based user interface</a>. The Appendix <span
! class="QUOTE">"<a href=
! "appendix.html#ACTIONSANAT">Troubleshooting: Anatomy of an
! Action</a>"</span> has hints on how to understand and debug
! actions that <span class="QUOTE">"misbehave"</span>.
! </p>
</li>
<li>
! <p>
! Please see the section <a href="contact.html">Contacting the
! Developers</a> on how to report bugs, problems with websites or
! to get help.
! </p>
</li>
<li>
! <p>
! Now enjoy surfing with enhanced control, comfort and privacy!
! </p>
</li>
</ul>
! <div class="SECT2">
! <h2 class="SECT2">
! <a name="QUICKSTART-AD-BLOCKING">4.1. Quickstart to Ad Blocking</a>
! </h2>
! <p>
! Ad blocking is but one of <span class=
! "APPLICATION">Privoxy's</span> array of features. Many of these
! features are for the technically minded advanced user. But, ad and
! banner blocking is surely common ground for everybody.
! </p>
! <p>
! This section will provide a quick summary of ad blocking so you can
! get up to speed quickly without having to read the more extensive
! information provided below, though this is highly recommended.
! </p>
! <p>
! First a bit of a warning ... blocking ads is much like blocking
! SPAM: the more aggressive you are about it, the more likely you are
! to block things that were not intended. And the more likely that
! some things may not work as intended. So there is a trade off here.
! If you want extreme ad free browsing, be prepared to deal with more
! <span class="QUOTE">"problem"</span> sites, and to spend more time
! adjusting the configuration to solve these unintended consequences.
! In short, there is not an easy way to eliminate <span class=
! "emphasis"><i class="EMPHASIS">all</i></span> ads. Either take the
! easy way and settle for <span class="emphasis"><i class=
! "EMPHASIS">most</i></span> ads blocked with the default
! configuration, or jump in and tweak it for your personal surfing
! habits and preferences.
! </p>
! <p>
! Secondly, a brief explanation of <span class=
! "APPLICATION">Privoxy's</span> <span class=
! "QUOTE">"actions"</span>. <span class="QUOTE">"Actions"</span> in
! this context, are the directives we use to tell <span class=
! "APPLICATION">Privoxy</span> to perform some task relating to HTTP
! transactions (i.e. web browsing). We tell <span class=
! "APPLICATION">Privoxy</span> to take some <span class=
! "QUOTE">"action"</span>. Each action has a unique name and
! function. While there are many potential <span class=
! "APPLICATION">actions</span> in <span class=
! "APPLICATION">Privoxy's</span> arsenal, only a few are used for ad
! blocking. <a href="actions-file.html#ACTIONS">Actions</a>, and <a
! href="actions-file.html">action configuration files</a>, are
! explained in depth below.
! </p>
! <p>
! Actions are specified in <span class="APPLICATION">Privoxy's</span>
! configuration, followed by one or more URLs to which the action
! should apply. URLs can actually be URL type <a href=
! "actions-file.html#AF-PATTERNS">patterns</a> that use wildcards so
! they can apply potentially to a range of similar URLs. The actions,
! together with the URL patterns are called a section.
! </p>
! <p>
! When you connect to a website, the full URL will either match one
! or more of the sections as defined in <span class=
! "APPLICATION">Privoxy's</span> configuration, or not. If so, then
! <span class="APPLICATION">Privoxy</span> will perform the
! respective actions. If not, then nothing special happens.
! Furthermore, web pages may contain embedded, secondary URLs that
! your web browser will use to load additional components of the
! page, as it parses the original page's HTML content. An ad image
! for instance, is just an URL embedded in the page somewhere. The
! image itself may be on the same server, or a server somewhere else
! on the Internet. Complex web pages will have many such embedded
! URLs. <span class="APPLICATION">Privoxy</span> can deal with each
! URL individually, so, for instance, the main page text is not
! touched, but images from such-and-such server are blocked.
! </p>
! <p>
! The most important actions for basic ad blocking are: <tt class=
! "LITERAL"><a href="actions-file.html#BLOCK">block</a></tt>, <tt
! class="LITERAL"><a href=
! "actions-file.html#HANDLE-AS-IMAGE">handle-as-image</a></tt>, <tt
! class="LITERAL"><a href=
! "actions-file.html#HANDLE-AS-EMPTY-DOCUMENT">handle-as-empty-document</a></tt>,and
! <tt class="LITERAL"><a href=
! "actions-file.html#SET-IMAGE-BLOCKER">set-image-blocker</a></tt>:
! </p>
! <p>
! </p>
! <ul>
! <li>
! <p>
! <tt class="LITERAL"><a href=
! "actions-file.html#BLOCK">block</a></tt> - this is perhaps the
! single most used action, and is particularly important for ad
! blocking. This action stops any contact between your browser
! and any URL patterns that match this action's configuration. It
! can be used for blocking ads, but also anything that is
! determined to be unwanted. By itself, it simply stops any
! communication with the remote server and sends <span class=
! "APPLICATION">Privoxy</span>'s own built-in BLOCKED page
! instead to let you now what has happened (with some exceptions,
! see below).
! </p>
! </li>
! <li>
! <p>
! <tt class="LITERAL"><a href=
! "actions-file.html#HANDLE-AS-IMAGE">handle-as-image</a></tt> -
! tells <span class="APPLICATION">Privoxy</span> to treat this
! URL as an image. <span class="APPLICATION">Privoxy</span>'s
! default configuration already does this for all common image
! types (e.g. GIF), but there are many situations where this is
! not so easy to determine. So we'll force it in these cases.
! This is particularly important for ad blocking, since only if
! we know that it's an image of some kind, can we replace it with
! an image of our choosing, instead of the <span class=
! "APPLICATION">Privoxy</span> BLOCKED page (which would only
! result in a <span class="QUOTE">"broken image"</span> icon).
! There are some limitations to this though. For instance, you
! can't just brute-force an image substitution for an entire HTML
! page in most situations.
! </p>
! </li>
! <li>
! <p>
! <tt class="LITERAL"><a href=
! "actions-file.html#HANDLE-AS-EMPTY-DOCUMENT">handle-as-empty-document</a></tt>
! - sends an empty document instead of <span class=
! "APPLICATION">Privoxy's</span> normal BLOCKED HTML page. This
! is useful for file types that are neither HTML nor images, such
! as blocking JavaScript files.
! </p>
! </li>
! <li>
! <p>
! <tt class="LITERAL"><a href=
! "actions-file.html#SET-IMAGE-BLOCKER">set-image-blocker</a></tt>
! - tells <span class="APPLICATION">Privoxy</span> what to
! display in place of an ad image that has hit a block rule. For
! this to come into play, the URL must match a <tt class=
! "LITERAL"><a href="actions-file.html#BLOCK">block</a></tt>
! action somewhere in the configuration, <span class=
! "emphasis"><i class="EMPHASIS">and</i></span>, it must also
! match an <tt class="LITERAL"><a href=
! "actions-file.html#HANDLE-AS-IMAGE">handle-as-image</a></tt>
! action.
! </p>
! <p>
! The configuration options on what to display instead of the ad
! are:
! </p>
! <table border="0">
! <tbody>
! <tr>
! <td>
! <span class="emphasis"><i class=
! "EMPHASIS">pattern</i></span> - a checkerboard pattern,
! so that an ad replacement is obvious. This is the
! default.
! </td>
! </tr>
! </tbody>
! </table>
! <table border="0">
! <tbody>
! <tr>
! <td>
! <span class="emphasis"><i class=
! "EMPHASIS">blank</i></span> - A very small empty GIF
! image is displayed. This is the so-called <span class=
! "QUOTE">"invisible"</span> configuration option.
! </td>
! </tr>
! </tbody>
! </table>
! <table border="0">
! <tbody>
! <tr>
! <td>
! <span class="emphasis"><i class=
! "EMPHASIS">http://<URL></i></span> - A redirect to
! any image anywhere of the user's choosing (advanced
! usage).
! </td>
! </tr>
! </tbody>
! </table>
! </li>
! </ul>
! <p>
! Advanced users will eventually want to explore <span class=
! "APPLICATION">Privoxy</span> <tt class="LITERAL"><a href=
! "actions-file.html#FILTER">filters</a></tt> as well. Filters are
! very different from <tt class="LITERAL"><a href=
! "actions-file.html#BLOCK">blocks</a></tt>. A <span class=
! "QUOTE">"block"</span> blocks a site, page, or unwanted contented.
! Filters are a way of filtering or modifying what is actually on the
! page. An example filter usage: a text replacement of <span class=
! "QUOTE">"no-no"</span> for <span class="QUOTE">"nasty-word"</span>.
! That is a very simple example. This process can be used for ad
! blocking, but it is more in the realm of advanced usage and has
! some pitfalls to be wary off.
! </p>
! <p>
! The quickest way to adjust any of these settings is with your
! browser through the special <span class=
! "APPLICATION">Privoxy</span> editor at <a href=
! "http://config.privoxy.org/show-status" target=
! "_top">http://config.privoxy.org/show-status</a> (shortcut: <a
! href="http://p.p/" target="_top">http://p.p/show-status</a>). This
! is an internal page, and does not require Internet access.
! </p>
! <p>
! Note that as of <span class="APPLICATION">Privoxy</span> 3.0.7 beta
! the action editor is disabled by default. Check the <a href=
! "config.html#ENABLE-EDIT-ACTIONS" target="_top">enable-edit-actions
! section in the configuration file</a> to learn why and in which
! cases it's safe to enable again.
! </p>
! <p>
! If you decided to enable the action editor, select the appropriate
! <span class="QUOTE">"actions"</span> file, and click <span class=
! "QUOTE">"<span class="GUIBUTTON">Edit</span>"</span>. It is best to
! put personal or local preferences in <tt class=
! "FILENAME">user.action</tt> since this is not meant to be
! overwritten during upgrades, and will over-ride the settings in
! other files. Here you can insert new <span class=
! "QUOTE">"actions"</span>, and URLs for ad blocking or other
! purposes, and make other adjustments to the configuration. <span
! class="APPLICATION">Privoxy</span> will detect these changes
! automatically.
! </p>
! <p>
! A quick and simple step by step example:
! </p>
! <p>
! </p>
! <ul>
! <li>
! <p>
! Right click on the ad image to be blocked, then select <span
! class="QUOTE">"<span class="GUIMENUITEM">Copy Link
! Location</span>"</span> from the pop-up menu.
! </p>
! </li>
! <li>
! <p>
! Set your browser to <a href=
! "http://config.privoxy.org/show-status" target=
! "_top">http://config.privoxy.org/show-status</a>
! </p>
! </li>
! <li>
! <p>
! Find <tt class="FILENAME">user.action</tt> in the top section,
! and click on <span class="QUOTE">"<span class=
! "GUIBUTTON">Edit</span>"</span>:
! </p>
! <p>
! </p>
! <div class="FIGURE">
! <a name="AEN612"></a>
! <p>
! <b>Figure 1. Actions Files in Use</b>
! </p>
! <div class="MEDIAOBJECT">
! <p>
! <img src="files-in-use.jpg">
! </p>
! </div>
! </div>
! </li>
! <li>
! <p>
! You should have a section with only <tt class="LITERAL"><a
! href="actions-file.html#BLOCK">block</a></tt> listed under
! <span class="QUOTE">"Actions:"</span>. If not, click a <span
! class="QUOTE">"<span class="GUIBUTTON">Insert new section
! below</span>"</span> button, and in the new section that just
! appeared, click the <span class="GUIBUTTON">Edit</span> button
! right under the word <span class="QUOTE">"Actions:"</span>.
! This will bring up a list of all actions. Find <tt class=
! "LITERAL"><a href="actions-file.html#BLOCK">block</a></tt> near
! the top, and click in the <span class="QUOTE">"Enabled"</span>
! column, then <span class="QUOTE">"<span class=
! "GUIBUTTON">Submit</span>"</span> just below the list.
! </p>
! </li>
! <li>
! <p>
! Now, in the <tt class="LITERAL"><a href=
! "actions-file.html#BLOCK">block</a></tt> actions section, click
! the <span class="QUOTE">"<span class=
! "GUIBUTTON">Add</span>"</span> button, and paste the URL the
! browser got from <span class="QUOTE">"<span class=
! "GUIMENUITEM">Copy Link Location</span>"</span>. Remove the <tt
! class="LITERAL">http://</tt> at the beginning of the URL. Then,
! click <span class="QUOTE">"<span class=
! "GUIBUTTON">Submit</span>"</span> (or <span class=
! "QUOTE">"<span class="GUIBUTTON">OK</span>"</span> if in a
! pop-up window).
! </p>
! </li>
! <li>
! <p>
! Now go back to the original page, and press <b class=
! "KEYCAP">SHIFT-Reload</b> (or flush all browser caches). The
! image should be gone now.
! </p>
! </li>
! </ul>
! <p>
! This is a very crude and simple example. There might be good
! reasons to use a wildcard pattern match to include potentially
! similar images from the same site. For a more extensive explanation
! of <span class="QUOTE">"patterns"</span>, and the entire actions
! concept, see <a href="actions-file.html">the Actions section</a>.
! </p>
! <p>
! For advanced users who want to hand edit their config files, you
! might want to now go to the <a href=
! "actions-file.html#ACT-EXAMPLES">Actions Files Tutorial</a>. The
! ideas explained therein also apply to the web-based editor.
! </p>
! <p>
! There are also various <a href=
! "actions-file.html#FILTER">filters</a> that can be used for ad
! blocking (filters are a special subset of actions). These fall into
! the <span class="QUOTE">"advanced"</span> usage category, and are
! explained in depth in later sections.
! </p>
! </div>
! </div>
! <div class="NAVFOOTER">
! <hr align="LEFT" width="100%">
! <table summary="Footer navigation table" width="100%" border="0"
! cellpadding="0" cellspacing="0">
! <tr>
! <td width="33%" align="left" valign="top">
! <a href="whatsnew.html" accesskey="P">Prev</a>
! </td>
! <td width="34%" align="center" valign="top">
! <a href="index.html" accesskey="H">Home</a>
! </td>
! <td width="33%" align="right" valign="top">
! <a href="startup.html" accesskey="N">Next</a>
! </td>
! </tr>
! <tr>
! <td width="33%" align="left" valign="top">
! What's New in this Release
! </td>
! <td width="34%" align="center" valign="top">
!
! </td>
! <td width="33%" align="right" valign="top">
! Starting Privoxy
! </td>
! </tr>
! </table>
</div>
! </body>
! </html>
--- 1,437 ----
! <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
! "http://www.w3.org/TR/html4/loose.dtd">
!
<html>
! <head>
! <title>Quickstart to Using Privoxy</title>
! <meta name="GENERATOR" content=
! "Modular DocBook HTML Stylesheet Version 1.79">
! <link rel="HOME" title="Privoxy 3.0.26 User Manual" href="index.html">
! <link rel="PREVIOUS" title="What's New in this Release" href=
! "whatsnew.html">
! <link rel="NEXT" title="Starting Privoxy" href="startup.html">
! <link rel="STYLESHEET" type="text/css" href="../p_doc.css">
! <meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
! <link rel="STYLESHEET" type="text/css" href="p_doc.css">
! </head>
!
! <body class="SECT1" bgcolor="#EEEEEE" text="#000000" link="#0000FF" vlink=
! "#840084" alink="#0000FF">
! <div class="NAVHEADER">
! <table summary="Header navigation table" width="100%" border="0"
! cellpadding="0" cellspacing="0">
! <tr>
! <th colspan="3" align="center">Privoxy 3.0.26 User Manual</th>
! </tr>
!
! <tr>
! <td width="10%" align="left" valign="bottom"><a href="whatsnew.html"
! accesskey="P">Prev</a></td>
!
! <td width="80%" align="center" valign="bottom"></td>
!
! <td width="10%" align="right" valign="bottom"><a href="startup.html"
! accesskey="N">Next</a></td>
! </tr>
! </table>
! <hr align="left" width="100%">
! </div>
!
! <div class="SECT1">
! <h1 class="SECT1"><a name="QUICKSTART" id="QUICKSTART">4. Quickstart to
! Using Privoxy</a></h1>
!
! <ul>
! <li>
! <p>Install <span class="APPLICATION">Privoxy</span>. See the <a href=
! "installation.html">Installation Section</a> below for platform
! specific information.</p>
! </li>
!
! <li>
! <p>Advanced users and those who want to offer <span class=
! "APPLICATION">Privoxy</span> service to more than just their local
! machine should check the <a href="config.html">main config file</a>,
! especially the <a href=
! "config.html#ACCESS-CONTROL">security-relevant</a> options. These are
! off by default.</p>
! </li>
!
! <li>
! <p>Start <span class="APPLICATION">Privoxy</span>, if the
! installation program has not done this already (may vary according to
! platform). See the section <a href="startup.html">Starting
! <span class="APPLICATION">Privoxy</span></a>.</p>
! </li>
!
! <li>
! <p>Set your browser to use <span class="APPLICATION">Privoxy</span>
! as HTTP and HTTPS (SSL) <a href=
! "http://en.wikipedia.org/wiki/Proxy_server" target="_top">proxy</a>
! by setting the proxy configuration for address of <tt class=
! "LITERAL">127.0.0.1</tt> and port <tt class="LITERAL">8118</tt>.
! <span class="emphasis"><i class="EMPHASIS">DO NOT</i></span> activate
! proxying for <tt class="LITERAL">FTP</tt> or any protocols besides
! HTTP and HTTPS (SSL) unless you intend to prevent your browser from
! using these protocols.</p>
! </li>
!
! <li>
! <p>Flush your browser's disk and memory caches, to remove any cached
! ad images. If using <span class="APPLICATION">Privoxy</span> to
! manage <a href="http://en.wikipedia.org/wiki/Browser_cookie" target=
! "_top">cookies</a>, you should remove any currently stored cookies
! too.</p>
! </li>
!
! <li>
! <p>A default installation should provide a reasonable starting point
! for most. There will undoubtedly be occasions where you will want to
! adjust the configuration, but that can be dealt with as the need
! arises. Little to no initial configuration is required in most cases,
! you may want to enable the <a href="config.html#ENABLE-EDIT-ACTIONS"
! target="_top">web-based action editor</a> though. Be sure to read the
! warnings first.</p>
!
! <p>See the <a href="configuration.html">Configuration section</a> for
! more configuration options, and how to customize your installation.
! You might also want to look at the <a href=
! "quickstart.html#QUICKSTART-AD-BLOCKING">next section</a> for a quick
! introduction to how <span class="APPLICATION">Privoxy</span> blocks
! ads and banners.</p>
! </li>
!
! <li>
! <p>If you experience ads that slip through, innocent images that are
! blocked, or otherwise feel the need to fine-tune <span class=
! "APPLICATION">Privoxy's</span> behavior, take a look at the <a href=
! "actions-file.html">actions files</a>. As a quick start, you might
! find the <a href="actions-file.html#ACT-EXAMPLES">richly commented
! examples</a> helpful. You can also view and edit the actions files
! through the <a href="http://config.privoxy.org" target=
! "_top">web-based user interface</a>. The Appendix <span class=
! "QUOTE">"<a href="appendix.html#ACTIONSANAT">Troubleshooting: Anatomy
! of an Action</a>"</span> has hints on how to understand and debug
! actions that <span class="QUOTE">"misbehave"</span>.</p>
! </li>
!
! <li>
! <p>Please see the section <a href="contact.html">Contacting the
! Developers</a> on how to report bugs, problems with websites or to
! get help.</p>
! </li>
!
! <li>
! <p>Now enjoy surfing with enhanced control, comfort and privacy!</p>
! </li>
! </ul>
!
! <div class="SECT2">
! <h2 class="SECT2"><a name="QUICKSTART-AD-BLOCKING" id=
! "QUICKSTART-AD-BLOCKING">4.1. Quickstart to Ad Blocking</a></h2>
!
! <p>Ad blocking is but one of <span class="APPLICATION">Privoxy's</span>
! array of features. Many of these features are for the technically
! minded advanced user. But, ad and banner blocking is surely common
! ground for everybody.</p>
!
! <p>This section will provide a quick summary of ad blocking so you can
! get up to speed quickly without having to read the more extensive
! information provided below, though this is highly recommended.</p>
!
! <p>First a bit of a warning ... blocking ads is much like blocking
! SPAM: the more aggressive you are about it, the more likely you are to
! block things that were not intended. And the more likely that some
! things may not work as intended. So there is a trade off here. If you
! want extreme ad free browsing, be prepared to deal with more
! <span class="QUOTE">"problem"</span> sites, and to spend more time
! adjusting the configuration to solve these unintended consequences. In
! short, there is not an easy way to eliminate <span class=
! "emphasis"><i class="EMPHASIS">all</i></span> ads. Either take the easy
! way and settle for <span class="emphasis"><i class=
! "EMPHASIS">most</i></span> ads blocked with the default configuration,
! or jump in and tweak it for your personal surfing habits and
! preferences.</p>
!
! <p>Secondly, a brief explanation of <span class=
! "APPLICATION">Privoxy's</span> <span class="QUOTE">"actions"</span>.
! <span class="QUOTE">"Actions"</span> in this context, are the
! directives we use to tell <span class="APPLICATION">Privoxy</span> to
! perform some task relating to HTTP transactions (i.e. web browsing). We
! tell <span class="APPLICATION">Privoxy</span> to take some <span class=
! "QUOTE">"action"</span>. Each action has a unique name and function.
! While there are many potential <span class="APPLICATION">actions</span>
! in <span class="APPLICATION">Privoxy's</span> arsenal, only a few are
! used for ad blocking. <a href="actions-file.html#ACTIONS">Actions</a>,
! and <a href="actions-file.html">action configuration files</a>, are
! explained in depth below.</p>
!
! <p>Actions are specified in <span class="APPLICATION">Privoxy's</span>
! configuration, followed by one or more URLs to which the action should
! apply. URLs can actually be URL type <a href=
! "actions-file.html#AF-PATTERNS">patterns</a> that use wildcards so they
! can apply potentially to a range of similar URLs. The actions, together
! with the URL patterns are called a section.</p>
!
! <p>When you connect to a website, the full URL will either match one or
! more of the sections as defined in <span class=
! "APPLICATION">Privoxy's</span> configuration, or not. If so, then
! <span class="APPLICATION">Privoxy</span> will perform the respective
! actions. If not, then nothing special happens. Furthermore, web pages
! may contain embedded, secondary URLs that your web browser will use to
! load additional components of the page, as it parses the original
! page's HTML content. An ad image for instance, is just an URL embedded
! in the page somewhere. The image itself may be on the same server, or a
! server somewhere else on the Internet. Complex web pages will have many
! such embedded URLs. <span class="APPLICATION">Privoxy</span> can deal
! with each URL individually, so, for instance, the main page text is not
! touched, but images from such-and-such server are blocked.</p>
!
! <p>The most important actions for basic ad blocking are: <tt class=
! "LITERAL"><a href="actions-file.html#BLOCK">block</a></tt>, <tt class=
! "LITERAL"><a href=
! "actions-file.html#HANDLE-AS-IMAGE">handle-as-image</a></tt>,
! <tt class="LITERAL"><a href=
! "actions-file.html#HANDLE-AS-EMPTY-DOCUMENT">handle-as-empty-document</a></tt>,and
! <tt class="LITERAL"><a href=
! "actions-file.html#SET-IMAGE-BLOCKER">set-image-blocker</a></tt>:</p>
!
<ul>
<li>
! <p><tt class="LITERAL"><a href=
! "actions-file.html#BLOCK">block</a></tt> - this is perhaps the
! single most used action, and is particularly important for ad
! blocking. This action stops any contact between your browser and
! any URL patterns that match this action's configuration. It can be
! used for blocking ads, but also anything that is determined to be
! unwanted. By itself, it simply stops any communication with the
! remote server and sends <span class="APPLICATION">Privoxy</span>'s
! own built-in BLOCKED page instead to let you now what has happened
! (with some exceptions, see below).</p>
</li>
+
<li>
! <p><tt class="LITERAL"><a href=
! "actions-file.html#HANDLE-AS-IMAGE">handle-as-image</a></tt> -
! tells <span class="APPLICATION">Privoxy</span> to treat this URL as
! an image. <span class="APPLICATION">Privoxy</span>'s default
! configuration already does this for all common image types (e.g.
! GIF), but there are many situations where this is not so easy to
! determine. So we'll force it in these cases. This is particularly
! important for ad blocking, since only if we know that it's an image
! of some kind, can we replace it with an image of our choosing,
! instead of the <span class="APPLICATION">Privoxy</span> BLOCKED
! page (which would only result in a <span class="QUOTE">"broken
! image"</span> icon). There are some limitations to this though. For
! instance, you can't just brute-force an image substitution for an
! entire HTML page in most situations.</p>
</li>
+
<li>
! <p><tt class="LITERAL"><a href=
! "actions-file.html#HANDLE-AS-EMPTY-DOCUMENT">handle-as-empty-document</a></tt>
! - sends an empty document instead of <span class=
! "APPLICATION">Privoxy's</span> normal BLOCKED HTML page. This is
! useful for file types that are neither HTML nor images, such as
! blocking JavaScript files.</p>
</li>
+
<li>
! <p><tt class="LITERAL"><a href=
! "actions-file.html#SET-IMAGE-BLOCKER">set-image-blocker</a></tt> -
! tells <span class="APPLICATION">Privoxy</span> what to display in
! place of an ad image that has hit a block rule. For this to come
! into play, the URL must match a <tt class="LITERAL"><a href=
! "actions-file.html#BLOCK">block</a></tt> action somewhere in the
! configuration, <span class="emphasis"><i class=
! "EMPHASIS">and</i></span>, it must also match an <tt class=
! "LITERAL"><a href=
! "actions-file.html#HANDLE-AS-IMAGE">handle-as-image</a></tt>
! action.</p>
!
! <p>The configuration options on what to display instead of the ad
! are:</p>
!
! <table border="0">
! <tbody>
! <tr>
! <td> <span class="emphasis"><i class=
! "EMPHASIS">pattern</i></span> - a checkerboard pattern, so
! that an ad replacement is obvious. This is the default.</td>
! </tr>
! </tbody>
! </table>
!
! <table border="0">
! <tbody>
! <tr>
! <td> <span class="emphasis"><i class=
! "EMPHASIS">blank</i></span> - A very small empty GIF image is
! displayed. This is the so-called <span class=
! "QUOTE">"invisible"</span> configuration option.</td>
! </tr>
! </tbody>
! </table>
!
! <table border="0">
! <tbody>
! <tr>
! <td> <span class="emphasis"><i class=
! "EMPHASIS">http://<URL></i></span> - A redirect to any
! image anywhere of the user's choosing (advanced usage).</td>
! </tr>
! </tbody>
! </table>
</li>
+ </ul>
+
+ <p>Advanced users will eventually want to explore <span class=
+ "APPLICATION">Privoxy</span> <tt class="LITERAL"><a href=
+ "actions-file.html#FILTER">filters</a></tt> as well. Filters are very
+ different from <tt class="LITERAL"><a href=
+ "actions-file.html#BLOCK">blocks</a></tt>. A <span class=
+ "QUOTE">"block"</span> blocks a site, page, or unwanted contented.
+ Filters are a way of filtering or modifying what is actually on the
+ page. An example filter usage: a text replacement of <span class=
+ "QUOTE">"no-no"</span> for <span class="QUOTE">"nasty-word"</span>.
+ That is a very simple example. This process can be used for ad
+ blocking, but it is more in the realm of advanced usage and has some
+ pitfalls to be wary off.</p>
+
+ <p>The quickest way to adjust any of these settings is with your
+ browser through the special <span class="APPLICATION">Privoxy</span>
+ editor at <a href="http://config.privoxy.org/show-status" target=
+ "_top">http://config.privoxy.org/show-status</a> (shortcut: <a href=
+ "http://p.p/" target="_top">http://p.p/show-status</a>). This is an
+ internal page, and does not require Internet access.</p>
+
+ <p>Note that as of <span class="APPLICATION">Privoxy</span> 3.0.7 beta
+ the action editor is disabled by default. Check the <a href=
+ "config.html#ENABLE-EDIT-ACTIONS" target="_top">enable-edit-actions
+ section in the configuration file</a> to learn why and in which cases
+ it's safe to enable again.</p>
+
+ <p>If you decided to enable the action editor, select the appropriate
+ <span class="QUOTE">"actions"</span> file, and click <span class=
+ "QUOTE">"<span class="GUIBUTTON">Edit</span>"</span>. It is best to put
+ personal or local preferences in <tt class="FILENAME">user.action</tt>
+ since this is not meant to be overwritten during upgrades, and will
+ over-ride the settings in other files. Here you can insert new
+ <span class="QUOTE">"actions"</span>, and URLs for ad blocking or other
+ purposes, and make other adjustments to the configuration. <span class=
+ "APPLICATION">Privoxy</span> will detect these changes
+ automatically.</p>
+
+ <p>A quick and simple step by step example:</p>
+
+ <ul>
<li>
! <p>Right click on the ad image to be blocked, then select
! <span class="QUOTE">"<span class="GUIMENUITEM">Copy Link
! Location</span>"</span> from the pop-up menu.</p>
</li>
+
<li>
! <p>Set your browser to <a href=
! "http://config.privoxy.org/show-status" target=
! "_top">http://config.privoxy.org/show-status</a></p>
</li>
+
<li>
! <p>Find <tt class="FILENAME">user.action</tt> in the top section,
! and click on <span class="QUOTE">"<span class=
! "GUIBUTTON">Edit</span>"</span>:</p>
!
! <div class="FIGURE">
! <a name="AEN657" id="AEN657"></a>
!
! <p><b>Figure 1. Actions Files in Use</b></p>
!
! <div class="MEDIAOBJECT">
! <p><img src="files-in-use.jpg"></p>
! </div>
! </div>
</li>
+
<li>
! <p>You should have a section with only <tt class="LITERAL"><a href=
! "actions-file.html#BLOCK">block</a></tt> listed under <span class=
! "QUOTE">"Actions:"</span>. If not, click a <span class=
! "QUOTE">"<span class="GUIBUTTON">Insert new section
! below</span>"</span> button, and in the new section that just
! appeared, click the <span class="GUIBUTTON">Edit</span> button
! right under the word <span class="QUOTE">"Actions:"</span>. This
! will bring up a list of all actions. Find <tt class=
! "LITERAL"><a href="actions-file.html#BLOCK">block</a></tt> near the
! top, and click in the <span class="QUOTE">"Enabled"</span> column,
! then <span class="QUOTE">"<span class=
! "GUIBUTTON">Submit</span>"</span> just below the list.</p>
</li>
+
<li>
! <p>Now, in the <tt class="LITERAL"><a href=
! "actions-file.html#BLOCK">block</a></tt> actions section, click the
! <span class="QUOTE">"<span class="GUIBUTTON">Add</span>"</span>
! button, and paste the URL the browser got from <span class=
! "QUOTE">"<span class="GUIMENUITEM">Copy Link
! Location</span>"</span>. Remove the <tt class=
! "LITERAL">http://</tt> at the beginning of the URL. Then, click
! <span class="QUOTE">"<span class="GUIBUTTON">Submit</span>"</span>
! (or <span class="QUOTE">"<span class="GUIBUTTON">OK</span>"</span>
! if in a pop-up window).</p>
! </li>
!
! <li>
! <p>Now go back to the original page, and press <b class=
! "KEYCAP">SHIFT-Reload</b> (or flush all browser caches). The image
! should be gone now.</p>
</li>
</ul>
! <p>This is a very crude and simple example. There might be good reasons
! to use a wildcard pattern match to include potentially similar images
! from the same site. For a more extensive explanation of <span class=
! "QUOTE">"patterns"</span>, and the entire actions concept, see <a href=
! "actions-file.html">the Actions section</a>.</p>
! <p>For advanced users who want to hand edit their config files, you
! might want to now go to the <a href=
! "actions-file.html#ACT-EXAMPLES">Actions Files Tutorial</a>. The ideas
! explained therein also apply to the web-based editor.</p>
! <p>There are also various <a href=
! "actions-file.html#FILTER">filters</a> that can be used for ad blocking
! (filters are a special subset of actions). These fall into the
! <span class="QUOTE">"advanced"</span> usage category, and are explained
! in depth in later sections.</p>
</div>
! </div>
+ <div class="NAVFOOTER">
+ <hr align="left" width="100%">
+
+ <table summary="Footer navigation table" width="100%" border="0"
+ cellpadding="0" cellspacing="0">
+ <tr>
+ <td width="33%" align="left" valign="top"><a href="whatsnew.html"
+ accesskey="P">Prev</a></td>
+
+ <td width="34%" align="center" valign="top"><a href="index.html"
+ accesskey="H">Home</a></td>
+
+ <td width="33%" align="right" valign="top"><a href="startup.html"
+ accesskey="N">Next</a></td>
+ </tr>
+
+ <tr>
+ <td width="33%" align="left" valign="top">What's New in this
+ Release</td>
+
+ <td width="34%" align="center" valign="top"> </td>
+
+ <td width="33%" align="right" valign="top">Starting Privoxy</td>
+ </tr>
+ </table>
+ </div>
+ </body>
+ </html>
Index: config.html
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/config.html,v
retrieving revision 1.76
retrieving revision 1.77
diff -C2 -d -r1.76 -r1.77
*** config.html 28 Jul 2016 08:25:50 -0000 1.76
--- config.html 26 Aug 2016 03:45:37 -0000 1.77
***************
*** 1,1046 ****
! <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01
! Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
<html>
! <head>
! <title>
! The Main Configuration File
! </title>
! <meta name="GENERATOR" content=
! "Modular DocBook HTML Stylesheet Version 1.79">
! <link rel="HOME" title="Privoxy 3.0.26 User Manual" href="index.html">
[...7740 lines suppressed...]
+ "configuration.html" accesskey="P">Prev</a></td>
+
+ <td width="34%" align="center" valign="top"><a href="index.html"
+ accesskey="H">Home</a></td>
+
+ <td width="33%" align="right" valign="top"><a href=
+ "actions-file.html" accesskey="N">Next</a></td>
+ </tr>
+
+ <tr>
+ <td width="33%" align="left" valign="top">Privoxy Configuration</td>
+
+ <td width="34%" align="center" valign="top"> </td>
+
+ <td width="33%" align="right" valign="top">Actions Files</td>
+ </tr>
+ </table>
+ </div>
+ </body>
+ </html>
------------------------------------------------------------------------------