RE: [PHP-DEV] Doc Comments cause parser errors
| From: | Lance Lovette | Date: | Wed, 02 Apr 2003 15:12:37 +0000 |
| Subject: | RE: [PHP-DEV] Doc Comments cause parser errors | ||
| References: | 1 | Groups: | php.internals |
| Request: | Send a blank email to internals+get-603@lists.php.net to get a copy of this message | ||
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:andi@zend.com]
> Sent: Wednesday, April 02, 2003 1:11 AM
> To: Sebastian Bergmann; internals@lists.php.net
> 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
>
>