Re: [gentoo-dev] About the 'eapi' file in profile directories

[Joshua Kinard]

On 7/31/2021 22:02, Sam James wrote:
>
>
>> On 1 Aug 2021, at 00:23, Joshua Kinard <kumba@g.o> 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@g.o
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