Newsgroups: php.internals Path: news.php.net Xref: news.php.net php.internals:110431 Return-Path: Delivered-To: mailing list internals@lists.php.net Received: (qmail 88218 invoked from network); 8 Jun 2020 18:04:09 -0000 Received: from unknown (HELO php-smtp4.php.net) (45.112.84.5) by pb1.pair.com with SMTP; 8 Jun 2020 18:04:09 -0000 Received: from php-smtp4.php.net (localhost [127.0.0.1]) by php-smtp4.php.net (Postfix) with ESMTP id 5B46F18056B for ; Mon, 8 Jun 2020 09:47:38 -0700 (PDT) X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on php-smtp4.php.net X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00,RCVD_IN_DNSWL_NONE, SPF_HELO_NONE,SPF_PASS autolearn=no autolearn_force=no version=3.4.2 X-Spam-ASN: AS36483 23.83.208.0/21 X-Spam-Virus: No X-Envelope-From: Received: from bird.elm.relay.mailchannels.net (bird.elm.relay.mailchannels.net [23.83.212.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by php-smtp4.php.net (Postfix) with ESMTPS for ; Mon, 8 Jun 2020 09:47:36 -0700 (PDT) X-Sender-Id: s0seqk11zu|x-authuser|lester@lsces.uk Received: from relay.mailchannels.net (localhost [127.0.0.1]) by relay.mailchannels.net (Postfix) with ESMTP id C2BCD6418B2 for ; Mon, 8 Jun 2020 16:47:33 +0000 (UTC) Received: from cp9.ukdns.biz (100-97-68-20.trex.outbound.svc.cluster.local [100.97.68.20]) (Authenticated sender: s0seqk11zu) by relay.mailchannels.net (Postfix) with ESMTPA id A8BB86413CF for ; Mon, 8 Jun 2020 16:47:32 +0000 (UTC) X-Sender-Id: s0seqk11zu|x-authuser|lester@lsces.uk Received: from cp9.ukdns.biz (cp9.ukdns.biz [95.215.224.60]) (using TLSv1.2 with cipher DHE-RSA-AES256-GCM-SHA384) by 0.0.0.0:2500 (trex/5.18.8); Mon, 08 Jun 2020 16:47:33 +0000 X-MC-Relay: Neutral X-MailChannels-SenderId: s0seqk11zu|x-authuser|lester@lsces.uk X-MailChannels-Auth-Id: s0seqk11zu X-Cooperative-Oafish: 7ae0166c0dac9a9d_1591634853405_682436338 X-MC-Loop-Signature: 1591634853405:1874189332 X-MC-Ingress-Time: 1591634853405 Received: from [86.133.81.161] (port=60822 helo=[192.168.1.133]) by cp9.ukdns.biz with esmtpsa (TLS1.2) tls TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 (Exim 4.93) (envelope-from ) id 1jiKve-0001Y8-Mg for internals@lists.php.net; Mon, 08 Jun 2020 17:47:18 +0100 To: PHP Internals References: Message-ID: <732f2e74-ff08-5353-7fb4-c9ab7e33b7f5@lsces.uk> Date: Mon, 8 Jun 2020 17:47:17 +0100 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101 Thunderbird/68.6.0 MIME-Version: 1.0 In-Reply-To: Content-Type: text/plain; charset=utf-8; format=flowed Content-Language: en-GB Content-Transfer-Encoding: 7bit X-thewebhostserver-MailScanner-Information: Please contact the ISP for more information X-thewebhostserver-MailScanner-ID: 1jiKve-0001Y8-Mg X-thewebhostserver-MailScanner: Found to be clean X-thewebhostserver-MailScanner-SpamCheck: X-thewebhostserver-MailScanner-From: lester@lsces.uk X-AuthUser: lester@lsces.uk Subject: Re: [PHP-DEV] [VOTE] Attribute Amendments From: lester@lsces.uk (Lester Caine) On 08/06/2020 16:30, Benjamin Eberlei wrote: > > > On Mon, Jun 8, 2020 at 11:11 AM Lester Caine > wrote: > > On 08/06/2020 09:44, Marco Pivetta wrote: > > I was mostly conflicted around the "allow grouped attributes" > bit, but > > James Titcumb (who currently cannot write to this list due to bounced > > emails) convinced me that it is a good replacement for `/**` and > `*/`: > > If twenty years of documentation provided by docblocks is to be > replaced > there has to be a compelling reason to do so and while this latest > drive > for yet another documentation method seems to be now a fate acompli > there WAS no reason to replace that perfectly acceptable documentation! > > > Attributes are not documentation (they could theoretically be used for > it, but its not the intented use-case). > > Attributes are supposed to be used with Runtime Reflection to have an > effect on the program. > > Their existence does not supersede docblocks, only the use of docblocks > for meta-programming (essentially doing what Attributes allows with > docblocks). So the statement that "it is a good replacement for `/**` and `*/`" is not correct ... it may be that others do not understand the difference? Personally none of this is addressing the fundamental problem of providing a generic variable system that can manage range as well as 'type' ... something the docblock have been providing for a long time and moving part of that to some new element is only making things worse :( -- Lester Caine - G8HFL ----------------------------- Contact - https://lsces.uk/wiki/Contact L.S.Caine Electronic Services - https://lsces.uk Model Engineers Digital Workshop - https://medw.uk Rainbow Digital Media - https://rainbowdigitalmedia.uk