Bug 11762 - Lacking documentation on virtual providers
Summary: Lacking documentation on virtual providers
Status: RESOLVED FIXED
Alias: None
Product: Reference
Classification: Documentation
Component: handbook (show other bugs)
Version: unspecified
Hardware: x86 Multiple
: Medium normal
Target Milestone: 2.5 M3
Assignee: Richard Purdie
QA Contact:
URL:
Whiteboard: 23 March 2018: RESOLVED
Depends on:
Blocks:
 
Reported: 2017-07-06 13:13 UTC by Jussi Kukkonen
Modified: 2018-03-23 11:42 UTC (History)
6 users (show)

See Also:
OS type for building Yocto: ---
Type of Regression: ---
Verified:
Documentation change: Done (doc changes complete)


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Jussi Kukkonen 2017-07-06 13:13:16 UTC
We don't attempt to explicitly explain what a specific "virtual/something" actually provides. In most cases this is fairly obvious but especially around OpenGL this is not so. We should try and document some of them

The ones that I think should have an explanation, and some guesses to start with:

* virtual/mesa
  Provides gbm.pc      <- no idea where we expect this to come with really ???
* virtual/egl:
  Provides egl.pc and _possibly_ wayland-egl.pc  <- I guess ???
* virtual/libgl:
  Provides gl.pc (meaning libGL)
* virtual/libgles1
  Provides glesv1_cm.pc (meaning libGLESv1_CM)
* virtual/libgles2
  Provides glesv2.pc (meaning libGLESv2)


Another question: Should we add "virtual/gbm" or ask TI folks to do it if they think their fork is compatible enough?
Comment 1 Scott Rifenbark 2017-07-06 15:21:42 UTC
Assigning to Kristi.  Set Person days.

Scott
Comment 2 Kristi 2017-08-31 21:56:06 UTC
Creating a new section.
Comment 3 Kristi 2017-09-06 23:03:21 UTC
I've created a new "Metadata (Virtual Providers)" section to the ref-manual for review here: http://www.yoctoproject.org/docs/2.4/ref-manual/ref-manual.html#metadata-virtual-providers

Please take a look at the concept paragraph, and bulleted list. I essentially copied the list provided, so please provide additional detail as necessary and I will update. 

Additionally, if there are others to explain, let me know and I will update the list. 

Thanks!
Kristi
Comment 4 Stephen K Jolley 2018-01-11 16:19:46 UTC
Richard,

Please review and comment.
Comment 5 Scott Rifenbark 2018-03-23 11:42:05 UTC
This issue is done... see https://www.yoctoproject.org/docs/2.5/dev-manual/dev-manual.html#metadata-virtual-providers.  

Setting to RESOLVED and putting the Doc flag to "Done"

Scott