From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id DEACB138359 for ; Thu, 24 Sep 2020 00:06:47 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id BD557E081B; Thu, 24 Sep 2020 00:06:42 +0000 (UTC) Received: from smtp.gentoo.org (dev.gentoo.org [IPv6:2001:470:ea4a:1:5054:ff:fec7:86e4]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id 4A324E0802 for ; Thu, 24 Sep 2020 00:06:42 +0000 (UTC) Received: by smtp.gentoo.org (Postfix, from userid 2274) id 00393335D83; Thu, 24 Sep 2020 00:06:40 +0000 (UTC) Date: Wed, 23 Sep 2020 18:06:37 -0600 From: Tim Harder To: gentoo-dev@lists.gentoo.org Subject: [gentoo-dev] tagging deprecated eclasses internally Message-ID: <20200924000637.GA6343@fir> Mail-Followup-To: gentoo-dev@lists.gentoo.org Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-dev@lists.gentoo.org Reply-to: gentoo-dev@lists.gentoo.org X-Auto-Response-Suppress: DR, RN, NRN, OOF, AutoReply MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline X-Archives-Salt: 2242bf54-50d4-4ec2-b647-6f913970d5c5 X-Archives-Hash: d3bbba4f87277d9e1ddaf0cead74d6c0 In short, pkgcheck (in git) now supports parsing the eclass doc format as specified at [1] for the gentoo repo. This enables extracting more info from various eclass doc annotations. Along those lines, pkgcheck recognizes the '@DEPRECATED:' tag for all eclass doc block types. At the global level, this allows deprecated eclasses to internally document their status inside the '@ECLASS:' block, note their replacement (if any), and add further information if necessary. This allows for the hardcoded and poorly maintained eclass deprecation list in pkgcheck to be replaced by a dynamic version pulled from its eclass cache. If no one objects, I'd like to replace the deprecated-eclass section in metadata/qa-policy.conf with individual '@DEPRECATED:' annotations for the listed eclasses as well as adding info about the tag to the devmanual. Tim [1]: https://devmanual.gentoo.org/eclass-writing/#documenting-eclasses