<?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>15235</bug_id>
          
          <creation_ts>2023-10-12 11:53:19 +0000</creation_ts>
          <short_desc>Opening line in dev manual, &quot;Unpacking Code&quot; is potentially confusing</short_desc>
          <delta_ts>2025-05-15 18:27:35 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>9</classification_id>
          <classification>Documentation</classification>
          <product>Development Manual</product>
          <component>development</component>
          <version>unspecified</version>
          <rep_platform>All</rep_platform>
          <op_sys>Multiple</op_sys>
          <bug_status>RESOLVED</bug_status>
          <resolution>WORKSFORME</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard></status_whiteboard>
          <keywords></keywords>
          <priority>Medium</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>5.2</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Robert P. J. Day">rpjday</reporter>
          <assigned_to name="Robert P. J. Day">rpjday</assigned_to>
          <cc>michael.opdenacker</cc>
    
    <cc>randy.macleod</cc>
          
          
          <cf_os>---</cf_os>
          <cf_regression_type>---</cf_regression_type>
          
          <cf_docchange>Yes (doc changes required)</cf_docchange>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>96681</commentid>
    <comment_count>0</comment_count>
    <who name="Robert P. J. Day">rpjday</who>
    <bug_when>2023-10-12 11:53:19 +0000</bug_when>
    <thetext></thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>96682</commentid>
    <comment_count>1</comment_count>
    <who name="Robert P. J. Day">rpjday</who>
    <bug_when>2023-10-12 11:56:35 +0000</bug_when>
    <thetext>Here, https://docs.yoctoproject.org/dev-manual/new-recipe.html#unpacking-code, the opening line:

&quot;During the build, the do_unpack task unpacks the source with ${S} pointing to where it is unpacked.&quot;

could very easily be misinterpreted as suggesting that the variable S will be set automatically to where the code is unpacked, rather than making it clear that it is the recipe author&apos;s responsibility to set that variable to where the code is unpacked (if it is not the default location). This section can be much shorter and clearer.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>99069</commentid>
    <comment_count>2</comment_count>
    <who name="Randy MacLeod">randy.macleod</who>
    <bug_when>2024-05-23 15:26:50 +0000</bug_when>
    <thetext>Rob, could you just send a patch to see what people think of the new wording?</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>100095</commentid>
    <comment_count>3</comment_count>
    <who name="Randy MacLeod">randy.macleod</who>
    <bug_when>2024-10-31 15:09:24 +0000</bug_when>
    <thetext>Bulk move of 5.1 bugs to 5.2. -- YP bug review (Randy)</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>101963</commentid>
    <comment_count>4</comment_count>
    <who name="Randy MacLeod">randy.macleod</who>
    <bug_when>2025-05-15 18:27:35 +0000</bug_when>
    <thetext>I think that YP devs are aware of the abstractions that we use and
that this statement is not confusing unless you&apos;re really just getting started
with YP and if so, you have lots of other &apos;confusing&apos; things to puzzle out.</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>