diff options
Diffstat (limited to 'documentation/concepts-manual/concepts-manual-concepts.xml')
| -rw-r--r-- | documentation/concepts-manual/concepts-manual-concepts.xml | 63 |
1 files changed, 0 insertions, 63 deletions
diff --git a/documentation/concepts-manual/concepts-manual-concepts.xml b/documentation/concepts-manual/concepts-manual-concepts.xml index fb02e2b512..0d01372c2e 100644 --- a/documentation/concepts-manual/concepts-manual-concepts.xml +++ b/documentation/concepts-manual/concepts-manual-concepts.xml | |||
| @@ -153,67 +153,6 @@ | |||
| 153 | </para> | 153 | </para> |
| 154 | </section> | 154 | </section> |
| 155 | 155 | ||
| 156 | <section id='metadata-virtual-providers'> | ||
| 157 | <title>Metadata (Virtual Providers)</title> | ||
| 158 | |||
| 159 | <para> | ||
| 160 | Prior to the build, if you know that several different recipes | ||
| 161 | provide the same functionality, you can use a virtual provider | ||
| 162 | (i.e. <filename>virtual/*</filename>) as a placeholder for the | ||
| 163 | actual provider. | ||
| 164 | The actual provider would be determined at build time. | ||
| 165 | In this case, you should add <filename>virtual/*</filename> | ||
| 166 | to | ||
| 167 | <ulink url='&YOCTO_DOCS_REF_URL;#var-DEPENDS'><filename>DEPENDS</filename></ulink>, | ||
| 168 | rather than listing the specified provider. | ||
| 169 | You would select the actual provider by setting the | ||
| 170 | <ulink url='&YOCTO_DOCS_REF_URL;#var-PREFERRED_PROVIDER'><filename>PREFERRED_PROVIDER</filename></ulink> | ||
| 171 | variable (i.e. | ||
| 172 | <filename>PREFERRED_PROVIDER_virtual/*</filename>) | ||
| 173 | in the build's configuration file (e.g. | ||
| 174 | <filename>poky/build/conf/local.conf</filename>). | ||
| 175 | <note> | ||
| 176 | Any recipe that | ||
| 177 | <ulink url='&YOCTO_DOCS_REF_URL;#var-PROVIDES'><filename>PROVIDES</filename></ulink> | ||
| 178 | a <filename>virtual/*</filename> item that is ultimately | ||
| 179 | not selected through | ||
| 180 | <filename>PREFERRED_PROVIDER</filename> does not get built. | ||
| 181 | Preventing these recipes from building is usually the | ||
| 182 | desired behavior since this mechanism's purpose is to | ||
| 183 | select between mutually exclusive alternative providers. | ||
| 184 | </note> | ||
| 185 | </para> | ||
| 186 | |||
| 187 | <para> | ||
| 188 | The following lists specific examples of virtual providers: | ||
| 189 | <itemizedlist> | ||
| 190 | <listitem><para> | ||
| 191 | <filename>virtual/mesa</filename>: | ||
| 192 | Provides <filename>gbm.pc</filename>. | ||
| 193 | </para></listitem> | ||
| 194 | <listitem><para> | ||
| 195 | <filename>virtual/egl</filename>: | ||
| 196 | Provides <filename>egl.pc</filename> and possibly | ||
| 197 | <filename>wayland-egl.pc</filename>. | ||
| 198 | </para></listitem> | ||
| 199 | <listitem><para> | ||
| 200 | <filename>virtual/libgl</filename>: | ||
| 201 | Provides <filename>gl.pc</filename> (i.e. libGL). | ||
| 202 | </para></listitem> | ||
| 203 | <listitem><para> | ||
| 204 | <filename>virtual/libgles1</filename>: | ||
| 205 | Provides <filename>glesv1_cm.pc</filename> | ||
| 206 | (i.e. libGLESv1_CM). | ||
| 207 | </para></listitem> | ||
| 208 | <listitem><para> | ||
| 209 | <filename>virtual/libgles2</filename>: | ||
| 210 | Provides <filename>glesv2.pc</filename> | ||
| 211 | (i.e. libGLESv2). | ||
| 212 | </para></listitem> | ||
| 213 | </itemizedlist> | ||
| 214 | </para> | ||
| 215 | </section> | ||
| 216 | |||
| 217 | <section id='concepts-components-classes'> | 156 | <section id='concepts-components-classes'> |
| 218 | <title>Classes</title> | 157 | <title>Classes</title> |
| 219 | 158 | ||
| @@ -248,8 +187,6 @@ | |||
| 248 | </section> | 187 | </section> |
| 249 | </section> | 188 | </section> |
| 250 | 189 | ||
| 251 | |||
| 252 | |||
| 253 | <section id="development-concepts"> | 190 | <section id="development-concepts"> |
| 254 | <title>Development Concepts</title> | 191 | <title>Development Concepts</title> |
| 255 | 192 | ||
