4906 2013-07-25 07:06:25 +0000 Ensure all used DISTRO_FEATURES are documented 2013-07-25 12:25:17 +0000 1 1 9 Documentation Reference handbook unspecified All Multiple RESOLVED FIXED http://git.yoctoproject.org/cgit/cgit.cgi/yocto-docs/commit/?id=2e06fe0f8135c13d3a86857f9b0e450239cedbf4 25 July 2013: RESOLVED Undecided normal --- 1 lpapp srifenbark poky.doc.watcher poky.watcher ross.burton srifenbark --- --- --- oldest_to_newest 34839 0 lpapp 2013-07-25 07:06:25 +0000 I cannot find that poky distribution feature mentioned in the document, but I see it all around in projects: https://www.yoctoproject.org/docs/current/poky-ref-manual/poky-ref-manual.html 34842 1 ross.burton 2013-07-25 07:58:31 +0000 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. 34852 2 srifenbark 2013-07-25 08:28:31 +0000 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 34853 3 lpapp 2013-07-25 08:30:09 +0000 Hmm, interesting. I do not see opengl mentioned in there. 34854 4 ross.burton 2013-07-25 08:32:28 +0000 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. 34855 5 lpapp 2013-07-25 08:35:02 +0000 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. 34856 6 ross.burton 2013-07-25 08:43:30 +0000 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. 34860 7 lpapp 2013-07-25 08:48:28 +0000 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? :) 34861 8 ross.burton 2013-07-25 08:56:29 +0000 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. 34862 9 lpapp 2013-07-25 09:03:31 +0000 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. 34865 10 srifenbark 2013-07-25 09:10:40 +0000 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? 34872 11 lpapp 2013-07-25 09:34:20 +0000 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. 34886 12 srifenbark 2013-07-25 12:17:18 +0000 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 34887 13 lpapp 2013-07-25 12:22:01 +0000 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. 34888 14 lpapp 2013-07-25 12:23:43 +0000 Also, past mistakes are not excuse for repeating them. Anyway, you did not make me a fully happy user if that matters... ;-) 34890 15 lpapp 2013-07-25 12:25:17 +0000 bug 4913 submitted.