fix typo in FAQ.
[privoxy.git] / doc / source / faq.sgml
index 86f11e0..589d530 100644 (file)
@@ -8,7 +8,7 @@
 <!entity history SYSTEM "history.sgml">
 <!entity copyright SYSTEM "copyright.sgml">
 <!entity license SYSTEM "license.sgml">
-<!entity p-version "3.0.25">
+<!entity p-version "3.0.27">
 <!entity p-status "UNRELEASED">
 <!entity % p-not-stable "INCLUDE">
 <!entity % p-stable "IGNORE">
@@ -27,9 +27,9 @@
                 This file belongs into
                 ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/
 
- $Id: faq.sgml,v 2.118 2016/03/06 11:32:06 fabiankeil Exp $
+ $Id: faq.sgml,v 2.135 2017/03/27 10:22:27 fabiankeil Exp $
 
- Copyright (C) 2001-2014 Privoxy Developers http://www.privoxy.org/
+ Copyright (C) 2001-2014 Privoxy Developers https://www.privoxy.org/
  See LICENSE.
 
  Based partially on the Internet Junkbuster FAQ originally written by and
  <subscript>
 <!-- Completely the wrong markup, but very little is allowed  -->
 <!-- in this part of an article. FIXME -->
- <link linkend="copyright">Copyright</link> &my-copy; 2001-2014 by
- <ulink url="http://www.privoxy.org/">Privoxy Developers</ulink>
+ <link linkend="copyright">Copyright</link> &my-copy; 2001-2016 by
+ <ulink url="https://www.privoxy.org/">Privoxy Developers</ulink>
  </subscript>
 </pubdate>
 
-<pubdate>$Id: faq.sgml,v 2.118 2016/03/06 11:32:06 fabiankeil Exp $</pubdate>
+<pubdate>$Id: faq.sgml,v 2.135 2017/03/27 10:22:27 fabiankeil Exp $</pubdate>
 
 <!--
 
@@ -118,7 +118,7 @@ Hal.
 ]]>
  <para>
  This FAQ gives quick answers to frequently asked questions about
- <ulink url="http://www.privoxy.org/">Privoxy</ulink>.
+ <ulink url="https://www.privoxy.org/">Privoxy</ulink>.
  It is not a substitute for the
  <ulink url="../user-manual/index.html"><citetitle>Privoxy User Manual</citetitle></ulink>.
 <!--
@@ -135,14 +135,11 @@ Hal.
   Please note that this document is a work in progress. This copy represents
   the state at the release of version &p-version;.
   You can find the latest version of the document at <ulink
-  url="http://www.privoxy.org/faq/">http://www.privoxy.org/faq/</ulink>.
+  url="https://www.privoxy.org/faq/">https://www.privoxy.org/faq/</ulink>.
   Please see the <link linkend="contact">Contact section</link> if you want to
   contact the developers.
  </para>
 
-<!--   <para> -->
-<!--    Feel free to send a note to the developers at <email>ijbswa-developers@lists.sourceforge.net</email>. -->
-<!--   </para> -->
 </abstract>
 </artheader>
 
@@ -478,8 +475,8 @@ warranty? Registration?</title>
  </para>
  <para>
   So first thing, subscribe to the <ulink
-   url="https://lists.sourceforge.net/lists/listinfo/ijbswa-users">Privoxy Users</ulink>
-  or the <ulink url="https://lists.sourceforge.net/lists/listinfo/ijbswa-developers">Privoxy
+   url="https://lists.privoxy.org/mailman/listinfo/privoxy-users">Privoxy Users</ulink>
+  or the <ulink url="https://lists.privoxy.org/mailman/listinfo/privoxy-devel">Privoxy
   Developers</ulink> mailing list, join the discussion, help out other users, provide general
   feedback or report problems you noticed.
  </para>
@@ -503,7 +500,7 @@ warranty? Registration?</title>
 <sect3 renderas="sect4" id="donate"><title>Would you like to donate?</title>
 <para>
  Donations are welcome. Our
- <ulink url="http://ijbswa.cvs.sourceforge.net/viewvc/ijbswa/current/TODO">TODO list</ulink>
+ <ulink url="http://ijbswa.cvs.sourceforge.net/viewvc/ijbswa/current/TODO?view=markup">TODO list</ulink>
  is rather long and being able to pay one (or more) developers to work on Privoxy
  would make a huge difference, even if it was only for a couple of weeks. Donations may
  also be used for Privoxy-related travel expenses (for example to attend conferences),
@@ -512,11 +509,13 @@ warranty? Registration?</title>
 
 <para>
  <application>Privoxy</application> is an associated
- project of <ulink url="http://www.spi-inc.org/">Software
+ project of <ulink url="https://www.spi-inc.org/">Software
  in the Public Interest (SPI)</ulink>, which allows us to receive
- tax-deductible donations in the United States. If you want to donate through
- SPI, please use <ulink url="http://www.spi-inc.org/donations">SPI's donation page</ulink>
- to see what the options are.
+ tax-deductible donations in the United States.
+ You can <ulink url="https://www.spi-inc.org/projects/privoxy/">donate via Paypal</ulink>
+ and <ulink url="https://co.clickandpledge.com/advanced/default.aspx?wid=34115">Click & Pledge</ulink>.
+ For details, please have a look at
+ <ulink url="https://www.spi-inc.org/donations">SPI's general donation page</ulink>.
 </para>
 
 <para>
@@ -549,7 +548,59 @@ warranty? Registration?</title>
  public user mailing list or, if it's a private matter, to
  <ulink url="mailto:fk@fabiankeil.de">Fabian Keil</ulink> (Privoxy's SPI liaison)
  directly.
+</para>
 </sect3>
+</sect2>
+<sect2 id="sponsor"><title>How can I become a sponsor and get my logo or link on privoxy.org?</title>
+<para>
+ We are currently offering the following sponsor levels as an experiment:
+</para>
+<variablelist>
+ <varlistentry>
+  <term>Gold (10000 EUR/year)</term>
+  <listitem>
+   <para>
+    Logo shown at the bottom of the
+    <ulink url="https://www.privoxy.org/">Privoxy homepage</ulink>.
+    Logo, link and self description on the
+    <ulink url="https://www.privoxy.org/sponsors/">sponsor page</ulink>.
+   </para>
+  </listitem>
+ </varlistentry>
+ <varlistentry>
+  <term>Silver (1000 EUR/year)</term>
+  <listitem>
+   <para>
+    Logo shown randomly at the bottom of the
+    <ulink url="https://www.privoxy.org/">Privoxy homepage</ulink>.
+    Logo, link and self description on the
+    <ulink url="https://www.privoxy.org/sponsors/">sponsor page</ulink>.
+   </para>
+  </listitem>
+ </varlistentry>
+ <varlistentry>
+  <term>Bronze (500 EUR/year)</term>
+  <listitem>
+   <para>
+    Logo and link on the <ulink url="https://www.privoxy.org/sponsors/">sponsor page</ulink>.
+   </para>
+  </listitem>
+ </varlistentry>
+</variablelist>
+<para>
+ The logo sizes depend on the sponsor level. Logos are served from
+ our server, no requests are made to the sponsor website unless
+ the links are being used.
+</para>
+<para>
+ The details may change over time but changes will only affect new sponsors
+ (or existing sponsors that explicitly agreed to the changes).
+</para>
+<para>
+ If you want to become a sponsor, please contact
+ <ulink url="mailto:fk@fabiankeil.de">Fabian Keil</ulink>.
+ New sponsors are only accepted if no developer objects.
+</para>
 
 </sect2>
 
@@ -701,9 +752,9 @@ All the ads are there. What's wrong?</title>
  <application>Privoxy</application> is not running at all. Check the <ulink
  url="../user-manual/config.html#LOGFILE">log file</ulink>. For instructions
  on starting <application>Privoxy</application> and browser configuration,
- see the <ulink url="http://www.privoxy.org/user-manual/startup.html">chapter
+ see the <ulink url="https://www.privoxy.org/user-manual/startup.html">chapter
  on starting <application>Privoxy</application></ulink> in the
- <ulink url="http://www.privoxy.org/user-manual/">User Manual</ulink>.
+ <ulink url="https://www.privoxy.org/user-manual/">User Manual</ulink>.
 </para>
 
 </sect2>
@@ -716,9 +767,9 @@ Privoxy is running and being used.</title>
  First, make sure that Privoxy is <emphasis>really</emphasis> running and
  being used by visiting <ulink url="http://p.p/">http://p.p/</ulink>. You
  should see the <application>Privoxy</application> main page. If not, see
- the <ulink url="http://www.privoxy.org/user-manual/startup.html">chapter
+ the <ulink url="https://www.privoxy.org/user-manual/startup.html">chapter
  on starting <application>Privoxy</application></ulink> in the
- <ulink url="http://www.privoxy.org/user-manual/">User Manual</ulink>.
+ <ulink url="https://www.privoxy.org/user-manual/">User Manual</ulink>.
 </para>
 
 <para>
@@ -830,15 +881,15 @@ the differences?</title>
   Based on your feedback and the continuing development, updates of
   <filename>default.action</filename> will be
   made available from time to time on the <ulink
-  url="http://sourceforge.net/project/showfiles.php?group_id=11118">files section</ulink> of
-  our <ulink url="http://sf.net/projects/ijbswa/">project page</ulink>.
+  url="https://sourceforge.net/project/showfiles.php?group_id=11118">files section</ulink> of
+  our <ulink url="https://sourceforge.net/projects/ijbswa/">project page</ulink>.
  </para>
 
  <para>
   If you wish to receive an email notification whenever we release updates of
   <application>Privoxy</application> or the actions file, <ulink
-  url="http://lists.sourceforge.net/lists/listinfo/ijbswa-announce/">subscribe
-  to our announce mailing list</ulink>, ijbswa-announce@lists.sourceforge.net.
+  url="https://lists.privoxy.org/mailman/listinfo/privoxy-announce">subscribe
+  to our announce mailing list</ulink>, privoxy-announce@lists.privoxy.org.
  </para>
 
 </sect2>
@@ -1036,7 +1087,7 @@ with a browser? Does that not raise security issues?</title>
 <para>
  If you intend to develop your own filters, you might want to have a look at
  <ulink
- url="http://www.fabiankeil.de/sourcecode/pft/">Privoxy-Filter-Test</ulink>.
+ url="https://www.fabiankeil.de/sourcecode/pft/">Privoxy-Filter-Test</ulink>.
 </para>
 
 </sect2>
@@ -1179,7 +1230,7 @@ on Win2K/NT/XP?</title>
 <para>
  Earlier ]]>3.x versions could run as a system service using <command>srvany.exe</command>.
  See the discussion at <ulink
- url="http://sourceforge.net/tracker/?func=detail&#38;atid=361118&#38;aid=485617&#38;group_id=11118">http://sourceforge.net/tracker/?func=detail&#38;atid=361118&#38;aid=485617&#38;group_id=11118</ulink>,
+ url="https://sourceforge.net/tracker/?func=detail&#38;atid=361118&#38;aid=485617&#38;group_id=11118">https://sourceforge.net/tracker/?func=detail&#38;atid=361118&#38;aid=485617&#38;group_id=11118</ulink>,
  for details, and a sample configuration.
 </para>
 </sect2>
@@ -1285,7 +1336,7 @@ and thus avoid individual browser configuration?</title>
 <para>
  For a good discussion of some of the issues involved (including privacy and
  security issues), see
- <ulink url="http://sourceforge.net/tracker/?func=detail&#38;atid=211118&#38;aid=629518&#38;group_id=11118">http://sourceforge.net/tracker/?func=detail&#38;atid=211118&#38;aid=629518&#38;group_id=11118</ulink>.
+ <ulink url="https://sourceforge.net/tracker/?func=detail&#38;atid=211118&#38;aid=629518&#38;group_id=11118">https://sourceforge.net/tracker/?func=detail&#38;atid=211118&#38;aid=629518&#38;group_id=11118</ulink>.
 </para>
 </sect2>
 
@@ -2003,6 +2054,20 @@ ads used to be. Why?</title>
 
 </sect2>
 
+<sect2 renderas="sect3" id="http2">
+<title>Does Privoxy support HTTP/2?</title>
+<para>
+  Privoxy currently doesn't parse HTTP/2 but applications
+  can tunnel HTTP/2 through Privoxy if Privoxy is configured
+  to allow CONNECT requests (default) which are also used
+  for HTTPS.
+</para>
+<para>
+  Adding HTTP/2 support is on the TODO list but currently
+  nobody is known to work on it.
+</para>
+</sect2>
+
 <sect2 renderas="sect3" id="secure">
 <title>Privoxy runs as a <quote>server</quote>. How
 secure is it? Do I need to take any special precautions?</title>
@@ -2075,7 +2140,7 @@ out of the picture?</title>
 <title>My logs show Privoxy <quote>crunches</quote>
 ads, but also its own internal CGI pages. What is a <quote>crunch</quote>?</title>
 <para>
- A <quote>crunch</quote> simply means <application>Privoxy</application> intercepted
+ A <quote>crunch</quote> means <application>Privoxy</application> intercepted
  <emphasis>something</emphasis>, nothing more. Often this is indeed ads or
  banners, but <application>Privoxy</application> uses the same mechanism for
  trapping requests for its own internal pages. For instance, a request for
@@ -2246,7 +2311,7 @@ and related issues?</title>
 <para>
  Lately there have been reports of problems with some kind of
  "parental control" software based on Privoxy that came preinstalled on
- certain <ulink url="http://sourceforge.net/p/ijbswa/bugs/813/">ASUS Netbooks</ulink>.
+ certain <ulink url="https://sourceforge.net/p/ijbswa/bugs/813/">ASUS Netbooks</ulink>.
  The problems described are inconsistent with the behaviour of official
  Privoxy versions, which suggests that the preinstalled software may
  contain vendor modifications that we don't know about and thus can't debug.
@@ -2618,37 +2683,6 @@ every time I start IE. What gives?</title>
  </para>
 </sect2>
 
-<!--   ~~~~~       New section      ~~~~~     -->
-<!-- XXX: Is this still relevant now that we have gzip support? -->
-<sect2 renderas="sect3" id="blankpage">
-<title>I get a completely blank page at one site. <quote>View Source</quote>
- shows only: <markup><![CDATA[<html><body></body></html>]]></markup>. Without
- Privoxy the page loads fine.</title>
- <para>
-  Chances are that the site suffers from a bug in
-  <ulink url="http://www.php.net/"><application>PHP</application></ulink>,
-  which results in empty pages being sent if the client explicitly requests
-  an uncompressed page, like <application>Privoxy</application> does.
-  This bug has been fixed in PHP 4.2.3.
- </para>
- <para>
-  To find out if this is in fact the source of the problem, try adding
-  the site to a <literal>-prevent-compression</literal> section in
-  <filename>user.action</filename>:
- </para>
- <screen>
-   # Make exceptions for ill-behaved sites:
-   #
-   {-prevent-compression}
-    .example.com</screen>
- <para>
-  If that works, you may also want to report the problem to the
-  site's webmasters, telling them to use zlib.output_compression
-  instead of ob_gzhandler in their PHP applications (workaround)
-  or upgrade to PHP 4.2.3 or later (fix).
- </para>
-</sect2>
-
 <sect2 renderas="sect3" id="nohostname">
 <title>My logs show many <quote>Unable to get my own hostname</quote> lines.
 Why?</title>
@@ -2714,7 +2748,7 @@ Why?</title>
 <para>
  Upgrading <application>Privoxy</application>, or going to the most recent
  <filename>default.action</filename> file available from <ulink
- url="http://sourceforge.net/project/showfiles.php?group_id=11118">SourceForge</ulink>
+ url="https://sourceforge.net/project/showfiles.php?group_id=11118">SourceForge</ulink>
  might be worth a try, too.
 </para>
 </sect2>
@@ -2989,6 +3023,27 @@ browsing has slowed to a crawl. What gives? </title>
 </para>
 </sect2>
 
+<sect2 renderas="sect3" id="pcre-stack-limit">
+<title>After adding my custom filters, &my-app; crashes when visitting certain websites</title>
+<para>
+ This can happen if your custom filters require more memory than &my-app;
+ is allowed to use.
+ Usually the problem is that the operating system enforces a stack size limit
+ that isn't sufficient.
+</para>
+<para>
+ Unless the problem occurs with the filters available in the default configuration,
+ this is not considered a Privoxy bug.
+</para>
+<para>
+ To prevent the crashes you can rewrite your filter to use less ressources,
+ increase the relevant memory limit or recompile pcre to use less stack space.
+ For details please see the
+ <ulink url="http://pcre.org/original/doc/html/pcrestack.html">pcrestack man page</ulink>
+ and the documentation of your operating system.
+</para>
+</sect2>
+
 </sect1>
 
   <!--   ~~~~~       New section      ~~~~~     -->