Newsgroups: php.internals Path: news.php.net Xref: news.php.net php.internals:123356 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 A92A61A009C for ; Sat, 18 May 2024 18:02:00 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=php.net; s=mail; t=1716055374; bh=P+d05jxhRf5UFFgFOu4n/v2MNUEPuFq60fFyUJl/29M=; h=Date:From:To:Subject:In-Reply-To:References:From; b=LQs2XZV7huZH00S3TP49kMgJOpwmzXLr69hekLbh7bJjXj4iG4Xjrl1xOkUcTKWZ4 aLxHGZVvv22nQFGuKag+4WK/988pDBT2DCgl8IvYjikegKS+F2ITGcUZNjvxBHS8nm b+W/uEIGmbiQrlS3Ld4xhUj6G03YwP7qV7UZuVLdWLG+LDyr4CgnTPo5emTTuar/1F UQH4tpZiWwweXCtYMkd8XIJoqqYLAf6LkVxtefcVaAbDl6hDbfw2zdBaQs+9r5aqgo J5aNwzSKjAkpzIgAwq46O3IObrP2xJCnOHznihFaPyyltduwPMUEYMRLiV8Ob800BS v5UOKIOVs4TcQ== Received: from php-smtp4.php.net (localhost [127.0.0.1]) by php-smtp4.php.net (Postfix) with ESMTP id 353C0180806 for ; Sat, 18 May 2024 18:02:53 +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.1 required=5.0 tests=BAYES_50,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,DMARC_MISSING,RCVD_IN_DNSWL_LOW, SPF_HELO_PASS,SPF_PASS,T_SCC_BODY_TEXT_LINE autolearn=no autolearn_force=no version=4.0.0 X-Spam-Virus: Error (Cannot connect to unix socket '/var/run/clamav/clamd.ctl': connect: Connection refused) X-Envelope-From: Received: from fout8-smtp.messagingengine.com (fout8-smtp.messagingengine.com [103.168.172.151]) (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, 18 May 2024 18:02:52 +0000 (UTC) Received: from compute2.internal (compute2.nyi.internal [10.202.2.46]) by mailfout.nyi.internal (Postfix) with ESMTP id 40BA41380184 for ; Sat, 18 May 2024 14:01:58 -0400 (EDT) Received: from mailfrontend1 ([10.202.2.162]) by compute2.internal (MEProxy); Sat, 18 May 2024 14:01:58 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=rwec.co.uk; h=cc :content-transfer-encoding:content-type:content-type:date:date :from:from:in-reply-to:in-reply-to:message-id:mime-version :references:reply-to:subject:subject:to:to; s=fm1; t=1716055318; x=1716141718; bh=P+d05jxhRf5UFFgFOu4n/v2MNUEPuFq60fFyUJl/29M=; b= Mu4Z7nd49aMMIYMRZ16xbIYWd3HGRyfKqF75WHErhkNJea22b7MzDcCpuR5eJz+9 rvCQzRFzAwr+0MZjKujSgqAB8ctTZwZ6y9Dim5fQvEcVhZ5GEqhH6Fkc7ucOw5mI JM4ekwfMZ4h7S1HQl9DP8OF7v2UZSB9550xHjey/udmRfU23u1sF4GYcVvcFfshn f1Ny+9JAjIgDNEGYy6uBVg/qiuPrig+922me2bw8cf1HDtMOyHOyQ5xcKPhGGnIn Zc7P8rjZtSIU5m24qklrYjmHtLQiD0wJzECud2mpeMuRTUvJjNOKHL35KxY0JPmJ AGcrrmyUyRvnXWZxI1/eTA== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-transfer-encoding:content-type :content-type:date:date:feedback-id:feedback-id:from:from :in-reply-to:in-reply-to:message-id:mime-version:references :reply-to:subject:subject:to:to:x-me-proxy:x-me-proxy :x-me-sender:x-me-sender:x-sasl-enc; s=fm1; t=1716055318; x= 1716141718; bh=P+d05jxhRf5UFFgFOu4n/v2MNUEPuFq60fFyUJl/29M=; b=h dWQllsF5338G6TAZKrVfRvHHRNzCAdCNJHs8FHVjZSh+pFR6PhLoxN5tYW77L2MB qEyVdNSEqj2U2z8wZbA8zMH6lwHeI6bAUPcSW+wDy7BNc5IUvuF9UnoZ4lswWgmj IxMDiD87SNfAZpgp6r0Vb37Nzgvvwfe1q6YSdZYqtZXNLiCJk+eKiiNzD1pmydkP FePW3MLF0brDZvazQ3JFPSRcpaCrU37HmSjTAe9B3CCYZ178/SR5WuSAJwNln6U/ 9ZFgGFPFpNF+6dReoC1OQHBjbKisvpiL/w+0WrGnTJNV7CrzuOuC7xzMYzaL71rB cg3zWWzqfjP0cHBQeZcqA== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvledrvdehiedguddtudcutefuodetggdotefrod ftvfcurfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfgh necuuegrihhlohhuthemuceftddtnecunecujfgurhepfffhvffufggjfhfkgggtgfesth hqmhdttderjeenucfhrhhomhepfdftohifrghnucfvohhmmhhinhhsucglkffoufhorfgn fdcuoehimhhsohhprdhphhhpsehrfigvtgdrtghordhukheqnecuggftrfgrthhtvghrnh epheelffetiefgveduteefudegtdduveeludegueegleehiefhhefgtdekveevgfelnecu vehluhhsthgvrhfuihiivgeptdenucfrrghrrghmpehmrghilhhfrhhomhepihhmshhoph drphhhphesrhifvggtrdgtohdruhhk X-ME-Proxy: Feedback-ID: id5114917:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA for ; Sat, 18 May 2024 14:01:57 -0400 (EDT) Date: Sat, 18 May 2024 19:01:55 +0100 To: internals@lists.php.net Subject: Re: [PHP-DEV] [Discussion] "Internal" attribute and warning User-Agent: K-9 Mail for Android In-Reply-To: References: <69669f3c-8e9e-4f27-a171-6c341c1d67f7@rwec.co.uk> Message-ID: Precedence: bulk list-help: list-post: List-Id: internals.lists.php.net MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable From: imsop.php@rwec.co.uk ("Rowan Tommins [IMSoP]") On 18 May 2024 16:25:06 BST, Robert Landers = wrote: >I thought about that too, but in-general, a vendor has the knowledge >and capability to ensure any two packages work together (like Doctrine >plugins in your example)=2E How do they achieve that "knowledge and capability" other than documentati= on, and tooling making use of that documentation? Doctrine DBAL and Doctrine ORM are both large open-source codebases, which= happen to have a dependency relationship, and also happen to have the same= vendor namespace=2E Documentation and warnings about using internal functi= ons/classes of the DBAL would be just as useful to a developer of the ORM a= s they would be to an application developer=2E As another example, within the completely private codebase I work on profe= ssionally, we have shared modules, parts of which are intended to be implem= entation details and not subject to compatibility guarantees=2E It would be= really useful to get an automatic notification if those were used in other= parts of our codebase, but all of our code shares the same vendor namespac= e, so a single-level #[Internal] attribute would be entirely useless=2E=20 Rowan Tommins [IMSoP]