<?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>14515</bug_id>
          
          <creation_ts>2021-08-18 05:43:49 +0000</creation_ts>
          <short_desc>Some distro features missing from documentation</short_desc>
          <delta_ts>2023-03-22 17:13:54 +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>unspecified</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>4.2 M1</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Frans Meulenbroeks">fransmeulenbroeks</reporter>
          <assigned_to name="Michael Opdenacker">michael.opdenacker</assigned_to>
          <cc>jdelbe.foss</cc>
    
    <cc>poky.doc.watcher</cc>
    
    <cc>poky.watcher</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>91205</commentid>
    <comment_count>0</comment_count>
    <who name="Frans Meulenbroeks">fransmeulenbroeks</who>
    <bug_when>2021-08-18 05:43:49 +0000</bug_when>
    <thetext>Some distro features are not documented.

E.g. poky/meta/conf/distro/include/default-distrovars.inc contains
DISTRO_FEATURES_DEFAULT ?= &quot;acl alsa argp bluetooth ext2 ipv4 ipv6 largefile pcmcia usbgadget usbhost wifi xattr nfs zeroconf pci 3g nfc x11 vfat&quot;

However the reference manual ch 12.2 does not describe the following from that list:
acl
argp
ipv4
largefile
xattr
zeeroconf
3g
nfc
vfat

It might be that more ditro features are missing from the manual.
I did not verify if all features that are mentioned in 12.2 are indeed still all there, but it might be worthwhile to check those too.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>91217</commentid>
    <comment_count>1</comment_count>
    <who name="Randy MacLeod">randy.macleod</who>
    <bug_when>2021-08-19 14:46:53 +0000</bug_when>
    <thetext>We could document the DFs that is used in oe-core.
Documenting that a complete list of DFs is not in scope since other layers can add distro features. Please note this in the manual to help people understand.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>94043</commentid>
    <comment_count>2</comment_count>
    <who name="Michael Opdenacker">michael.opdenacker</who>
    <bug_when>2022-09-21 15:06:02 +0000</bug_when>
    <thetext>Why not adding the distro features defined in Poky too?

meta-poky/conf/distro/poky.conf:POKY_DEFAULT_DISTRO_FEATURES = &quot;largefile opengl ptest multiarch wayland vulkan&quot;
meta-poky/conf/distro/poky.conf:DISTRO_FEATURES ?= &quot;${DISTRO_FEATURES_DEFAULT} ${POKY_DEFAULT_DISTRO_FEATURES}&quot;</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>94045</commentid>
    <comment_count>3</comment_count>
    <who name="Michael Opdenacker">michael.opdenacker</who>
    <bug_when>2022-09-21 20:27:49 +0000</bug_when>
    <thetext>Posted a patch to address this issue:
https://lists.yoctoproject.org/g/docs/message/3201</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>94104</commentid>
    <comment_count>4</comment_count>
    <who name="Michael Opdenacker">michael.opdenacker</who>
    <bug_when>2022-10-06 07:49:40 +0000</bug_when>
    <thetext>Now fixed in master:
https://git.yoctoproject.org/yocto-docs/commit/?id=0db0560a7906b75eaa1b611092ad0f6444fb2fc6</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>95175</commentid>
    <comment_count>5</comment_count>
    <who name="Julien Delbergue">jdelbe.foss</who>
    <bug_when>2023-03-22 11:57:07 +0000</bug_when>
    <thetext>&quot;argp&quot; seems to be still missing from the documentation.
A small description would be helpful, as I am not sure what the feature brings. Thanks!</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>95176</commentid>
    <comment_count>6</comment_count>
    <who name="Michael Opdenacker">michael.opdenacker</who>
    <bug_when>2023-03-22 16:35:51 +0000</bug_when>
    <thetext>Good catch!
I asked the question on the Poky mailing list:
https://lists.yoctoproject.org/g/poky/message/13042</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>95177</commentid>
    <comment_count>7</comment_count>
    <who name="Michael Opdenacker">michael.opdenacker</who>
    <bug_when>2023-03-22 17:13:54 +0000</bug_when>
    <thetext>argp is no longer in use, not even in the &quot;kirkstone&quot; branch of Poky (and apparently not even in &quot;dunfell&quot;.
No need to document &quot;argp&quot; then.
Thanks anyway for asking!</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>