Bug 11762

Summary:	Lacking documentation on virtual providers
Product:	[Documentation] Reference	Reporter:	Jussi Kukkonen <jku>
Component:	handbook	Assignee:	Richard Purdie <richard.purdie>
Status:	RESOLVED FIXED	QA Contact:
Severity:	normal
Priority:	Medium	CC:	bluelightning, kristi, poky.doc.watcher, poky.watcher, ross.burton, srifenbark
Version:	unspecified
Target Milestone:	2.5 M3
Hardware:	x86
OS:	Multiple
Whiteboard:	23 March 2018: RESOLVED
OS type for building Yocto:	---	Type of Regression:	---
Verified:		Documentation change:	Done (doc changes complete)

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