Re: [gentoo-dev] Re: EAPI spec (was Re: Re: let's clear things up (was Slacker archs))

[Chris Gianelloni]

(Everything here is meant to be educational, not really commenting on
anything else.)

On Thu, 2007-02-22 at 12:04 -0800, Brian Harring wrote:
> Said spec covers profiles also; mentioning at least the existance of
> the misc STAGE* settings isn't a horrible idea, even if not going into
> detail- anyone digging through the profiles will see them, and likely
> wonder why they're there, and why quite a few profiles specify an
> extra set of use lists.

Some of the stuff in profiles, such as STAGE1_USE, isn't used by the
package manager in any way.  STAGE1_USE is used by nothing but catalyst,
and it does exactly what you think it does.  It doesn't stack (that
might be something worth mentioning) but it is inherited.
GRP_STAGE23_USE hasn't been used in catalyst for a very long time.
Again, this was the only thing that actually used it.

Of course, I'm always willing to help anyone understand any aspects of
the profiles that might be in question.  I can definitely tell you how
default-linux works.  I tend to leave the hardened/embedded/uclibc stuff
alone, except where I am positive what I'm doing won't affect them
adversely.

> While writing the sucker out, I'd expect you'll come across things
> where gentoo has a specific way of doing it, which isn't required by
> the manager.  The suggestion would be to track that somehow, or look
> at mangling the devmanual so that it's just diffs against the spec.

Well, the STAGE1_USE stuff you pointed out is a prime example.  Also,
STAGE1_USE is *not* required.  If it is empty, stage1 is built with
USE="build" and if it is actually populated, stage1 is built with
USE="build ${STAGE1_USE}".

As for USE, what I've been trying to do is the following:

default-linux - uhhh... defaults for all arches under Linux for releases

$arch - *very* generic USE additions for arch-specific stuff *only*

$relver - generic USE used to build the release... this would be the
equivalent of the old GRP_STAGE23_USE, since it is what stages 2 and 3
are built against

desktop/server - these are the massive USE that used to be in $relver
previously... since the stages aren't built against these, they can have
more stuff added to them without as harsh consequences... LiveCD-based
installs use the desktop profile for networkless installs

Essentially, as you go to the right down the stack, things get more
specific and adds more USE flags.

-- 
Chris Gianelloni
Release Engineering Strategic Lead
Alpha/AMD64/x86 Architecture Teams
Games Developer/Council Member/Foundation Trustee
Gentoo Foundation