diff options
Diffstat (limited to 'documentation/concepts-manual')
-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 | ||