[Pkg-roundcube-maintainers] Bug#802804: roundcube: Apache configuration file installation should be documented

[Paul Boddie]

Package: roundcube
Version: 1.1.2+dfsg.1-4~bpo8+2
Severity: normal

Dear Maintainer,

Although the documentation for the roundcube packages mentions the apache.conf
file, it might be useful to suggest how this file might be used. For example,
I ended up making a symlink...

ln -s /etc/roundcube/apache.conf /etc/apache2/sites-available/roundcube.conf

Even though this is probably insufficient for some deployments, and even though
experienced administrators would be familiar with the necessary extra work, it
might be a good idea to mention such things explicitly. I did wonder whether
something special had been done to make Apache see the file where it was
installed, but that would be quite surprising and probably a policy violation.

I also wondered why one wouldn't just install a file into sites-available,
anyway. It is "available" and not "enabled", after all.

Thank you for your patience and understanding in reading this request!

Paul

-- System Information:
Debian Release: 8.2
  APT prefers stable
  APT policy: (500, 'stable')
Architecture: i386 (i686)

Kernel: Linux 3.2.62
Locale: LANG=en_GB.ISO-8859-15, LC_CTYPE=en_GB.ISO-8859-15 (charmap=ISO-8859-15)
Shell: /bin/sh linked to /bin/dash
Init: systemd (via /run/systemd/system)

Versions of packages roundcube depends on:
ii  roundcube-core  1.1.2+dfsg.1-4~bpo8+2

roundcube recommends no packages.

roundcube suggests no packages.

Versions of packages roundcube-core depends on:
ii  dbconfig-common        1.8.47+nmu3
ii  debconf [debconf-2.0]  1.5.56
ii  libapache2-mod-php5    5.6.13+dfsg-0+deb8u1
ii  libmagic1              1:5.22+15-2
ii  php-auth               1.6.4-1
ii  php-mail-mime          1.8.9-1
ii  php-mail-mimedecode    1.5.5-2
ii  php-net-ldap3          1.0.3-1~bpo8+1
ii  php-net-smtp           1.6.2-2
ii  php-net-socket         1.0.14-1
ii  php5                   5.6.13+dfsg-0+deb8u1
ii  php5-cli               5.6.13+dfsg-0+deb8u1
ii  php5-common            5.6.13+dfsg-0+deb8u1
ii  php5-intl              5.6.13+dfsg-0+deb8u1
ii  php5-json              1.3.6-1
ii  php5-mcrypt            5.6.13+dfsg-0+deb8u1
ii  roundcube-mysql        1.1.2+dfsg.1-4~bpo8+2
ii  ucf                    3.0030

Versions of packages roundcube-core recommends:
ii  apache2 [httpd-cgi]  2.4.10-10+deb8u3
ii  php-net-sieve        1.3.2-4
ii  php5-gd              5.6.13+dfsg-0+deb8u1
ii  php5-pspell          5.6.13+dfsg-0+deb8u1

Versions of packages roundcube-core suggests:
ii  php-auth-sasl      1.0.6-1
pn  php-crypt-gpg      <none>
pn  roundcube-plugins  <none>

-- debconf information:
  roundcube/db/basepath:
  roundcube/mysql/method: unix socket
  roundcube/language: en_GB
  roundcube/install-error: abort
  roundcube/remove-error: abort
* roundcube/database-type: pgsql
  roundcube/reconfigure-webserver: apache2, lighttpd
  roundcube/pgsql/authmethod-admin: ident
  roundcube/pgsql/method: unix socket
  roundcube/remote/port:
  roundcube/mysql/admin-user: postgres
  roundcube/pgsql/manualconf:
  roundcube/db/app-user: roundcube
  roundcube/hosts:
  roundcube/pgsql/authmethod-user: ident
  roundcube/db/dbname: roundcube
  roundcube/dbconfig-upgrade: true
  roundcube/pgsql/no-empty-passwords:
  roundcube/purge: false
  roundcube/internal/reconfiguring: false
  roundcube/restart-webserver: true
  roundcube/upgrade-backup: true
  roundcube/passwords-do-not-match:
* roundcube/dbconfig-install: true
  roundcube/remote/host:
  roundcube/remote/newhost:
  roundcube/missing-db-package-error: ignore
  roundcube/dbconfig-remove:
  roundcube/dbconfig-reinstall: false
  roundcube/pgsql/changeconf: false
  roundcube/internal/skip-preseed: false
  roundcube/upgrade-error: abort
  roundcube/pgsql/admin-user: postgres