[wp-hackers] Proposal for a function commenting convention

[Peter Westwood]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Marcos Sader | marcosmedia wrote:
> I still think that there should be a "WP" indicator in case of functions
> shared between the regular and multiuser version.
> 
> So WP will get,
> /**
> * @since WP 1.5
> * @deprecated WP 2.1
> */
> 
> and WPmu,
> /**
> * @since WPmu 1.5
> * @deprecated WPmu 2.1
> */

If you want PHPDoc over in wpmu land then you need to convince the
people there that it is worth adding and the the @since and @depreceated
tags can be correctly maintained there.

WP != WPmu and we don't need WPmu docs in our code.

westi
- --
Peter Westwood
http://blog.ftwr.co.uk
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.2 (MingW32)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iD8DBQFHFR30VPRdzag0AcURAtjtAKDRyKv8ZxLeI35Dwfvn+Ktz+IAKJwCg0bzk
g2JdEhmxaOG2a5SsLpvGhGE=
=3hi9
-----END PGP SIGNATURE-----