Add LDAP_DEBUG_DEPRECIATED to enable warnings when 'depreciated'

interfaces are used.  Added comments to ldap_cdefs.h

include/ldap_cdefs.h

@@ -7,8 +7,8 @@
 #	define LDAP_BEGIN_DECL	extern "C" {
 #	define LDAP_END_DECL	}
 #else
-#	define LDAP_BEGIN_DECL	/* empty */
-#	define LDAP_END_DECL	/* empty */
+#	define LDAP_BEGIN_DECL	/* begin declarations */
+#	define LDAP_END_DECL	/* end declarations */
 #endif
 
 #if !defined(__NO_PROTOTYPES) && ( \

include/ldap_log.h

@@ -30,6 +30,7 @@ LDAP_BEGIN_DECL
 #define LDAP_DEBUG_SHELL	0x0400
 #define LDAP_DEBUG_PARSE	0x0800
 
+#define LDAP_DEBUG_DEPRECIATED	0x1000
 #define LDAP_DEBUG_NONE		0x8000
 #define LDAP_DEBUG_ANY		-1