[PEPr] Comment on RFC::Amendment of Docblock Comment Standards
| From: | Joe Stump | Date: | Wed, 12 Nov 2008 21:24:51 +0000 |
| Subject: | [PEPr] Comment on RFC::Amendment of Docblock Comment Standards | ||
| References: | 1 | Groups: | php.pear.dev |
| Request: | Send a blank email to pear-dev+get-51068@lists.php.net to get a copy of this message | ||
Joe Stump (http://pear.php.net/user/jstump) has commented on the proposal for RFC::Amendment of
Docblock Comment Standards.
Comment:
I agree with everything, but the omission of @return. PHP still doesn't
have any way to imply anything other than void. PHPDocumentor could
indicate that *something* is returned, but not what that thing is.
I'd recommend this remain explicit.
Proposal information:
http://pear.php.net/pepr/pepr-proposal-show.php?id=580
--
Sent by PEPr, the automatic proposal system at http://pear.php.net