Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:124703
Message-ID: <0839d8b7-9f81-4ba5-8e15-9684215003a8@gmx.de>
Date: Wed, 31 Jul 2024 23:49:44 +0200
Precedence: bulk
MIME-Version: 1.0
User-Agent: Mozilla Thunderbird
Subject: Re: [PHP-DEV] [RFC] [VOTE] Deprecations for PHP 8.4
Content-Language: de-DE
To: "Rowan Tommins [IMSoP]" <imsop.php@rwec.co.uk>, internals@lists.php.net
References: <USzt7tZZlO1DmAbSTLhD-bqa23FqZn0zk2aah8Ndxgk9c7RY5PefQ8MjbYPUYAzr2_m4Cf-5AI4PuNBTS84rim_FNS6RaT-cWSv714HEvvU=@gpb.moe>
 <1a88918e-e808-d778-45e1-53797660e093@php.net>
 <CAPrKfG5Cw_nU7g7FR+t4C1-YZ8CDsDO_-sRs=yEsHO5kCTZL+A@mail.gmail.com>
 <95147d9d-d6e8-4396-bf0b-409c33679f90@bastelstu.be>
 <CAPrKfG4TijmZ_N9512_Fk9MBUNg=E6PjNTy-bCbV8CAj9_wX8A@mail.gmail.com>
 <CAPrKfG7Hi0SGbLA31V-9KjHM50QaX+Q=PptuO4+VMOrz7d9eBA@mail.gmail.com>
 <G9IiDe18a2ZhrXPA-zljNZsawKCZxlTn2ACfJpM32scdRkRflZ2rM6Ra8z88ZYDczomex4pffxZMpVhEjdB74YQXXNyqJkd7rQdDGA14HC0=@gpb.moe>
 <89096756-9f50-4b10-9630-d3b18e4b9c29@gmx.de>
 <d54b99fd-64ea-40f2-9fee-c904f1305893@app.fastmail.com>
 <3beb3488-94fc-484e-ac6c-ce7a7a0facd2@app.fastmail.com>
 <70262e95-f0e7-40c0-a731-480f178cbc35@bastelstu.be>
 <caae7d17-27d9-4882-9ff0-f18f16433d2d@rwec.co.uk>
In-Reply-To: <caae7d17-27d9-4882-9ff0-f18f16433d2d@rwec.co.uk>
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: quoted-printable
UI-OutboundReport: notjunk:1;M01:P0:KGoS78E2c+4=;1LXKfZv2Mu+re+JrrpIXmndao/X
 oJVc35tZLHMBno78Y9ohWgiIAodXPPzDL8jEohKJjhobduxLrNBCNWAVKyR3bE4MN6JZN+/5+
 jTP6EHbI3p+AAEh6Q/i57+oeQ2MfSqtvfVKHD340fgWwpGHu/xR2Fb4JUrxSZxvcwCsE5nnC+
 Q0/EHSxT5qnE6a7Q6Ockx8gp0oTMREqmPra1MQBwWcznxDhjq33vytrThliOI180TCH+aD82t
 4uG3OTW1gjdUW16tY4MjoeMyoecUz8qxAwOAfWAzpWujXzyGVWSBJ290I47bcHSwqMB4E68hK
 vCStTurhK+vZuMU11enjB8itBbLol12k/a1fart9t2dBm//wEIiAqfDeslYyQ87i/jPdHSZzm
 GBawKF4arfD7SAtwRFnpxBSg3Ah3AENad7w6I9qiNbvc2un0gMPhIb+yk7CpzkcOHCEE+asJR
 XPwZr6ofWJweTxvHdvQHUuHE6vwZj6q2q0nOgoTgInlu2hCDfoyQl8p159iIDvCxv0FYj4oye
 igf7kMvdqbB2otSsqNNZNay48b7UGbTxG6nKWzmT1ERrzh0B42GUyVxgIP0l5c3F4mumZNhMP
 zNlzkcRG29hZpnYQWHB1EL3IrqPUbe8UuHVNKPeMsJ/rAAvv5nQRkrrqNZdnl9xc4Nfr7LwEy
 zTiEYO1qcsEKdnYde56koUV/x0Tgrn1jOKfcg/oaxJNTtnHJ+KdDGxnVEwHVbyHYSCbOHMNBV
 3VpAxi0xoNZzdweK0Q+mTFc5l+nu/nVmxgyXRlAKHseRlcrLOW0OUliHwEKS5l60pRAVC9BOT
 Sf9yA0i1J5uQF3QzG71EBagw==
From: cmbecker69@gmx.de ("Christoph M. Becker")

On 31.07.2024 at 23:13, Rowan Tommins [IMSoP] wrote:

> On 30/07/2024 20:15, Tim D=C3=BCsterhus wrote:
>
>> Part of the motivation of the deprecation (and my argument against the
>> addition of a standalone sha256() function) is simplifying the
>> documentation: Everything needs to be written down in multiple
>> different places, any changes to hash_file() will likely also need to
>> be applied to md5_file() and sha1_file() - and then it will need to be
>> translated.
>
> We already have a solution for this: named snippets (implemented as XML
> entities), which exist in the source once, are translated once, and then
> inserted into every page that applies when it's rendered to HTML.

These entities are of limited use, though, since they are not
parametrizable, so you always get exactly the same text, and may need
ugly workarounds to even use entities for reusable text snippets.

And lots of entities can make the sources of the documentation pretty
hard to read.

Cheers,
Christoph