summaryrefslogtreecommitdiffstats
path: root/documentation/concepts-manual
diff options
context:
space:
mode:
authorScott Rifenbark <srifenbark@gmail.com>2018-02-23 16:51:18 -0800
committerRichard Purdie <richard.purdie@linuxfoundation.org>2018-03-03 08:35:25 +0000
commitc6f2b40f1d50d0772f2c78f0e4046628ffc1aaea (patch)
tree3ad3914df3470d567423b470a41e769bfdf8da33 /documentation/concepts-manual
parentbb4ab5a65305b5bafdbdfe2ebf907dbde19368bf (diff)
downloadpoky-c6f2b40f1d50d0772f2c78f0e4046628ffc1aaea.tar.gz
concepts-manual, dev-manual: Moved the virtual providers to dev-manual
This topic was deemed unfit for concepts so I moved it to the dev-manual and rewrote it to be "Using Virtual Providers". (From yocto-docs rev: df7d48ac4fcf7ece75681ccf0bbb5699f7ff5ea6) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/concepts-manual')
-rw-r--r--documentation/concepts-manual/concepts-manual-concepts.xml63
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