[Pkg-openldap-devel] Bug#320073: libldap2-dev: Many functions undocumented

[Steve Langasek]

On Sat, Feb 09, 2008 at 07:05:01PM -0800, Russ Allbery wrote:
> Steve Langasek <vorlon at debian.org> writes:
> > On Sat, Feb 09, 2008 at 06:34:48PM -0800, Russ Allbery wrote:

> >> This should be much better as of 2.4.7-5, and in particular both of the
> >> examples you listed (ldap_initialize and ldap_get_option) now have man
> >> pages.  If you notice other omissions, please feel free to open a bug
> >> citing specific missing man pages.

> > While ldap_initialize is /documented/ in a manpage, the manpage is only
> > installed as ldap_init(3), not ldap_initialize(3) - so not very
> > findable.  I think there's a fix still required here.

> ldap_initialize is a link to ldap_open, so man should cope, no?  I admit
> that I assumed without checking that the latest release fixed all the man
> page symlinks, since 2.4.7-5 didn't make the last archive pulse.

Aha - this is accounted for upstream, but the Debian package didn't have
these listed as manpages to install.

> > Ditto ldap_get_option; I can't even see any manpages in libldap2-dev
> > that look like obvious candidates for this.  Where did you find this
> > documented?

> Well, doc/man/man3/ldap_get_option.3.  Are we not installing it?

Nope, that one wasn't making it to the package either.

I've corrected these now in svn: using a single wildcard for man3/* is
a bit easier than listing the manpages one-by-one in
debian/libldap2-dev.manpages :)

-- 
Steve Langasek                   Give me a lever long enough and a Free OS
Debian Developer                   to set it on, and I can move the world.
Ubuntu Developer                                    http://www.debian.org/
slangasek at ubuntu.com                                     vorlon at debian.org