Newsgroups: php.internals Path: news.php.net Xref: news.php.net php.internals:130126 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 lists.php.net (Postfix) with ESMTPS id 815CA1A00BC for ; Sun, 22 Feb 2026 17:52:27 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=php.net; s=mail; t=1771782752; bh=9KGkyib0QoNDy+CdGecrHP6HklEgn7Y/ga43bN+eQh4=; h=Date:Subject:To:References:From:In-Reply-To:From; b=Z01n99OFdV+b6eJUGrrMhAHqZ+YZqZhHiavuEuopnetrn52JhzgG2pONPVOpNQTXF ySaSgLxzRqKgoX+aCsI+xoV1lQASeWRNpGzHTh1+w9c39n5iO+hChZXs2AcfxBiaAv /MUMCgl4puKf043O7GdEaiuHPwv1JSU0Yv3LeiV+rAb5395Aj7X9IusbyuHS51G8dq BlNwI15sJng++17GS0Z4x/EFlow8cX1IUAGuTkmjTn9+aoTrfBed0vlfY3HSX5CqkS QWS4ecxW5Fd2Mus5zVKjmjY/tfjycmFqUkTb8S67Y/ANtic44fy/BJzYjbtbIGrTJB Stm96fjl13crg== Received: from php-smtp4.php.net (localhost [127.0.0.1]) by php-smtp4.php.net (Postfix) with ESMTP id 460F1180069 for ; Sun, 22 Feb 2026 17:52:31 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 4.0.1 (2024-03-25) on php-smtp4.php.net X-Spam-Level: X-Spam-Status: No, score=0.6 required=5.0 tests=BAYES_50,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,DMARC_PASS,SPF_HELO_NONE, SPF_PASS autolearn=no autolearn_force=no version=4.0.1 X-Spam-Virus: No X-Envelope-From: Received: from chrono.xqk7.com (chrono.xqk7.com [176.9.45.72]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by php-smtp4.php.net (Postfix) with ESMTPS for ; Sun, 22 Feb 2026 17:52:30 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bastelstu.be; s=mail20171119; t=1771782743; bh=2BnlKI9yQ/otBOSnaOKICMYLr8uVMX4qU+iuplFCv9Y=; h=Message-ID:Date:MIME-Version:Subject:To:References:From: In-Reply-To:Content-Type:from:to:cc:subject:message-id; b=kPgY307kZ5Cknox5s/twsBwvxjpJ7h58CL2JrezMJzsFER8VWmDILgcqMqsh3dBPA F+yDXlPPgpDLhv6wZXaQaVakBt5GNYDR08WR/6uJL7RexAb3DUq4taoGKXk9IH8ISK 9r5f3MCGcc6b3eL+Et/Jb+LSxiDJjvt4U+u5ZKKchdCVWLCweiGTsvwNuaSmxLFcHO Y875EfdKmPwjv+5pBcW5dCtFbQmV04W+592UK+R952/Z/mdYj2lU1bfKoN2RqBjcjn 6ip/5mv0jKB19Rd1ymDb0D0n0fsMRONvenbjshn17KzkNppc2sEuy5CgN1t/xfxzHs o4tIg/nF8lgJQ== Message-ID: Date: Sun, 22 Feb 2026 18:52:21 +0100 Precedence: list list-help: list-unsubscribe: list-post: List-Id: x-ms-reactions: disallow MIME-Version: 1.0 Subject: Re: [PHP-DEV] [RFC] DocComments For Function Parameters To: Christian Schneider , PHP internals list References: <24229A82-F5BF-48F2-9E6C-FE45A99FB9E9@cschneid.com> Content-Language: en-US In-Reply-To: <24229A82-F5BF-48F2-9E6C-FE45A99FB9E9@cschneid.com> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 8bit From: tim@bastelstu.be (=?UTF-8?Q?Tim_D=C3=BCsterhus?=) Hi On 2/21/26 18:51, Christian Schneider wrote: > I would like to introduce DocComment support for function parameters: > > https://wiki.php.net/rfc/parameter-doccomments Thank you. This makes sense to me and it has a straight-forward implementation. Some comments regarding the RFC: - Please add a link to the ML discussion to the “References” section: https://news-web.php.net/php.internals/130121 - The ABI change is irrelevant: Extensions have to be recompiled for every PHP branch and new features may not ship with 3rd-digit versions anyways. Mentioning this is thus misleading at best (affecting “Backwards incompatible changes”, “Proposed PHP version”, and “RFC Impact”). - In fact, there is not even an ABI change, because the new field is added at the end of the struct. - Within the “Ecosystem” impact, you should probably mention that this might require adjustments to code style / formatting guidelines and autoformatters - or at the very least a decision needs to be made there. Best regards Tim Düsterhus