diff options
| author | Scott Rifenbark <srifenbark@gmail.com> | 2018-01-29 15:18:03 -0800 |
|---|---|---|
| committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2018-02-14 15:25:29 +0000 |
| commit | ae06e04cd225d2c2147ca355e2dd39b4f6cf6775 (patch) | |
| tree | c920e85262a91e7626279e7dcbbd56a299919f49 /documentation/getting-started/eclipse/html/getting-started/metadata-virtual-providers.html | |
| parent | ebc7de094881dd8f2450aa4fdf548f2e9c835df1 (diff) | |
| download | poky-ae06e04cd225d2c2147ca355e2dd39b4f6cf6775.tar.gz | |
documentation: Created new "Getting Started" manual.
Creation involved removing the overview-manual and replacing it
with the getting-started manual. All links to the string
"&YOCTO_DOCS_OVERVIEW_URL" had to be replaced with
"&YOCTO_DOCS_GS_URL" across the entire YP manual set. I renamed
files used to create the manual with prefixes suited for the
new manual name, which is "Getting Started With Yocto Project".
The style sheet for the new manual needed updating to display the
new .PNG image for the title page. The mega-manual file had to
be updated to include the files. The mega-manual.sed file had
to be updated to include the new manual and not use the overview
manual.
(From yocto-docs rev: 6c7abf9192390121000f577d6c98f259d290d15d)
Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/getting-started/eclipse/html/getting-started/metadata-virtual-providers.html')
| -rw-r--r-- | documentation/getting-started/eclipse/html/getting-started/metadata-virtual-providers.html | 74 |
1 files changed, 74 insertions, 0 deletions
diff --git a/documentation/getting-started/eclipse/html/getting-started/metadata-virtual-providers.html b/documentation/getting-started/eclipse/html/getting-started/metadata-virtual-providers.html new file mode 100644 index 0000000000..ebbae37990 --- /dev/null +++ b/documentation/getting-started/eclipse/html/getting-started/metadata-virtual-providers.html | |||
| @@ -0,0 +1,74 @@ | |||
| 1 | <html> | ||
| 2 | <head> | ||
| 3 | <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> | ||
| 4 | <title>3.1.3. Metadata (Virtual Providers)</title> | ||
| 5 | <link rel="stylesheet" type="text/css" href="../book.css"> | ||
| 6 | <meta name="generator" content="DocBook XSL Stylesheets V1.76.1"> | ||
| 7 | <link rel="home" href="index.html" title="Getting Started With Yocto Project"> | ||
| 8 | <link rel="up" href="yocto-project-components.html" title="3.1. Yocto Project Components"> | ||
| 9 | <link rel="prev" href="usingpoky-components-metadata.html" title="3.1.2. Metadata (Recipes)"> | ||
| 10 | <link rel="next" href="usingpoky-components-classes.html" title="3.1.4. Classes"> | ||
| 11 | </head> | ||
| 12 | <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="section" title="3.1.3. Metadata (Virtual Providers)"> | ||
| 13 | <div class="titlepage"><div><div><h3 class="title"> | ||
| 14 | <a name="metadata-virtual-providers"></a>3.1.3. Metadata (Virtual Providers)</h3></div></div></div> | ||
| 15 | <p> | ||
| 16 | Prior to the build, if you know that several different recipes | ||
| 17 | provide the same functionality, you can use a virtual provider | ||
| 18 | (i.e. <code class="filename">virtual/*</code>) as a placeholder for the | ||
| 19 | actual provider. | ||
| 20 | The actual provider would be determined at build time. | ||
| 21 | In this case, you should add <code class="filename">virtual/*</code> | ||
| 22 | to | ||
| 23 | <a class="link" href="../ref-manual/var-DEPENDS.html" target="_self"><code class="filename">DEPENDS</code></a>, | ||
| 24 | rather than listing the specified provider. | ||
| 25 | You would select the actual provider by setting the | ||
| 26 | <a class="link" href="../ref-manual/var-PREFERRED_PROVIDER.html" target="_self"><code class="filename">PREFERRED_PROVIDER</code></a> | ||
| 27 | variable (i.e. | ||
| 28 | <code class="filename">PREFERRED_PROVIDER_virtual/*</code>) | ||
| 29 | in the build's configuration file (e.g. | ||
| 30 | <code class="filename">poky/build/conf/local.conf</code>). | ||
| 31 | </p> | ||
| 32 | <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"> | ||
| 33 | <h3 class="title">Note</h3> | ||
| 34 | Any recipe that PROVIDES a <code class="filename">virtual/*</code> | ||
| 35 | item that is ultimately not selected through | ||
| 36 | <code class="filename">PREFERRED_PROVIDER</code> does not get built. | ||
| 37 | Preventing these recipes from building is usually the | ||
| 38 | desired behavior since this mechanism's purpose is to | ||
| 39 | select between mutually exclusive alternative providers. | ||
| 40 | </div> | ||
| 41 | <p> | ||
| 42 | </p> | ||
| 43 | <p> | ||
| 44 | The following lists specific examples of virtual providers: | ||
| 45 | </p> | ||
| 46 | <div class="itemizedlist"><ul class="itemizedlist" type="disc"> | ||
| 47 | <li class="listitem"><p> | ||
| 48 | <code class="filename">virtual/mesa</code>: | ||
| 49 | Provides <code class="filename">gbm.pc</code>. | ||
| 50 | </p></li> | ||
| 51 | <li class="listitem"><p> | ||
| 52 | <code class="filename">virtual/egl</code>: | ||
| 53 | Provides <code class="filename">egl.pc</code> and possibly | ||
| 54 | <code class="filename">wayland-egl.pc</code>. | ||
| 55 | </p></li> | ||
| 56 | <li class="listitem"><p> | ||
| 57 | <code class="filename">virtual/libgl</code>: | ||
| 58 | Provides <code class="filename">gl.pc</code> (i.e. libGL). | ||
| 59 | </p></li> | ||
| 60 | <li class="listitem"><p> | ||
| 61 | <code class="filename">virtual/libgles1</code>: | ||
| 62 | Provides <code class="filename">glesv1_cm.pc</code> | ||
| 63 | (i.e. libGLESv1_CM). | ||
| 64 | </p></li> | ||
| 65 | <li class="listitem"><p> | ||
| 66 | <code class="filename">virtual/libgles2</code>: | ||
| 67 | Provides <code class="filename">glesv2.pc</code> | ||
| 68 | (i.e. libGLESv2). | ||
| 69 | </p></li> | ||
| 70 | </ul></div> | ||
| 71 | <p> | ||
| 72 | </p> | ||
| 73 | </div></body> | ||
| 74 | </html> | ||