Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:130602
Date: Fri, 10 Apr 2026 16:40:58 +0100
To: internals@lists.php.net, Christian Schneider <cschneid@cschneid.com>
Subject: Re: [PHP-DEV] DocComments for internal functions
User-Agent: K-9 Mail for Android
In-Reply-To: <30448463-1ABD-4005-89CC-3F558C7FE9B2@cschneid.com>
References: <CF327F5E-E105-4405-AB05-EE4BAFFCCB56@cschneid.com> <2FGg02j2pKAcV7nu_mLBtetGMhhax9Ernyly_rH2jDaWzNUSlWMk7pYf4mEq9QIbuBj4tgxA9xLlTEnwPVqmxSTw558yTPNrEsk53G63xtQ=@gpb.moe> <30448463-1ABD-4005-89CC-3F558C7FE9B2@cschneid.com>
Message-ID: <FAA5044A-D145-4972-B45A-0D4B6DCEBA6D@php.net>
Precedence: list
MIME-Version: 1.0
Content-Type: text/plain;
 charset=utf-8
Content-Transfer-Encoding: quoted-printable
From: derick@php.net (Derick Rethans)

On 10 April 2026 15:21:34 BST, Christian Schneider <cschneid@cschneid=2Ecom=
> wrote:
>Am 10=2E04=2E2026 um 12:54 schrieb Gina P=2E Banyard <internals@gpb=2Emoe=
>:
>> On Thursday, 9 April 2026 at 14:33, Christian Schneider <cschneid@cschn=
eid=2Ecom> wrote:
>>> The implementation can be examined at
>>> https://github=2Ecom/php/php-src/compare/master=2E=2E=2Echschneider:ph=
p-src:internal-functions-doccomments
>>=20
>> I am not *fully* convinced that we should add DocComments for internal =
parameters/functions/classes/constants, as this feels like a lot of complex=
ity=2E
>
>What kind of complexity are you thinking about? Code-wise? Integration in=
to the build process?

I'm wondering how much this does to increase the size of the PHP compiled =
binaries=2E=20

cheers=20
Derick=20