[Pkg-mailman-hackers] Bug#597112: mailman: Mailman man page descriptions could be more useful

[Ken Johnson]

Package: mailman
Version: 1:2.1.11-11+lenny1
Severity: wishlist


Each man page has a short description with it, which is displayed after the
name of the man page.  These short descriptions are searched by the utility
apropos.

Currently, most of the man pages associated with mailman can be found by the
use of these two commands:

apropos "mailing list"
apropos "mailman"

However, the man pages add_members, check_db, and remove_members contain
neither "mailing list" nor "mailman" in their short description.

It would be ideal from my point of view if a single common phrase such as
"mailing list" or "mailman" appeared in all of the short descriptions. 
Failing that, please add one or the other to the short descriptions of
add_members, check_db, and remove_members.

Thank you.


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

Kernel: Linux 2.6.26-2-686 (SMP w/2 CPU cores)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/bash

Versions of packages mailman depends on:
ii  adduser                  3.110           add and remove users and groups
ii  apache2                  2.2.9-10+lenny8 Apache HTTP Server metapackage
ii  apache2-mpm-prefork [htt 2.2.9-10+lenny8 Apache HTTP Server - traditional n
ii  cron                     3.0pl1-105      management of regular background p
ii  debconf [debconf-2.0]    1.5.24          Debian configuration management sy
ii  exim4                    4.69-9          metapackage to ease Exim MTA (v4) 
ii  exim4-daemon-heavy [mail 4.69-9          Exim MTA (v4) daemon with extended
ii  libc6                    2.7-18lenny4    GNU C Library: Shared libraries
ii  logrotate                3.7.1-5         Log rotation utility
ii  lsb-base                 3.2-20          Linux Standard Base 3.2 init scrip
ii  pwgen                    2.06-1          Automatic Password generation
ii  python                   2.5.2-3         An interactive high-level object-o
ii  python-support           0.8.4lenny2     automated rebuilding support for P
ii  ucf                      3.0016          Update Configuration File: preserv

mailman recommends no packages.

Versions of packages mailman suggests:
pn  listadmin                 <none>         (no description available)
pn  lynx                      <none>         (no description available)
ii  spamassassin              3.2.5-2+lenny2 Perl-based spam filter using text 

-- debconf information:
  mailman/queue_files_present: abort installation
* mailman/default_server_language: en (English)
* mailman/gate_news: false
* mailman/site_languages: en (English)
* mailman/used_languages:
* mailman/create_site_list: