Can the purpose of doc comments be clarified? Why aren't class variables important enough to document? I think everything exposed by a class - variables, methods, constants, etc. - are all equally important and should be documented.
> -----Original Message----- > From: Andi Gutmans [mailto:[EMAIL PROTECTED] > Sent: Wednesday, April 02, 2003 1:11 AM > To: Sebastian Bergmann; [EMAIL PROTECTED] > Subject: Re: [PHP-DEV] Doc Comments cause parser errors > > > AFAIK, doc comments are for classes and functions only. I think this is > what's important because interfaces are functions not variables. > > Andi > > At 07:50 AM 4/2/2003 +0200, Sebastian Bergmann wrote: > > Current HEAD: > > > > <?php > > class Foo { > > var $foo; > > } > > ?> > > > > works, but > > > > <?php > > class Foo { > > /** > > */ > > var $foo; > > } > > ?> > > > > causes > > > > Parse error: parse error, unexpected T_VAR, expecting T_FUNCTION > > in e:\var.php on line 5 > > > >-- > > Sebastian Bergmann > > http://sebastian-bergmann.de/ > http://phpOpenTracker.de/ > > > > Did I help you? Consider a gift: > http://wishlist.sebastian-bergmann.de/ > > > >-- > >PHP Internals - PHP Runtime Development Mailing List > >To unsubscribe, visit: http://www.php.net/unsub.php > > > -- > PHP Internals - PHP Runtime Development Mailing List > To unsubscribe, visit: http://www.php.net/unsub.php > > -- PHP Internals - PHP Runtime Development Mailing List To unsubscribe, visit: http://www.php.net/unsub.php
