[Pkg-openldap-devel] Bug#794998: Bug#794998: openldap: no manual page for smbk5pwd module

[Ryan Tandy]

Hi,

On Sun, Aug 09, 2015 at 09:56:03AM +0200, Peter Marschall wrote:
>++.\" Copyright 2015 The OpenLDAP Foundation All Rights Reserved.

I assume this is intentional, and is because the content is adapted from 
the existing README?

>++.SH SEE ALSO
>++.BR slapd.conf (5),
>++.BR ldappasswd (1),
>++.BR ldap (3),

Looks like a trailing comma?

>diff --git a/debian/slapd-smbk5pwd.manpages b/debian/slapd-smbk5pwd.manpages
>new file mode 100644
>index 0000000..9640f35
>--- /dev/null
>+++ b/debian/slapd-smbk5pwd.manpages
>@@ -0,0 +1 @@
>+debian/tmp/usr/share/man/man5/slapo-smbk5pwd.5
>diff --git a/debian/slapd.manpages b/debian/slapd.manpages
>index 5969ae9..72cc5c9 100644
>--- a/debian/slapd.manpages
>+++ b/debian/slapd.manpages
>@@ -1,2 +1,25 @@
>-debian/tmp/usr/share/man/man5/slap*.5
>+debian/tmp/usr/share/man/man5/slapd*.5
>+debian/tmp/usr/share/man/man5/slapo-accesslog.5
>+debian/tmp/usr/share/man/man5/slapo-auditlog.5
>+debian/tmp/usr/share/man/man5/slapo-chain.5
>+debian/tmp/usr/share/man/man5/slapo-collect.5
>+debian/tmp/usr/share/man/man5/slapo-constraint.5
>+debian/tmp/usr/share/man/man5/slapo-dds.5
>+debian/tmp/usr/share/man/man5/slapo-dyngroup.5
>+debian/tmp/usr/share/man/man5/slapo-dynlist.5
>+debian/tmp/usr/share/man/man5/slapo-lastbind.5
>+debian/tmp/usr/share/man/man5/slapo-memberof.5
>+debian/tmp/usr/share/man/man5/slapo-pbind.5
>+debian/tmp/usr/share/man/man5/slapo-pcache.5
>+debian/tmp/usr/share/man/man5/slapo-ppolicy.5
>+debian/tmp/usr/share/man/man5/slapo-refint.5
>+debian/tmp/usr/share/man/man5/slapo-retcode.5
>+debian/tmp/usr/share/man/man5/slapo-rwm.5
>+#debian/tmp/usr/share/man/man5/slapo-smbk5pwd.5
>+debian/tmp/usr/share/man/man5/slapo-sock.5
>+debian/tmp/usr/share/man/man5/slapo-sssvlv.5
>+debian/tmp/usr/share/man/man5/slapo-syncprov.5
>+debian/tmp/usr/share/man/man5/slapo-translucent.5
>+debian/tmp/usr/share/man/man5/slapo-unique.5
>+debian/tmp/usr/share/man/man5/slapo-valsort.5
> debian/tmp/usr/share/man/man8/slap*.8

Thinking out loud... I'd be happier if newly added man pages could be 
installed automatically, or at least if we could be notified about 
needing to update the file.

I tried to use dh_install --fail-missing, but it looks like it doesn't 
(yet) cooperate with dh_installman and others, so files are spuriously 
reported missing (#436240#c15). The solution used for the module itself, 
letting it be installed into slapd and then rm'ing it, is a bit of a 
hack, but does achieve that. On the other hand, the only new slapo-* man 
pages we're likely to get in 2.4 are contrib ones, so maybe this is 
fine.

Any thoughts on that?

thanks,
Ryan