[php-maint] Bug#571795: [DOCUMENTATION PATCH] README.Debian.gz doesn't satisfactorily explain how to use apache2 + php5-cgi

[v.nix.is]

Package: php5-cgi
Version: 5.2.12.dfsg.1-2
Severity: minor


Now the README.Debian documentaion for php5-cgi says you should put
this in /etc/apache2/conf.d/:

<IfModule mod_actions.c>
    Action application/x-httpd-php /cgi-bin/php5
</IfModule>

However that will simply yield errors from apache about /cgi-bin/php5
being missing. Instead it should tell users to add something like this
instead:

<IfModule mod_actions.c>
    ScriptAlias /cgi-bin/php5-cgi /usr/lib/cgi-bin/php5
    Action php5-cgi /cgi-bin/php5-cgi
    AddHandler php5-cgi .php
</IfModule>

Or if they don't want .php support everywhere to add the `AddHandler
php5-cgi .php` bit to individual vhosts and not to /etc/apache2/conf.d/

-- System Information:
Debian Release: squeeze/sid
  APT prefers testing
  APT policy: (650, 'testing'), (500, 'unstable')
Architecture: amd64 (x86_64)

Kernel: Linux 2.6.32-x86_64-linode11 (SMP w/4 CPU cores)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash

Versions of packages php5-cgi depends on:
ii  libbz2-1.0             1.0.5-4           high-quality block-sorting file co
ii  libc6                  2.10.2-2          GNU C Library: Shared libraries
ii  libcomerr2             1.41.10-1         common error description library
ii  libdb4.8               4.8.26-1          Berkeley v4.8 Database Libraries [
ii  libgssapi-krb5-2       1.8+dfsg~alpha1-7 MIT Kerberos runtime libraries - k
ii  libk5crypto3           1.8+dfsg~alpha1-7 MIT Kerberos runtime libraries - C
ii  libkrb5-3              1.8+dfsg~alpha1-7 MIT Kerberos runtime libraries
ii  libmagic1              5.04-1            File type determination library us
ii  libpcre3               7.8-3             Perl 5 Compatible Regular Expressi
ii  libssl0.9.8            0.9.8k-8          SSL shared libraries
ii  libxml2                2.7.6.dfsg-2+b1   GNOME XML library
ii  mime-support           3.48-1            MIME files 'mime.types' & 'mailcap
ii  php5-common            5.2.12.dfsg.1-2   Common files for packages built fr
ii  tzdata                 2010b-1           time zone and daylight-saving time
ii  ucf                    3.0025            Update Configuration File: preserv
ii  zlib1g                 1:1.2.3.4.dfsg-3  compression library - runtime

php5-cgi recommends no packages.

Versions of packages php5-cgi suggests:
ii  php-pear                 5.2.12.dfsg.1-2 PEAR - PHP Extension and Applicati

-- no debconf information