Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:105055
Content-Type: text/plain;
	charset=utf-8
Mime-Version: 1.0 (Mac OS X Mail 12.4 \(3445.104.8\))
In-Reply-To: <CAHN63oOfR3DD9b_xHLPUh20=jJFQTJH+Qce298k-4vm6X4bdKg@mail.gmail.com>
Date: Wed, 3 Apr 2019 19:00:46 +0200
Cc: Rowan Collins <rowan.collins@gmail.com>,
 PHP internals <internals@lists.php.net>
Content-Transfer-Encoding: quoted-printable
Message-ID: <65AF9E1E-DFA6-47AE-952B-9ABEBD9B6038@gmail.com>
References: <CAHN63oMjO-7cdnF55Mrj-MxVrq9mvm5=c2M681CuXLkE_Hez_A@mail.gmail.com>
 <CAESVnVpcTTC-77EjLgH-9jwbPgzaR2x_JV+D00SMffWKgU=bkw@mail.gmail.com>
 <CAHN63oP4p-VdK=J3L3vi0GygHawRq5KkCHJEF0tFoQBtSezGiQ@mail.gmail.com>
 <CALKiJKrbcv42cyWYqLfizzNVGc55Z4qEW+X6gfxzoVENSrnZuw@mail.gmail.com>
 <CAHN63oOfR3DD9b_xHLPUh20=jJFQTJH+Qce298k-4vm6X4bdKg@mail.gmail.com>
To: "M. W. Moe" <mo.mu.wss@gmail.com>
Subject: Re: [PHP-DEV] Question about adding !function_identifier
From: claude.pache@gmail.com (Claude Pache)



> Le 3 avr. 2019 =C3=A0 18:52, M. W. Moe <mo.mu.wss@gmail.com> a =C3=A9cri=
t :
>=20
> Hello,
>=20
> not documenting at first is not really a question of laziness or so, =
as
> things are still moving around
> you absolutely  need this agility; a good design layout between theory =
and
> stable state will refactored
> discussed a thousand times; that what I expect from engineers; filling =
the
> gaps between assumptions
> and reality.
>=20
> And for me-self throw vs no throw is important language information =
and
> part of internal behaviors;
> to clarify, for instance, would be more useful to have such indicator
> rather than having having
> abstract and interface which are cumbersome; same as the extra public
> keyword; you can do without
> especially with the new traits construct.
>=20
> Best.

If you=E2=80=99re unwilling to write a docblock for some good reason, =
why not just use the built-in, user-extensible way that most programming =
languages have to add annotations without runtime effect, namely =
unstructured comments? Something like /* nothrow */ is both forward- and =
backward-compatible... Am I missing something?

=E2=80=94Claude