Newsgroups: php.internals Path: news.php.net Xref: news.php.net php.internals:130122 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 7EDD91A00BC for ; Sat, 21 Feb 2026 18:41:39 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=php.net; s=mail; t=1771699304; bh=8TGq2DiJ40ROhIdBeFrzsecFgfCxO61O9K7DRhcXEJI=; h=References:In-Reply-To:From:Date:Subject:To:From; b=eA9X0ME6FUqzgQS3yRWOFF4Oq8VRi0AUFP8sIRnBmtTfpnxxQxnV9E1z0/UEq2F29 HIKOaXIiGYn7nc9tciwUm8dAuwytIfyQBHzr9beMT+K9XeKmO2KGay8hmF7FGNsSfN GC7UhNG6Ii+h1Ex30Ia0z/dSpZ4Acqeu/NawYsej8Nl1I8jRPvh4IhZFoOMfL7q6i4 fPcSmTxFlprKR/mVo4JKk6TOhB+WZGl6mlUY1mFoOv+GX9d4XfdRNFpJWEflhvP0pu IGbIzMctlHgKq0qNwmB+LjYPyo6Zia6qhy+TFGd2BHP6sBstkYUCLCAuoVnw5QIxpr GzZaelt4npZng== Received: from php-smtp4.php.net (localhost [127.0.0.1]) by php-smtp4.php.net (Postfix) with ESMTP id 59D3D180080 for ; Sat, 21 Feb 2026 18:41:43 +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=1.6 required=5.0 tests=ARC_SIGNED,ARC_VALID,BAYES_50, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,DMARC_PASS, FORGED_GMAIL_RCVD,FREEMAIL_FROM,HTML_MESSAGE,RCVD_IN_DNSWL_NONE, RCVD_IN_MSPIKE_H2,SPF_HELO_NONE,SPF_PASS autolearn=no autolearn_force=no version=4.0.1 X-Spam-Virus: No X-Envelope-From: Received: from mail-lj1-f179.google.com (mail-lj1-f179.google.com [209.85.208.179]) (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 ; Sat, 21 Feb 2026 18:41:39 +0000 (UTC) Received: by mail-lj1-f179.google.com with SMTP id 38308e7fff4ca-3870778358aso27123581fa.1 for ; Sat, 21 Feb 2026 10:41:34 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1771699293; cv=none; d=google.com; s=arc-20240605; b=VTEoY+ottlQqdEr+LHnUVUgur17Im2DksgMHyD7QV23dDTUzuLYXBcOO56bR5vIXZ4 e/ufd9DaXwituF+Q+Gr7WxSNS0E9zoVTm84SuopT9MWI94gWja+in7Fbq76417gbs73Z SH0zna+spTgalVLLphPBYMpRwscRopwW8H65LcJPrRIyTpQEk+UihHZoHNiXIBirqFOC 4c/D7WIkd9bw6y7IcweOsLEL3fsc9MvsGwvqksSd3Bybt/fnnUrK42w5cX2lEE3Y6f/K 2w99+qwE8YFQOMulqcIHxCvp7DUhrnzVbEcaEVnKcm51MHyNaieiDlNroPxAZyWL2+z8 USVg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20240605; h=to:subject:message-id:date:from:in-reply-to:references:mime-version :dkim-signature; bh=07x5pW3PPiokj+IaD5VQoD08IhjdO/rXJpFGGuC43JI=; fh=fu4N+4vmJYOGkugTj98V7uEvwNEy4Am1XPV65IQOSVk=; b=icLWV2t7sEA3QDVEre7ma1XGQvN31tNwwEoeie87GzaMDfzs7MS9o+51ToPYdLipoA UcCtbmelzwsY4wgv5cSH/GW9MmSKy5z0ApZK35RLXlVuKv76xc6XBzzAT3H5Ewt2gjg0 LXyvTGIClY+i9noxW53WXHrLwYZFFyjcera7XvDJdh5j9knwF7uiXqs5RrSLhlx++VQa p9R6XeLUsUAhvSH4/4IgPZCaIZ35cIwCRG7xoBv6O40DsK148Qw2/fmwLiLKYYk1UYE+ zC/dsHyyyrTaJ71KkM+ImWHskExAQLyboRZvgr7iU0foaVVH+HYfRGvPmlga83kCBee8 p4/Q==; darn=lists.php.net ARC-Authentication-Results: i=1; mx.google.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1771699293; x=1772304093; darn=lists.php.net; h=to:subject:message-id:date:from:in-reply-to:references:mime-version :from:to:cc:subject:date:message-id:reply-to; bh=07x5pW3PPiokj+IaD5VQoD08IhjdO/rXJpFGGuC43JI=; b=iufuaHQ46Ae8E6PqJ3DXbPipJxzBko4wwkwRaxtRWvsr4aty0SMjvsxTRSXLq7Huig 1WoE1d74nWDCoRl5Ihr/Qxyok0IZ8FzbQl8qOrx05bLSEe5pe8w/CI7c2s3xQL5S0+Pb m5bNz0DVpsSWD/qKg+otG57as+cQCg/UHRNpukBce7i7ICJ2EeWkn4evHMHMp6Xva0z+ YNWwYOb5QnXmRQwsg5vI287YvBn5vA0Mx7b1W/zqkiiOU0RC87C06mELhHzXK/AIN/Vj r8WAv/UMu5FlSRtkOWxgIz8hpFaPaZAdmMPusf+BXntGrQFOtID9zSohid49U6X8+CA8 NHiw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1771699293; x=1772304093; h=to:subject:message-id:date:from:in-reply-to:references:mime-version :x-gm-gg:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=07x5pW3PPiokj+IaD5VQoD08IhjdO/rXJpFGGuC43JI=; b=DkUd/mfBzABLXmoS4zcNDRZXMisxyCelloAyAeK1epR54uKIHx5ihDvrgmmYCGdC5N hdVgfor1o4Y8nA0TR877OY9csfIdo5pG2yvjuJKepIWNvWEBw2eFMZ6mipq5R+83aqXf xqkNX2Je/CABHw2SqXekXs+6KXcv8PSCMVSdsrHwZNAQBTl278x3h8DQENeK0jui2wXB qGbMKuF7c7FohVtnoROmDHOPZY4SQHjGLUBPdo69RfWrt34YQrPjlxokqoe2PCRNHZ39 otV/g1N1ALBHst2c32WrRqv2L/pgtPlCvGsIByCYudYcJidZP407LyjSGIn0qlwLpTA5 sVmg== X-Gm-Message-State: AOJu0YwZTj/YkgL1gdqvdlCwRhnLWTP/z8Kdt6R899BHBQTIRVmyR8q8 aPkqncqfOUxfek25h9Ye7miHeToxC+qmDQ0RCJitwmK02ew3a/uIbR+LZKQhcKK9bWriYvic3iF FOHvR569FvfMQw+3O/II5d391ZYfA1rkMYQ== X-Gm-Gg: AZuq6aIsa9sdhuR14A/uTDMa1Vynv4PxGub9nkih2tPjDcheBeyZ9r+3sWtl2Z5MKKZ O3dbLSR0NfGEttbIHJrFfcMyIkU6Ii8ZcxeIIdeGGJ4fNxJn4yaxrsDz596UTaAQR9Mh7gxgkYd nkwc2/4xWbTKyieYs0Kd6djt//WP9Mt/9Dizo7I+b6L2rxDlvpaMwTTFtDkObHYPyKGctDUgCG5 Hu5eQIHV9poICjAomldyu5Dxt4RjTNagBtF/uGPv7hnnBxNJ+mPuMKUTeiPph8WdUj1EtxZwtTA oMP1Zg== X-Received: by 2002:a2e:9a12:0:b0:385:d3fd:2f0c with SMTP id 38308e7fff4ca-389a5de7978mr12327921fa.23.1771699293200; Sat, 21 Feb 2026 10:41:33 -0800 (PST) Precedence: list list-help: list-unsubscribe: list-post: List-Id: x-ms-reactions: disallow MIME-Version: 1.0 References: <24229A82-F5BF-48F2-9E6C-FE45A99FB9E9@cschneid.com> In-Reply-To: <24229A82-F5BF-48F2-9E6C-FE45A99FB9E9@cschneid.com> Date: Sat, 21 Feb 2026 12:41:22 -0600 X-Gm-Features: AaiRm50tkETtSjo2nvHp82z8ZnSmqOYuw8pTOWtnvyv2o6ji3Dg1ulFAd9wkm4k Message-ID: Subject: Re: [PHP-DEV] [RFC] DocComments For Function Parameters To: PHP Developers Mailing List Content-Type: multipart/alternative; boundary="000000000000052416064b59e3c7" From: mweierophinney@gmail.com ("Matthew Weier O'Phinney") --000000000000052416064b59e3c7 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable On Sat, Feb 21, 2026, 11:52=E2=80=AFAM Christian Schneider wrote: > I would like to introduce DocComment support for function parameters: > > https://wiki.php.net/rfc/parameter-doccomments > > I've been wanting this for nearly 20 years! Questions: - Would it also support the comment appearing before the parameter? /** This is the description */ string $message, - If so, what would be the behavior of the engine if a docblock was present in both positions, like: /** This is the description */ $message /** But what about this? */, Generally, docblocks precede the item being documented, so if only one form were allowed, for consistency, that should be the form supported. --=20 Matthew Weier O'Phinney mweierophinney@gmail.com https://mwop.net/ he/him > --000000000000052416064b59e3c7 Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable




On Sat, Feb 21, 2026, 11:52=E2=80=AFAM Christian Schneider <cschneid@cschneid.com> wrote:
<= /div>
I would like to introduce DocComment su= pport for function parameters:

https://wiki.php.net/rfc/parameter-doccomme= nts


I've been wanting this for nearly 20 years!

Questions:

- Would it also support the comment appearing before = the parameter?

=C2=A0 = =C2=A0 /** This is the description */
=C2=A0 =C2=A0 = string $message,

- If so= , what would be the behavior of the engine if a docblock was present in bot= h positions, like:

=C2= =A0 =C2=A0 /** This is the description */
=C2=A0 =C2= =A0 $message
=C2=A0 =C2=A0 /** But what about this? = */,

Generally, docblocks= precede the item being documented, so if only one form were allowed, for c= onsistency, that should be the form supported.=C2=A0


--=C2=A0
Matthew Weier O'Phinney
he/him
--000000000000052416064b59e3c7--