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

[quanah@stanford.edu]

--On Monday, April 02, 2007 5:23 PM +0000 wweng@kencast.com wrote:

> Full_Name: Wei Weng
> Version: 2.3.19
> OS: Linux(Fedora 5)
> URL: ftp://ftp.openldap.org/incoming/
> Submission from: (NULL) (69.120.101.108)
>
>
> I don't know if the people who are in charge to build a RPM are paying
> attention to what they are doing or not.
>
> You can do a man ldap_init, and then look at /usr/include/ldap.h for the
> function definition.
>
> I am not a LDAP expert or anything close to that. But it seems to me that
> function called ldap_init has already been replaced by the function called
> ldap_initialize, and they take even different set of parameters.
>
> And yet the manpage not only didn't reflect that change, but enforce the
> wrong idea of using ldap_init function by having ldap_init in manpages.
>
> An extremely poor job done by the package maintainer.

Hi,

I suggest you complain to RedHat if you don't like the way they've packaged 
something.  The OpenLDAP foundation is not responsible for the way in which 
RedHat packages its releases.  In any case, if you are taking the time to 
read the header file, then pay close attention to the following:

#if LDAP_DEPRECATED
LDAP_F( LDAP * )
ldap_init LDAP_P(( /* deprecated, use ldap_create or ldap_initialize */
        LDAP_CONST char *host,
        int port ));


I.e., ldap_init is a deprecated function, and ldap_initialize should be 
used instead.  However, there are many programs out there that still use 
the old API, so the old functions are maintained for backwards 
compatibility purposes.  Hence the man page.

This ITS will be closed.

Regards,
Quanah



--
Quanah Gibson-Mount
Senior Systems Software Developer
ITS/Shared Application Services
Stanford University
GnuPG Public Key: http://www.stanford.edu/~quanah/pgp.html