Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:120254
Feedback-ID: i8414410d:Fastmail
User-Agent: Cyrus-JMAP/3.9.0-alpha0-415-gf2b17fe6c3-fm-20230503.001-gf2b17fe6
Mime-Version: 1.0
Message-ID: <68c1b984-1bcd-4dfd-8499-65fe392d7783@app.fastmail.com>
In-Reply-To: <9F928894-199E-4C46-A590-136BDDE035F7@gmail.com>
References: 
 <CAH5C8xXtCVHaxwzmAW_eBxp_D6p7kww9svND=3AEeC9X6--YXg@mail.gmail.com>
 <ffa8138a-f1b6-3926-bc2f-558ffca344b0@gmail.com>
 <CAH5C8xXhCkZt7bBs7YcjMBRYM5ggu7W47huCCbVwb2-q_zFnBA@mail.gmail.com>
 <e3eba528-a015-48be-ba8e-fa71d512aa33@app.fastmail.com>
 <CAH5C8xVJPXx8Mk5WViOiqBe-094zTbtSO6pkZGx2BeGKbaXVoA@mail.gmail.com>
 <9ab0173f-a6f2-66f6-3ab3-d5f0c44feb05@bastelstu.be>
 <CA+kxMuT_DsqqH6-pq+P7ZjddEpCetHhYQvuDkAd4_oNSh7ePpA@mail.gmail.com>
 <D222D279-03C2-413A-A65A-67EA96EFBF88@gmail.com>
 <CAH5C8xXFTuL9Eno6FTnMqzF084NiPY-iDSebRwwxu2Dc3=tr1A@mail.gmail.com>
 <9F928894-199E-4C46-A590-136BDDE035F7@gmail.com>
Date: Fri, 12 May 2023 23:08:22 +0000
To: "php internals" <internals@lists.php.net>
Content-Type: text/plain;charset=utf-8
Content-Transfer-Encoding: quoted-printable
Subject: Re: [PHP-DEV] [RFC] [Discussion] Deprecate functions with overloaded
 signatures
From: larry@garfieldtech.com ("Larry Garfield")

On Fri, May 12, 2023, at 9:59 PM, Rowan Tommins wrote:
> On 12 May 2023 19:17:20 BST, "M=C3=A1t=C3=A9 Kocsis" <kocsismate90@gma=
il.com> wrote:
>>Libraries have to
>>get rid of deprecated calls in any case, otherwise
>>their users will surely start to complain.=20
>
> I've said it before, and I'll say it again: the solution to this is no=
t=20
> fewer deprecation messages; it's better documentation to stop people=20
> confusing deprecations for errors, and better functionality for users=20
> to choose which messages they see.

A better argument, I think:

The old function exists in 8.2, the new one does not.
The new one exists in 8.3.
The old one ceases to exist in 9.0.

That means it's impossible to write code that works from 8.2 to 9.0 with=
out version checks.  The overlap period is only 2 releases (8.3 and 8.4)=
.  That's too short of a window.

That's mitigated by these all being very uncommon cases, yes, but as a p=
rinciple we should give people more warning than that.

I am actually tempted to propose that we do deprecations at the very sta=
rt of a release, 9.0 and 9.1 only, and then not allow them for the rest =
of that major, for that exact reason.

--Larry Garfield