[wp-hackers] Proposal for a function commenting convention

[Jacob]

Matt wrote:
> On 10/14/07, Jacob <wordpress at santosj.name> wrote:
>   
>> 2. Deprecated functions, globals can be handled with @deprecated tag.
>>
>>     
>
> @deprecated has the version it was deprecated in, right?
>
>   
I'm kind of waiting until I get more feedback before I make a trac 
ticket and start doing any more documentation.

The second try [1] has @deprecated since 2.1 for one global. It isn't 
required, but it should be used to allow others to know when the global 
or function stopped being used.

/**
 * @since 1.5
 * @deprecated since 2.1
 */

[1] http://www.santosj.name/wp-settings.phpdoc.2.diff

Jacob Santos