Add faq to troubleshooting re: blank page syndrome, ie {-prevent-compression}.

[privoxy.git] / doc / source / faq.sgml
diff --git a/doc/source/faq.sgml b/doc/source/faq.sgml

index c6eaf91..fdeb0a8 100644 (file)
--- a/doc/source/faq.sgml
+++ b/doc/source/faq.sgml
@@ -24,7 +24,7 @@
                  This file belongs into
                  ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/
                  
- $Id: faq.sgml,v 1.61.2.14 2002/08/07 02:53:43 hal9 Exp $
+ $Id: faq.sgml,v 1.61.2.15 2002/08/10 11:34:22 oes Exp $
  
   Copyright (C) 2001, 2002 Privoxy Developers <developers@privoxy.org>
   See LICENSE.
@@ -72,7 +72,7 @@
   </subscript>
  </pubdate>
  
-<pubdate>$Id: faq.sgml,v 1.61.2.14 2002/08/07 02:53:43 hal9 Exp $</pubdate>
+<pubdate>$Id: faq.sgml,v 1.61.2.15 2002/08/10 11:34:22 oes Exp $</pubdate>
  
  <!--
  
@@ -1637,6 +1637,31 @@ every time I start IE. What gives?</title>
  </sect2>
  
  
+<!--   ~~~~~       New section      ~~~~~     -->
+<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>.</title>
+ <para>
+  This is usually the result of a webserver that mishandles the request 
+  <application>Privoxy</application> sends to not compress the content.
+ </para>
+ <para>
+  In a default configuration, <application>Privoxy</application> requests all
+  data be sent <quote>uncompressed</quote>. This is required for the page 
+  filtering and other magic to work. In some rare cases, the browser and 
+  webserver miscommunicate and the result is a totally blank page. The 
+  suggested work around is to selectively turn off this feature for sites 
+  that exhibit such behavior. Example section for <filename>user.action</filename>:
+ </para>
+ <screen>
+   # Make exceptions for ill-behaved sites:                                     
+   #                                                                    
+   {-prevent-compression}                                               
+    .example.com</screen>
+</sect2>
+
+
  </sect1>
  <!--
  </sect1>
@@ -1729,6 +1754,9 @@ FIXME: Commented out until we have something to put here. HB 03/18/02.
   Temple Place - Suite 330, Boston, MA  02111-1307, USA.
  
  $Log: faq.sgml,v $
+Revision 1.61.2.15  2002/08/10 11:34:22  oes
+Add disclaimer about probably being out-of-date
+
  Revision 1.61.2.14  2002/08/07 02:53:43  hal9
  Fix some minor markup errors, and move one OSX Q/A to troubleshooting section.