Bug#436148: zope-common: man dzhandle doesn't explain defaults

[Ross Boylan]

Package: zope-common
Version: 0.5.37
Severity: minor

The man page for dzhandle(1) lists many options under make-instance,
but mostly does not say what the default behavior is if the option is
omitted (or perhaps some arguments are mandatory?).   It would be
helpful if it did.

It also might be useful to explain how the restart option interacts
with the init.d scripts, though
/usr/share/doc/zope-common//README.Debian.gz does discuss that ("An
instance, which should be restarted on system start, has to be
mentioned in /etc/default/zope<version>.").  The sentence in the
README seems a bit misleading though, since the default (at least for
2.9) is "all", which I assume means instances will restart without
being explicitly mentioned.

Is dzhandle in section 1 because users can run it to install instances
in their home directory?  I would have expected to find it in section
8.

-- System Information:
Debian Release: lenny/sid
  APT prefers testing
  APT policy: (990, 'testing'), (990, 'stable'), (50, 'unstable')
Architecture: i386 (i686)

Kernel: Linux 2.6.18-4-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 zope-common depends on:
ii  adduser                       3.104      add and remove users and groups
ii  debconf [debconf-2.0]         1.5.14     Debian configuration management sy
ii  python2.4                     2.4.4-5    An interactive high-level object-o

zope-common recommends no packages.

-- debconf information excluded