Re: (ITS#4902) ManPage in 2.3.19 RPM is completely screwed up

[ando@sys-net.it]

Please keep replies on the ITS: the "T" stands for "tracking".

Wei Weng wrote:
> I just installed 2.3.34 version that was found to be the latest
> "Release" from openLDAP. Not only there isn't any mention of
> LDAP_DEPRECATED,

in OpenLDAP 2.3 source tree:

bash-3.00$ grep LDAP_DEPRECATED -rI include/
include/ldap.h:#if LDAP_DEPRECATED
include/ldap.h:#if LDAP_DEPRECATED
include/ldap.h:#if LDAP_DEPRECATED
include/ldap.h:#if LDAP_DEPRECATED
include/ldap.h:#if LDAP_DEPRECATED
include/ldap.h:#if LDAP_DEPRECATED
include/ldap.h:#if LDAP_DEPRECATED
include/ldap.h:#if LDAP_DEPRECATED
include/ldap.h:#if LDAP_DEPRECATED
include/ldap.h:#if LDAP_DEPRECATED
include/ldap.h:#if LDAP_DEPRECATED
include/ldap.h:#if LDAP_DEPRECATED
include/ldap.h:#if LDAP_DEPRECATED

> but there isn't manpage for the new ldap_initialize
> function either.

You're right, it's only been released starting with 2.4.

> I am just very surprised that a quite mature openLDAP open source
> projects can be this careless about the documentation.

I already explained the reason in my previous posting.  It's not lack of
care, it's optimization of resources.  The code works fine also without
documentation, which eventually will converge (and it __is__ converging,
in OpenLDAP 2.4).

> There is (only
> place) mention of ldap_initialize function in ldap.3: "A session handle
> is created using ldap_initialize(3)". Naturally you want to do a man
> ldap_initialize but there is nothing.

ITS#3947 addresses this issue.

> I was reporting this bug so that the "newbies" (new to openLDAP APIs)
> won't be stuck like I was for a few hours.

Then you probably should have entitled your posting "some C API man
pages seem to be missing from OpenLDAP 2.3 code", or even better "this
is a duplicate of ITS#2240".

> Isn't the "Documentation"
> supposed to help you to understand the APIs?

This is not a bug.  This is missing documentation, which is different.
It is a known issue (ITS#2240), so your post is only adding noise.  A
non-noisy posting would have been accompanied by a patch fixing the
issue, which is however already fixed in re24 (that's why ITS#2240 is
now closed).

> By the way, if you guys ask me to supply patch for the ldap_initialize,
> sorry, I was just maintaining the old code to try to compile it on a
> Fedora 5 box. The details about ldap APIs is above my ability.
> 
> PS: ldap_initialize is just an example, there are also a bunch of other
> functions that seemed to have been deprecated.

Please check OpenLDAP 2.4.

p.



Ing. Pierangelo Masarati
OpenLDAP Core Team

SysNet s.n.c.
Via Dossi, 8 - 27100 Pavia - ITALIA
http://www.sys-net.it
------------------------------------------
Office:   +39.02.23998309
Mobile:   +39.333.4963172
Email:    pierangelo.masarati@sys-net.it
------------------------------------------