[wp-hackers] Proposal for a function commenting convention

Ryan Boren ryan at boren.nu
Mon Oct 15 22:59:09 GMT 2007


On 10/15/07, Robin Adrianse <robin.adr at gmail.com> wrote:
> +1.
>
> On 10/15/07, Otto <otto at ottodestruct.com> wrote:
> >
> > On 10/14/07, Jacob <wordpress at santosj.name> wrote:
> > > /**
> > >  * @since 1.5
> > >  * @deprecated since 2.1
> > >  */
> >
> > I suggest using the same scheme for version numbers on both of these.
> > In other words, do this instead:
> > /**
> > * @since 1.5
> > * @deprecated 2.1
> > */

+1 here too.

Also, we have some old phpdoc patches around if anyone wants to update them.

http://trac.wordpress.org/query?status=new&status=assigned&status=reopened&status=closed&keywords=%7Ephpdoc&order=priority


More information about the wp-hackers mailing list