From: Fabian Keil <fk@fabiankeil.de> Date: Mon, 26 May 2014 10:49:19 +0000 (+0000) Subject: Rebuild HTML docs for 3.0.22 UNSTABLE X-Git-Tag: v_3_0_22~140 X-Git-Url: http://www.privoxy.org/gitweb/%22https:/faq/@default-cgi@/static/@default-cgi@edit-actions-add-url-form?a=commitdiff_plain;h=aaff4cd0e076bb9d094f69ac83a4ff5429235991;p=privoxy.git Rebuild HTML docs for 3.0.22 UNSTABLE --- diff --git a/doc/webserver/developer-manual/documentation.html b/doc/webserver/developer-manual/documentation.html index 79076c0d..fec3fbec 100644 --- a/doc/webserver/developer-manual/documentation.html +++ b/doc/webserver/developer-manual/documentation.html @@ -384,7 +384,7 @@ <td><span class="emphasis"><i class= "EMPHASIS">p-version</i></span>: the <span class= "APPLICATION">Privoxy</span> version string, e.g. - <span class="QUOTE">"3.0.21"</span>.</td> + <span class="QUOTE">"3.0.22"</span>.</td> </tr> <tr> diff --git a/doc/webserver/developer-manual/index.html b/doc/webserver/developer-manual/index.html index 604226cb..10ead450 100644 --- a/doc/webserver/developer-manual/index.html +++ b/doc/webserver/developer-manual/index.html @@ -39,7 +39,7 @@ entirely correct. As always, patches are welcome.</p> <p>Please note that this document is constantly evolving. This copy - represents the state at the release of version 3.0.21. You can find + represents the state at the release of version 3.0.22. You can find the latest version of the this manual at <a href= "http://www.privoxy.org/developer-manual/" target= "_top">http://www.privoxy.org/developer-manual/</a>. Please have a diff --git a/doc/webserver/developer-manual/newrelease.html b/doc/webserver/developer-manual/newrelease.html index fb103267..cf3feb7c 100644 --- a/doc/webserver/developer-manual/newrelease.html +++ b/doc/webserver/developer-manual/newrelease.html @@ -738,7 +738,7 @@ <tr> <td> <pre class="PROGRAMLISTING"> - debchange -v 3.0.21-stable-1 "New upstream version" + debchange -v 3.0.22-UNRELEASED-1 "New upstream version" </pre> </td> </tr> @@ -757,7 +757,7 @@ </table> <p>This will create <tt class= - "FILENAME">../privoxy_3.0.21-stable-1_i386.deb</tt> which can be + "FILENAME">../privoxy_3.0.22-UNRELEASED-1_i386.deb</tt> which can be uploaded. To upload the package to Sourceforge, simply issue</p> <table border="0" bgcolor="#E0E0E0" width="100%"> @@ -1090,7 +1090,7 @@ column, and click <tt class="LITERAL">Add Release</tt>. You will then need to create a new release for your package, using the format of <tt class="LITERAL">$VERSION ($CODE_STATUS)</tt>, e.g. <span class= - "emphasis"><i class="EMPHASIS">3.0.21 (beta)</i></span>.</p> + "emphasis"><i class="EMPHASIS">3.0.22 (beta)</i></span>.</p> <p>Now just follow the prompts. Be sure to add any appropriate Release notes. You should see your freshly uploaded packages in <span class= diff --git a/doc/webserver/faq/configuration.html b/doc/webserver/faq/configuration.html index 523e2c0b..35192061 100644 --- a/doc/webserver/faq/configuration.html +++ b/doc/webserver/faq/configuration.html @@ -152,13 +152,23 @@ configuration so complicated?</a></h3> <p><span class="QUOTE">"Complicated"</span> is in the eye of the - beholder. Those that are familiar with some of the underlying concepts, - such as regular expression syntax, take to it like a fish takes to - water. Also, software that tries hard to be <span class="QUOTE">"user - friendly"</span>, often lacks sophistication and flexibility. There is - always that trade-off there between power vs. easy-of-use. Furthermore, - anyone is welcome to contribute ideas and implementations to enhance - <span class="APPLICATION">Privoxy</span>.</p> + beholder.</p> + + <p>Privoxy is currently mainly written by and for people who are + already familiar with the underlying concepts like regular expressions, + HTTP and HTML, or are willing to become familiar with them to be able + to get the most out of a powerful and flexible tool such as + Privoxy.</p> + + <p>While everybody is expected to be able to get a Privoxy default + installation up and running, fine-tuning requires a certain amount of + background information and Privoxy's documentation mainly concentrates + on the Privoxy-specific parts while only providing references to the + rest.</p> + + <p>If you or anyone you know has the skills, time and energy to reduce + the barrier of entry, please <a href="general.html#PARTICIPATE">get + involved</a>.</p> </div> <div class="SECT2"> @@ -289,7 +299,7 @@ </div> <div class="SECT2"> - <h3 class="SECT2"><a name="AEN486" id="AEN486">3.11. What is the + <h3 class="SECT2"><a name="AEN488" id="AEN488">3.11. What is the <tt class="FILENAME">default.filter</tt> file? What is a <span class= "QUOTE">"filter"</span>?</a></h3> @@ -400,7 +410,7 @@ </div> <div class="SECT2"> - <h3 class="SECT2"><a name="AEN537" id="AEN537">3.13. Instead of ads, + <h3 class="SECT2"><a name="AEN539" id="AEN539">3.13. Instead of ads, now I get a checkerboard pattern. I don't want to see anything.</a></h3> @@ -427,7 +437,7 @@ </div> <div class="SECT2"> - <h3 class="SECT2"><a name="AEN554" id="AEN554">3.14. Why would anybody + <h3 class="SECT2"><a name="AEN556" id="AEN556">3.14. Why would anybody want to see a checkerboard pattern?</a></h3> <p>Remember that <a href="general.html#WHATSANAD">telling which image @@ -443,7 +453,7 @@ </div> <div class="SECT2"> - <h3 class="SECT2"><a name="AEN560" id="AEN560">3.15. I see some images + <h3 class="SECT2"><a name="AEN562" id="AEN562">3.15. I see some images being replaced with text instead of the checkerboard image. Why and how do I get rid of this?</a></h3> diff --git a/doc/webserver/faq/contact.html b/doc/webserver/faq/contact.html index a5615e5e..57dca029 100644 --- a/doc/webserver/faq/contact.html +++ b/doc/webserver/faq/contact.html @@ -260,7 +260,8 @@ <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.</p> + might cause a crash. Documentation issues, for example spelling + errors and unclear descriptions, are bugs, too.</p> </li> </ul> diff --git a/doc/webserver/faq/copyright.html b/doc/webserver/faq/copyright.html index a26dad7d..3e445e96 100644 --- a/doc/webserver/faq/copyright.html +++ b/doc/webserver/faq/copyright.html @@ -55,7 +55,7 @@ "APPLICATION">Privoxy</span>.</p> <div class="SECT2"> - <h2 class="SECT2"><a name="AEN1470" id="AEN1470">7.1. License</a></h2> + <h2 class="SECT2"><a name="AEN1479" id="AEN1479">7.1. License</a></h2> <p><span class="APPLICATION">Privoxy</span> is free software; you can redistribute it and/or modify it under the terms of the <i class= @@ -71,7 +71,7 @@ </div> <div class="SECT2"> - <h2 class="SECT2"><a name="AEN1479" id="AEN1479">7.2. History</a></h2> + <h2 class="SECT2"><a name="AEN1488" id="AEN1488">7.2. History</a></h2> <p>A long time ago, there was the <span class="APPLICATION">Internet Junkbuster</span>, by Anonymous Coders and Junkbusters Corporation. diff --git a/doc/webserver/faq/general.html b/doc/webserver/faq/general.html index d7c448d0..b9119fba 100644 --- a/doc/webserver/faq/general.html +++ b/doc/webserver/faq/general.html @@ -401,7 +401,7 @@ and <span class="APPLICATION">Privoxy's</span> privacy enhancing features at the same time. While your browser probably lacks some features <span class="APPLICATION">Privoxy</span> offers, it should - also be able to do some things more reliable, for example restricting + also be able to do some things more reliably, for example restricting and suppressing JavaScript.</p> </div> diff --git a/doc/webserver/faq/index.html b/doc/webserver/faq/index.html index dbb28c13..296bcf55 100644 --- a/doc/webserver/faq/index.html +++ b/doc/webserver/faq/index.html @@ -22,7 +22,7 @@ 2001-2011 by <a href="http://www.privoxy.org/" target="_top">Privoxy Developers</a></sub><br></p> - <p class="PUBDATE">$Id: faq.sgml,v 2.92 2013/03/01 17:44:24 fabiankeil + <p class="PUBDATE">$Id: faq.sgml,v 2.100 2014/05/05 09:59:30 fabiankeil Exp $<br></p> <div> @@ -66,7 +66,7 @@ </ul> <p>Please note that this document is a work in progress. This copy - represents the state at the release of version 3.0.21. You can find + represents the state at the release of version 3.0.22. You can find the latest version of the document at <a href= "http://www.privoxy.org/faq/" target= "_top">http://www.privoxy.org/faq/</a>. Please see the <a href= @@ -217,21 +217,21 @@ change the configuration with a browser? Does that not raise security issues?</a></dt> - <dt>3.11. <a href="configuration.html#AEN486">What is the + <dt>3.11. <a href="configuration.html#AEN488">What is the <tt class="FILENAME">default.filter</tt> file? What is a <span class="QUOTE">"filter"</span>?</a></dt> <dt>3.12. <a href="configuration.html#LANCONFIG">How can I set up Privoxy to act as a proxy for my LAN?</a></dt> - <dt>3.13. <a href="configuration.html#AEN537">Instead of ads, now + <dt>3.13. <a href="configuration.html#AEN539">Instead of ads, now I get a checkerboard pattern. I don't want to see anything.</a></dt> - <dt>3.14. <a href="configuration.html#AEN554">Why would anybody + <dt>3.14. <a href="configuration.html#AEN556">Why would anybody want to see a checkerboard pattern?</a></dt> - <dt>3.15. <a href="configuration.html#AEN560">I see some images + <dt>3.15. <a href="configuration.html#AEN562">I see some images being replaced with text instead of the checkerboard image. Why and how do I get rid of this?</a></dt> @@ -292,7 +292,7 @@ <dd> <dl> - <dt>4.1. <a href="misc.html#AEN735">How much does Privoxy slow my + <dt>4.1. <a href="misc.html#AEN737">How much does Privoxy slow my browsing down? This has to add extra time to browsing.</a></dt> <dt>4.2. <a href="misc.html#LOADINGTIMES">I notice considerable @@ -313,32 +313,32 @@ <dt>4.7. <a href="misc.html#IP">How can I hide my IP address?</a></dt> - <dt>4.8. <a href="misc.html#AEN800">Can Privoxy guarantee I am + <dt>4.8. <a href="misc.html#AEN802">Can Privoxy guarantee I am anonymous?</a></dt> - <dt>4.9. <a href="misc.html#AEN818">A test site says I am not + <dt>4.9. <a href="misc.html#AEN820">A test site says I am not using a Proxy.</a></dt> <dt>4.10. <a href="misc.html#TOR">How do I use Privoxy together with Tor?</a></dt> - <dt>4.11. <a href="misc.html#AEN874">Might some things break + <dt>4.11. <a href="misc.html#AEN876">Might some things break because header information or content is being altered?</a></dt> - <dt>4.12. <a href="misc.html#AEN888">Can Privoxy act as a + <dt>4.12. <a href="misc.html#AEN890">Can Privoxy act as a <span class="QUOTE">"caching"</span> proxy to speed up web browsing?</a></dt> - <dt>4.13. <a href="misc.html#AEN898">What about as a firewall? + <dt>4.13. <a href="misc.html#AEN900">What about as a firewall? Can Privoxy protect me?</a></dt> - <dt>4.14. <a href="misc.html#AEN903">I have large empty spaces / + <dt>4.14. <a href="misc.html#AEN905">I have large empty spaces / a checkerboard pattern now where ads used to be. Why?</a></dt> - <dt>4.15. <a href="misc.html#AEN911">How can Privoxy filter + <dt>4.15. <a href="misc.html#AEN913">How can Privoxy filter Secure (HTTPS) URLs?</a></dt> - <dt>4.16. <a href="misc.html#AEN925">Privoxy runs as a + <dt>4.16. <a href="misc.html#AEN927">Privoxy runs as a <span class="QUOTE">"server"</span>. How secure is it? Do I need to take any special precautions?</a></dt> @@ -387,14 +387,14 @@ <dd> <dl> - <dt>5.1. <a href="trouble.html#AEN1091">I cannot connect to any + <dt>5.1. <a href="trouble.html#AEN1093">I cannot connect to any websites. Or, I am getting <span class="QUOTE">"connection refused"</span> message with every web page. Why?</a></dt> <dt>5.2. <a href="trouble.html#ERROR503">Why am I getting a 503 Error (WSAECONNREFUSED) on every page?</a></dt> - <dt>5.3. <a href="trouble.html#AEN1114">I just added a new rule, + <dt>5.3. <a href="trouble.html#AEN1116">I just added a new rule, but the steenkin ad is still getting through. How?</a></dt> <dt>5.4. <a href="trouble.html#BADSITE">One of my favorite sites @@ -420,57 +420,61 @@ delays in page loading. I'm using <tt class= "LITERAL">localhost</tt> as my browser's proxy setting.</a></dt> - <dt>5.10. <a href="trouble.html#BLANKPAGE">I get a completely + <dt>5.10. <a href="trouble.html#MACOSXACCOUNTDELETION">I just + upgraded to Mac OS X 10.9 (Mavericks) and now <span class= + "APPLICATION">Privoxy</span> has stopped working.</a></dt> + + <dt>5.11. <a href="trouble.html#BLANKPAGE">I get a completely blank page at one site. <span class="QUOTE">"View Source"</span> shows only: <span class= "MARKUP"><html><body></body></html></span>. Without Privoxy the page loads fine.</a></dt> - <dt>5.11. <a href="trouble.html#NOHOSTNAME">My logs show many + <dt>5.12. <a href="trouble.html#NOHOSTNAME">My logs show many <span class="QUOTE">"Unable to get my own hostname"</span> lines. Why?</a></dt> - <dt>5.12. <a href="trouble.html#INUSE">When I try to launch + <dt>5.13. <a href="trouble.html#INUSE">When I try to launch Privoxy, I get an error message <span class="QUOTE">"port 8118 is already in use"</span> (or similar wording). Why?</a></dt> - <dt>5.13. <a href="trouble.html#DEMORONIZER">Pages with UTF-8 + <dt>5.14. <a href="trouble.html#DEMORONIZER">Pages with UTF-8 fonts are garbled.</a></dt> - <dt>5.14. <a href="trouble.html#DEMORONIZER2">Why are binary + <dt>5.15. <a href="trouble.html#DEMORONIZER2">Why are binary files (such as images) corrupted when Privoxy is used?</a></dt> - <dt>5.15. <a href="trouble.html#DEMORONIZER3">What is the + <dt>5.16. <a href="trouble.html#DEMORONIZER3">What is the <span class="QUOTE">"demoronizer"</span> and why is it there?</a></dt> - <dt>5.16. <a href="trouble.html#WINDOWOPEN">Why do I keep seeing + <dt>5.17. <a href="trouble.html#WINDOWOPEN">Why do I keep seeing <span class="QUOTE">"PrivoxyWindowOpen()"</span> in raw source code?</a></dt> - <dt>5.17. <a href="trouble.html#DNSERRORS">I am getting too many + <dt>5.18. <a href="trouble.html#DNSERRORS">I am getting too many DNS errors like <span class="QUOTE">"404 No Such Domain"</span>. Why can't Privoxy do this better?</a></dt> - <dt>5.18. <a href="trouble.html#ALLCPU">At one site Privoxy just + <dt>5.19. <a href="trouble.html#ALLCPU">At one site Privoxy just hangs, and starts taking all CPU. Why is this?</a></dt> - <dt>5.19. <a href="trouble.html#SLOWCRAWL">I just installed + <dt>5.20. <a href="trouble.html#SLOWCRAWL">I just installed Privoxy, and all my browsing has slowed to a crawl. What gives?</a></dt> - <dt>5.20. <a href="trouble.html#PREVENTCOMP">Why do my filters + <dt>5.21. <a href="trouble.html#PREVENTCOMP">Why do my filters work on some sites but not on others?</a></dt> - <dt>5.21. <a href="trouble.html#SSL-WARNINGS">On some HTTPS sites + <dt>5.22. <a href="trouble.html#SSL-WARNINGS">On some HTTPS sites my browser warns me about unauthenticated content, the URL bar doesn't get highlighted and the lock symbol appears to be broken. What's going on?</a></dt> - <dt>5.22. <a href="trouble.html#SE-LINUX">I get selinux error + <dt>5.23. <a href="trouble.html#SE-LINUX">I get selinux error messages. How can I fix this?</a></dt> - <dt>5.23. <a href="trouble.html#GENTOO-RICERS">I compiled + <dt>5.24. <a href="trouble.html#GENTOO-RICERS">I compiled <span class="APPLICATION">Privoxy</span> with Gentoo's portage and it appears to be very slow. Why?</a></dt> </dl> @@ -513,9 +517,9 @@ <dd> <dl> - <dt>7.1. <a href="copyright.html#AEN1470">License</a></dt> + <dt>7.1. <a href="copyright.html#AEN1479">License</a></dt> - <dt>7.2. <a href="copyright.html#AEN1479">History</a></dt> + <dt>7.2. <a href="copyright.html#AEN1488">History</a></dt> </dl> </dd> </dl> diff --git a/doc/webserver/faq/misc.html b/doc/webserver/faq/misc.html index ebf30b27..7ff717fe 100644 --- a/doc/webserver/faq/misc.html +++ b/doc/webserver/faq/misc.html @@ -41,7 +41,7 @@ <h1 class="SECT1"><a name="MISC" id="MISC">4. Miscellaneous</a></h1> <div class="SECT2"> - <h3 class="SECT2"><a name="AEN735" id="AEN735">4.1. How much does + <h3 class="SECT2"><a name="AEN737" id="AEN737">4.1. How much does Privoxy slow my browsing down? This has to add extra time to browsing.</a></h3> @@ -201,7 +201,7 @@ </div> <div class="SECT2"> - <h3 class="SECT2"><a name="AEN800" id="AEN800">4.8. Can Privoxy + <h3 class="SECT2"><a name="AEN802" id="AEN802">4.8. Can Privoxy guarantee I am anonymous?</a></h3> <p>No. Your chances of remaining anonymous are improved, but unless you @@ -246,7 +246,7 @@ </div> <div class="SECT2"> - <h3 class="SECT2"><a name="AEN818" id="AEN818">4.9. A test site says I + <h3 class="SECT2"><a name="AEN820" id="AEN820">4.9. A test site says I am not using a Proxy.</a></h3> <p>Good! Actually, they are probably testing for some other kinds of @@ -293,7 +293,7 @@ your local network. Using socks4a would work too, but with socks5 you get more precise error messages.</p> - <p>Since <span class="APPLICATION">Privoxy</span> 3.0.5, its <a href= + <p><span class="APPLICATION">Privoxy's</span> <a href= "../user-manual/config.html" target="_top">main configuration file</a> is already prepared for <span class="APPLICATION">Tor</span>, if you are using a default <span class="APPLICATION">Tor</span> configuration @@ -306,7 +306,7 @@ <tr> <td> <pre class="SCREEN"> -# forward-socks5 / 127.0.0.1:9050 . +# forward-socks5t / 127.0.0.1:9050 . </pre> </td> @@ -369,7 +369,7 @@ </div> <div class="SECT2"> - <h3 class="SECT2"><a name="AEN874" id="AEN874">4.11. Might some things + <h3 class="SECT2"><a name="AEN876" id="AEN876">4.11. Might some things break because header information or content is being altered?</a></h3> <p>Definitely. It is common for sites to use browser type, browser @@ -409,7 +409,7 @@ </div> <div class="SECT2"> - <h3 class="SECT2"><a name="AEN888" id="AEN888">4.12. Can Privoxy act as + <h3 class="SECT2"><a name="AEN890" id="AEN890">4.12. Can Privoxy act as a <span class="QUOTE">"caching"</span> proxy to speed up web browsing?</a></h3> @@ -425,7 +425,7 @@ </div> <div class="SECT2"> - <h3 class="SECT2"><a name="AEN898" id="AEN898">4.13. What about as a + <h3 class="SECT2"><a name="AEN900" id="AEN900">4.13. What about as a firewall? Can Privoxy protect me?</a></h3> <p>Not in the way you mean, or in the way some firewall vendors claim @@ -436,7 +436,7 @@ </div> <div class="SECT2"> - <h3 class="SECT2"><a name="AEN903" id="AEN903">4.14. I have large empty + <h3 class="SECT2"><a name="AEN905" id="AEN905">4.14. I have large empty spaces / a checkerboard pattern now where ads used to be. Why?</a></h3> <p>It is technically possible to eliminate banners and ads in a way @@ -464,7 +464,7 @@ </div> <div class="SECT2"> - <h3 class="SECT2"><a name="AEN911" id="AEN911">4.15. How can Privoxy + <h3 class="SECT2"><a name="AEN913" id="AEN913">4.15. How can Privoxy filter Secure (HTTPS) URLs?</a></h3> <p>Since secure HTTP connections are encrypted SSL sessions between @@ -498,7 +498,7 @@ </div> <div class="SECT2"> - <h3 class="SECT2"><a name="AEN925" id="AEN925">4.16. Privoxy runs as a + <h3 class="SECT2"><a name="AEN927" id="AEN927">4.16. Privoxy runs as a <span class="QUOTE">"server"</span>. How secure is it? Do I need to take any special precautions?</a></h3> diff --git a/doc/webserver/faq/trouble.html b/doc/webserver/faq/trouble.html index 2d8ae473..213d4a96 100644 --- a/doc/webserver/faq/trouble.html +++ b/doc/webserver/faq/trouble.html @@ -44,7 +44,7 @@ Troubleshooting</a></h1> <div class="SECT2"> - <h3 class="SECT2"><a name="AEN1091" id="AEN1091">5.1. I cannot connect + <h3 class="SECT2"><a name="AEN1093" id="AEN1093">5.1. I cannot connect to any websites. Or, I am getting <span class="QUOTE">"connection refused"</span> message with every web page. Why?</a></h3> @@ -94,7 +94,7 @@ </div> <div class="SECT2"> - <h3 class="SECT2"><a name="AEN1114" id="AEN1114">5.3. I just added a + <h3 class="SECT2"><a name="AEN1116" id="AEN1116">5.3. I just added a new rule, but the steenkin ad is still getting through. How?</a></h3> <p>If the ad had been displayed before you added its URL, it will @@ -361,7 +361,28 @@ Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&si=Ua </div> <div class="SECT2"> - <h3 class="SECT2"><a name="BLANKPAGE" id="BLANKPAGE">5.10. I get a + <h3 class="SECT2"><a name="MACOSXACCOUNTDELETION" id= + "MACOSXACCOUNTDELETION">5.10. I just upgraded to Mac OS X 10.9 + (Mavericks) and now <span class="APPLICATION">Privoxy</span> has + stopped working.</a></h3> + + <p>The upgrade process to Mac OS X Mavericks (10.9) from an earlier + version of OS X deletes all user accounts that are either not part of + OS X itself or are not interactive user accounts (ones you log in + with). Since, for the sake of security, <span class= + "APPLICATION">Privoxy</span> runs as a non-privileged user that is + created by its installer (_privoxy), it can no longer start up once + that account gets deleted. The solution is to perform a complete + uninstall using the supplied <span class= + "APPLICATION">uninstall.command</span> script (either back up your + configuration files or select to not have the uninstaller remove them + when it prompts you) and then reinstall <span class= + "APPLICATION">Privoxy</span> using the installer package and merge in + your configuration.</p> + </div> + + <div class="SECT2"> + <h3 class="SECT2"><a name="BLANKPAGE" id="BLANKPAGE">5.11. I get a completely blank page at one site. <span class="QUOTE">"View Source"</span> shows only: <span class= "MARKUP"><html><body></body></html></span>. @@ -398,7 +419,7 @@ Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&si=Ua </div> <div class="SECT2"> - <h3 class="SECT2"><a name="NOHOSTNAME" id="NOHOSTNAME">5.11. My logs + <h3 class="SECT2"><a name="NOHOSTNAME" id="NOHOSTNAME">5.12. My logs show many <span class="QUOTE">"Unable to get my own hostname"</span> lines. Why?</a></h3> @@ -427,7 +448,7 @@ Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&si=Ua </div> <div class="SECT2"> - <h3 class="SECT2"><a name="INUSE" id="INUSE">5.12. When I try to launch + <h3 class="SECT2"><a name="INUSE" id="INUSE">5.13. When I try to launch Privoxy, I get an error message <span class="QUOTE">"port 8118 is already in use"</span> (or similar wording). Why?</a></h3> @@ -443,36 +464,45 @@ Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&si=Ua </div> <div class="SECT2"> - <h3 class="SECT2"><a name="DEMORONIZER" id="DEMORONIZER">5.13. Pages + <h3 class="SECT2"><a name="DEMORONIZER" id="DEMORONIZER">5.14. Pages with UTF-8 fonts are garbled.</a></h3> - <p>This is caused by the <span class="QUOTE">"demoronizer"</span> - filter. You should either upgrade <span class= - "APPLICATION">Privoxy</span>, or at least upgrade to the most recent - <tt class="FILENAME">default.action</tt> file available from <a href= + <p>This may be the result of an overly aggressive filter. The filters + that are enabled in the default configuration aren't expected to cause + problems like this. If you enabled the <span class= + "QUOTE">"demoronizer"</span> filter, please try temporarily disabling + it.</p> + + <p>If that doesn't help, temporarily disable all filters to see if + another filter could be the culprit. If the problem disappears, enable + the filters one by one, until the problem reappears and the offending + filter is found.</p> + + <p>Once the problem-causing filter is known, it can be fixed or + disabled.</p> + + <p>Upgrading <span class="APPLICATION">Privoxy</span>, or going to the + most recent <tt class="FILENAME">default.action</tt> file available + from <a href= "http://sourceforge.net/project/showfiles.php?group_id=11118" target= - "_top">SourceForge</a>. Or you can simply disable the demoronizer - filter.</p> + "_top">SourceForge</a> might be worth a try, too.</p> </div> <div class="SECT2"> - <h3 class="SECT2"><a name="DEMORONIZER2" id="DEMORONIZER2">5.14. Why + <h3 class="SECT2"><a name="DEMORONIZER2" id="DEMORONIZER2">5.15. Why are binary files (such as images) corrupted when Privoxy is used?</a></h3> - <p>This may also be caused by the <span class= - "QUOTE">"demoronizer"</span> filter, in conjunction with a web server - that is misreporting the content type. Binary files are exempted from - <span class="APPLICATION">Privoxy's</span> filtering (unless the web - server by mistake says the file is something else). Either upgrade - <span class="APPLICATION">Privoxy</span>, or go to the most recent - <tt class="FILENAME">default.action</tt> file available from <a href= - "http://sourceforge.net/project/showfiles.php?group_id=11118" target= - "_top">SourceForge</a>.</p> + <p>This may also be caused by an (<a href= + "trouble.html#DEMORONIZER">overly aggressive filter</a> in conjunction + with a web server that is misreporting the content type. By default + binary files are exempted from <span class= + "APPLICATION">Privoxy's</span> filtering (unless the web server by + mistake says the file is something else).</p> </div> <div class="SECT2"> - <h3 class="SECT2"><a name="DEMORONIZER3" id="DEMORONIZER3">5.15. What + <h3 class="SECT2"><a name="DEMORONIZER3" id="DEMORONIZER3">5.16. What is the <span class="QUOTE">"demoronizer"</span> and why is it there?</a></h3> @@ -500,7 +530,7 @@ Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&si=Ua </div> <div class="SECT2"> - <h3 class="SECT2"><a name="WINDOWOPEN" id="WINDOWOPEN">5.16. Why do I + <h3 class="SECT2"><a name="WINDOWOPEN" id="WINDOWOPEN">5.17. Why do I keep seeing <span class="QUOTE">"PrivoxyWindowOpen()"</span> in raw source code?</a></h3> @@ -521,7 +551,7 @@ Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&si=Ua </div> <div class="SECT2"> - <h3 class="SECT2"><a name="DNSERRORS" id="DNSERRORS">5.17. I am getting + <h3 class="SECT2"><a name="DNSERRORS" id="DNSERRORS">5.18. I am getting too many DNS errors like <span class="QUOTE">"404 No Such Domain"</span>. Why can't Privoxy do this better?</a></h3> @@ -549,7 +579,7 @@ Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&si=Ua </div> <div class="SECT2"> - <h3 class="SECT2"><a name="ALLCPU" id="ALLCPU">5.18. At one site + <h3 class="SECT2"><a name="ALLCPU" id="ALLCPU">5.19. At one site Privoxy just hangs, and starts taking all CPU. Why is this?</a></h3> <p>This is probably a manifestation of the <span class="QUOTE">"100% @@ -568,7 +598,7 @@ Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&si=Ua </div> <div class="SECT2"> - <h3 class="SECT2"><a name="SLOWCRAWL" id="SLOWCRAWL">5.19. I just + <h3 class="SECT2"><a name="SLOWCRAWL" id="SLOWCRAWL">5.20. I just installed Privoxy, and all my browsing has slowed to a crawl. What gives?</a></h3> @@ -582,7 +612,7 @@ Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&si=Ua </div> <div class="SECT2"> - <h3 class="SECT2"><a name="PREVENTCOMP" id="PREVENTCOMP">5.20. Why do + <h3 class="SECT2"><a name="PREVENTCOMP" id="PREVENTCOMP">5.21. Why do my filters work on some sites but not on others?</a></h3> <p>It's probably due to compression. It is a common practice for web @@ -599,7 +629,7 @@ Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&si=Ua </div> <div class="SECT2"> - <h3 class="SECT2"><a name="SSL-WARNINGS" id="SSL-WARNINGS">5.21. On + <h3 class="SECT2"><a name="SSL-WARNINGS" id="SSL-WARNINGS">5.22. On some HTTPS sites my browser warns me about unauthenticated content, the URL bar doesn't get highlighted and the lock symbol appears to be broken. What's going on?</a></h3> @@ -645,7 +675,7 @@ Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&si=Ua </div> <div class="SECT2"> - <h3 class="SECT2"><a name="SE-LINUX" id="SE-LINUX">5.22. I get selinux + <h3 class="SECT2"><a name="SE-LINUX" id="SE-LINUX">5.23. I get selinux error messages. How can I fix this?</a></h3> <p>Please report the problem to the creator of your selinux @@ -670,7 +700,7 @@ Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&si=Ua </div> <div class="SECT2"> - <h3 class="SECT2"><a name="GENTOO-RICERS" id="GENTOO-RICERS">5.23. I + <h3 class="SECT2"><a name="GENTOO-RICERS" id="GENTOO-RICERS">5.24. I compiled <span class="APPLICATION">Privoxy</span> with Gentoo's portage and it appears to be very slow. Why?</a></h3> diff --git a/doc/webserver/index.html b/doc/webserver/index.html index b32c7e66..5cc2f4ca 100644 --- a/doc/webserver/index.html +++ b/doc/webserver/index.html @@ -52,7 +52,7 @@ </ul> <p>The most recent release is <a href="announce.txt" target= - "_top">3.0.21 (stable)</a>.</p> + "_top">3.0.22 (UNRELEASED)</a>.</p> </div> </div> <hr> diff --git a/doc/webserver/privoxy-index.html b/doc/webserver/privoxy-index.html index eef47e60..4ea7856e 100644 --- a/doc/webserver/privoxy-index.html +++ b/doc/webserver/privoxy-index.html @@ -19,7 +19,7 @@ <h1 class="TITLE"><a name="AEN2" id="AEN2">Privoxy - The Privacy Enhancing Proxy</a></h1> - <h2 class="SUBTITLE">Project Index Page v3.0.21</h2> + <h2 class="SUBTITLE">Project Index Page v3.0.22</h2> <div> <div class="ABSTRACT"> diff --git a/doc/webserver/user-manual/actions-file.html b/doc/webserver/user-manual/actions-file.html index 3a318b3e..221e7e2a 100644 --- a/doc/webserver/user-manual/actions-file.html +++ b/doc/webserver/user-manual/actions-file.html @@ -6,7 +6,7 @@ <title>Actions Files</title> <meta name="GENERATOR" content= "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy 3.0.21 User Manual" href="index.html"> + <link rel="HOME" title="Privoxy 3.0.22 User Manual" href="index.html"> <link rel="PREVIOUS" title="The Main Configuration File" href= "config.html"> <link rel="NEXT" title="Filter Files" href="filter-file.html"> @@ -21,7 +21,7 @@ <table summary="Header navigation table" width="100%" border="0" cellpadding="0" cellspacing="0"> <tr> - <th colspan="3" align="center">Privoxy 3.0.21 User Manual</th> + <th colspan="3" align="center">Privoxy 3.0.22 User Manual</th> </tr> <tr> @@ -117,7 +117,7 @@ in <tt class="FILENAME">default.action</tt> are:</p> <div class="TABLE"> - <a name="AEN2858" id="AEN2858"></a> + <a name="AEN2863" id="AEN2863"></a> <p><b>Table 1. Default Configurations</b></p> @@ -314,7 +314,7 @@ actions</a>.</p> <div class="SECT2"> - <h2 class="SECT2"><a name="AEN2957" id="AEN2957">8.1. Finding the Right + <h2 class="SECT2"><a name="AEN2962" id="AEN2962">8.1. Finding the Right Mix</a></h2> <p>Note that some <a href="actions-file.html#ACTIONS">actions</a>, like @@ -339,7 +339,7 @@ </div> <div class="SECT2"> - <h2 class="SECT2"><a name="AEN2964" id="AEN2964">8.2. How to + <h2 class="SECT2"><a name="AEN2969" id="AEN2969">8.2. How to Edit</a></h2> <p>The easiest way to edit the actions files is with a browser by using @@ -430,8 +430,8 @@ and potentially match against many similar patterns.</p> <p>Generally, an URL pattern has the form <tt class= - "LITERAL"><domain><port>/<path></tt>, where the - <tt class="LITERAL"><domain></tt>, the <tt class= + "LITERAL"><host><port>/<path></tt>, where the + <tt class="LITERAL"><host></tt>, the <tt class= "LITERAL"><port></tt> and the <tt class= "LITERAL"><path></tt> are optional. (This is why the special <tt class="LITERAL">/</tt> pattern matches all URLs). Note that the @@ -440,15 +440,15 @@ "EMPHASIS">not</i></span> be included in the pattern. This is assumed already!</p> - <p>The pattern matching syntax is different for the domain and path - parts of the URL. The domain part uses a simple globbing type matching + <p>The pattern matching syntax is different for the host and path parts + of the URL. The host part uses a simple globbing type matching technique, while the path part uses more flexible <a href= "http://en.wikipedia.org/wiki/Regular_expressions" target= "_top"><span class="QUOTE">"Regular Expressions"</span></a> (POSIX 1003.2).</p> <p>The port part of a pattern is a decimal port number preceded by a - colon (<tt class="LITERAL">:</tt>). If the domain part contains a + colon (<tt class="LITERAL">:</tt>). If the host part contains a numerical IPv6 address, it has to be put into angle brackets (<tt class="LITERAL"><</tt>, <tt class="LITERAL">></tt>).</p> @@ -457,7 +457,7 @@ <dt><tt class="LITERAL">www.example.com/</tt></dt> <dd> - <p>is a domain-only pattern and will match any request to + <p>is a host-only pattern and will match any request to <tt class="LITERAL">www.example.com</tt>, regardless of which document on that server is requested. So ALL pages in this domain would be covered by the scope of this action. Note that a simple @@ -468,7 +468,7 @@ <dt><tt class="LITERAL">www.example.com</tt></dt> <dd> - <p>means exactly the same. For domain-only patterns, the trailing + <p>means exactly the same. For host-only patterns, the trailing <tt class="LITERAL">/</tt> may be omitted.</p> </dd> @@ -510,6 +510,14 @@ <p>Matches any URL pointing to TCP port 8000.</p> </dd> + <dt><tt class="LITERAL">10.0.0.1/</tt></dt> + + <dd> + <p>Matches any URL with the host address <tt class= + "LITERAL">10.0.0.1</tt>. (Note that the real URL uses plain + brackets, not angle brackets.)</p> + </dd> + <dt><tt class="LITERAL"><2001:db8::1>/</tt></dt> <dd> @@ -529,12 +537,14 @@ </div> <div class="SECT3"> - <h3 class="SECT3"><a name="AEN3076" id="AEN3076">8.4.1. The Domain - Pattern</a></h3> + <h3 class="SECT3"><a name="HOST-PATTERN" id="HOST-PATTERN">8.4.1. The + Host Pattern</a></h3> - <p>The matching of the domain part offers some flexible options: if - the domain starts or ends with a dot, it becomes unanchored at that - end. For example:</p> + <p>The matching of the host part offers some flexible options: if the + host pattern starts or ends with a dot, it becomes unanchored at that + end. The host pattern is often referred to as domain pattern as it is + usually used to match domain names and not IP addresses. For + example:</p> <div class="VARIABLELIST"> <dl> @@ -634,7 +644,7 @@ </div> <div class="SECT3"> - <h3 class="SECT3"><a name="AEN3152" id="AEN3152">8.4.2. The Path + <h3 class="SECT3"><a name="AEN3163" id="AEN3163">8.4.2. The Path Pattern</a></h3> <p><span class="APPLICATION">Privoxy</span> uses <span class= @@ -784,6 +794,24 @@ indirection is seldom needed anyway and even the example doesn't make too much sense.</p> </div> + + <div class="SECT3"> + <h3 class="SECT3"><a name="NEGATIVE-TAG-PATTERNS" id= + "NEGATIVE-TAG-PATTERNS">8.4.4. The Negative Tag Patterns</a></h3> + + <p>To match requests that do not have a certain tag, specify a + negative tag pattern by prefixing the tag pattern line with either + <span class="QUOTE">"NO-REQUEST-TAG:"</span> or <span class= + "QUOTE">"NO-RESPONSE-TAG:"</span> instead of <span class= + "QUOTE">"TAG:"</span>.</p> + + <p>Negative tag patterns created with <span class= + "QUOTE">"NO-REQUEST-TAG:"</span> are checked after all client headers + are scanned, the ones created with <span class= + "QUOTE">"NO-RESPONSE-TAG:"</span> are checked after all server + headers are scanned. In both cases all the created tags are + considered.</p> + </div> </div> <div class="SECT2"> @@ -4336,7 +4364,7 @@ example.org/instance-that-is-delivered-as-xml-but-is-not </div> <div class="SECT3"> - <h3 class="SECT3"><a name="AEN4827" id="AEN4827">8.5.35. + <h3 class="SECT3"><a name="AEN4847" id="AEN4847">8.5.35. Summary</a></h3> <p>Note that many of these actions have the potential to cause a page @@ -4495,7 +4523,7 @@ example.org/instance-that-is-delivered-as-xml-but-is-not together:</p> <div class="SECT3"> - <h3 class="SECT3"><a name="AEN4891" id="AEN4891">8.7.1. + <h3 class="SECT3"><a name="AEN4911" id="AEN4911">8.7.1. match-all.action</a></h3> <p>Remember <span class="emphasis"><i class="EMPHASIS">all actions @@ -4544,7 +4572,7 @@ example.org/instance-that-is-delivered-as-xml-but-is-not </div> <div class="SECT3"> - <h3 class="SECT3"><a name="AEN4913" id="AEN4913">8.7.2. + <h3 class="SECT3"><a name="AEN4933" id="AEN4933">8.7.2. default.action</a></h3> <p>If you aren't a developer, there's no need for you to edit the @@ -4887,7 +4915,7 @@ wiki. </div> <div class="SECT3"> - <h3 class="SECT3"><a name="AEN5026" id="AEN5026">8.7.3. + <h3 class="SECT3"><a name="AEN5046" id="AEN5046">8.7.3. user.action</a></h3> <p>So far we are painting with a broad brush by setting general diff --git a/doc/webserver/user-manual/appendix.html b/doc/webserver/user-manual/appendix.html index 9b1cc1bf..54fb4765 100644 --- a/doc/webserver/user-manual/appendix.html +++ b/doc/webserver/user-manual/appendix.html @@ -6,7 +6,7 @@ <title>Appendix</title> <meta name="GENERATOR" content= "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy 3.0.21 User Manual" href="index.html"> + <link rel="HOME" title="Privoxy 3.0.22 User Manual" href="index.html"> <link rel="PREVIOUS" title="See Also" href="seealso.html"> <link rel="STYLESHEET" type="text/css" href="../p_doc.css"> <meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> @@ -19,7 +19,7 @@ <table summary="Header navigation table" width="100%" border="0" cellpadding="0" cellspacing="0"> <tr> - <th colspan="3" align="center">Privoxy 3.0.21 User Manual</th> + <th colspan="3" align="center">Privoxy 3.0.22 User Manual</th> </tr> <tr> @@ -293,7 +293,7 @@ </div> <div class="SECT2"> - <h2 class="SECT2"><a name="AEN5902" id="AEN5902">14.2. Privoxy's + <h2 class="SECT2"><a name="AEN5929" id="AEN5929">14.2. Privoxy's Internal Pages</a></h2> <p>Since <span class="APPLICATION">Privoxy</span> proxies each @@ -313,7 +313,7 @@ <ul> <li> - <p>Privoxy main page:</p><a name="AEN5916" id="AEN5916"></a> + <p>Privoxy main page:</p><a name="AEN5943" id="AEN5943"></a> <blockquote class="BLOCKQUOTE"> <p><a href="http://config.privoxy.org/" target= @@ -328,8 +328,8 @@ <li> <p>Show information about the current configuration, including - viewing and editing of actions files:</p><a name="AEN5924" id= - "AEN5924"></a> + viewing and editing of actions files:</p><a name="AEN5951" id= + "AEN5951"></a> <blockquote class="BLOCKQUOTE"> <p><a href="http://config.privoxy.org/show-status" target= @@ -338,8 +338,8 @@ </li> <li> - <p>Show the source code version numbers:</p><a name="AEN5929" id= - "AEN5929"></a> + <p>Show the source code version numbers:</p><a name="AEN5956" id= + "AEN5956"></a> <blockquote class="BLOCKQUOTE"> <p><a href="http://config.privoxy.org/show-version" target= @@ -348,8 +348,8 @@ </li> <li> - <p>Show the browser's request headers:</p><a name="AEN5934" id= - "AEN5934"></a> + <p>Show the browser's request headers:</p><a name="AEN5961" id= + "AEN5961"></a> <blockquote class="BLOCKQUOTE"> <p><a href="http://config.privoxy.org/show-request" target= @@ -358,8 +358,8 @@ </li> <li> - <p>Show which actions apply to a URL and why:</p><a name="AEN5939" - id="AEN5939"></a> + <p>Show which actions apply to a URL and why:</p><a name="AEN5966" + id="AEN5966"></a> <blockquote class="BLOCKQUOTE"> <p><a href="http://config.privoxy.org/show-url-info" target= @@ -373,20 +373,20 @@ <span class="QUOTE">"off"</span>, <span class= "QUOTE">"Privoxy"</span> continues to run, but only as a pass-through proxy, with no actions taking place:</p><a name= - "AEN5947" id="AEN5947"></a> + "AEN5974" id="AEN5974"></a> <blockquote class="BLOCKQUOTE"> <p><a href="http://config.privoxy.org/toggle" target= "_top">http://config.privoxy.org/toggle</a></p> </blockquote> - <p>Short cuts. Turn off, then on:</p><a name="AEN5951" id= - "AEN5951"></a> + <p>Short cuts. Turn off, then on:</p><a name="AEN5978" id= + "AEN5978"></a> <blockquote class="BLOCKQUOTE"> <p><a href="http://config.privoxy.org/toggle?set=disable" target= "_top">http://config.privoxy.org/toggle?set=disable</a></p> - </blockquote><a name="AEN5954" id="AEN5954"></a> + </blockquote><a name="AEN5981" id="AEN5981"></a> <blockquote class="BLOCKQUOTE"> <p><a href="http://config.privoxy.org/toggle?set=enable" target= diff --git a/doc/webserver/user-manual/config.html b/doc/webserver/user-manual/config.html index 85c80e22..0ac3f667 100644 --- a/doc/webserver/user-manual/config.html +++ b/doc/webserver/user-manual/config.html @@ -6,7 +6,7 @@ <title>The Main Configuration File</title> <meta name="GENERATOR" content= "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy 3.0.21 User Manual" href="index.html"> + <link rel="HOME" title="Privoxy 3.0.22 User Manual" href="index.html"> <link rel="PREVIOUS" title="Privoxy Configuration" href= "configuration.html"> <link rel="NEXT" title="Actions Files" href="actions-file.html"> @@ -21,7 +21,7 @@ <table summary="Header navigation table" width="100%" border="0" cellpadding="0" cellspacing="0"> <tr> - <th colspan="3" align="center">Privoxy 3.0.21 User Manual</th> + <th colspan="3" align="center">Privoxy 3.0.22 User Manual</th> </tr> <tr> @@ -2030,7 +2030,7 @@ <tr> <td> <pre class="SCREEN"> - forward-socks5 / 127.0.0.1:9050 . + forward-socks5t / 127.0.0.1:9050 . </pre> </td> </tr> @@ -2288,6 +2288,9 @@ HTTP connections into <span class= "APPLICATION">Privoxy</span>.</p> + <p>Note that intercepting encrypted connections (HTTPS) isn't + supported.</p> + <p>Make sure that <span class="APPLICATION">Privoxy's</span> own requests aren't redirected as well. Additionally take care that <span class="APPLICATION">Privoxy</span> can't diff --git a/doc/webserver/user-manual/configuration.html b/doc/webserver/user-manual/configuration.html index 1e2e346c..22454888 100644 --- a/doc/webserver/user-manual/configuration.html +++ b/doc/webserver/user-manual/configuration.html @@ -6,7 +6,7 @@ <title>Privoxy Configuration</title> <meta name="GENERATOR" content= "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy 3.0.21 User Manual" href="index.html"> + <link rel="HOME" title="Privoxy 3.0.22 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"> @@ -20,7 +20,7 @@ <table summary="Header navigation table" width="100%" border="0" cellpadding="0" cellspacing="0"> <tr> - <th colspan="3" align="center">Privoxy 3.0.21 User Manual</th> + <th colspan="3" align="center">Privoxy 3.0.22 User Manual</th> </tr> <tr> @@ -46,7 +46,7 @@ controlled easily with a web browser.</p> <div class="SECT2"> - <h2 class="SECT2"><a name="AEN1078" id="AEN1078">6.1. Controlling + <h2 class="SECT2"><a name="AEN1080" id="AEN1080">6.1. Controlling Privoxy with Your Web Browser</a></h2> <p><span class="APPLICATION">Privoxy</span>'s user interface can be @@ -63,8 +63,8 @@ </pre> - <h2 class="BRIDGEHEAD"><a name="AEN1086" id= - "AEN1086"></a> Privoxy Menu</h2> + <h2 class="BRIDGEHEAD"><a name="AEN1088" id= + "AEN1088"></a> Privoxy Menu</h2> <pre> </pre> @@ -104,7 +104,7 @@ <tr> <td> - ▪ <a href="http://www.privoxy.org/3.0.21/user-manual/" + ▪ <a href="http://www.privoxy.org/3.0.22/user-manual/" target="_top">Documentation</a></td> </tr> </tbody> @@ -147,7 +147,9 @@ <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> + <span class="APPLICATION">Privoxy</span> executable. The name and + number of configuration files has changed from previous versions, and + is subject to change as development progresses.</p> <p>The installed defaults provide a reasonable starting point, though some settings may be aggressive by some standards. For the time being, @@ -236,6 +238,12 @@ "QUOTE">"wake up"</span> requests must obviously be sent to the <span class="emphasis"><i class="EMPHASIS">old</i></span> listening address.</p> + + <p>While under development, the configuration content is subject to + change. The below documentation may not be accurate by the time you + read this. Also, what constitutes a <span class= + "QUOTE">"default"</span> setting, may change, so please check all your + configuration files on important issues.</p> </div> </div> diff --git a/doc/webserver/user-manual/contact.html b/doc/webserver/user-manual/contact.html index 87b96447..603801f9 100644 --- a/doc/webserver/user-manual/contact.html +++ b/doc/webserver/user-manual/contact.html @@ -7,7 +7,7 @@ Requests</title> <meta name="GENERATOR" content= "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy 3.0.21 User Manual" href="index.html"> + <link rel="HOME" title="Privoxy 3.0.22 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= @@ -23,7 +23,7 @@ <table summary="Header navigation table" width="100%" border="0" cellpadding="0" cellspacing="0"> <tr> - <th colspan="3" align="center">Privoxy 3.0.21 User Manual</th> + <th colspan="3" align="center">Privoxy 3.0.22 User Manual</th> </tr> <tr> @@ -260,7 +260,8 @@ <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.</p> + might cause a crash. Documentation issues, for example spelling + errors and unclear descriptions, are bugs, too.</p> </li> </ul> diff --git a/doc/webserver/user-manual/copyright.html b/doc/webserver/user-manual/copyright.html index 1c18ffb3..6864deed 100644 --- a/doc/webserver/user-manual/copyright.html +++ b/doc/webserver/user-manual/copyright.html @@ -6,7 +6,7 @@ <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.21 User Manual" href="index.html"> + <link rel="HOME" title="Privoxy 3.0.22 User Manual" href="index.html"> <link rel="PREVIOUS" title= "Contacting the Developers, Bug Reporting and Feature Requests" href= "contact.html"> @@ -22,7 +22,7 @@ <table summary="Header navigation table" width="100%" border="0" cellpadding="0" cellspacing="0"> <tr> - <th colspan="3" align="center">Privoxy 3.0.21 User Manual</th> + <th colspan="3" align="center">Privoxy 3.0.22 User Manual</th> </tr> <tr> @@ -493,7 +493,8 @@ Public License instead of this License. provided patches, made suggestions or contributed in some way. These include (in alphabetical order):</p> - <p class="LITERALLAYOUT"> Ken Arromdee<br> + <p class="LITERALLAYOUT"> Anatoly Arzhnikov<br> + Ken Arromdee<br> Natxo Asenjo<br> Devin Bayer<br> Havard Berland<br> @@ -568,8 +569,10 @@ Public License instead of this License. Spinor S.<br> Peter Thoenen<br> Martin Thomas<br> + Reuben Thomas<br> Bobby G. Vinyard<br> Jochen Voss<br> + David Wagner<br> Glenn Washburn<br> Song Weijia<br> Jörg Weinmann<br> diff --git a/doc/webserver/user-manual/filter-file.html b/doc/webserver/user-manual/filter-file.html index f01f6893..49284e01 100644 --- a/doc/webserver/user-manual/filter-file.html +++ b/doc/webserver/user-manual/filter-file.html @@ -6,7 +6,7 @@ <title>Filter Files</title> <meta name="GENERATOR" content= "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy 3.0.21 User Manual" href="index.html"> + <link rel="HOME" title="Privoxy 3.0.22 User Manual" href="index.html"> <link rel="PREVIOUS" title="Actions Files" href="actions-file.html"> <link rel="NEXT" title="Privoxy's Template Files" href="templates.html"> <link rel="STYLESHEET" type="text/css" href="../p_doc.css"> @@ -20,7 +20,7 @@ <table summary="Header navigation table" width="100%" border="0" cellpadding="0" cellspacing="0"> <tr> - <th colspan="3" align="center">Privoxy 3.0.21 User Manual</th> + <th colspan="3" align="center">Privoxy 3.0.22 User Manual</th> </tr> <tr> @@ -134,9 +134,28 @@ FILTER: foo Replace all "foo" with "bar" "_top">Perl</a>'s <tt class="LITERAL">s///</tt> operator. If you are familiar with Perl, you will find this to be quite intuitive, and may want to look at the PCRS documentation for the subtle differences to Perl - behaviour. Most notably, the non-standard option letter <tt class= + behaviour.</p> + + <p>Most notably, the non-standard option letter <tt class= "LITERAL">U</tt> is supported, which turns the default to ungreedy - matching.</p> + matching (add <tt class="LITERAL">?</tt> to quantifiers to turn them + greedy again).</p> + + <p>The non-standard option letter <tt class="LITERAL">D</tt> (dynamic) + allows to use the variables $host, $origin (the IP address the request + came from), $path and $url. They will be replaced with the value they + refer to before the filter is executed.</p> + + <p>Note that '$' is a bad choice for a delimiter in a dynamic filter as + you might end up with unintended variables if you use a variable name + directly after the delimiter. Variables will be resolved without escaping + anything, therefore you also have to be careful not to chose delimiters + that appear in the replacement text. For example '<' should be save, + while '?' will sooner or later cause conflicts with $url.</p> + + <p>The non-standard option letter <tt class="LITERAL">T</tt> (trivial) + prevents parsing for backreferences in the substitute. Use it if you want + to include text like '$&' in your substitute without quoting.</p> <p>If you are new to <a href= "http://en.wikipedia.org/wiki/Regular_expressions" target= @@ -151,7 +170,7 @@ FILTER: foo Replace all "foo" with "bar" started.</p> <div class="SECT2"> - <h2 class="SECT2"><a name="AEN5181" id="AEN5181">9.1. Filter File + <h2 class="SECT2"><a name="AEN5208" id="AEN5208">9.1. Filter File Tutorial</a></h2> <p>Now, let's complete our <span class="QUOTE">"foo"</span> content diff --git a/doc/webserver/user-manual/index.html b/doc/webserver/user-manual/index.html index 09386f82..3746844f 100644 --- a/doc/webserver/user-manual/index.html +++ b/doc/webserver/user-manual/index.html @@ -3,7 +3,7 @@ <html> <head> - <title>Privoxy 3.0.21 User Manual</title> + <title>Privoxy 3.0.22 User Manual</title> <meta name="GENERATOR" content= "Modular DocBook HTML Stylesheet Version 1.79"> <link rel="NEXT" title="Introduction" href="introduction.html"> @@ -16,14 +16,14 @@ "#840084" alink="#0000FF"> <div class="ARTICLE"> <div class="TITLEPAGE"> - <h1 class="TITLE"><a name="AEN2" id="AEN2">Privoxy 3.0.21 User + <h1 class="TITLE"><a name="AEN2" id="AEN2">Privoxy 3.0.22 User Manual</a></h1> <p class="PUBDATE"><sub><a href="copyright.html">Copyright</a> © 2001-2013 by <a href="http://www.privoxy.org/" target="_top">Privoxy Developers</a></sub><br></p> - <p class="PUBDATE">$Id: user-manual.sgml,v 2.175 2013/03/20 11:30:28 + <p class="PUBDATE">$Id: user-manual.sgml,v 2.182 2014/05/05 10:08:43 fabiankeil Exp $<br></p> <div> @@ -173,7 +173,7 @@ <dd> <dl> - <dt>6.1. <a href="configuration.html#AEN1078">Controlling Privoxy + <dt>6.1. <a href="configuration.html#AEN1080">Controlling Privoxy with Your Web Browser</a></dt> <dt>6.2. <a href="configuration.html#CONFOVERVIEW">Configuration @@ -345,10 +345,10 @@ <dd> <dl> - <dt>8.1. <a href="actions-file.html#AEN2957">Finding the Right + <dt>8.1. <a href="actions-file.html#AEN2962">Finding the Right Mix</a></dt> - <dt>8.2. <a href="actions-file.html#AEN2964">How to Edit</a></dt> + <dt>8.2. <a href="actions-file.html#AEN2969">How to Edit</a></dt> <dt>8.3. <a href="actions-file.html#ACTIONS-APPLY">How Actions are Applied to Requests</a></dt> @@ -358,14 +358,18 @@ <dd> <dl> - <dt>8.4.1. <a href="actions-file.html#AEN3076">The Domain + <dt>8.4.1. <a href="actions-file.html#HOST-PATTERN">The Host Pattern</a></dt> - <dt>8.4.2. <a href="actions-file.html#AEN3152">The Path + <dt>8.4.2. <a href="actions-file.html#AEN3163">The Path Pattern</a></dt> <dt>8.4.3. <a href="actions-file.html#TAG-PATTERN">The Tag Pattern</a></dt> + + <dt>8.4.4. <a href= + "actions-file.html#NEGATIVE-TAG-PATTERNS">The Negative Tag + Patterns</a></dt> </dl> </dd> @@ -475,7 +479,7 @@ "actions-file.html#SET-IMAGE-BLOCKER">set-image-blocker</a></dt> <dt>8.5.35. <a href= - "actions-file.html#AEN4827">Summary</a></dt> + "actions-file.html#AEN4847">Summary</a></dt> </dl> </dd> @@ -487,13 +491,13 @@ <dd> <dl> <dt>8.7.1. <a href= - "actions-file.html#AEN4891">match-all.action</a></dt> + "actions-file.html#AEN4911">match-all.action</a></dt> <dt>8.7.2. <a href= - "actions-file.html#AEN4913">default.action</a></dt> + "actions-file.html#AEN4933">default.action</a></dt> <dt>8.7.3. <a href= - "actions-file.html#AEN5026">user.action</a></dt> + "actions-file.html#AEN5046">user.action</a></dt> </dl> </dd> </dl> @@ -503,7 +507,7 @@ <dd> <dl> - <dt>9.1. <a href="filter-file.html#AEN5181">Filter File + <dt>9.1. <a href="filter-file.html#AEN5208">Filter File Tutorial</a></dt> <dt>9.2. <a href="filter-file.html#PREDEFINED-FILTERS">The @@ -567,7 +571,7 @@ <dt>14.1. <a href="appendix.html#REGEX">Regular Expressions</a></dt> - <dt>14.2. <a href="appendix.html#AEN5902">Privoxy's Internal + <dt>14.2. <a href="appendix.html#AEN5929">Privoxy's Internal Pages</a></dt> <dd> diff --git a/doc/webserver/user-manual/installation.html b/doc/webserver/user-manual/installation.html index 021c2e92..f637e431 100644 --- a/doc/webserver/user-manual/installation.html +++ b/doc/webserver/user-manual/installation.html @@ -6,7 +6,7 @@ <title>Installation</title> <meta name="GENERATOR" content= "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy 3.0.21 User Manual" href="index.html"> + <link rel="HOME" title="Privoxy 3.0.22 User Manual" href="index.html"> <link rel="PREVIOUS" title="Introduction" href="introduction.html"> <link rel="NEXT" title="What's New in this Release" href="whatsnew.html"> <link rel="STYLESHEET" type="text/css" href="../p_doc.css"> @@ -20,7 +20,7 @@ <table summary="Header navigation table" width="100%" border="0" cellpadding="0" cellspacing="0"> <tr> - <th colspan="3" align="center">Privoxy 3.0.21 User Manual</th> + <th colspan="3" align="center">Privoxy 3.0.22 User Manual</th> </tr> <tr> @@ -252,8 +252,8 @@ <tr> <td> <pre class="SCREEN"> - tar xzvf privoxy-3.0.21-stable-src.tar.gz - cd privoxy-3.0.21-stable + tar xzvf privoxy-3.0.22-beta-src.tar.gz + cd privoxy-3.0.22-beta </pre> </td> </tr> diff --git a/doc/webserver/user-manual/introduction.html b/doc/webserver/user-manual/introduction.html index dcd6e5b5..66ebe7a6 100644 --- a/doc/webserver/user-manual/introduction.html +++ b/doc/webserver/user-manual/introduction.html @@ -6,8 +6,8 @@ <title>Introduction</title> <meta name="GENERATOR" content= "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy 3.0.21 User Manual" href="index.html"> - <link rel="PREVIOUS" title="Privoxy 3.0.21 User Manual" href="index.html"> + <link rel="HOME" title="Privoxy 3.0.22 User Manual" href="index.html"> + <link rel="PREVIOUS" title="Privoxy 3.0.22 User Manual" href="index.html"> <link rel="NEXT" title="Installation" href="installation.html"> <link rel="STYLESHEET" type="text/css" href="../p_doc.css"> <meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> @@ -20,7 +20,7 @@ <table summary="Header navigation table" width="100%" border="0" cellpadding="0" cellspacing="0"> <tr> - <th colspan="3" align="center">Privoxy 3.0.21 User Manual</th> + <th colspan="3" align="center">Privoxy 3.0.22 User Manual</th> </tr> <tr> @@ -40,8 +40,17 @@ <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.21.</p> + <p>This documentation is included with the current UNRELEASED version of + <span class="APPLICATION">Privoxy</span>, 3.0.22, and is mostly complete + at this point. The most up to date reference for the time being is still + the comments in the source files and in the individual configuration + files. Development of a new version is currently nearing completion, and + includes significant changes and enhancements over earlier versions.</p> + + <p>Since this is a UNRELEASED version, not all new features are well + tested. This documentation may be slightly out of sync as a result + (especially with CVS sources). And there <span class="emphasis"><i class= + "EMPHASIS">may be</i></span> bugs, though hopefully not many!</p> <div class="SECT2"> <h2 class="SECT2"><a name="FEATURES" id="FEATURES">1.1. @@ -50,8 +59,8 @@ <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> + supplemental features, some of them currently under development, that + give the end-user more control, more privacy and more freedom:</p> <ul> <li> @@ -157,7 +166,7 @@ </tr> <tr> - <td width="33%" align="left" valign="top">Privoxy 3.0.21 User + <td width="33%" align="left" valign="top">Privoxy 3.0.22 User Manual</td> <td width="34%" align="center" valign="top"> </td> diff --git a/doc/webserver/user-manual/quickstart.html b/doc/webserver/user-manual/quickstart.html index 880d3bd7..ef1a179d 100644 --- a/doc/webserver/user-manual/quickstart.html +++ b/doc/webserver/user-manual/quickstart.html @@ -6,7 +6,7 @@ <title>Quickstart to Using Privoxy</title> <meta name="GENERATOR" content= "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy 3.0.21 User Manual" href="index.html"> + <link rel="HOME" title="Privoxy 3.0.22 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"> @@ -21,7 +21,7 @@ <table summary="Header navigation table" width="100%" border="0" cellpadding="0" cellspacing="0"> <tr> - <th colspan="3" align="center">Privoxy 3.0.21 User Manual</th> + <th colspan="3" align="center">Privoxy 3.0.22 User Manual</th> </tr> <tr> @@ -343,7 +343,7 @@ "GUIBUTTON">Edit</span>"</span>:</p> <div class="FIGURE"> - <a name="AEN854" id="AEN854"></a> + <a name="AEN856" id="AEN856"></a> <p><b>Figure 1. Actions Files in Use</b></p> diff --git a/doc/webserver/user-manual/seealso.html b/doc/webserver/user-manual/seealso.html index 2621350e..3dd23847 100644 --- a/doc/webserver/user-manual/seealso.html +++ b/doc/webserver/user-manual/seealso.html @@ -6,7 +6,7 @@ <title>See Also</title> <meta name="GENERATOR" content= "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy 3.0.21 User Manual" href="index.html"> + <link rel="HOME" title="Privoxy 3.0.22 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"> @@ -21,7 +21,7 @@ <table summary="Header navigation table" width="100%" border="0" cellpadding="0" cellspacing="0"> <tr> - <th colspan="3" align="center">Privoxy 3.0.21 User Manual</th> + <th colspan="3" align="center">Privoxy 3.0.22 User Manual</th> </tr> <tr> diff --git a/doc/webserver/user-manual/startup.html b/doc/webserver/user-manual/startup.html index c0868408..4d2418a0 100644 --- a/doc/webserver/user-manual/startup.html +++ b/doc/webserver/user-manual/startup.html @@ -6,7 +6,7 @@ <title>Starting Privoxy</title> <meta name="GENERATOR" content= "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy 3.0.21 User Manual" href="index.html"> + <link rel="HOME" title="Privoxy 3.0.22 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"> @@ -21,7 +21,7 @@ <table summary="Header navigation table" width="100%" border="0" cellpadding="0" cellspacing="0"> <tr> - <th colspan="3" align="center">Privoxy 3.0.21 User Manual</th> + <th colspan="3" align="center">Privoxy 3.0.22 User Manual</th> </tr> <tr> @@ -55,7 +55,7 @@ protocols.</p> <div class="FIGURE"> - <a name="AEN909" id="AEN909"></a> + <a name="AEN911" id="AEN911"></a> <p><b>Figure 2. Proxy Configuration Showing Mozilla/Netscape HTTP and HTTPS (SSL) Settings</b></p> @@ -112,7 +112,7 @@ only HTTP and HTTPS (SSL)!</p> <div class="FIGURE"> - <a name="AEN954" id="AEN954"></a> + <a name="AEN956" id="AEN956"></a> <p><b>Figure 3. Proxy Configuration Showing Internet Explorer HTTP and HTTPS (Secure) Settings</b></p> @@ -320,12 +320,12 @@ <p><span class="emphasis"><i class="EMPHASIS">--pre-chroot-nslookup hostname</i></span></p> - <p>Specifies a hostname 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>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 diff --git a/doc/webserver/user-manual/templates.html b/doc/webserver/user-manual/templates.html index 40e3065b..265341d9 100644 --- a/doc/webserver/user-manual/templates.html +++ b/doc/webserver/user-manual/templates.html @@ -6,7 +6,7 @@ <title>Privoxy's Template Files</title> <meta name="GENERATOR" content= "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy 3.0.21 User Manual" href="index.html"> + <link rel="HOME" title="Privoxy 3.0.22 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= @@ -22,7 +22,7 @@ <table summary="Header navigation table" width="100%" border="0" cellpadding="0" cellspacing="0"> <tr> - <th colspan="3" align="center">Privoxy 3.0.21 User Manual</th> + <th colspan="3" align="center">Privoxy 3.0.22 User Manual</th> </tr> <tr> diff --git a/doc/webserver/user-manual/whatsnew.html b/doc/webserver/user-manual/whatsnew.html index 4d385c78..af685472 100644 --- a/doc/webserver/user-manual/whatsnew.html +++ b/doc/webserver/user-manual/whatsnew.html @@ -6,7 +6,7 @@ <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.21 User Manual" href="index.html"> + <link rel="HOME" title="Privoxy 3.0.22 User Manual" href="index.html"> <link rel="PREVIOUS" title="Installation" href="installation.html"> <link rel="NEXT" title="Quickstart to Using Privoxy" href= "quickstart.html"> @@ -21,7 +21,7 @@ <table summary="Header navigation table" width="100%" border="0" cellpadding="0" cellspacing="0"> <tr> - <th colspan="3" align="center">Privoxy 3.0.21 User Manual</th> + <th colspan="3" align="center">Privoxy 3.0.22 User Manual</th> </tr> <tr>