<?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>10135</bug_id>
          
          <creation_ts>2016-08-12 14:14:01 +0000</creation_ts>
          <short_desc>Some small mostly package-related nits</short_desc>
          <delta_ts>2016-08-12 21:49:34 +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>12 July 2016: RESOLVED</status_whiteboard>
          <keywords></keywords>
          <priority>Undecided</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>poky.doc.watcher</cc>
    
    <cc>poky.watcher</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>65127</commentid>
    <comment_count>0</comment_count>
    <who name="">ulfalizer</who>
    <bug_when>2016-08-12 14:14:01 +0000</bug_when>
    <thetext>Some small mostly package-related nits

Hello! Some small (too small for separate bugs) documentation nits below:


* The FILES variable is closely linked to the PACKAGES variable, but
the FILES glossary entry does not mention it at all. The first sentence of the
FILES glossary entry could be replaced by this:

  The list of files and directories that are placed in a package. The
  [PACKAGES] variable lists the packages generated by a recipe.


* The FILES glossary entry has a path with a redundant &apos;/&apos; at the end. This is
a personal pet peeve because it means you often end up with ugly stuff like
&quot;//&quot;, plus people start thinking all directory paths have to end with &apos;/&apos;.
Here&apos;s the fixed version:

  FILES_${PN} += &quot;${bindir}/mydir1 ${bindir}/mydir2/myfile&quot;


* In &apos;2.3.3. Running Specific Tasks&apos;, instead of saying &quot;any given package
consists of a set of tasks&quot;, it would be better to say &quot;any given recipe
consists of a set of tasks&quot;. People often confuse packages and recipes.


* There&apos;s another redundant &apos;/&apos; in &apos;5.3.18.3. Makefile-Based Package&apos; in the
development manual. Instead of

  S = &quot;${WORKDIR}/git/&quot;

it could just say

  S = &quot;${WORKDIR}/git&quot;


Cheers,
Ulf</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>65158</commentid>
    <comment_count>1</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2016-08-12 21:15:13 +0000</bug_when>
    <thetext>Hi, 

See http://www.yoctoproject.org/docs/2.2/ref-manual/ref-manual.html#var-FILES for the changes to the FILES glossary entry

See http://www.yoctoproject.org/docs/2.2/ref-manual/ref-manual.html#usingpoky-debugging-taskrunning for the change to &quot;Running Specific Tasks&quot; section.

See http://www.yoctoproject.org/docs/2.2/dev-manual/dev-manual.html#new-recipe-makefile-based-package for the change in the dev-manual.

Thanks, 
Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>65159</commentid>
    <comment_count>2</comment_count>
    <who name="">ulfalizer</who>
    <bug_when>2016-08-12 21:19:19 +0000</bug_when>
    <thetext>Looks good to me.

Thanks,
Ulf</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>65167</commentid>
    <comment_count>3</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2016-08-12 21:49:34 +0000</bug_when>
    <thetext>Awesome!

Setting to RESOLVED and turning the flag off for docs.

scott</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>