On 7/31/2021 22:02, Sam James wrote: > > >> On 1 Aug 2021, at 00:23, Joshua Kinard <ku...@gentoo.org> 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 ku...@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
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 @@ +<?xml version="1.0"?> +<guide self="profiles/eapi/"> +<chapter> +<title>Profiles <c>eapi</c> Files</title> +<body> + +<p> +An <c>eapi</c> 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 <c>parent</c> +nor in subdirectories. +</p> + +</body> +</chapter> +</guide> + 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 <c>man portage</c>. </chapter> <include href="categories/"/> +<include href="eapi/"/> <include href="info_files/"/> <include href="make.defaults/"/> <include href="package.mask/"/>
