Newsgroups: php.internals Path: news.php.net Xref: news.php.net php.internals:125412 X-Original-To: internals@lists.php.net Delivered-To: internals@lists.php.net Received: from php-smtp4.php.net (php-smtp4.php.net [45.112.84.5]) by qa.php.net (Postfix) with ESMTPS id 4AF721A00BD for ; Wed, 4 Sep 2024 13:04:28 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=php.net; s=mail; t=1725455185; bh=zy0PEwsydPto+BXSZ+jRVjLo7y856FBsv4iVKxgxobY=; h=Date:To:From:Subject:From; b=L6STrqaI6fuWEJiCUNMiI/JwRw6rniG3eXfYYd94e51qNRZUZktlnbMjxxto0ibpD cifH8ckLzHZfOxYkpYh0kaB8fQRtZdAPQQax1GlZ+NfEDAmwVrdWeDWnJ3L5gnlD/K M5Gk94WfII5/DU2+9A51ETjm9C5CpZL3VLse3UPWY41AIDL9OoNrOL3V86HWfcI0+4 jCAfuez89e60jiYG1cg9fZ5I9ITlaINtZa9vesBOHNUoG59U63aqmSAv9ui7OJ6wi6 LYJ+P2DrKRQgGBdLkOEOegomwAceS+qdlO36dPtmuEJl+xyqdJWDpD06/QDWal0WDF jJzKu0kjAqAYg== Received: from php-smtp4.php.net (localhost [127.0.0.1]) by php-smtp4.php.net (Postfix) with ESMTP id 2752918006E for ; Wed, 4 Sep 2024 13:06:25 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 4.0.0 (2022-12-13) on php-smtp4.php.net X-Spam-Level: X-Spam-Status: No, score=0.2 required=5.0 tests=BAYES_50,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,DMARC_PASS, FREEMAIL_ENVFROM_END_DIGIT,FREEMAIL_FROM,RCVD_IN_DNSWL_LOW, RCVD_IN_MSPIKE_H3,RCVD_IN_MSPIKE_WL,SPF_HELO_NONE,SPF_PASS autolearn=no autolearn_force=no version=4.0.0 X-Spam-Virus: No X-Envelope-From: Received: from mout.gmx.net (mout.gmx.net [212.227.17.22]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange ECDHE (prime256v1) server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by php-smtp4.php.net (Postfix) with ESMTPS for ; Wed, 4 Sep 2024 13:06:23 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmx.de; s=s31663417; t=1725455064; x=1726059864; i=cmbecker69@gmx.de; bh=rdC779L4QQI2oyyITTBhLmknDotfbJhS70pZ3Vf1D38=; h=X-UI-Sender-Class:Message-ID:Date:MIME-Version:To:From:Subject: Content-Type:Content-Transfer-Encoding:cc: content-transfer-encoding:content-type:date:from:message-id: mime-version:reply-to:subject:to; b=EpHOg2/tCZsNbmdJ7CIQ3AVSrIBzZCwVpwoGp7f+RxiK5pz+tMjY+X82XtEu9WbR 4cxA+lpDExiZGIPe2lBTSPNahCGVC6kGHc81AnYc/5ipUJlHi7pcLunvy8sDVwxWe WyPgD928gvtl9A5WIUFbQgoOtRXQOHkQRvcXGO45ab7oWGY1ipYwySiSf+CW+a9/V /d/hbSdn7Lri8DwmOs8Vj98m1gR1pFqb0derP4JNUC9mPMryGdDWCfq/zUSN8xqPb DFiiXFE08w266DQq5HnpvCRnCfUN37TiL1idFTbOxIVg6ErIRxovp3I0KpS60rlDd dpGzKdr9w0VumIJAXQ== X-UI-Sender-Class: 724b4f7f-cbec-4199-ad4e-598c01a50d3a Received: from [192.168.2.130] ([79.251.205.37]) by mail.gmx.net (mrgmx105 [212.227.17.168]) with ESMTPSA (Nemesis) id 1MStCY-1scRTq0Rvq-00Idif for ; Wed, 04 Sep 2024 15:04:24 +0200 Message-ID: Date: Wed, 4 Sep 2024 15:04:24 +0200 Precedence: bulk list-help: list-post: List-Id: internals.lists.php.net x-ms-reactions: disallow MIME-Version: 1.0 User-Agent: Mozilla Thunderbird To: PHP internals list Content-Language: de-DE Subject: [PHP-DEV] Where to document configuration option changes? Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit X-Provags-ID: V03:K1:v7YwOT4nNbbocTb/vU52UzXiPi3+MqKqSBMIif8S/rSTmj+0ctz m0z28OO9ycNVejPXQT/bep8+n4DEHnbn8Rmi7DyJxeSBroE5t0J2XGUyZKeM3wnV17NOtI/ Q733izBnUMwSPn96LfOyT3v5/er2zt2SdvjOlkmgJQ/+w5vo5vwfYYuHZ8Mp/0zB7QjcVaR 0dkUXWYYYYULX5ngxAHHg== UI-OutboundReport: notjunk:1;M01:P0:DQDlKiV4P7M=;LTd7lVMoEY789yQeZQxPB3NY8OW PZn3yprP6AKZU9kjAjgH/2gs6qqjHPs7hnJ1Cw/kllajVS8L0080+9/04eRDK6HxGTnAn/X8h ZYipZ7ro/Pi2WdMwF5oUwmvSrtfpjHZlHwZaY2wFzB40TpaWOoWCG2A+dEypMK8zVvRbbUQNS zhL/CSxYucnjuyQTUHoyD2zK/YuueXNQwL9Hh4F3WagzmzmtYl+dpV2i4sMVxTZ6zSn1jFRmz 8fQH+X1ZX03R1IhoBJ9M/PHh7Q3iXJqJV30vYw2VFAT06GXZsoGPG5LaTxLaKK+tGxKH45ElY yfeFWvgvPfodukWWNJCl/l7R/RSeSLLWERNNHqR1VCYe3mxJ2HGEri2EvAoW8/RM9YO+XEI2Y 1gzO4vPxyMRyV06BDiIPGynlxVvkJGdUfumY/zQTFLbJ132LWPnSviZmM0K2Q7MO/5kxwenaA CTP7tnFgaysINav9tpqnklyIJjZSjyVqRK+Tv89/CjO7NYs4UhP4vZ1OOP/rwEsWTohd9RyPI NQTuOY8wAw+uZ0AEfKDQL9XUQ50GY/N4s2THC1ICgccXfsN3gFGrjqCUGiXh2yVVkuQr6BghZ Gjqh0uvVsu7Qs1if1GQxqcjf+EQ8/GsX3dh3Vf3EiJD9laL2BnicOXy9eUWWrkBgAeUIFsiU0 uqAe35TKNK+q5GUTwvKkyYqvwsswkRbvSMPF8jSUm967TFx2QvP4oOfC3itxi99EpA//X8ECR PdUNjeK4faCdZP5Cx/hfrN0F2PKllZleWx+awUGTtLi+6gVb5QBuxBRoUx3Ikyswcwa988WFe yJvIVCwENe6LgbXfhaZErd8Q== From: cmbecker69@gmx.de ("Christoph M. Becker") Hi all, that issue came up the other day on a pull request[1], but since it is not particularly related to any single PR, I wanted to ask here for clarification. This is about changes to `./configure` options of php-src, and whether these should be documented in UPGRADING or UPGRADING.INTERNALS. For the master branch, most such changes are currently documented in UPGRADING.INTERNALS, but a few are in UPGRADING. In my opinion these changes should be documented in UPGRADING, but not in UPGRADING.INTERNALS, because they are relevant for users who build PHP themselves, packagers (aka distro managers) and the documentation team, and neither of these is supposed to read UPGRADING.INTERNALS. And I believe that it has been done this way in the past. What do you think? On a general note, it might be reasonable to properly document what should go into UPGRADING, UPGRADING.INTERNALS and NEWS; that seems to be generally somewhat unclear; sometimes there are entries in NEWS *and* UPGRADING for the same changes, what appears to be duplicate content to me. [1] Christoph