<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<!DOCTYPE bugzilla SYSTEM "https://bugzilla.yoctoproject.org/page.cgi?id=bugzilla.dtd">

<bugzilla version="5.0.6"
          urlbase="https://bugzilla.yoctoproject.org/"
          
          maintainer="it-coreprojects-helpdesk@linuxfoundation.org"
>

    <bug>
          <bug_id>10011</bug_id>
          
          <creation_ts>2016-07-23 11:47:12 +0000</creation_ts>
          <short_desc>Suggested addition to the PROVIDES glossary entry to explain virtual targets</short_desc>
          <delta_ts>2016-07-29 21:10:01 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>9</classification_id>
          <classification>Documentation</classification>
          <product>Reference</product>
          <component>handbook</component>
          <version>2.2</version>
          <rep_platform>x86</rep_platform>
          <op_sys>Multiple</op_sys>
          <bug_status>RESOLVED</bug_status>
          <resolution>FIXED</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard></status_whiteboard>
          <keywords></keywords>
          <priority>Medium</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>2.2 M4</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter>ulfalizer</reporter>
          <assigned_to name="Scott Rifenbark">srifenbark</assigned_to>
          <cc>bluelightning</cc>
    
    <cc>poky.doc.watcher</cc>
    
    <cc>poky.watcher</cc>
    
    <cc>sgw</cc>
    
    <cc>srifenbark</cc>
          
          
          <cf_os>---</cf_os>
          <cf_regression_type>---</cf_regression_type>
          
          <cf_docchange>Done (doc changes complete)</cf_docchange>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>64385</commentid>
    <comment_count>0</comment_count>
    <who name="">ulfalizer</who>
    <bug_when>2016-07-23 11:47:12 +0000</bug_when>
    <thetext>There doesn&apos;t seem to be much documentation on virtual targets at the moment. I suggest adding the following to the end of the PROVIDES glossary entry in the Yocto Reference Manual and BitBake manual:

  In addition to providing recipes under alternate names, the PROVIDES
  mechanism is also used to implement &lt;i&gt;virtual targets&lt;/i&gt;. A virtual target
  is a name that corresponds to some particular functionality, e.g. a Linux
  kernel. Recipes that provide the functionality in question list the virtual
  target in PROVIDES. Recipes that depend on the functionality in question can
  include the virtual target in DEPENDS to leave the choice of provider open.
  
  Conventionally, virtual targets have names on the form &quot;virtual/function&quot;
  (e.g. &quot;virtual/kernel&quot;). The slash is simply part of the name and has no
  syntactic significance.
  
  The [PREFERRED_PROVIDER] variable is used to select which particular recipe
  provides a virtual target.

Cheers,
Ulf</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>64386</commentid>
    <comment_count>1</comment_count>
    <who name="">ulfalizer</who>
    <bug_when>2016-07-23 11:50:36 +0000</bug_when>
    <thetext>In the PREFERRED_PROVIDER glossary entry, the word &quot;provide&quot; in the opening sentence could be turned into a link as well:

  If multiple recipes [provide](http://www.yoctoproject.org/docs/2.2/ref-manual/ref-manual.html#var-PROVIDES) an item...</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>64669</commentid>
    <comment_count>2</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2016-07-29 17:14:59 +0000</bug_when>
    <thetext>Hi Ulf, 

See http://www.yoctoproject.org/docs/2.2/ref-manual/ref-manual.html#var-PROVIDES for the changes in the ref-manual.  When we settle on these, I will update the same variable in the BitBake User Manual.  I am going to wait though until we are good here.  

Regarding linking the normal work &quot;provides&quot;, I don&apos;t want to do that as I have not done that in the past.

Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>64674</commentid>
    <comment_count>3</comment_count>
    <who name="">ulfalizer</who>
    <bug_when>2016-07-29 18:53:53 +0000</bug_when>
    <thetext>Looks good to me.

Thanks,
Ulf</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>64681</commentid>
    <comment_count>4</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2016-07-29 21:10:01 +0000</bug_when>
    <thetext>Thanks Ulf, 

I am closing the bug.  Here is the link to the changed version in the BitBake manual now - http://www.yoctoproject.org/docs/2.2/bitbake-user-manual/bitbake-user-manual.html#var-PROVIDES.

Scott</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>