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 99F9E139337 for ; Sun, 1 Aug 2021 04:58:13 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 3A191E099E; Sun, 1 Aug 2021 04:58:09 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) (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 14097E096B for ; Sun, 1 Aug 2021 04:58:07 +0000 (UTC) Subject: Re: [gentoo-dev] About the 'eapi' file in profile directories To: gentoo-dev@lists.gentoo.org References: <35f80c1a-ed6e-a231-d0ea-c69de7b9161f@gentoo.org> <9D494357-A100-4E3C-88F7-FFEE98AF4A3A@gentoo.org> From: Joshua Kinard Openpgp: preference=signencrypt Message-ID: Date: Sun, 1 Aug 2021 00:58:04 -0400 User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:60.0) Gecko/20100101 Thunderbird/60.9.1 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 In-Reply-To: <9D494357-A100-4E3C-88F7-FFEE98AF4A3A@gentoo.org> Content-Type: multipart/mixed; boundary="------------6F506F4F2D8C313129B196A0" Content-Language: en-US X-Archives-Salt: a3328b74-ec0b-49f3-bfd7-13aa0b3e5f13 X-Archives-Hash: 706a3a57c3c05aa866e80a8a0e8cafb5 This is a multi-part message in MIME format. --------------6F506F4F2D8C313129B196A0 Content-Type: text/plain; charset=windows-1252 Content-Transfer-Encoding: 7bit On 7/31/2021 22:02, Sam James wrote: > > >> On 1 Aug 2021, at 00:23, Joshua Kinard wrote: >> >>> [snip] >> >> Yeah, I found one mention in the Wiki[1], but not under "Profiles" in the >> devmanual[2]. The Wiki description doesn't say why that file is needed in >> every single subdirectory. >> >> [1] https://wiki.gentoo.org/wiki/Profile_(Portage)#Profile_structure >> [2] https://devmanual.gentoo.org/profiles/index.html >> >> That said, the PMS reference actually provides the clearest explanation. I >> think that language should be in the devmanual at [2], as it also explains >> the lack of inheritance. >> > > Does this PR [0] for the devmanual help a bit? Let me know if you have feedback > (either here or on GitHub is fine, I don't mind). > >> Okay, mystery solved. We'll have to someday revisit why this file can't be >> inherited, which would allow us to reduce the number of copies in the tree. >> > > Yeah, I think this is worth investigating. I've wondered the same thing before. > > [0] https://github.com/gentoo/devmanual/pull/240 > > best, > sam That does help, thanks! Let's go one further, though, and also add a mention of eapi, borrowing some of the lingo from PMS, since the file is so prolific. See the attached patch and let me know how the language looks. -- Joshua Kinard Gentoo/MIPS kumba@gentoo.org rsa6144/5C63F4E3F5C6C943 2015-04-27 177C 1972 1FB8 F254 BAD0 3E72 5C63 F4E3 F5C6 C943 "The past tempts us, the present confuses us, the future frightens us. And our lives slip away, moment by moment, lost in that vast, terrible in-between." --Emperor Turhan, Centauri Republic --------------6F506F4F2D8C313129B196A0 Content-Type: text/plain; charset=UTF-8; name="devmanual_add-eapi-info.patch" Content-Transfer-Encoding: 7bit Content-Disposition: attachment; filename="devmanual_add-eapi-info.patch" diff --git a/profiles/eapi/text.xml b/profiles/eapi/text.xml new file mode 100644 index 0000000..477ff24 --- /dev/null +++ b/profiles/eapi/text.xml @@ -0,0 +1,18 @@ + + + +Profiles <c>eapi</c> Files + + +

+An eapi file may be found in each profile directory. If present, this +file specifies the EAPI to use when handling the directory. Otherwise, EAPI 0 +will be used instead. The contents of the file is a single line specifying the +numeric value of the supported EAPI. This file is not inherited by parent +nor in subdirectories. +

+ + + + + diff --git a/profiles/text.xml b/profiles/text.xml index 3269d33..87a8358 100644 --- a/profiles/text.xml +++ b/profiles/text.xml @@ -19,6 +19,7 @@ are also documented in man portage. + --------------6F506F4F2D8C313129B196A0--