current/doc/webserver/user-manual actions-file.html, 1.103, 1.104 appendix.html, 1.112, 1.113 config.html, 1.78, 1.79 configuration.html, 1.95, 1.96 contact.html, 1.69, 1.70 copyright.html, 1.104, 1.105 filter-file.html, 1.96, 1.97 index.html, 1.124, 1.125 installation.html, 1.77, 1.78 introduction.html, 1.65, 1.66 quickstart.html, 1.85, 1.86 seealso.html, 1.58, 1.59 startup.html, 1.87, 1.88 templates.html, 1.45, 1.46 whatsnew.html, 1.84, 1.85
Fabian Keil <[email protected]> Thu, 12 Jan 2017 14:27:49 +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-serv24265/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:
Regenerate HTML docs with recent changes
configure.in has been locally reverted to r1.204
to get 3.0.26 stable documentation that can be put
on the webserver before the next release.
Tidied with tidy 5.2.0 from http://www.html-tidy.org/.
As an expected side effect the diff is bloated enough
to be considered a "rewrite" by git (again), but using
a more recent tidy version should make it easier to
prevent frequent diff bloat in the future when building
on different platforms.
As an unexpected side-effect some pre tags are messed
up now and their first line contains bogus white-space
that causes rendering issues. This regression should
be analysed and fixed or worked around before the next
release but doesn't seem critical.
It's conceivable that the tidy upgrade caused less
obvious regressions that have yet to be found.
Index: whatsnew.html
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/whatsnew.html,v
retrieving revision 1.84
retrieving revision 1.85
diff -C2 -d -r1.84 -r1.85
*** whatsnew.html 26 Aug 2016 13:15:05 -0000 1.84
--- whatsnew.html 12 Jan 2017 14:27:47 -0000 1.85
***************
*** 1,685 ****
! <!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">
[...1132 lines suppressed...]
! <table summary="Footer navigation table" width="100%" border="0"
! cellpadding="0" cellspacing="0">
! <tr>
! <td width="33%" align="left" valign="top"><a href="installation.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="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.77
retrieving revision 1.78
diff -C2 -d -r1.77 -r1.78
*** installation.html 26 Aug 2016 12:32:49 -0000 1.77
--- installation.html 12 Jan 2017 14:27:47 -0000 1.78
***************
*** 1,385 ****
! <!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">
[...1000 lines suppressed...]
! <table summary="Footer navigation table" width="100%" border="0"
! cellpadding="0" cellspacing="0">
! <tr>
! <td width="33%" align="left" valign="top"><a href="introduction.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="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.112
retrieving revision 1.113
diff -C2 -d -r1.112 -r1.113
*** appendix.html 26 Aug 2016 12:32:49 -0000 1.112
--- appendix.html 12 Jan 2017 14:27:47 -0000 1.113
***************
*** 1,677 ****
! <!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">
[...1792 lines suppressed...]
! <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="seealso.html"
! accesskey="P">Prev</a></td>
! <td width="34%" align="center" valign="top"><a href="index.html"
! accesskey="H">Home</a></td>
! <td width="33%" align="right" valign="top"> </td>
! </tr>
! <tr>
! <td width="33%" align="left" valign="top">See Also</td>
! <td width="34%" align="center" valign="top"> </td>
! <td width="33%" align="right" valign="top"> </td>
! </tr>
! </table>
! </div>
! </body>
</html>
Index: seealso.html
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/seealso.html,v
retrieving revision 1.58
retrieving revision 1.59
diff -C2 -d -r1.58 -r1.59
*** seealso.html 26 Aug 2016 12:32:49 -0000 1.58
--- seealso.html 12 Jan 2017 14:27:47 -0000 1.59
***************
*** 1,195 ****
! <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01
! Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
<html>
! <head>
! <title>
! See Also
! </title>
! <meta name="GENERATOR" content=
! "Modular DocBook HTML Stylesheet Version 1.79">
! <link rel="HOME" title="Privoxy 3.0.26 User Manual" href="index.html">
! <link rel="PREVIOUS" title="Privoxy Copyright, License and History" href=
! "copyright.html">
! <link rel="NEXT" title="Appendix" href="appendix.html">
! <link rel="STYLESHEET" type="text/css" href="../p_doc.css">
! <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
! <link rel="STYLESHEET" type="text/css" href="p_doc.css">
! </head>
! <body class="SECT1" bgcolor="#EEEEEE" text="#000000" link="#0000FF" vlink=
! "#840084" alink="#0000FF">
! <div class="NAVHEADER">
! <table summary="Header navigation table" width="100%" border="0"
! cellpadding="0" cellspacing="0">
<tr>
! <th colspan="3" align="center">
! Privoxy 3.0.26 User Manual
! </th>
</tr>
<tr>
! <td width="10%" align="left" valign="bottom">
! <a href="copyright.html" accesskey="P">Prev</a>
! </td>
! <td width="80%" align="center" valign="bottom">
! </td>
! <td width="10%" align="right" valign="bottom">
! <a href="appendix.html" accesskey="N">Next</a>
! </td>
</tr>
! </table>
! <hr align="LEFT" width="100%">
! </div>
! <div class="SECT1">
! <h1 class="SECT1">
! <a name="SEEALSO">13. See Also</a>
! </h1>
! <p>
! Other references and sites of interest to <span class=
! "APPLICATION">Privoxy</span> users:
! </p>
! <p>
! </p>
! <table border="0">
! <tbody>
! <tr>
! <td>
! <a href="https://www.privoxy.org/" target=
! "_top">https://www.privoxy.org/</a>, the <span class=
! "APPLICATION">Privoxy</span> Home page.
! </td>
! </tr>
! </tbody>
! </table>
! <table border="0">
! <tbody>
! <tr>
! <td>
! <a href="https://www.privoxy.org/faq/" target=
! "_top">https://www.privoxy.org/faq/</a>, the <span class=
! "APPLICATION">Privoxy</span> FAQ.
! </td>
! </tr>
! </tbody>
! </table>
! <table border="0">
! <tbody>
! <tr>
! <td>
! <a href="https://www.privoxy.org/developer-manual/" target=
! "_top">https://www.privoxy.org/developer-manual/</a>, the <span
! class="APPLICATION">Privoxy</span> developer manual.
! </td>
! </tr>
! </tbody>
! </table>
! <table border="0">
! <tbody>
! <tr>
! <td>
! <a href="https://sourceforge.net/projects/ijbswa/" target=
! "_top">https://sourceforge.net/projects/ijbswa/</a>, the
! Project Page for <span class="APPLICATION">Privoxy</span> on <a
! href="http://sourceforge.net" target="_top">SourceForge</a>.
! </td>
! </tr>
! </tbody>
! </table>
! <table border="0">
! <tbody>
! <tr>
! <td>
! <a href="http://config.privoxy.org/" target=
! "_top">http://config.privoxy.org/</a>, the web-based user
! interface. <span class="APPLICATION">Privoxy</span> must be
! running for this to work. Shortcut: <a href="http://p.p/"
! target="_top">http://p.p/</a>
! </td>
! </tr>
! </tbody>
! </table>
! <table border="0">
! <tbody>
! <tr>
! <td>
! <a href=
! "https://sourceforge.net/tracker/?group_id=11118&atid=460288"
! target=
! "_top">https://sourceforge.net/tracker/?group_id=11118&atid=460288</a>,
! to submit <span class="QUOTE">"misses"</span> and other
! configuration related suggestions to the developers.
! </td>
! </tr>
! </tbody>
! </table>
! <table border="0">
! <tbody>
! <tr>
! <td>
! <a href="http://www.squid-cache.org/" target=
! "_top">http://www.squid-cache.org/</a>, a popular caching
! proxy, which is often used together with <span class=
! "APPLICATION">Privoxy</span>.
! </td>
! </tr>
! </tbody>
! </table>
! <table border="0">
! <tbody>
! <tr>
! <td>
! <a href=
! "http://www.pps.univ-paris-diderot.fr/~jch/software/polipo/"
! target=
! "_top">http://www.pps.univ-paris-diderot.fr/~jch/software/polipo/</a>,
! <span class="APPLICATION">Polipo</span> is a caching proxy with
! advanced features like pipelining, multiplexing and caching of
! partial instances. In many setups it can be used as <span
! class="APPLICATION">Squid</span> replacement.
! </td>
! </tr>
! </tbody>
! </table>
! <table border="0">
! <tbody>
! <tr>
! <td>
! <a href="https://www.torproject.org/" target=
! "_top">https://www.torproject.org/</a>, <span class=
! "APPLICATION">Tor</span> can help anonymize web browsing, web
! publishing, instant messaging, IRC, SSH, and other
! applications.
! </td>
! </tr>
! </tbody>
! </table>
! </div>
! <div class="NAVFOOTER">
! <hr align="LEFT" width="100%">
! <table summary="Footer navigation table" width="100%" border="0"
! cellpadding="0" cellspacing="0">
<tr>
! <td width="33%" align="left" valign="top">
! <a href="copyright.html" accesskey="P">Prev</a>
! </td>
! <td width="34%" align="center" valign="top">
! <a href="index.html" accesskey="H">Home</a>
! </td>
! <td width="33%" align="right" valign="top">
! <a href="appendix.html" accesskey="N">Next</a>
! </td>
</tr>
<tr>
! <td width="33%" align="left" valign="top">
! Privoxy Copyright, License and History
! </td>
! <td width="34%" align="center" valign="top">
!
! </td>
! <td width="33%" align="right" valign="top">
! Appendix
! </td>
</tr>
! </table>
! </div>
! </body>
</html>
-
--- 1,154 ----
! <!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=utf-8">
! <link rel="STYLESHEET" type="text/css" href="p_doc.css">
! </head>
! <body class="SECT1" bgcolor="#EEEEEE" text="#000000" link="#0000FF" vlink=
! "#840084" alink="#0000FF">
! <div class="NAVHEADER">
! <table summary="Header navigation table" width="100%" border="0"
! cellpadding="0" cellspacing="0">
! <tr>
! <th colspan="3" align="center">Privoxy 3.0.26 User Manual</th>
! </tr>
! <tr>
! <td width="10%" align="left" valign="bottom"><a href="copyright.html"
! accesskey="P">Prev</a></td>
! <td width="80%" align="center" valign="bottom"></td>
! <td width="10%" align="right" valign="bottom"><a href="appendix.html"
! accesskey="N">Next</a></td>
! </tr>
! </table>
! <hr align="left" width="100%">
! </div>
! <div class="SECT1">
! <h1 class="SECT1"><a name="SEEALSO" id="SEEALSO">13. See Also</a></h1>
! <p>Other references and sites of interest to <span class=
! "APPLICATION">Privoxy</span> users:</p>
! <table border="0">
! <tbody>
<tr>
! <td><a href="https://www.privoxy.org/" target=
! "_top">https://www.privoxy.org/</a>, the <span class=
! "APPLICATION">Privoxy</span> Home page.</td>
</tr>
+ </tbody>
+ </table>
+ <table border="0">
+ <tbody>
<tr>
! <td><a href="https://www.privoxy.org/faq/" target=
! "_top">https://www.privoxy.org/faq/</a>, the <span class=
! "APPLICATION">Privoxy</span> FAQ.</td>
</tr>
! </tbody>
! </table>
! <table border="0">
! <tbody>
<tr>
! <td><a href="https://www.privoxy.org/developer-manual/" target=
! "_top">https://www.privoxy.org/developer-manual/</a>, the
! <span class="APPLICATION">Privoxy</span> developer manual.</td>
</tr>
+ </tbody>
+ </table>
+ <table border="0">
+ <tbody>
<tr>
! <td><a href="https://sourceforge.net/projects/ijbswa/" target=
! "_top">https://sourceforge.net/projects/ijbswa/</a>, the Project
! Page for <span class="APPLICATION">Privoxy</span> on <a href=
! "http://sourceforge.net" target="_top">SourceForge</a>.</td>
</tr>
! </tbody>
! </table>
! <table border="0">
! <tbody>
! <tr>
! <td><a href="http://config.privoxy.org/" target=
! "_top">http://config.privoxy.org/</a>, the web-based user
! interface. <span class="APPLICATION">Privoxy</span> must be running
! for this to work. Shortcut: <a href="http://p.p/" target=
! "_top">http://p.p/</a></td>
! </tr>
! </tbody>
! </table>
! <table border="0">
! <tbody>
! <tr>
! <td><a href=
! "https://sourceforge.net/tracker/?group_id=11118&atid=460288"
! target=
! "_top">https://sourceforge.net/tracker/?group_id=11118&atid=460288</a>,
! to submit <span class="QUOTE">"misses"</span> and other
! configuration related suggestions to the developers.</td>
! </tr>
! </tbody>
! </table>
! <table border="0">
! <tbody>
! <tr>
! <td><a href="http://www.squid-cache.org/" target=
! "_top">http://www.squid-cache.org/</a>, a popular caching proxy,
! which is often used together with <span class=
! "APPLICATION">Privoxy</span>.</td>
! </tr>
! </tbody>
! </table>
! <table border="0">
! <tbody>
! <tr>
! <td><a href=
! "http://www.pps.univ-paris-diderot.fr/~jch/software/polipo/"
! target="_top">http://www.pps.univ-paris-diderot.fr/~jch/software/polipo/</a>,
! <span class="APPLICATION">Polipo</span> is a caching proxy with
! advanced features like pipelining, multiplexing and caching of
! partial instances. In many setups it can be used as <span class=
! "APPLICATION">Squid</span> replacement.</td>
! </tr>
! </tbody>
! </table>
! <table border="0">
! <tbody>
! <tr>
! <td><a href="https://www.torproject.org/" target=
! "_top">https://www.torproject.org/</a>, <span class=
! "APPLICATION">Tor</span> can help anonymize web browsing, web
! publishing, instant messaging, IRC, SSH, and other
! applications.</td>
! </tr>
! </tbody>
! </table>
! </div>
! <div class="NAVFOOTER">
! <hr align="left" width="100%">
! <table summary="Footer navigation table" width="100%" border="0"
! cellpadding="0" cellspacing="0">
! <tr>
! <td width="33%" align="left" valign="top"><a href="copyright.html"
! accesskey="P">Prev</a></td>
! <td width="34%" align="center" valign="top"><a href="index.html"
! accesskey="H">Home</a></td>
! <td width="33%" align="right" valign="top"><a href="appendix.html"
! accesskey="N">Next</a></td>
! </tr>
! <tr>
! <td width="33%" align="left" valign="top">Privoxy Copyright, License
! and History</td>
! <td width="34%" align="center" valign="top"> </td>
! <td width="33%" align="right" valign="top">Appendix</td>
! </tr>
! </table>
! </div>
! </body>
</html>
Index: actions-file.html
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/actions-file.html,v
retrieving revision 1.103
retrieving revision 1.104
diff -C2 -d -r1.103 -r1.104
*** actions-file.html 26 Aug 2016 12:32:49 -0000 1.103
--- actions-file.html 12 Jan 2017 14:27:46 -0000 1.104
***************
*** 1,1041 ****
! <!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">
[...10382 lines suppressed...]
! <table summary="Footer navigation table" width="100%" border="0"
! cellpadding="0" cellspacing="0">
! <tr>
! <td width="33%" align="left" valign="top"><a href="config.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="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.65
retrieving revision 1.66
diff -C2 -d -r1.65 -r1.66
*** introduction.html 26 Aug 2016 12:32:49 -0000 1.65
--- introduction.html 12 Jan 2017 14:27:47 -0000 1.66
***************
*** 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>
-
--- 1,138 ----
! <!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=utf-8">
! <link rel="STYLESHEET" type="text/css" href="p_doc.css">
! </head>
! <body class="SECT1" bgcolor="#EEEEEE" text="#000000" link="#0000FF" vlink=
! "#840084" alink="#0000FF">
! <div class="NAVHEADER">
! <table summary="Header navigation table" width="100%" border="0"
! cellpadding="0" cellspacing="0">
! <tr>
! <th colspan="3" align="center">Privoxy 3.0.26 User Manual</th>
! </tr>
! <tr>
! <td width="10%" align="left" valign="bottom"><a href="index.html"
! accesskey="P">Prev</a></td>
! <td width="80%" align="center" valign="bottom"></td>
! <td width="10%" align="right" valign="bottom"><a href=
! "installation.html" accesskey="N">Next</a></td>
! </tr>
! </table>
! <hr align="left" width="100%">
! </div>
! <div class="SECT1">
! <h1 class="SECT1"><a name="INTRODUCTION" id="INTRODUCTION">1.
! Introduction</a></h1>
! <p>This documentation is included with the current stable version of
! <span class="APPLICATION">Privoxy</span>, 3.0.26.</p>
! <div class="SECT2">
! <h2 class="SECT2"><a name="FEATURES" id="FEATURES">1.1.
! Features</a></h2>
! <p>In addition to the core features of ad blocking and <a href=
! "http://en.wikipedia.org/wiki/Browser_cookie" target="_top">cookie</a>
! management, <span class="APPLICATION">Privoxy</span> provides many
! supplemental features, that give the end-user more control, more
! privacy and more freedom:</p>
! <ul>
! <li>
! <p>Supports "Connection: keep-alive". Outgoing connections can be
! kept alive independently from the client.</p>
! </li>
! <li>
! <p>Supports IPv6, provided the operating system does so too, and
! the configure script detects it.</p>
! </li>
! <li>
! <p>Supports tagging which allows to change the behaviour based on
! client and server headers.</p>
! </li>
! <li>
! <p>Can be run as an "intercepting" proxy, which obviates the need
! to configure browsers individually.</p>
! </li>
! <li>
! <p>Sophisticated actions and filters for manipulating both server
! and client headers.</p>
! </li>
! <li>
! <p>Can be chained with other proxies.</p>
! </li>
! <li>
! <p>Integrated browser-based configuration and control utility at
! <a href="http://config.privoxy.org/" target=
! "_top">http://config.privoxy.org/</a> (shortcut: <a href=
! "http://p.p/" target="_top">http://p.p/</a>). Browser-based tracing
! of rule and filter effects. Remote toggling.</p>
! </li>
! <li>
! <p>Web page filtering (text replacements, removes banners based on
! size, invisible <span class="QUOTE">"web-bugs"</span> and HTML
! annoyances, etc.)</p>
! </li>
! <li>
! <p>Modularized configuration that allows for standard settings and
! user settings to reside in separate files, so that installing
! updated actions files won't overwrite individual user settings.</p>
! </li>
! <li>
! <p>Support for Perl Compatible Regular Expressions in the
! configuration files, and a more sophisticated and flexible
! configuration syntax.</p>
! </li>
! <li>
! <p>GIF de-animation.</p>
! </li>
! <li>
! <p>Bypass many click-tracking scripts (avoids script
! redirection).</p>
! </li>
! <li>
! <p>User-customizable HTML templates for most proxy-generated pages
! (e.g. "blocked" page).</p>
! </li>
! <li>
! <p>Auto-detection and re-reading of config file changes.</p>
! </li>
! <li>
! <p>Most features are controllable on a per-site or per-location
! basis.</p>
! </li>
! <li>
! <p>Many smaller new features added, limitations and bugs
! removed.</p>
! </li>
! </ul>
</div>
! </div>
! <div class="NAVFOOTER">
! <hr align="left" width="100%">
! <table summary="Footer navigation table" width="100%" border="0"
! cellpadding="0" cellspacing="0">
! <tr>
! <td width="33%" align="left" valign="top"><a href="index.html"
! accesskey="P">Prev</a></td>
! <td width="34%" align="center" valign="top"><a href="index.html"
! accesskey="H">Home</a></td>
! <td width="33%" align="right" valign="top"><a href=
! "installation.html" accesskey="N">Next</a></td>
! </tr>
! <tr>
! <td width="33%" align="left" valign="top">Privoxy 3.0.26 User
! Manual</td>
! <td width="34%" align="center" valign="top"> </td>
! <td width="33%" align="right" valign="top">Installation</td>
! </tr>
! </table>
! </div>
! </body>
</html>
Index: index.html
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/index.html,v
retrieving revision 1.124
retrieving revision 1.125
diff -C2 -d -r1.124 -r1.125
*** index.html 26 Aug 2016 12:32:49 -0000 1.124
--- index.html 12 Jan 2017 14:27:47 -0000 1.125
***************
*** 1,803 ****
! <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01
! Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
<html>
! <head>
! <title>
! Privoxy 3.0.26 User Manual
! </title>
! <meta name="GENERATOR" content=
! "Modular DocBook HTML Stylesheet Version 1.79">
! <link rel="NEXT" title="Introduction" href="introduction.html">
[...1238 lines suppressed...]
! </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"> </td>
! <td width="34%" align="center" valign="top"> </td>
! <td width="33%" align="right" valign="top"><a href=
! "introduction.html" accesskey="N">Next</a></td>
! </tr>
! <tr>
! <td width="33%" align="left" valign="top"> </td>
! <td width="34%" align="center" valign="top"> </td>
! <td width="33%" align="right" valign="top">Introduction</td>
! </tr>
! </table>
! </div>
! </body>
</html>
Index: startup.html
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/startup.html,v
retrieving revision 1.87
retrieving revision 1.88
diff -C2 -d -r1.87 -r1.88
*** startup.html 26 Aug 2016 12:32:49 -0000 1.87
--- startup.html 12 Jan 2017 14:27:47 -0000 1.88
***************
*** 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>
-
--- 1,332 ----
! <!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=utf-8">
! <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="AEN710" id="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>
! <div class="FIGURE">
! <a name="AEN755" id="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" id="START-DEBIAN">5.1.
! Debian</a></h2>
! <p>We use a script. Note that Debian typically starts <span class=
! "APPLICATION">Privoxy</span> upon booting per default. It will use the
! file <tt class="FILENAME">/etc/privoxy/config</tt> as its main
! configuration file.</p>
! <table border="0" bgcolor="#E0E0E0" width="100%">
<tr>
! <td>
! <pre class="SCREEN"> # /etc/init.d/privoxy start</pre>
</td>
</tr>
</table>
</div>
! <div class="SECT2">
! <h2 class="SECT2"><a name="START-FREEBSD" id="START-FREEBSD">5.2.
! FreeBSD and ElectroBSD</a></h2>
! <p>To start <span class="APPLICATION">Privoxy</span> upon booting, add
! "privoxy_enable='YES'" to <tt class="FILENAME">/etc/rc.conf</tt>.
! <span class="APPLICATION">Privoxy</span> will use <tt class=
! "FILENAME">/usr/local/etc/privoxy/config</tt> as its main configuration
! file.</p>
! <p>If you installed <span class="APPLICATION">Privoxy</span> into a
! jail, the paths above are relative to the jail root.</p>
! <p>To start <span class="APPLICATION">Privoxy</span> manually, run:</p>
! <table border="0" bgcolor="#E0E0E0" width="100%">
<tr>
! <td>
! <pre class="SCREEN"> # service privoxy onestart</pre>
</td>
</tr>
+ </table>
+ </div>
+ <div class="SECT2">
+ <h2 class="SECT2"><a name="START-WINDOWS" id="START-WINDOWS">5.3.
+ Windows</a></h2>
+ <p>Click on the <span class="APPLICATION">Privoxy</span> Icon to start
+ <span class="APPLICATION">Privoxy</span>. If no configuration file is
+ specified on the command line, <span class="APPLICATION">Privoxy</span>
+ will look for a file named <tt class="FILENAME">config.txt</tt>. Note
+ that Windows will automatically start <span class=
+ "APPLICATION">Privoxy</span> when the system starts if you chose that
+ option when installing.</p>
+ <p><span class="APPLICATION">Privoxy</span> can run with full Windows
+ service functionality. On Windows only, the <span class=
+ "APPLICATION">Privoxy</span> program has two new command line arguments
+ to install and uninstall <span class="APPLICATION">Privoxy</span> as a
+ service. See the <a href=
+ "installation.html#INSTALLATION-PACK-WIN">Windows Installation
+ instructions</a> for details.</p>
+ </div>
+ <div class="SECT2">
+ <h2 class="SECT2"><a name="START-UNICES" id="START-UNICES">5.4. Generic
+ instructions for Unix derivates (Solaris, NetBSD, HP-UX etc.)</a></h2>
+ <p>Example Unix startup command:</p>
+ <table border="0" bgcolor="#E0E0E0" width="100%">
<tr>
! <td>
! <pre class="SCREEN">
! # /usr/sbin/privoxy --user privoxy /etc/privoxy/config</pre>
</td>
</tr>
</table>
+ <p>Note that if you installed <span class="APPLICATION">Privoxy</span>
+ through a package manager, the package will probably contain a
+ platform-specific script or configuration file to start <span class=
+ "APPLICATION">Privoxy</span> upon boot.</p>
</div>
! <div class="SECT2">
! <h2 class="SECT2"><a name="START-OS2" id="START-OS2">5.5. OS/2</a></h2>
! <p>During installation, <span class="APPLICATION">Privoxy</span> is
! configured to start automatically when the system restarts. You can
! start it manually by double-clicking on the <span class=
! "APPLICATION">Privoxy</span> icon in the <span class=
! "APPLICATION">Privoxy</span> folder.</p>
! </div>
! <div class="SECT2">
! <h2 class="SECT2"><a name="START-MACOSX" id="START-MACOSX">5.6. Mac OS
! X</a></h2>
! <p>The privoxy service will automatically start after a successful
! installation (and thereafter every time your computer starts up)
! however you will need to configure your web browser(s) to use it. To do
! so, configure them to use a proxy for HTTP and HTTPS at the address
! 127.0.0.1:8118.</p>
! <p>To prevent the privoxy service from automatically starting when your
! computer starts up, remove or rename the file <tt class=
! "LITERAL">/Library/LaunchDaemons/org.ijbswa.privoxy.plist</tt> (on OS X
! 10.5 and higher) or the folder named <tt class=
! "LITERAL">/Library/StartupItems/Privoxy</tt> (on OS X 10.4
! 'Tiger').</p>
! <p>To manually start or stop the privoxy service, use the scripts
! startPrivoxy.sh and stopPrivoxy.sh supplied in /Applications/Privoxy.
! They must be run from an administrator account, using sudo.</p>
! </div>
! <div class="SECT2">
! <h2 class="SECT2"><a name="CMDOPTIONS" id="CMDOPTIONS">5.7. Command
! Line Options</a></h2>
! <p><span class="APPLICATION">Privoxy</span> may be invoked with the
! following command-line options:</p>
! <ul>
! <li>
! <p><span class="emphasis"><i class=
! "EMPHASIS">--config-test</i></span></p>
! <p>Exit after loading the configuration files before binding to the
! listen address. The exit code signals whether or not the
! configuration files have been successfully loaded.</p>
! <p>If the exit code is 1, at least one of the configuration files
! is invalid, if it is 0, all the configuration files have been
! successfully loaded (but may still contain errors that can
! currently only be detected at run time).</p>
! <p>This option doesn't affect the log setting, combination with
! <span class="emphasis"><i class="EMPHASIS">--no-daemon</i></span>
! is recommended if a configured log file shouldn't be used.</p>
! </li>
! <li>
! <p><span class="emphasis"><i class=
! "EMPHASIS">--version</i></span></p>
! <p>Print version info and exit. Unix only.</p>
! </li>
! <li>
! <p><span class="emphasis"><i class="EMPHASIS">--help</i></span></p>
! <p>Print short usage info and exit. Unix only.</p>
! </li>
! <li>
! <p><span class="emphasis"><i class=
! "EMPHASIS">--no-daemon</i></span></p>
! <p>Don't become a daemon, i.e. don't fork and become process group
! leader, and don't detach from controlling tty. Unix only.</p>
! </li>
! <li>
! <p><span class="emphasis"><i class="EMPHASIS">--pidfile
! FILE</i></span></p>
! <p>On startup, write the process ID to <span class=
! "emphasis"><i class="EMPHASIS">FILE</i></span>. Delete the
! <span class="emphasis"><i class="EMPHASIS">FILE</i></span> on exit.
! Failure to create or delete the <span class="emphasis"><i class=
! "EMPHASIS">FILE</i></span> is non-fatal. If no <span class=
! "emphasis"><i class="EMPHASIS">FILE</i></span> option is given, no
! PID file will be used. Unix only.</p>
! </li>
! <li>
! <p><span class="emphasis"><i class="EMPHASIS">--user
! USER[.GROUP]</i></span></p>
! <p>After (optionally) writing the PID file, assume the user ID of
! <span class="emphasis"><i class="EMPHASIS">USER</i></span>, and if
! included the GID of GROUP. Exit if the privileges are not
! sufficient to do so. Unix only.</p>
! </li>
! <li>
! <p><span class="emphasis"><i class=
! "EMPHASIS">--chroot</i></span></p>
! <p>Before changing to the user ID given in the <span class=
! "emphasis"><i class="EMPHASIS">--user</i></span> option, chroot to
! that user's home directory, i.e. make the kernel pretend to the
! <span class="APPLICATION">Privoxy</span> process that the directory
! tree starts there. If set up carefully, this can limit the impact
! of possible vulnerabilities in <span class=
! "APPLICATION">Privoxy</span> to the files contained in that
! hierarchy. Unix only.</p>
! </li>
! <li>
! <p><span class="emphasis"><i class="EMPHASIS">--pre-chroot-nslookup
! hostname</i></span></p>
! <p>Specifies a hostname (for example www.privoxy.org) to look up
! before doing a chroot. On some systems, initializing the resolver
! library involves reading config files from /etc and/or loading
! additional shared libraries from /lib. On these systems, doing a
! hostname lookup before the chroot reduces the number of files that
! must be copied into the chroot tree.</p>
! <p>For fastest startup speed, a good value is a hostname that is
! not in /etc/hosts but that your local name server (listed in
! /etc/resolv.conf) can resolve without recursion (that is, without
! having to ask any other name servers). The hostname need not exist,
! but if it doesn't, an error message (which can be ignored) will be
! output.</p>
! </li>
! <li>
! <p><span class="emphasis"><i class=
! "EMPHASIS">configfile</i></span></p>
! <p>If no <span class="emphasis"><i class=
! "EMPHASIS">configfile</i></span> is included on the command line,
! <span class="APPLICATION">Privoxy</span> will look for a file named
! <span class="QUOTE">"config"</span> in the current directory
! (except on Win32 where it will look for <span class=
! "QUOTE">"config.txt"</span> instead). Specify full path to avoid
! confusion. If no config file is found, <span class=
! "APPLICATION">Privoxy</span> will fail to start.</p>
! </li>
! </ul>
! <p>On <span class="APPLICATION">MS Windows</span> only there are two
! additional command-line options to allow <span class=
! "APPLICATION">Privoxy</span> to install and run as a <span class=
! "emphasis"><i class="EMPHASIS">service</i></span>. See the <a href=
! "installation.html#INSTALLATION-PACK-WIN">Window Installation
! section</a> for details.</p>
! </div>
! </div>
! <div class="NAVFOOTER">
! <hr align="left" width="100%">
! <table summary="Footer navigation table" width="100%" border="0"
! cellpadding="0" cellspacing="0">
! <tr>
! <td width="33%" align="left" valign="top"><a href="quickstart.html"
! accesskey="P">Prev</a></td>
! <td width="34%" align="center" valign="top"><a href="index.html"
! accesskey="H">Home</a></td>
! <td width="33%" align="right" valign="top"><a href=
! "configuration.html" accesskey="N">Next</a></td>
! </tr>
! <tr>
! <td width="33%" align="left" valign="top">Quickstart to Using
! Privoxy</td>
! <td width="34%" align="center" valign="top"> </td>
! <td width="33%" align="right" valign="top">Privoxy Configuration</td>
! </tr>
! </table>
! </div>
! </body>
</html>
Index: contact.html
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/contact.html,v
retrieving revision 1.69
retrieving revision 1.70
diff -C2 -d -r1.69 -r1.70
*** contact.html 26 Aug 2016 12:32:49 -0000 1.69
--- contact.html 12 Jan 2017 14:27:47 -0000 1.70
***************
*** 1,417 ****
! <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01
! Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
<html>
! <head>
! <title>
! Contacting the Developers, Bug Reporting and Feature Requests
! </title>
! <meta name="GENERATOR" content=
! "Modular DocBook HTML Stylesheet Version 1.79">
! <link rel="HOME" title="Privoxy 3.0.26 User Manual" href="index.html">
! <link rel="PREVIOUS" title="Privoxy's Template Files" href=
! "templates.html">
! <link rel="NEXT" title="Privoxy Copyright, License and History" href=
! "copyright.html">
! <link rel="STYLESHEET" type="text/css" href="../p_doc.css">
! <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
! <link rel="STYLESHEET" type="text/css" href="p_doc.css">
! </head>
! <body class="SECT1" bgcolor="#EEEEEE" text="#000000" link="#0000FF" vlink=
! "#840084" alink="#0000FF">
! <div class="NAVHEADER">
! <table summary="Header navigation table" width="100%" border="0"
! cellpadding="0" cellspacing="0">
! <tr>
! <th colspan="3" align="center">
! Privoxy 3.0.26 User Manual
! </th>
! </tr>
! <tr>
! <td width="10%" align="left" valign="bottom">
! <a href="templates.html" accesskey="P">Prev</a>
! </td>
! <td width="80%" align="center" valign="bottom">
! </td>
! <td width="10%" align="right" valign="bottom">
! <a href="copyright.html" accesskey="N">Next</a>
! </td>
! </tr>
! </table>
! <hr align="LEFT" width="100%">
! </div>
! <div class="SECT1">
! <h1 class="SECT1">
! <a name="CONTACT">11. Contacting the Developers, Bug Reporting and
! Feature Requests</a>
! </h1>
! <p>
! We value your feedback. In fact, we rely on it to improve <span
! class="APPLICATION">Privoxy</span> and its configuration. However,
! please note the following hints, so we can provide you with the best
! support.
! </p>
! <div class="SECT2">
! <h2 class="SECT2">
! <a name="SUFFICIENT-INFORMATION">11.1. Please provide sufficient
! information</a>
! </h2>
! <p>
! A lot of support requests don't contain enough information and
! can't be solved without a lot of back and forth which causes
! unnecessary delays. Reading this section should help to prevent
! that.
! </p>
! <p>
! Before contacting us to report a problem, please try to verify that
! it is a <span class="APPLICATION">Privoxy</span> problem, and not a
! browser or site problem or documented behaviour that just happens
! to be different than what you expected. If unsure, try <a href=
! "http://config.privoxy.org/toggle?set=disable" target=
! "_top">toggling off</a> <span class="APPLICATION">Privoxy</span>,
! and see if the problem persists.
! </p>
! <p>
! If you are using your own custom configuration, please try the
! default configuration to see if the problem is configuration
! related. If you're having problems with a feature that is disabled
! by default, please ask around on the mailing list if others can
! reproduce the problem.
! </p>
! <p>
! If you aren't using the latest Privoxy version, the problem may
! have been found and fixed in the meantime. We would appreciate if
! you could take the time to <a href=
! "https://www.privoxy.org/user-manual/installation.html" target=
! "_top">upgrade to the latest version</a> and verify that the
! problem still exists.
! </p>
! <p>
! Please be sure to provide the following information when reporting
! problems or requesting support:
! </p>
! <p>
! </p>
! <ul>
! <li>
! <p>
! The exact <span class="APPLICATION">Privoxy</span> version you
! are using.
! </p>
! </li>
! <li>
! <p>
! The operating system and versions you run <span class=
! "APPLICATION">Privoxy</span> on, e.g. <span class=
! "APPLICATION">Windows XP SP2</span>.
! </p>
! </li>
! <li>
! <p>
! The name, platform, and version of the <span class=
! "APPLICATION">browser</span> you were using (e.g. <span class=
! "APPLICATION">Internet Explorer v5.5</span> for Mac).
! </p>
! </li>
! <li>
! <p>
! The URL where the problem occurred, or some way for us to
! duplicate the problem (e.g. <tt class=
! "LITERAL">http://somesite.example.com/?somethingelse=123</tt>).
! </p>
! </li>
! <li>
! <p>
! Whether your version of <span class=
! "APPLICATION">Privoxy</span> is one supplied by the <span
! class="APPLICATION">Privoxy</span> developers via SourceForge,
! or if you got your copy somewhere else.
! </p>
! </li>
! <li>
! <p>
! Whether you are using <span class="APPLICATION">Privoxy</span>
! together with another proxy such as <span class=
! "APPLICATION">Tor</span>. If so, please temporary disable the
! other proxy to see if the symptoms change.
! </p>
! </li>
! <li>
! <p>
! Whether you are using a personal firewall product. If so, does
! <span class="APPLICATION">Privoxy</span> work without it?
! </p>
! </li>
! <li>
! <p>
! Any other pertinent information to help identify the problem
! such as config or log file excerpts (yes, you should have log
! file entries for each action taken). To get a meaningful
! logfile, please make sure that the <a href=
! "../user-manual/config.html#LOGFILE" target="_top">logfile
! directive</a> is being used and the following <a href=
! "../user-manual/config.html#DEBUG" target="_top">debug
! options</a> are enabled (all of them):
! </p>
! <p class="LITERALLAYOUT">
! debug 1 # Log the destination for each request Privoxy let through. See also debug 1024.<br>
!
! debug 2 # show each connection status<br>
!
! debug 4 # show I/O status<br>
!
! debug 8 # show header parsing<br>
!
! debug 128 # debug redirects<br>
!
! debug 256 # debug GIF de-animation<br>
! debug 512 # Common Log Format<br>
! debug 1024 # Log the destination for requests Privoxy didn't let through, and the reason why.<br>
! debug 4096 # Startup banner and warnings.<br>
! debug 8192 # Non-fatal errors
! </p>
! <p>
! If you are having trouble with a filter, please additionally
! enable
! </p>
! <p class="LITERALLAYOUT">
! debug 64 # debug regular expression filters
! </p>
! If you are using Privoxy 3.0.17 or later and suspect that it
! interprets the request or the response incorrectly, please enable
! <p class="LITERALLAYOUT">
! debug 32768 # log all data read from the network
! </p>
! <p>
! It's easy for us to ignore log messages that aren't relevant
! but missing log messages may make it impossible to investigate
! a problem. If you aren't sure which of the debug directives are
! relevant, please just enable all of them and let us worry about
! it.
! </p>
! <p>
! Note that Privoxy log files may contain sensitive information
! so please don't submit any logfiles you didn't read first. You
! can mask sensitive information as long as it's clear that you
! removed something.
! </p>
! </li>
! </ul>
! <p>
! You don't have to tell us your actual name when filing a problem
! report, but if you don't, please use a nickname so we can
! differentiate between your messages and the ones entered by other
! "anonymous" users that may respond to your request if they have the
! same problem or already found a solution. Note that due to spam the
! trackers may not always allow to post without being logged into
! SourceForge. If that's the case, you are still free to create a
! login that isn't directly linked to your name, though.
! </p>
! <p>
! Please also check the status of your request a few days after
! submitting it, as we may request additional information. If you use
! a SF id, you should automatically get a mail when someone responds
! to your request. Please don't bother to add an email address when
! using the tracker. If you prefer to communicate through email, just
! use one of the mailing lists directly.
! </p>
! <p>
! If you are new to reporting problems, you might be interested in <a
! href="http://www.chiark.greenend.org.uk/~sgtatham/bugs.html"
! target="_top">How to Report Bugs Effectively</a>.
! </p>
! <p>
! The <a href=
! "https://www.privoxy.org/user-manual/appendix.html#ACTIONSANAT"
! target="_top">appendix of the Privoxy User Manual</a> also has
! helpful information on understanding <tt class=
! "LITERAL">actions</tt>, and <tt class="LITERAL">action</tt>
! debugging.
! </p>
! </div>
! <div class="SECT2">
! <h2 class="SECT2">
! <a name="CONTACT-SUPPORT">11.2. Get Support</a>
! </h2>
! <p>
! All users are welcome to discuss their issues on the <a href=
! "https://lists.privoxy.org/mailman/listinfo/privoxy-users" target=
! "_top">users mailing list</a>, where the developers also hang
! around.
! </p>
! <p>
! Please don't send private support requests to individual Privoxy
! developers, either use the mailing lists or the support trackers.
! </p>
! <p>
! If you have to contact a Privoxy developer directly for other
! reasons, please send a real mail and do not bother with
! SourceForge's messaging system. Answers to SourceForge messages are
! usually bounced by SourceForge's mail server in which case the
! developer wasted time writing a response you don't get. From your
! point of view it will look like your message has been completely
! ignored, so this is frustrating for all parties involved.
! </p>
! <p>
! Note that the Privoxy mailing lists are moderated. Posts from
! unsubscribed addresses have to be accepted manually by a moderator.
! This may cause a delay of several days and if you use a subject
! that doesn't clearly mention Privoxy or one of its features, your
! message may be accidentally discarded as spam.
! </p>
! <p>
! If you aren't subscribed, you should therefore spend a few seconds
! to come up with a proper subject. Additionally you should make it
! clear that you want to get CC'd. Otherwise some responses will be
! directed to the mailing list only, and you won't see them.
! </p>
! </div>
! <div class="SECT2">
! <h2 class="SECT2">
! <a name="REPORTING">11.3. Reporting Problems</a>
! </h2>
! <p>
! <span class="QUOTE">"Problems"</span> for our purposes, come in two
! forms:
! </p>
! <ul>
! <li>
! <p>
! Configuration issues, such as ads that slip through, or sites
! that don't function properly due to one <span class=
! "APPLICATION">Privoxy</span> <span class=
! "QUOTE">"action"</span> or another being turned <span class=
! "QUOTE">"on"</span>.
! </p>
! </li>
! <li>
! <p>
! <span class="QUOTE">"Bugs"</span> in the programming code that
! makes up <span class="APPLICATION">Privoxy</span>, such as that
! might cause a crash. Documentation issues, for example spelling
! errors and unclear descriptions, are bugs, too.
! </p>
! </li>
! </ul>
! <div class="SECT3">
! <h3 class="SECT3">
! <a name="CONTACT-ADS">11.3.1. Reporting Ads or Other
! Configuration Problems</a>
! </h3>
! <p>
! Please send feedback on ads that slipped through, innocent images
! that were blocked, sites that don't work properly, and other
! configuration related problem of <tt class=
! "FILENAME">default.action</tt> file, to <a href=
! "https://sourceforge.net/tracker/?group_id=11118&atid=460288"
! target=
! "_top">https://sourceforge.net/tracker/?group_id=11118&atid=460288</a>,
! the Actions File Tracker.
! </p>
! </div>
! <div class="SECT3">
! <h3 class="SECT3">
! <a name="CONTACT-BUGS">11.3.2. Reporting Bugs</a>
! </h3>
! <p>
! Before reporting bugs, please make sure that the bug has <span
! class="emphasis"><i class="EMPHASIS">not already been
! submitted</i></span> and observe the additional hints at the top
! of the <a href=
! "https://sourceforge.net/tracker/?func=add&group_id=11118&atid=111118"
! target="_top">submit form</a>. If already submitted, please feel
! free to add any info to the original report that might help to
! solve the issue.
! </p>
! </div>
! </div>
! <div class="SECT2">
! <h2 class="SECT2">
! <a name="SECURITY-CONTACT">11.4. Reporting security problems</a>
! </h2>
! <p>
! If you discovered a security problem or merely suspect that a bug
! might be a security issue, please mail Fabian Keil
! <[email protected]> (OpenPGP fingerprint: 4F36 C17F 3816 9136
! 54A1 E850 6918 2291 8BA2 371C).
! </p>
! <p>
! Usually you should get a response within a day, otherwise it's
! likely that either your mail or the response didn't make it. If
! that happens, please mail to the developer list to request a status
! update.
! </p>
! </div>
! <div class="SECT2">
! <h2 class="SECT2">
! <a name="MAILING-LISTS">11.5. Mailing Lists</a>
! </h2>
! <p>
! If you prefer to communicate through email, instead of using a web
! interface, feel free to use one of the mailing lists. To discuss
! issues that haven't been completely diagnosed yet, please use the
! Privoxy users list. Technically interested users and people who
! wish to contribute to the project are always welcome on the
! developers list. You can find an overview of all <span class=
! "APPLICATION">Privoxy</span>-related mailing lists, including list
! archives, at: <a href="https://lists.privoxy.org/mailman/listinfo"
! target="_top">https://lists.privoxy.org/mailman/listinfo</a>. The
! lists hosted on privoxy.org have been created in 2016, the
! previously-used lists hosted at SourceForge are deprecated but the
! archives may still be useful: <a href=
! "https://sourceforge.net/mail/?group_id=11118" target=
! "_top">https://sourceforge.net/mail/?group_id=11118</a>.
! </p>
</div>
! <div class="SECT2">
! <h2 class="SECT2">
! <a name="SF-TRACKERS">11.6. SourceForge support trackers</a>
! </h2>
! <p>
! The <a href=
! "https://sourceforge.net/tracker/?group_id=11118&atid=211118"
! target="_top">SourceForge support trackers</a> may be used as well,
! but have various technical problems that are unlikely to be fixed
! anytime soon. If you don't get a timely response, please try the
! mailing list as well.
! </p>
</div>
</div>
! <div class="NAVFOOTER">
! <hr align="LEFT" width="100%">
! <table summary="Footer navigation table" width="100%" border="0"
! cellpadding="0" cellspacing="0">
! <tr>
! <td width="33%" align="left" valign="top">
! <a href="templates.html" accesskey="P">Prev</a>
! </td>
! <td width="34%" align="center" valign="top">
! <a href="index.html" accesskey="H">Home</a>
! </td>
! <td width="33%" align="right" valign="top">
! <a href="copyright.html" accesskey="N">Next</a>
! </td>
! </tr>
! <tr>
! <td width="33%" align="left" valign="top">
! Privoxy's Template Files
! </td>
! <td width="34%" align="center" valign="top">
!
! </td>
! <td width="33%" align="right" valign="top">
! Privoxy Copyright, License and History
! </td>
! </tr>
! </table>
</div>
! </body>
</html>
-
--- 1,306 ----
! <!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=utf-8">
! <link rel="STYLESHEET" type="text/css" href="p_doc.css">
! </head>
! <body class="SECT1" bgcolor="#EEEEEE" text="#000000" link="#0000FF" vlink=
! "#840084" alink="#0000FF">
! <div class="NAVHEADER">
! <table summary="Header navigation table" width="100%" border="0"
! cellpadding="0" cellspacing="0">
! <tr>
! <th colspan="3" align="center">Privoxy 3.0.26 User Manual</th>
! </tr>
! <tr>
! <td width="10%" align="left" valign="bottom"><a href="templates.html"
! accesskey="P">Prev</a></td>
! <td width="80%" align="center" valign="bottom"></td>
! <td width="10%" align="right" valign="bottom"><a href=
! "copyright.html" accesskey="N">Next</a></td>
! </tr>
! </table>
! <hr align="left" width="100%">
! </div>
! <div class="SECT1">
! <h1 class="SECT1"><a name="CONTACT" id="CONTACT">11. Contacting the
! Developers, Bug Reporting and Feature Requests</a></h1>
! <p>We value your feedback. In fact, we rely on it to improve <span class=
! "APPLICATION">Privoxy</span> and its configuration. However, please note
! the following hints, so we can provide you with the best support.</p>
! <div class="SECT2">
! <h2 class="SECT2"><a name="SUFFICIENT-INFORMATION" id=
! "SUFFICIENT-INFORMATION">11.1. Please provide sufficient
! information</a></h2>
! <p>A lot of support requests don't contain enough information and can't
! be solved without a lot of back and forth which causes unnecessary
! delays. Reading this section should help to prevent that.</p>
! <p>Before contacting us to report a problem, please try to verify that
! it is a <span class="APPLICATION">Privoxy</span> problem, and not a
! browser or site problem or documented behaviour that just happens to be
! different than what you expected. If unsure, try <a href=
! "http://config.privoxy.org/toggle?set=disable" target="_top">toggling
! off</a> <span class="APPLICATION">Privoxy</span>, and see if the
! problem persists.</p>
! <p>If you are using your own custom configuration, please try the
! default configuration to see if the problem is configuration related.
! If you're having problems with a feature that is disabled by default,
! please ask around on the mailing list if others can reproduce the
! problem.</p>
! <p>If you aren't using the latest Privoxy version, the problem may have
! been found and fixed in the meantime. We would appreciate if you could
! take the time to <a href=
! "https://www.privoxy.org/user-manual/installation.html" target=
! "_top">upgrade to the latest version</a> and verify that the problem
! still exists.</p>
! <p>Please be sure to provide the following information when reporting
! problems or requesting support:</p>
! <ul>
! <li>
! <p>The exact <span class="APPLICATION">Privoxy</span> version you
! are using.</p>
! </li>
! <li>
! <p>The operating system and versions you run <span class=
! "APPLICATION">Privoxy</span> on, e.g. <span class=
! "APPLICATION">Windows XP SP2</span>.</p>
! </li>
! <li>
! <p>The name, platform, and version of the <span class=
! "APPLICATION">browser</span> you were using (e.g. <span class=
! "APPLICATION">Internet Explorer v5.5</span> for Mac).</p>
! </li>
! <li>
! <p>The URL where the problem occurred, or some way for us to
! duplicate the problem (e.g. <tt class=
! "LITERAL">http://somesite.example.com/?somethingelse=123</tt>).</p>
! </li>
! <li>
! <p>Whether your version of <span class="APPLICATION">Privoxy</span>
! is one supplied by the <span class="APPLICATION">Privoxy</span>
! developers via SourceForge, or if you got your copy somewhere
! else.</p>
! </li>
! <li>
! <p>Whether you are using <span class="APPLICATION">Privoxy</span>
! together with another proxy such as <span class=
! "APPLICATION">Tor</span>. If so, please temporary disable the other
! proxy to see if the symptoms change.</p>
! </li>
! <li>
! <p>Whether you are using a personal firewall product. If so, does
! <span class="APPLICATION">Privoxy</span> work without it?</p>
! </li>
! <li>
! <p>Any other pertinent information to help identify the problem
! such as config or log file excerpts (yes, you should have log file
! entries for each action taken). To get a meaningful logfile, please
! make sure that the <a href="../user-manual/config.html#LOGFILE"
! target="_top">logfile directive</a> is being used and the following
! <a href="../user-manual/config.html#DEBUG" target="_top">debug
! options</a> are enabled (all of them):</p>
! <p class="LITERALLAYOUT">
! debug 1 # Log the destination for each request Privoxy let through. See also debug 1024.<br>
! debug 2 # show each connection status<br>
! debug 4 # show I/O status<br>
! debug 8 # show header parsing<br>
! debug 128 # debug redirects<br>
! debug 256 # debug GIF de-animation<br>
! debug 512 # Common Log Format<br>
! debug 1024 # Log the destination for requests Privoxy didn't let through, and the reason why.<br>
! debug 4096 # Startup banner and warnings.<br>
! debug 8192 # Non-fatal errors</p>
! <p>If you are having trouble with a filter, please additionally
! enable</p>
! <p class="LITERALLAYOUT">
! debug 64 # debug regular expression filters</p>If
! you are using Privoxy 3.0.17 or later and suspect that it
! interprets the request or the response incorrectly, please enable
! <p class="LITERALLAYOUT">
! debug 32768 # log all data read from the network</p>
! <p>It's easy for us to ignore log messages that aren't relevant but
! missing log messages may make it impossible to investigate a
! problem. If you aren't sure which of the debug directives are
! relevant, please just enable all of them and let us worry about
! it.</p>
! <p>Note that Privoxy log files may contain sensitive information so
! please don't submit any logfiles you didn't read first. You can
! mask sensitive information as long as it's clear that you removed
! something.</p>
! </li>
! </ul>
! <p>You don't have to tell us your actual name when filing a problem
! report, but if you don't, please use a nickname so we can differentiate
! between your messages and the ones entered by other "anonymous" users
! that may respond to your request if they have the same problem or
! already found a solution. Note that due to spam the trackers may not
! always allow to post without being logged into SourceForge. If that's
! the case, you are still free to create a login that isn't directly
! linked to your name, though.</p>
! <p>Please also check the status of your request a few days after
! submitting it, as we may request additional information. If you use a
! SF id, you should automatically get a mail when someone responds to
! your request. Please don't bother to add an email address when using
! the tracker. If you prefer to communicate through email, just use one
! of the mailing lists directly.</p>
! <p>If you are new to reporting problems, you might be interested in
! <a href="http://www.chiark.greenend.org.uk/~sgtatham/bugs.html" target=
! "_top">How to Report Bugs Effectively</a>.</p>
! <p>The <a href=
! "https://www.privoxy.org/user-manual/appendix.html#ACTIONSANAT" target=
! "_top">appendix of the Privoxy User Manual</a> also has helpful
! information on understanding <tt class="LITERAL">actions</tt>, and
! <tt class="LITERAL">action</tt> debugging.</p>
! </div>
! <div class="SECT2">
! <h2 class="SECT2"><a name="CONTACT-SUPPORT" id="CONTACT-SUPPORT">11.2.
! Get Support</a></h2>
! <p>All users are welcome to discuss their issues on the <a href=
! "https://lists.privoxy.org/mailman/listinfo/privoxy-users" target=
! "_top">users mailing list</a>, where the developers also hang
! around.</p>
! <p>Please don't send private support requests to individual Privoxy
! developers, either use the mailing lists or the support trackers.</p>
! <p>If you have to contact a Privoxy developer directly for other
! reasons, please send a real mail and do not bother with SourceForge's
! messaging system. Answers to SourceForge messages are usually bounced
! by SourceForge's mail server in which case the developer wasted time
! writing a response you don't get. From your point of view it will look
! like your message has been completely ignored, so this is frustrating
! for all parties involved.</p>
! <p>Note that the Privoxy mailing lists are moderated. Posts from
! unsubscribed addresses have to be accepted manually by a moderator.
! This may cause a delay of several days and if you use a subject that
! doesn't clearly mention Privoxy or one of its features, your message
! may be accidentally discarded as spam.</p>
! <p>If you aren't subscribed, you should therefore spend a few seconds
! to come up with a proper subject. Additionally you should make it clear
! that you want to get CC'd. Otherwise some responses will be directed to
! the mailing list only, and you won't see them.</p>
! </div>
! <div class="SECT2">
! <h2 class="SECT2"><a name="REPORTING" id="REPORTING">11.3. Reporting
! Problems</a></h2>
! <p><span class="QUOTE">"Problems"</span> for our purposes, come in two
! forms:</p>
! <ul>
! <li>
! <p>Configuration issues, such as ads that slip through, or sites
! that don't function properly due to one <span class=
! "APPLICATION">Privoxy</span> <span class="QUOTE">"action"</span> or
! another being turned <span class="QUOTE">"on"</span>.</p>
! </li>
! <li>
! <p><span class="QUOTE">"Bugs"</span> in the programming code that
! makes up <span class="APPLICATION">Privoxy</span>, such as that
! might cause a crash. Documentation issues, for example spelling
! errors and unclear descriptions, are bugs, too.</p>
! </li>
! </ul>
! <div class="SECT3">
! <h3 class="SECT3"><a name="CONTACT-ADS" id="CONTACT-ADS">11.3.1.
! Reporting Ads or Other Configuration Problems</a></h3>
! <p>Please send feedback on ads that slipped through, innocent images
! that were blocked, sites that don't work properly, and other
! configuration related problem of <tt class=
! "FILENAME">default.action</tt> file, to <a href=
! "https://sourceforge.net/tracker/?group_id=11118&atid=460288"
! target=
! "_top">https://sourceforge.net/tracker/?group_id=11118&atid=460288</a>,
! the Actions File Tracker.</p>
</div>
! <div class="SECT3">
! <h3 class="SECT3"><a name="CONTACT-BUGS" id="CONTACT-BUGS">11.3.2.
! Reporting Bugs</a></h3>
! <p>Before reporting bugs, please make sure that the bug has
! <span class="emphasis"><i class="EMPHASIS">not already been
! submitted</i></span> and observe the additional hints at the top of
! the <a href=
! "https://sourceforge.net/tracker/?func=add&group_id=11118&atid=111118"
! target="_top">submit form</a>. If already submitted, please feel free
! to add any info to the original report that might help to solve the
! issue.</p>
</div>
</div>
! <div class="SECT2">
! <h2 class="SECT2"><a name="SECURITY-CONTACT" id=
! "SECURITY-CONTACT">11.4. Reporting security problems</a></h2>
! <p>If you discovered a security problem or merely suspect that a bug
! might be a security issue, please mail Fabian Keil
! <[email protected]> (OpenPGP fingerprint: 4F36 C17F 3816 9136 54A1
! E850 6918 2291 8BA2 371C).</p>
! <p>Usually you should get a response within a day, otherwise it's
! likely that either your mail or the response didn't make it. If that
! happens, please mail to the developer list to request a status
! update.</p>
</div>
! <div class="SECT2">
! <h2 class="SECT2"><a name="MAILING-LISTS" id="MAILING-LISTS">11.5.
! Mailing Lists</a></h2>
! <p>If you prefer to communicate through email, instead of using a web
! interface, feel free to use one of the mailing lists. To discuss issues
! that haven't been completely diagnosed yet, please use the Privoxy
! users list. Technically interested users and people who wish to
! contribute to the project are always welcome on the developers list.
! You can find an overview of all <span class=
! "APPLICATION">Privoxy</span>-related mailing lists, including list
! archives, at: <a href="https://lists.privoxy.org/mailman/listinfo"
! target="_top">https://lists.privoxy.org/mailman/listinfo</a>. The lists
! hosted on privoxy.org have been created in 2016, the previously-used
! lists hosted at SourceForge are deprecated but the archives may still
! be useful: <a href="https://sourceforge.net/mail/?group_id=11118"
! target="_top">https://sourceforge.net/mail/?group_id=11118</a>.</p>
! </div>
! <div class="SECT2">
! <h2 class="SECT2"><a name="SF-TRACKERS" id="SF-TRACKERS">11.6.
! SourceForge support trackers</a></h2>
! <p>The <a href=
! "https://sourceforge.net/tracker/?group_id=11118&atid=211118"
! target="_top">SourceForge support trackers</a> may be used as well, but
! have various technical problems that are unlikely to be fixed anytime
! soon. If you don't get a timely response, please try the mailing list
! as well.</p>
! </div>
! </div>
! <div class="NAVFOOTER">
! <hr align="left" width="100%">
! <table summary="Footer navigation table" width="100%" border="0"
! cellpadding="0" cellspacing="0">
! <tr>
! <td width="33%" align="left" valign="top"><a href="templates.html"
! accesskey="P">Prev</a></td>
! <td width="34%" align="center" valign="top"><a href="index.html"
! accesskey="H">Home</a></td>
! <td width="33%" align="right" valign="top"><a href="copyright.html"
! accesskey="N">Next</a></td>
! </tr>
! <tr>
! <td width="33%" align="left" valign="top">Privoxy's Template
! Files</td>
! <td width="34%" align="center" valign="top"> </td>
! <td width="33%" align="right" valign="top">Privoxy Copyright, License
! and History</td>
! </tr>
! </table>
! </div>
! </body>
</html>
Index: filter-file.html
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/filter-file.html,v
retrieving revision 1.96
retrieving revision 1.97
diff -C2 -d -r1.96 -r1.97
*** filter-file.html 26 Aug 2016 12:32:49 -0000 1.96
--- filter-file.html 12 Jan 2017 14:27:47 -0000 1.97
***************
*** 1,484 ****
! <!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">
[...1848 lines suppressed...]
! <table summary="Footer navigation table" width="100%" border="0"
! cellpadding="0" cellspacing="0">
! <tr>
! <td width="33%" align="left" valign="top"><a href="actions-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="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.95
retrieving revision 1.96
diff -C2 -d -r1.95 -r1.96
*** configuration.html 26 Aug 2016 12:32:49 -0000 1.95
--- configuration.html 12 Jan 2017 14:27:47 -0000 1.96
***************
*** 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>
-
--- 1,222 ----
! <!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=utf-8">
! <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="AEN902" id=
! "AEN902"></a>����Privoxy Menu</h2>
! <pre><br></pre>
! <table border="0">
! <tbody>
! <tr>
! <td>��������▪��<a href=
! "http://config.privoxy.org/show-status" target="_top">View
! & change the current configuration</a></td>
! </tr>
! <tr>
! <td>��������▪��<a href=
! "http://config.privoxy.org/show-version" target="_top">View
! the source code version numbers</a></td>
! </tr>
! <tr>
! <td>��������▪��<a href=
! "http://config.privoxy.org/show-request" target="_top">View
! the request headers.</a></td>
! </tr>
! <tr>
! <td>��������▪��<a href=
! "http://config.privoxy.org/show-url-info" target=
! "_top">Look up which actions apply to a URL and
! why</a></td>
! </tr>
! <tr>
! <td>��������▪��<a href="http://config.privoxy.org/toggle"
! target="_top">Toggle Privoxy on or off</a></td>
! </tr>
! <tr>
! <td>��������▪��<a href=
! "https://www.privoxy.org/3.0.26/user-manual/" target=
! "_top">Documentation</a></td>
! </tr>
! </tbody>
! </table>
</td>
</tr>
</table>
! <p>This should be self-explanatory. Note the first item leads to an
! editor for the <a href="actions-file.html">actions files</a>, which is
! where the ad, banner, cookie, and URL blocking magic is configured as
! well as other advanced features of <span class=
! "APPLICATION">Privoxy</span>. This is an easy way to adjust various
! aspects of <span class="APPLICATION">Privoxy</span> configuration. The
! actions file, and other configuration files, are explained in detail
! below.</p>
! <p><span class="QUOTE">"Toggle Privoxy On or Off"</span> is handy for
! sites that might have problems with your current actions and filters.
! You can in fact use it as a test to see whether it is <span class=
! "APPLICATION">Privoxy</span> causing the problem or not. <span class=
! "APPLICATION">Privoxy</span> continues to run as a proxy in this case,
! but all manipulation is disabled, i.e. <span class=
! "APPLICATION">Privoxy</span> acts like a normal forwarding proxy.</p>
! <p>Note that several of the features described above are disabled by
! default in <span class="APPLICATION">Privoxy</span> 3.0.7 beta and
! later. Check the <a href="config.html" target="_top">configuration
! file</a> to learn why and in which cases it's safe to enable them
! again.</p>
</div>
! <div class="SECT2">
! <h2 class="SECT2"><a name="CONFOVERVIEW" id="CONFOVERVIEW">6.2.
! Configuration Files Overview</a></h2>
! <p>For Unix, *BSD and Linux, all configuration files are located in
! <tt class="FILENAME">/etc/privoxy/</tt> by default. For MS Windows,
! OS/2, and AmigaOS these are all in the same directory as the
! <span class="APPLICATION">Privoxy</span> executable.</p>
! <p>The installed defaults provide a reasonable starting point, though
! some settings may be aggressive by some standards. For the time being,
! the principle configuration files are:</p>
! <ul>
! <li>
! <p>The <a href="config.html">main configuration file</a> is named
! <tt class="FILENAME">config</tt> on Linux, Unix, BSD, OS/2, and
! AmigaOS and <tt class="FILENAME">config.txt</tt> on Windows. This
! is a required file.</p>
! </li>
! <li>
! <p><tt class="FILENAME">match-all.action</tt> is used to define
! which <span class="QUOTE">"actions"</span> relating to
! banner-blocking, images, pop-ups, content modification, cookie
! handling etc should be applied by default. It should be the first
! actions file loaded.</p>
! <p><tt class="FILENAME">default.action</tt> defines many exceptions
! (both positive and negative) from the default set of actions that's
! configured in <tt class="FILENAME">match-all.action</tt>. It should
! be the second actions file loaded and shouldn't be edited by the
! user.</p>
! <p>Multiple actions files may be defined in <tt class=
! "FILENAME">config</tt>. These are processed in the order they are
! defined. Local customizations and locally preferred exceptions to
! the default policies as defined in <tt class=
! "FILENAME">match-all.action</tt> (which you will most probably want
! to define sooner or later) are best applied in <tt class=
! "FILENAME">user.action</tt>, where you can preserve them across
! upgrades. The file isn't installed by all installers, but you can
! easily create it yourself with a text editor.</p>
! <p>There is also a web based editor that can be accessed from
! <a href="http://config.privoxy.org/show-status" target=
! "_top">http://config.privoxy.org/show-status</a> (Shortcut:
! <a href="http://p.p/show-status" target=
! "_top">http://p.p/show-status</a>) for the various actions
! files.</p>
! </li>
! <li>
! <p><span class="QUOTE">"Filter files"</span> (the <a href=
! "filter-file.html">filter file</a>) can be used to re-write the raw
! page content, including viewable text as well as embedded HTML and
! JavaScript, and whatever else lurks on any given web page. The
! filtering jobs are only pre-defined here; whether to apply them or
! not is up to the actions files. <tt class=
! "FILENAME">default.filter</tt> includes various filters made
! available for use by the developers. Some are much more intrusive
! than others, and all should be used with caution. You may define
! additional filter files in <tt class="FILENAME">config</tt> as you
! can with actions files. We suggest <tt class=
! "FILENAME">user.filter</tt> for any locally defined filters or
! customizations.</p>
! </li>
! </ul>
! <p>The syntax of the configuration and filter files may change between
! different Privoxy versions, unfortunately some enhancements cost
! backwards compatibility.</p>
! <p>All files use the <span class="QUOTE">"<tt class=
! "LITERAL">#</tt>"</span> character to denote a comment (the rest of the
! line will be ignored) and understand line continuation through placing
! a backslash ("<tt class="LITERAL">\</tt>") as the very last character
! in a line. If the <tt class="LITERAL">#</tt> is preceded by a
! backslash, it looses its special function. Placing a <tt class=
! "LITERAL">#</tt> in front of an otherwise valid configuration line to
! prevent it from being interpreted is called "commenting out" that line.
! Blank lines are ignored.</p>
! <p>The actions files and filter files can use Perl style <a href=
! "appendix.html#REGEX">regular expressions</a> for maximum
! flexibility.</p>
! <p>After making any changes, there is no need to restart <span class=
! "APPLICATION">Privoxy</span> in order for the changes to take effect.
! <span class="APPLICATION">Privoxy</span> detects such changes
! automatically. Note, however, that it may take one or two additional
! requests for the change to take effect. When changing the listening
! address of <span class="APPLICATION">Privoxy</span>, these <span class=
! "QUOTE">"wake up"</span> requests must obviously be sent to the
! <span class="emphasis"><i class="EMPHASIS">old</i></span> listening
! address.</p>
</div>
! </div>
! <div class="NAVFOOTER">
! <hr align="left" width="100%">
! <table summary="Footer navigation table" width="100%" border="0"
! cellpadding="0" cellspacing="0">
! <tr>
! <td width="33%" align="left" valign="top"><a href="startup.html"
! accesskey="P">Prev</a></td>
! <td width="34%" align="center" valign="top"><a href="index.html"
! accesskey="H">Home</a></td>
! <td width="33%" align="right" valign="top"><a href="config.html"
! accesskey="N">Next</a></td>
! </tr>
! <tr>
! <td width="33%" align="left" valign="top">Starting Privoxy</td>
! <td width="34%" align="center" valign="top"> </td>
! <td width="33%" align="right" valign="top">The Main Configuration
! File</td>
! </tr>
! </table>
! </div>
! </body>
</html>
Index: templates.html
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/templates.html,v
retrieving revision 1.45
retrieving revision 1.46
diff -C2 -d -r1.45 -r1.46
*** templates.html 26 Aug 2016 12:32:49 -0000 1.45
--- templates.html 12 Jan 2017 14:27:47 -0000 1.46
***************
*** 1,176 ****
! <!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 -->
... beta warning HTML code goes here ...
! <!-- 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>
-
--- 1,130 ----
! <!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=utf-8">
! <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 -->
... beta warning HTML code goes here ...
! <!-- if-unstable-end@ --></pre>
! </td>
! </tr>
! </table>
! <p>If the "unstable" symbol is set, everything in between and including
! <tt class="LITERAL">@if-unstable-start</tt> and <tt class=
! "LITERAL">if-unstable-end@</tt> will disappear, leaving nothing but an
! empty comment:</p>
! <table border="0" bgcolor="#E0E0E0" width="100%">
! <tr>
! <td>
! <pre class="SCREEN"><!-- --></pre>
! </td>
! </tr>
! </table>
! <p>There's also an if-then-else construct and an <tt class=
! "LITERAL">#include</tt> mechanism, but you'll sure find out if you are
! inclined to edit the templates ;-)</p>
! <p>All templates refer to a style located at <a href=
! "http://config.privoxy.org/send-stylesheet" target="_top"><tt class=
! "LITERAL">http://config.privoxy.org/send-stylesheet</tt></a>. This is, of
! course, locally served by <span class="APPLICATION">Privoxy</span> and
! the source for it can be found and edited in the <tt class=
! "FILENAME">cgi-style.css</tt> template.</p>
! </div>
! <div class="NAVFOOTER">
! <hr align="left" width="100%">
! <table summary="Footer navigation table" width="100%" border="0"
! cellpadding="0" cellspacing="0">
! <tr>
! <td width="33%" align="left" valign="top"><a href="filter-file.html"
! accesskey="P">Prev</a></td>
! <td width="34%" align="center" valign="top"><a href="index.html"
! accesskey="H">Home</a></td>
! <td width="33%" align="right" valign="top"><a href="contact.html"
! accesskey="N">Next</a></td>
! </tr>
! <tr>
! <td width="33%" align="left" valign="top">Filter Files</td>
! <td width="34%" align="center" valign="top"> </td>
! <td width="33%" align="right" valign="top">Contacting the Developers,
! Bug Reporting and Feature Requests</td>
! </tr>
! </table>
! </div>
! </body>
</html>
Index: copyright.html
===================================================================
RCS file: /cvsroot/ijbswa/current/doc/webserver/user-manual/copyright.html,v
retrieving revision 1.104
retrieving revision 1.105
diff -C2 -d -r1.104 -r1.105
*** copyright.html 26 Aug 2016 12:32:49 -0000 1.104
--- copyright.html 12 Jan 2017 14:27:47 -0000 1.105
***************
*** 1,74 ****
! <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01
! Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
<html>
! <head>
! <title>
! Privoxy Copyright, License and History
! </title>
! <meta name="GENERATOR" content=
! "Modular DocBook HTML Stylesheet Version 1.79">
! <link rel="HOME" title="Privoxy 3.0.26 User Manual" href="index.html">
! <link rel="PREVIOUS" title=
! "Contacting the Developers, Bug Reporting and Feature Requests" href=
! "contact.html">
! <link rel="NEXT" title="See Also" href="seealso.html">
! <link rel="STYLESHEET" type="text/css" href="../p_doc.css">
! <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
! <link rel="STYLESHEET" type="text/css" href="p_doc.css">
! </head>
! <body class="SECT1" bgcolor="#EEEEEE" text="#000000" link="#0000FF" vlink=
! "#840084" alink="#0000FF">
! <div class="NAVHEADER">
! <table summary="Header navigation table" width="100%" border="0"
! cellpadding="0" cellspacing="0">
! <tr>
! <th colspan="3" align="center">
! Privoxy 3.0.26 User Manual
! </th>
! </tr>
<tr>
! <td width="10%" align="left" valign="bottom">
! <a href="contact.html" accesskey="P">Prev</a>
! </td>
! <td width="80%" align="center" valign="bottom">
! </td>
! <td width="10%" align="right" valign="bottom">
! <a href="seealso.html" accesskey="N">Next</a>
! </td>
! </tr>
! </table>
! <hr align="LEFT" width="100%">
! </div>
! <div class="SECT1">
! <h1 class="SECT1">
! <a name="COPYRIGHT">12. Privoxy Copyright, License and History</a>
! </h1>
! <p>
! Copyright © 2001-2016 by Privoxy Developers <code class=
! "EMAIL"><<a href=
! "mailto:[email protected]">[email protected]</a>></code>
! </p>
! <p>
! Some source code is based on code Copyright © 1997 by Anonymous
! Coders and Junkbusters, Inc. and licensed under the <i class=
! "CITETITLE">GNU General Public License</i>.
! </p>
! <p>
! <span class="APPLICATION">Privoxy</span> is free software; you can
! redistribute it and/or modify it under the terms of the <i class=
! "CITETITLE">GNU General Public License</i>, version 2, as published
! by the Free Software Foundation and included in the next section.
! </p>
! <div class="SECT2">
! <h2 class="SECT2">
! <a name="LICENSE">12.1. License</a>
! </h2>
! <p>
! </p>
! <table border="0" bgcolor="#E0E0E0" width="100%">
! <tr>
! <td>
! <pre class="SCREEN">
! GNU GENERAL PUBLIC LICENSE
Version 2, June 1991
--- 1,56 ----
! <!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=utf-8">
! <link rel="STYLESHEET" type="text/css" href="p_doc.css">
! </head>
! <body class="SECT1" bgcolor="#EEEEEE" text="#000000" link="#0000FF" vlink=
! "#840084" alink="#0000FF">
! <div class="NAVHEADER">
! <table summary="Header navigation table" width="100%" border="0"
! cellpadding="0" cellspacing="0">
! <tr>
! <th colspan="3" align="center">Privoxy 3.0.26 User Manual</th>
! </tr>
! <tr>
! <td width="10%" align="left" valign="bottom"><a href="contact.html"
! accesskey="P">Prev</a></td>
! <td width="80%" align="center" valign="bottom"></td>
! <td width="10%" align="right" valign="bottom"><a href="seealso.html"
! accesskey="N">Next</a></td>
! </tr>
! </table>
! <hr align="left" width="100%">
! </div>
! <div class="SECT1">
! <h1 class="SECT1"><a name="COPYRIGHT" id="COPYRIGHT">12. Privoxy
! Copyright, License and History</a></h1>
! <p>Copyright � 2001-2016 by Privoxy Developers <code class=
! "EMAIL"><<a href=
! "mailto:[email protected]">[email protected]</a>></code></p>
! <p>Some source code is based on code Copyright � 1997 by Anonymous Coders
! and Junkbusters, Inc. and licensed under the <i class="CITETITLE">GNU
! General Public License</i>.</p>
! <p><span class="APPLICATION">Privoxy</span> is free software; you can
! redistribute it and/or modify it under the terms of the <i class=
! "CITETITLE">GNU General Public License</i>, version 2, as published by
! the Free Software Foundation and included in the next section.</p>
! <div class="SECT2">
! <h2 class="SECT2"><a name="LICENSE" id="LICENSE">12.1. License</a></h2>
! <table border="0" bgcolor="#E0E0E0" width="100%">
<tr>
! <td>
! <pre class="SCREEN">
! GNU GENERAL PUBLIC LICENSE
Version 2, June 1991
***************
*** 409,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>
-
--- 391,618 ----
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>
! Clint Adams<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>
! Danny Goossen<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>
! Tobias Netzel<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>
! Marc Thomas<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.85
retrieving revision 1.86
diff -C2 -d -r1.85 -r1.86
*** quickstart.html 26 Aug 2016 12:32:49 -0000 1.85
--- quickstart.html 12 Jan 2017 14:27:47 -0000 1.86
***************
*** 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>
-
--- 1,381 ----
! <!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=utf-8">
! <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="AEN655" id="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.78
retrieving revision 1.79
diff -C2 -d -r1.78 -r1.79
*** config.html 26 Aug 2016 12:32:49 -0000 1.78
--- config.html 12 Jan 2017 14:27:47 -0000 1.79
***************
*** 1,1048 ****
! <!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">
[...6985 lines suppressed...]
! <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=
! "configuration.html" accesskey="P">Prev</a></td>
! <td width="34%" align="center" valign="top"><a href="index.html"
! accesskey="H">Home</a></td>
! <td width="33%" align="right" valign="top"><a href=
! "actions-file.html" accesskey="N">Next</a></td>
! </tr>
! <tr>
! <td width="33%" align="left" valign="top">Privoxy Configuration</td>
! <td width="34%" align="center" valign="top"> </td>
! <td width="33%" align="right" valign="top">Actions Files</td>
! </tr>
! </table>
! </div>
! </body>
</html>
------------------------------------------------------------------------------
Developer Access Program for Intel Xeon Phi Processors
Access to Intel Xeon Phi processor-based developer platforms.
With one year of Intel Parallel Studio XE.
Training and support from Colfax.
Order your platform today. http://sdm.link/xeonphi
_______________________________________________
ijbswa-commits mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/ijbswa-commits