Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:60299
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
Received-SPF: pass (pb1.pair.com: domain gmail.com designates 209.85.210.45 as permitted sender)
References: <CAKOpQSw_sxFcY+1+7s-ZLeCp3Gf_kagztpaM7JSiG=iaOEWK6A@mail.gmail.com> <CAORXhGLdTh20tUA=cTYckx-arV7u_MeyeQDcXBDdiNA=Gc_nUg@mail.gmail.com> <CAKOpQSwZ4_Bae+TSditLWCqJpCGLpk=y++1YQgw60rEfNWhzOw@mail.gmail.com>
In-Reply-To: <CAKOpQSwZ4_Bae+TSditLWCqJpCGLpk=y++1YQgw60rEfNWhzOw@mail.gmail.com>
Mime-Version: 1.0 (1.0)
Content-Transfer-Encoding: quoted-printable
Content-Type: text/plain;
	charset=us-ascii
Message-ID: <9D120847-C2AB-47C4-BCE4-6F68F3C6FE06@gmail.com>
Cc: Tom Boutell <tom@punkave.com>,
 PHP internals list <internals@lists.php.net>
Date: Wed, 25 Apr 2012 07:00:20 +0800
To: Kris Craig <kris.craig@gmail.com>
Subject: Re: [PHP-DEV] [RFC] Pure PHP Scripts (Updated)
From: tjerk.meesters@gmail.com (Tjerk Meesters)


On 25 Apr, 2012, at 5:42 AM, Kris Craig <kris.craig@gmail.com> wrote:

> On Tue, Apr 24, 2012 at 1:10 PM, Tom Boutell <tom@punkave.com> wrote:
>=20
>> * The RFC starts off immediately talking about file extensions, but
>> the actual implementation proposed doesn't rely on file extensions or
>> suggest any enforcement of them. That disparity should be addressed
>> for clarity.
>>=20
>=20
> Did you read the whole RFC?  Please refer to the "Naming Conventions"
> section.  It addresses this explicitly.
>=20
> Are you saying that section wasn't sufficiently clear or did you just miss=

> it?
>=20

I think what he means is that the abstract section should be, well, abstract=
. Currently it appears more detailed than it should be by referring to file e=
xtensions on the let go. I would phrase that section in a way that doesn't r=
ely on another section to explain the used terminology.=20

Also, references such as .phpp are used throughout the document to indicate a=
 particular type of source file rather than an actual file extension. As suc=
h I would recommend moving your terminology section to right underneath abst=
ract. This would improve the readability.=20