Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:603
Return-Path: <lance.php@dailydiary.com>
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
Delivered-To: mailing list internals@lists.php.net
Received: (qmail 93513 invoked from network); 2 Apr 2003 15:12:40 -0000
Received: from unknown (HELO mail.dailydiary.com) (66.108.72.145)
  by pb1.pair.com with SMTP; 2 Apr 2003 15:12:40 -0000
Received: (qmail 12291 invoked from network); 2 Apr 2003 15:12:38 -0000
Received: from unknown (HELO lancelot) (192.168.1.1)
  by 0 with SMTP; 2 Apr 2003 15:12:38 -0000
To: <internals@lists.php.net>
Cc: "Andi Gutmans" <andi@zend.com>
Date: Wed, 2 Apr 2003 10:12:37 -0500
Message-ID: <OGEMJEFCJMJJMIPAAOIDOEHDCGAA.lance.php@dailydiary.com>
MIME-Version: 1.0
Content-Type: text/plain;
	charset="us-ascii"
Content-Transfer-Encoding: 7bit
X-Priority: 3 (Normal)
X-MSMail-Priority: Normal
X-Mailer: Microsoft Outlook IMO, Build 9.0.2416 (9.0.2911.0)
In-reply-to: <5.1.0.14.2.20030402091017.032db718@127.0.0.1>
X-MIMEOLE: Produced By Microsoft MimeOLE V6.00.2800.1106
Importance: Normal
Subject: RE: [PHP-DEV] Doc Comments cause parser errors
From: lance.php@dailydiary.com ("Lance Lovette")
References: <5.1.0.14.2.20030402091017.032db718@127.0.0.1>

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
>
>