<?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>4987</bug_id>
          
          <creation_ts>2013-08-06 10:14:53 +0000</creation_ts>
          <short_desc>Document version requirements in RDEPENDS etc</short_desc>
          <delta_ts>2013-09-18 22:07:11 +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>1.5</version>
          <rep_platform>All</rep_platform>
          <op_sys>Multiple</op_sys>
          <bug_status>RESOLVED</bug_status>
          <resolution>FIXED</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard>18 September 2013: RESOLVED</status_whiteboard>
          <keywords></keywords>
          <priority>Medium</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>1.5</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Ross Burton">ross.burton</reporter>
          <assigned_to name="Scott Rifenbark">srifenbark</assigned_to>
          <cc>bluelightning</cc>
    
    <cc>poky.doc.watcher</cc>
    
    <cc>poky.watcher</cc>
    
    <cc>ross.burton</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>35414</commentid>
    <comment_count>0</comment_count>
    <who name="Ross Burton">ross.burton</who>
    <bug_when>2013-08-06 10:14:53 +0000</bug_when>
    <thetext>It&apos;s possible to specify versions in the RDEPENDS (etc) fields, for example:

RDEPENDS_${PN} = &quot;foo (&gt;= 1.2)&quot;

We should clearly document this syntax and all of the operators involved.

CC&apos;ing Paul as hopefully he knows where to look to get the full list of supported expressions.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>35417</commentid>
    <comment_count>1</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2013-08-06 10:34:53 +0000</bug_when>
    <thetext>Get me the options and I will get this in. 

Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>35424</commentid>
    <comment_count>2</comment_count>
    <who name="Ross Burton">ross.burton</who>
    <bug_when>2013-08-06 14:04:37 +0000</bug_when>
    <thetext>Mark kindly commented on the thread which spawned this bug:


The format for RDEPENDS is slightly different from all three [packaging systems].

dep (= ver)
dep (&lt; ver)
dep (&gt; ver)
dep (&lt;= ver)
dep (&gt;= ver)

Hopefully the operators are fairly self-explanatory.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>35604</commentid>
    <comment_count>3</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2013-08-13 06:14:56 +0000</bug_when>
    <thetext>Ross, 

I don&apos;t get the last comment.  It implies different syntax forms for different packaging systems.  However, the list shows the standard Boolean logical operators from which I can&apos;t discern any differences based on package types.

Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>35609</commentid>
    <comment_count>4</comment_count>
    <who name="Ross Burton">ross.burton</who>
    <bug_when>2013-08-13 08:20:00 +0000</bug_when>
    <thetext>Sorry, my quoting was a bit too tight.

Each of the possible packaging formats has a different syntax for dependencies, but we hide that from the user.  The table in comment 2 is the syntax for versioned dependencies that bitbake supports.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>36828</commentid>
    <comment_count>5</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2013-09-17 23:05:43 +0000</bug_when>
    <thetext>Ross, 

Check out the last part for the RDEPENDS variable at http://www.yoctoproject.org/docs/1.5/ref-manual/ref-manual.html#var-RDEPENDS.  Let me know if this covers it.  Once we are okay with it, you can indicate the other variables that need the same explanation.  I am assuming that is what you meant by &quot;etc&quot; in your comment.  I imagine DEPENDS would be one of them.

Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>36854</commentid>
    <comment_count>6</comment_count>
    <who name="Ross Burton">ross.burton</who>
    <bug_when>2013-09-18 10:20:52 +0000</bug_when>
    <thetext>By &quot;etc&quot; I meant the other runtime dependences, so RCONFLICTS RRECOMMENDS RREPLACES.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>36880</commentid>
    <comment_count>7</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2013-09-18 15:12:06 +0000</bug_when>
    <thetext>Ross, 

Thanks for the clarification.  Can you &quot;okay&quot; the RDEPENDS section changes first then or send me feedback on them?  Once I have those solid I will make similar changes to the other R* variables.

Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>36905</commentid>
    <comment_count>8</comment_count>
    <who name="Ross Burton">ross.burton</who>
    <bug_when>2013-09-18 18:50:50 +0000</bug_when>
    <thetext>Sorry, meant to put that in my reply too.  The new material is great.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>36915</commentid>
    <comment_count>9</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2013-09-18 22:07:11 +0000</bug_when>
    <thetext>Hi, 

I have added similar wordings to the RCONFLICTS, RREPLACES, and RRECOMMENDS variables to support versioned specification of a package.  The wording was &quot;okayed&quot; for RDEPENDS so I am marking this bug RESOLVED.

If you want to look at the final stuff see:

http://www.yoctoproject.org/docs/1.5/ref-manual/ref-manual.html#var-RCONFLICTS
http://www.yoctoproject.org/docs/1.5/ref-manual/ref-manual.html#var-RREPLACES
http://www.yoctoproject.org/docs/1.5/ref-manual/ref-manual.html#var-RRECOMMENDS
http://www.yoctoproject.org/docs/1.5/ref-manual/ref-manual.html#var-RDEPENDS

Scott</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>