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 ------------------------------------------