<?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>5386</bug_id>
          
          <creation_ts>2013-10-25 17:41:39 +0000</creation_ts>
          <short_desc>Supported IMAGE_FSTYPES are not precisely documented</short_desc>
          <delta_ts>2013-10-28 13:37:26 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>9</classification_id>
          <classification>Documentation</classification>
          <product>General Docs</product>
          <component>docs-general</component>
          <version>unspecified</version>
          <rep_platform>x86</rep_platform>
          <op_sys>Multiple</op_sys>
          <bug_status>RESOLVED</bug_status>
          <resolution>FIXED</resolution>
          
          
          <bug_file_loc>http://git.yoctoproject.org/cgit/cgit.cgi/yocto-docs/commit/?id=5961cde05aff967f8db7cd10cd9b46c147c62f83</bug_file_loc>
          <status_whiteboard>28 October 2013: RESOLVED</status_whiteboard>
          <keywords></keywords>
          <priority>Medium</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>1.6</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Laszlo Papp">lpapp</reporter>
          <assigned_to name="Scott Rifenbark">srifenbark</assigned_to>
          <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>38184</commentid>
    <comment_count>0</comment_count>
    <who name="Laszlo Papp">lpapp</who>
    <bug_when>2013-10-25 17:41:39 +0000</bug_when>
    <thetext>From the documentation below:

https://www.yoctoproject.org/docs/1.6/poky-ref-manual/poky-ref-manual.html#var-IMAGE_FSTYPES

You can read the following:

&quot;Specifies the formats of the root filesystem created by the OpenEmbedded build system. Available formats are a subset of the supported images listed in IMAGE_TYPES.&quot;

IMAGES_TYPES is documented good, but it is not clear what I can pick up from that list as the &quot;subset&quot; is a relative term here.

Based on the subset range, I would either write down the supported types explicitly for IMAGE_FSTYPES, or I would write out what is not contained by the subset.

Thank you in advance!</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>38188</commentid>
    <comment_count>1</comment_count>
    <who name="Saul Wold">sgw</who>
    <bug_when>2013-10-27 09:41:02 +0000</bug_when>
    <thetext>The subset is relative to the list in IMAGE_TYPES meaning that you would list the types you want created in IMAGE_FSTYPES for your target image.

Scott, I will be back on Tuesday and we can discuss this if you need.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>38189</commentid>
    <comment_count>2</comment_count>
    <who name="Laszlo Papp">lpapp</who>
    <bug_when>2013-10-27 09:52:51 +0000</bug_when>
    <thetext>OK, I see.

So, the sentence can be misunderstood just like I accidentally I did. I would suggest to clarify the sentence then based on your explanation.

The subset does not mean what is supported, but what the user can put in there, which can also be the complete list then, not just the subset.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>38207</commentid>
    <comment_count>3</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2013-10-28 13:11:23 +0000</bug_when>
    <thetext>Hi, 

The explanation was definitely ambiguous.  I have rewritten it to be clearer.  Let me know if this works.

http://www.yoctoproject.org/docs/1.6/ref-manual/ref-manual.html#var-IMAGE_FSTYPES

Thanks, 
Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>38208</commentid>
    <comment_count>4</comment_count>
    <who name="Laszlo Papp">lpapp</who>
    <bug_when>2013-10-28 13:15:25 +0000</bug_when>
    <thetext>Yes, this is better. I would give an example at least with two selected items to be more explicit, and also consistent with the variables (IMAGE_INSTALL, IMAGE_LINGUAS, IMAGE_NAME, etc) underneath this one in the documentation.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>38210</commentid>
    <comment_count>5</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2013-10-28 13:29:59 +0000</bug_when>
    <thetext>Laszlo, 

Good suggestions.  Try this on for size and let me know what you think.

http://www.yoctoproject.org/docs/1.6/ref-manual/ref-manual.html#var-IMAGES_FSTYPES.

Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>38213</commentid>
    <comment_count>6</comment_count>
    <who name="Laszlo Papp">lpapp</who>
    <bug_when>2013-10-28 13:31:53 +0000</bug_when>
    <thetext>Looks good. I am happy with that, thanks. :)</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>38214</commentid>
    <comment_count>7</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2013-10-28 13:37:26 +0000</bug_when>
    <thetext>Updated to RESOLVED.

Thanks, 
Scott</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>