[Date Prev][Date Next] [Chronological] [Thread] [Top]

Re: (ITS#4590) fix ldap_abandon{,ext} man page to match current reality



At 12:55 PM 6/13/2006, fenlason@redhat.com wrote:
>Full_Name: Jay Fenlason
>Version: CVS rev 1.17
>OS: Linux
>URL: http://people.redhat.com/fenlason/openldap-2.3.24-ldap_abandon-man.patch
>Submission from: (NULL) (66.187.230.200)
>
>
>I got fed up with the man pages not describing which functions are deprecated in
>2.3.24, so I fixed up the first one I came across, ldap_abandon(3).  If you like
>it, I can do the rest of the man pages.

Quite welcomed.


>I'm putting the patch up on my people.redhat.com page.  The URL is below

I've updated ldap_abandon_ext(3) to reflect how I think
we should handle documentation of non-deprecated and
deprecated interfaces.   For the latter, I prefer only
a brief statement saying X was deprecated in favor of
Y, along with a statement about the LDAP_DEPRECATED
macro.  That is, I see no need to continue providing
a detailed manual for deprecated routines.

Kurt