Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:126089
Message-ID: <f702b9b5-c414-43ba-9c23-7a5a04b7b0e3@gmx.de>
Date: Sun, 1 Dec 2024 20:10:14 +0100
Precedence: bulk
MIME-Version: 1.0
User-Agent: Mozilla Thunderbird
Subject: Re: [PHP-DEV] Re: Inaccurate documentation on return values from
 native functions
To: mickmackusa <mickmackusa@gmail.com>, "Gina P. Banyard" <internals@gpb.moe>
Cc: internals <internals@lists.php.net>
References: <CAKVXxD-9=cv5M7DHs0FLZdLMy9Xe5+AcXYtd6iSEmY=9u1g4AQ@mail.gmail.com>
 <CAKVXxD9QX1DODPboY9=36Cb23t36hLAF-Fa_NAeN3xoWDXycPg@mail.gmail.com>
 <Re44EoZ2A4IxjpFiUp0ZFd0ybwLNe923wDGbJo2TfZ4UPQcAQHxX2XE-RB-IWtZFkK_rrPT6JQvss265WxXuf3RvMqjzd8pH1G_7DhiM1NQ=@gpb.moe>
 <CAKVXxD_yd6sUgM=mjYEPJ1jK6O760nr8pGwyEfFG8tYttsBN6A@mail.gmail.com>
Content-Language: de-DE
In-Reply-To: <CAKVXxD_yd6sUgM=mjYEPJ1jK6O760nr8pGwyEfFG8tYttsBN6A@mail.gmail.com>
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: quoted-printable
UI-OutboundReport: notjunk:1;M01:P0:rQfKeDfQAv8=;wCSha49Vhf7gZvMXvgvSPIA2PWF
 JjSUB5poBUHwNMHXIBo9+prZ8eIKmjZfLOhgXUfpsETb/lAxEozNH69vrl3MvKpfcLWfrAeva
 aDinQ5oSr5aDdHjZMuZ/opxI/0AMkehCXcCOaL6/gHOTjy3sEiW34wvO/JMBZi7yH45hVSYHw
 hCGmV+tuLy1WikguM1gG44QR5nCElu8bo3E47tOH0fNja7WddFq6XLyvCXVki/7qzyRNA5su5
 tPr2hs1wS0dmLH8i2gcODa+L/F7NMdFdox5tIO1eRuEh4HWMk/bkXygK8BHEt4EEBukNRENN0
 WMTI4k+lRjNyawFulg9iOIXkwUaiPQIQ26RSjYD82qJqx/73rfSrYUDIDH/Fad93Tg8kFm6wQ
 iPc20W4CW6acfM7QglF6fu4JPEhy4g0C+PQz2Cljlke1qXxiF+qEMKwYQ8E3M9ejjuCnI5DGv
 +anJ8Os8xFzwaRqsxxR5Psg12WYYHhWhTXhsB3BfgUKE5Vk94RJPo5K7y2LkU993gx30f37IX
 zpJYAtPN5WfzBdLikpb0yHfgQdNtD0SetmyTbpJzmweXOwiyuQLERZiOIXo9x5sefJwUojPaw
 eM2fJgQG2AVMwqmyXrSVdneEEB6u76IDSPgmVFlqlLAO+sUrYkt4HAVq2yEcKrT4maMyI/vOd
 4O2y2aDrdl+u+u4EK6nFnEfvIEo5Y2hTr7+njSSwnksKNnwIcBi3+D7QXgNaD3QMFyX/aKyvW
 Jl44HVLKJ0VboshCCYOCehlNOD1QOPeazGZ2T382z7fEYcGE6MvfW+m/mowkeY5trlsOLtrT4
 eytWpiUO9oTwnh0AnSnRBfxIm9YVTQq5klgBSZYUdCIeevY7M2agZwvyV4WhYfNkvVf+F62Q2
 xstRTOqBzFy+ZHasANsIJWG0fB50/c85XFWFHxfEZA+H0amafC4xTWNu2Ln0zYaaO3xk9P2kr
 KwxxirfQTpRjFTgXCPmQrMrR7qJ4NHa8UsCYWP6Eyx6/7UbwK9ba8jqwrWmNJ7fJqp8yPqsof
 szGnRNz8m4bxguvjAOr22k5PQbsEd+lQc8RiRrUMLj7iZ4+3ORVMBeLFvG45MSJNROFrKpEsD
 YJIvHVhdHjWM2zNthyO3VYcmZ6Zbwj
From: cmbecker69@gmx.de ("Christoph M. Becker")

On 01.12.2024 at 19:26, mickmackusa wrote:

> On Sun, Dec 1, 2024 at 10:01=E2=80=AFPM Gina P. Banyard <internals@gpb.m=
oe> wrote:
>
>> This should just have been an issue on the php/doc-en repo.
>>
>> Please open such an issue so that we can track it (or submit a PR).
>
> I am not sure that this is purely a problem with the documentation.
> It seems possible to me that someone updated the documentation to reflec=
t a
> new intention for these functions.
> Will it not be that these functions will be altered in the core to do wh=
at
> the documentation says?

If the docs are not correct, we cannot simply change the source to
conform for BC reasons.

In this case, see <https://github.com/php/doc-en/issues/3629>.

Christoph