The set of DISTRO_FEATURES in use and the set in the documentation doesn't exactly match.  At least one example is missing:

opengl: Whether the distribution should support OpenGL.

There are likely to be a few more, I'll do some greppage shortly.

I have added this feature to the list of features the user can add through the DISTRO_FEATURES variable.  You can see the change at http://www.yoctoproject.org/docs/1.5/ref-manual/ref-manual.html#ref-features-distro.

Scott

Hmm, interesting. I do not see opengl mentioned in there.

In between nfs and pci:

"opengl: Include the Open Graphics Library, which is a cross-language, multi-platform application programming interface used for rendering two and three-dimensional graphics."

You may have a stale cache if you can't see it.

I did use F5 so it probably required some time to sync up.

I see now, but I still do not understand the comment though. What does it mean "including". Also, what library exactly, et cetera?

Is that also good for ES, or that is a separate variable? Which opengl version? Or it is global? I think it would need a bit more clarification than just a short line.

DISTRO_FEATURES are high level, so "opengl" means "some form of OpenGL".  The library/libraries/versions used depends on the machine.

There is a known ambiguity about the meaning of the feature, currently it means "any form of GL".  Yes, there is work to be done to express the finer details of machines where both GL and GLES are available but GL is preferred over GLES (eg Pine View) or GLES over GL (eg Cedar View).  However, this isn't relevant here, the DISTRO_FEATURE is "OpenGL" without specifying a version or library.

I believe it is relevant to know the details about something that you are supposed to use. Please extend the documentation as much as possible.

Yes, we would know that there is an "opengl" feature, but would not be entirely sure what it means with the documentation currently available.

This is what the review is for, to catch such issues, right? :)

Are you suggesting a table of every machine (according to the layer index, that's 150-200) and every available GL implementation available?  That's going to be ... rather large.  And changing all the time.

The DISTRO_FEATURE just means "OpenGL support".  What that means at a concrete library/version level is up to the machine definition, as that is where the virtual/opengl etc providers are defined.

No, I mean clear documentation which can be a reference to virtual/opengl as well for further details. That reference is not present at the moment.

Help me understand this a bit more... Are you looking for a linked reference to some other area on the Web?  If so, can someone point me to where the best reference for virtual/opengl would be?

I am fine with raw text reference if you cannot find an online url, but something has to be there to know where to read about details.

I am marking this particular bug RESOLVED.  I will plan on creating a separate section that provides some details on GL details.  This new section transcends this bug as it is against mentioning opengl as a supported distro feature.  Including it in the list and providing a description that conforms to similar feature descriptions is good enough here.

Scott

Should I reopen this one or create a new one with the same issue?

Again, I do not really understand without further details what this feature is for. Seriously, go to #opengl, and ask around if you do not trust me.

Also, past mistakes are not excuse for repeating them.

Anyway, you did not make me a fully happy user if that matters... ;-)

bug 4913 submitted.