Explain how to avoid internal errors when running apache in its default

configuration

2 files changed, 33 insertions, 8 deletions

diff --git a/debian/README.Debian b/debian/README.Debian
index 169fa54..b49be51 100644
--- a/debian/README.Debian
+++ b/debian/README.Debian
@@ -10,13 +10,36 @@ served up by a web CGI program, /usr/lib/cgi-bin/mailgraph.cgi. With any
 normal Debian web server install, this should be accessible as
 http://localhost/cgi-bin/mailgraph.cgi
 
+
 Note for Lighttpd users:
-Lighttpd doesn't take *.cgi? values, hence the graphs are not displayed 
-without extra configuration.
-An example of such configuration is available in
-/usr/share/doc/mailgraph/examples/lighttpd.conf
-It should be amended to suit your needs, and copied to eg.
-/etc/lighttpd/conf-available/50-mailgraph.conf
+
+  Lighttpd doesn't take *.cgi? values, hence the graphs are not displayed 
+  without extra configuration.
+  An example of such configuration is available in
+    /usr/share/doc/mailgraph/examples/lighttpd.conf
+
+  It should be amended to suit your needs, and copied to eg.
+   /etc/lighttpd/conf-available/50-mailgraph.conf
+
+
+Note for Apache users:
+
+  The default configuration of the Debian Apache packages is so that
+  everything in /usr/lib/cgi-bin will be handled as executable/CGI script.
+
+  This leads to internal errors, eg:
+    (13)Permission denied: exec of '/usr/lib/cgi-bin/mailgraph.css' failed
+    Premature end of script headers: mailgraph.css
+
+  To avoid this, you might want to add a handler to your configuration, eg:
+    AddHandler cgi-script .cgi
+
+  This means only files with a .cgi extension are handled as executable/CGI scripts.
+  You can obviously add other extensions required by your configuration.
+
+  The AddHandler requires mod_mime to be enabled. See the official Apache documentation
+  for more information: http://httpd.apache.org/docs/2.2/mod/mod_mime.html#addhandler
+ 
 
  -- Norbert Tretkowski <nobse@debian.org>  Thu, 25 Dec 2003 23:50:13 +0100
- -- Julien Valroff <julien@kirya.net>  Fri, 13 Aug 2010 08:50:13 +0200
+ -- Julien Valroff <julien@kirya.net>  Fri, 17 Aug 2010 22:18:13 +0200
diff --git a/debian/changelog b/debian/changelog
index f9a70bf..9370d3b 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,8 +1,10 @@
 mailgraph (1.14-4) unstable; urgency=low
 
   * Recommend apache2 instead of apache
+  * Explain in README.Debian how to avoid internal errors
+    when running Apache with the default configuration (Closes: #513527)
 
- -- Julien Valroff <julien@kirya.net>  Mon, 16 Aug 2010 10:30:13 +0200
+ -- Julien Valroff <julien@kirya.net>  Tue, 17 Aug 2010 22:25:55 +0200
 
 mailgraph (1.14-3) unstable; urgency=low