freeing mem from ldap_parse_result

["Dale Moore" <Dale.Moore@cs.cmu.edu>]

I'm trying to write exceptionally correct
code with no memory leaks.

I'm calling ldap_parse_result(3). And
of course one of the parameters is
  char ***referalsp;

The documentation says to free the memory
allocated to this data structure by calling 
the routine ldap_value_free().
But the routine ldap_value_free() is deprecated.

My options are
  - Compile with -DLDAP_DEPRECATED
     = I hate to create software using deprecated API
  - Call ber_memvfree((void **)) instead of ldap_value_free()
  - Use a different mechanism to parse the message

The bug I'm reporting here is  
  - a problem with the documentation or 
  - in the premature deprecation of ldap_value_free or
  - the lack of deprecation of ldap_parse_ressult()
I'm not sure which.  Looking for advice.

Dale Moore