Bump sgml entities for 3.0.25 beta
[privoxy.git] / doc / source / faq.sgml
index 49dc82c..8a1aefb 100644 (file)
@@ -9,7 +9,7 @@
 <!entity copyright SYSTEM "copyright.sgml">
 <!entity license SYSTEM "license.sgml">
 <!entity p-version "3.0.25">
-<!entity p-status "UNRELEASED">
+<!entity p-status "beta">
 <!entity % p-not-stable "INCLUDE">
 <!entity % p-stable "IGNORE">
 <!entity % p-text "IGNORE">        <!-- define we are not a text only doc -->
@@ -27,9 +27,9 @@
                 This file belongs into
                 ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/
 
- $Id: faq.sgml,v 2.119 2016/03/17 10:18:57 fabiankeil Exp $
+ $Id: faq.sgml,v 2.124 2016/05/22 12:42:29 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
 <!-- 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>
+ <ulink url="https://www.privoxy.org/">Privoxy Developers</ulink>
  </subscript>
 </pubdate>
 
-<pubdate>$Id: faq.sgml,v 2.119 2016/03/17 10:18:57 fabiankeil Exp $</pubdate>
+<pubdate>$Id: faq.sgml,v 2.124 2016/05/22 12:42:29 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>
@@ -701,9 +698,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 +713,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>
@@ -837,8 +834,8 @@ the differences?</title>
  <para>
   If you wish to receive an email notification whenever we release updates of
   <application>Privoxy</application> or the actions file, <ulink
-  url="https://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 +1033,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>
@@ -2618,37 +2615,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>
@@ -2989,6 +2955,26 @@ 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>
+
 </sect1>
 
   <!--   ~~~~~       New section      ~~~~~     -->