Re: Doc Comments cause parser errors
| From: | Andrei Zmievski | Date: | Wed, 02 Apr 2003 15:30:39 +0000 |
| Subject: | Re: Doc Comments cause parser errors | ||
| References: | 1 2 | Groups: | php.internals |
| Request: | Send a blank email to internals+get-604@lists.php.net to get a copy of this message | ||
On Wed, 02 Apr 2003, Lance Lovette wrote:
> 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.
The problem is finding the storage for them. Classes/functions have
internal structures that we can store doc comments in. Constants and
variables, alas, don't.
-Andrei http://www.gravitonic.com/
* Proximity bug: when the program crashes in front of important visitors. *