[Pkg-openldap-devel] Bug#594711: Bug#594711: Can we close this bug?

[Ryan Tandy]

On 07/06/14 08:21 PM, Soren Stoutner wrote:
> This is a fairly old bug that appears to have been resolved.  Any
> reason we shouldn't close it?

It's still possible for the same problem to be introduced again; in fact 
Ubuntu did so for few days recently. So rather than just close the bug, 
let's try to fix it by adding the requested documentation. What do you 
think of this:

Database format upgrades

   When upgrading slapd to a new version where the database library's
   storage format has changed, the database has to be backed up using
   slapcat(8) before upgrading and restored using slapadd(8) afterwards.
   Normally the maintainer scripts will handle this automatically,
   performing the dump and restore as needed.

   If, after upgrading, slapd fails to start and you see the message
   "Program version doesn't match environment version" in syslog, then
   the DB version may have changed without a dump and reload. This should
   be reported as a bug in the slapd package. In this case you will have
   to downgrade slapd to the previous version as the new tools are unable
   to dump the old database, and the same error would prevent you from
   upgrading to the fixed version. Old package versions can be
   found at http://snapshot.debian.org if needed.

pkg-openldap-devel readers, any feedback on the above text? The 
second-to-last sentence is intended to specifically address this bug.

thanks,
Ryan