[Pkg-mailman-hackers] Bug#964116: mailman3-web: mailman-web.py config file falsely says you can enable Django admin documentation

[AJ Jordan]

Package: mailman3-web
Version: 0+20180916-8
Severity: normal

/etc/mailman/mailman-web.py contains the following snippet in
INSTALLED_APPS:

    # Uncomment the next line to enable admin documentation:
    #'django.contrib.admindocs',

but the comment is inaccurate. Uncommenting it does not produce a
documentation link in the upper-right hand corner of the Django admin
interface.

Installing the `python3-docutils` Debian package does not help.

See https://docs.djangoproject.com/en/3.0/ref/contrib/admin/admindocs/
for requirements for this mechanism.

-- System Information:
Debian Release: 10.4
  APT prefers stable-updates
  APT policy: (500, 'stable-updates'), (500, 'stable')
Architecture: amd64 (x86_64)

Kernel: Linux 4.19.0-9-amd64 (SMP w/2 CPU cores)
Kernel taint flags: TAINT_PROPRIETARY_MODULE, TAINT_OOT_MODULE, TAINT_UNSIGNED_MODULE
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8), LANGUAGE=en_US.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
Init: systemd (via /run/systemd/system)
LSM: AppArmor: enabled

Versions of packages mailman3-web depends on:
ii  dbconfig-mysql             2.0.11+deb10u1
ii  debconf [debconf-2.0]      1.5.71
ii  lsb-base                   10.2019051400
ii  node-less                  1.6.3~dfsg-3
ii  python3                    3.7.3-1
ii  python3-django-hyperkitty  1.2.2-1
ii  python3-django-postorius   1.2.4-1
ii  python3-mysqldb            1.3.10-2
ii  python3-psycopg2           2.7.7-1
ii  python3-whoosh             2.7.4+git6-g9134ad92-4
ii  sassc                      3.5.0-1
ii  ucf                        3.0038+nmu1
ii  uwsgi                      2.0.18-1
ii  uwsgi-plugin-python3       2.0.18-1

Versions of packages mailman3-web recommends:
ii  libapache2-mod-proxy-uwsgi  2.4.38-3+deb10u3

Versions of packages mailman3-web suggests:
ii  mariadb-server-10.3 [virtual-mysql-server]  1:10.3.22-0+deb10u1
ii  postgresql                                  11+200+deb10u3

-- Configuration Files:
/etc/mailman3/uwsgi.ini changed [not included]

-- debconf information:
  mailman3-web/pgsql/authmethod-user: password
  mailman3-web/upgrade-error: abort
  mailman3-web/remove-error: abort
  mailman3-web/pgsql/authmethod-admin: ident
  mailman3-web/dbconfig-remove: true
  mailman3-web/remote/host: localhost
* mailman3-web/emailname: lists.strugee.net
  mailman3-web/pgsql/method: TCP/IP
  mailman3-web/remote/port: 3306
  mailman3-web/passwords-do-not-match:
  mailman3-web/remote/newhost:
  mailman3-web/pgsql/manualconf:
  mailman3-web/missing-db-package-error: abort
* mailman3-web/dbconfig-reinstall: false
  mailman3-web/db/app-user: mailman3web at localhost
* mailman3-web/mysql/admin-user: debian-sys-maint
* mailman3-web/superuser-mail: alex at strugee.net
  mailman3-web/db/dbname: mailman3web
  mailman3-web/db/basepath: /var/lib/mailman3/web
* mailman3-web/dbconfig-install: true
* mailman3-web/restart-webserver: false
  mailman3-web/mysql/method: Unix socket
  mailman3-web/internal/skip-preseed: false
  mailman3-web/pgsql/admin-user: postgres
  mailman3-web/pgsql/changeconf: false
* mailman3-web/database-type: mysql
  mailman3-web/purge: false
  mailman3-web/dbconfig-upgrade: true
* mailman3-web/superuser-name: alex
* mailman3-web/configure-webserver: apache2
  mailman3-web/nginx-choice:
  mailman3-web/internal/reconfiguring: false
  mailman3-web/pgsql/no-empty-passwords:
  mailman3-web/upgrade-backup: true
  mailman3-web/install-error: abort