Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:126090
Precedence: bulk
MIME-Version: 1.0
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> <f702b9b5-c414-43ba-9c23-7a5a04b7b0e3@gmx.de>
In-Reply-To: <f702b9b5-c414-43ba-9c23-7a5a04b7b0e3@gmx.de>
Date: Sun, 1 Dec 2024 21:32:29 +0100
Message-ID: <CAJmy8YEeFafHKRRZUWhd_rS-cDZ6dPnT=2PmO_PZfA5tM=z8UQ@mail.gmail.com>
Subject: Re: [PHP-DEV] Re: Inaccurate documentation on return values from
 native functions
To: "Christoph M. Becker" <cmbecker69@gmx.de>
Cc: mickmackusa <mickmackusa@gmail.com>, "Gina P. Banyard" <internals@gpb.moe>, 
	internals <internals@lists.php.net>
Content-Type: multipart/alternative; boundary="0000000000008921a206283b55cd"
From: divinity76@gmail.com (Hans Henrik Bergan)

--0000000000008921a206283b55cd
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

On Sun, Dec 1, 2024, 20:12 Christoph M. Becker <cmbecker69@gmx.de> wrote:

> 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.=
moe>
> 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
> reflect a
> > new intention for these functions.
> > Will it not be that these functions will be altered in the core to do
> what
> > 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
>

The same way we can't simply stop curl_close from writing to
CURLOPT_COOKIEFILE for BC reasons?  (
https://github.com/php/doc-en/issues/2239 )

>

--0000000000008921a206283b55cd
Content-Type: text/html; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

<div dir=3D"auto"><div><br><br><div class=3D"gmail_quote"><div dir=3D"ltr" =
class=3D"gmail_attr">On Sun, Dec 1, 2024, 20:12 Christoph M. Becker &lt;<a =
href=3D"mailto:cmbecker69@gmx.de">cmbecker69@gmx.de</a>&gt; wrote:<br></div=
><blockquote class=3D"gmail_quote" style=3D"margin:0 0 0 .8ex;border-left:1=
px #ccc solid;padding-left:1ex">On 01.12.2024 at 19:26, mickmackusa wrote:<=
br>
<br>
&gt; On Sun, Dec 1, 2024 at 10:01=E2=80=AFPM Gina P. Banyard &lt;internals@=
gpb.moe&gt; wrote:<br>
&gt;<br>
&gt;&gt; This should just have been an issue on the php/doc-en repo.<br>
&gt;&gt;<br>
&gt;&gt; Please open such an issue so that we can track it (or submit a PR)=
.<br>
&gt;<br>
&gt; I am not sure that this is purely a problem with the documentation.<br=
>
&gt; It seems possible to me that someone updated the documentation to refl=
ect a<br>
&gt; new intention for these functions.<br>
&gt; Will it not be that these functions will be altered in the core to do =
what<br>
&gt; the documentation says?<br>
<br>
If the docs are not correct, we cannot simply change the source to<br>
conform for BC reasons.<br>
<br>
In this case, see &lt;<a href=3D"https://github.com/php/doc-en/issues/3629"=
 rel=3D"noreferrer noreferrer" target=3D"_blank">https://github.com/php/doc=
-en/issues/3629</a>&gt;.<br>
<br>
Christoph<br></blockquote></div></div><div dir=3D"auto"><br></div><div dir=
=3D"auto">The same way we can&#39;t simply stop curl_close from writing to =
CURLOPT_COOKIEFILE for BC reasons?=C2=A0 ( <a href=3D"https://github.com/ph=
p/doc-en/issues/2239">https://github.com/php/doc-en/issues/2239</a> )</div>=
<div dir=3D"auto"><div class=3D"gmail_quote"><blockquote class=3D"gmail_quo=
te" style=3D"margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"=
>
</blockquote></div></div></div>

--0000000000008921a206283b55cd--