LDAP_DEPRECATED

["Kurt D. Zeilenga" <Kurt@OpenLDAP.org>]

I'd also like to move the deprecated API routines behind
a macro LDAP_DEPRECATED.  For an application to use a
LDAP_DEPRECATED routine, it would have to be compiled with
-DLDAP_DEPRECATED.  This hopefully will result in
users/packagers of this application to notify the
application developer should update to their code.
And application developers which distribute there
code with LDAP_DEPRECATED defined somehow do so at
there own peril.

We should try to first mark deprecated routines with
comments (in headers or other documentation), then
in some subsequently (second warning) put them behind
LDAP_DEPRECATED, and then later delete them in HEAD
(third warning), then release.  (with some reasonable
time/releases between each of these steps)

Kurt