current/doc/webserver/user-manual actions-file.html, 1.102, 1.103 appendix.html, 1.111, 1.112 config.html, 1.77, 1.78 configuration.html, 1.94, 1.95 contact.html, 1.68, 1.69 copyright.html, 1.103, 1.104 filter-file.html, 1.95, 1.96 index.html, 1.123, 1.124 installation.html, 1.76, 1.77 introduction.html, 1.64, 1.65 quickstart.html, 1.84, 1.85 seealso.html, 1.57, 1.58 startup.html, 1.86, 1.87 templates.html, 1.44, 1.45 whatsnew.html, 1.82, 1.83
Fabian Keil <[email protected]> Fri, 26 Aug 2016 12:32:51 +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-serv30811/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:
Rebuild HTML docs for 3.0.26 stable
This commit yet again introduces lots of white-space
changes as the tidy output apparently isn't stable
across platforms.
Index: whatsnew.html
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/whatsnew.html,v
retrieving revision 1.82
retrieving revision 1.83
diff -C2 -d -r1.82 -r1.83
*** whatsnew.html 26 Aug 2016 03:45:37 -0000 1.82
--- whatsnew.html 26 Aug 2016 12:32:49 -0000 1.83
***************
*** 1,589 ****
! <!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">
! <link rel="PREVIOUS" title="Installation" href="installation.html">
[...1246 lines suppressed...]
! <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.76
retrieving revision 1.77
diff -C2 -d -r1.76 -r1.77
*** installation.html 26 Aug 2016 03:45:37 -0000 1.76
--- installation.html 26 Aug 2016 12:32:49 -0000 1.77
***************
*** 1,330 ****
! <!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">
! <link rel="PREVIOUS" title="Introduction" href="introduction.html">
[...1090 lines suppressed...]
! <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.111
retrieving revision 1.112
diff -C2 -d -r1.111 -r1.112
*** appendix.html 26 Aug 2016 03:45:37 -0000 1.111
--- appendix.html 26 Aug 2016 12:32:49 -0000 1.112
***************
*** 1,585 ****
! <!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">
! <link rel="PREVIOUS" title="See Also" href="seealso.html">
[...1878 lines suppressed...]
+ <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.57
retrieving revision 1.58
diff -C2 -d -r1.57 -r1.58
*** seealso.html 26 Aug 2016 03:45:37 -0000 1.57
--- seealso.html 26 Aug 2016 12:32:49 -0000 1.58
***************
*** 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>
--- 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>
+
Index: actions-file.html
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/actions-file.html,v
retrieving revision 1.102
retrieving revision 1.103
diff -C2 -d -r1.102 -r1.103
*** actions-file.html 26 Aug 2016 03:45:37 -0000 1.102
--- actions-file.html 26 Aug 2016 12:32:49 -0000 1.103
***************
*** 1,400 ****
! <!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">
! <link rel="PREVIOUS" title="The Main Configuration File" href=
[...11249 lines suppressed...]
! <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.64
retrieving revision 1.65
diff -C2 -d -r1.64 -r1.65
*** introduction.html 26 Aug 2016 03:45:37 -0000 1.64
--- introduction.html 26 Aug 2016 12:32:49 -0000 1.65
***************
*** 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>
--- 1,193 ----
! <!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 stable version of
! <span class="APPLICATION">Privoxy</span>, 3.0.26.
! </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,
! 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>
+
Index: index.html
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/index.html,v
retrieving revision 1.123
retrieving revision 1.124
diff -C2 -d -r1.123 -r1.124
*** index.html 26 Aug 2016 03:45:37 -0000 1.123
--- index.html 26 Aug 2016 12:32:49 -0000 1.124
***************
*** 1,641 ****
! <!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">
! <link rel="STYLESHEET" type="text/css" href="../p_doc.css">
[...1415 lines suppressed...]
! <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.86
retrieving revision 1.87
diff -C2 -d -r1.86 -r1.87
*** startup.html 26 Aug 2016 03:45:37 -0000 1.86
--- startup.html 26 Aug 2016 12:32:49 -0000 1.87
***************
*** 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>
--- 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="AEN710"></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="AEN755"></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>
+
Index: contact.html
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/contact.html,v
retrieving revision 1.68
retrieving revision 1.69
diff -C2 -d -r1.68 -r1.69
*** contact.html 26 Aug 2016 03:45:37 -0000 1.68
--- contact.html 26 Aug 2016 12:32:49 -0000 1.69
***************
*** 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>
--- 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>
+
Index: filter-file.html
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/filter-file.html,v
retrieving revision 1.95
retrieving revision 1.96
diff -C2 -d -r1.95 -r1.96
*** filter-file.html 26 Aug 2016 03:45:37 -0000 1.95
--- filter-file.html 26 Aug 2016 12:32:49 -0000 1.96
***************
*** 1,213 ****
! <!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">
! <link rel="PREVIOUS" title="Actions Files" href="actions-file.html">
[...2003 lines suppressed...]
! <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.94
retrieving revision 1.95
diff -C2 -d -r1.94 -r1.95
*** configuration.html 26 Aug 2016 03:45:37 -0000 1.94
--- configuration.html 26 Aug 2016 12:32:49 -0000 1.95
***************
*** 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>
--- 1,299 ----
! <!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="AEN902"></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.
! </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>
! </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.44
retrieving revision 1.45
diff -C2 -d -r1.44 -r1.45
*** templates.html 26 Aug 2016 03:45:37 -0000 1.44
--- templates.html 26 Aug 2016 12:32:49 -0000 1.45
***************
*** 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 -->
--- 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 -->
***************
*** 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>
--- 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>
+
Index: copyright.html
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/copyright.html,v
retrieving revision 1.103
retrieving revision 1.104
diff -C2 -d -r1.103 -r1.104
*** copyright.html 26 Aug 2016 03:45:37 -0000 1.103
--- copyright.html 26 Aug 2016 12:32:49 -0000 1.104
***************
*** 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
--- 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
***************
*** 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>
--- 409,677 ----
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>
+ 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.84
retrieving revision 1.85
diff -C2 -d -r1.84 -r1.85
*** quickstart.html 26 Aug 2016 03:45:37 -0000 1.84
--- quickstart.html 26 Aug 2016 12:32:49 -0000 1.85
***************
*** 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>
--- 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="AEN655"></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.77
retrieving revision 1.78
diff -C2 -d -r1.77 -r1.78
*** config.html 26 Aug 2016 03:45:37 -0000 1.77
--- config.html 26 Aug 2016 12:32:49 -0000 1.78
***************
*** 1,870 ****
! <!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">
! <link rel="PREVIOUS" title="Privoxy Configuration" href=
[...7740 lines suppressed...]
! <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>
+
------------------------------------------------------------------------------