where to add a couple things related to kernel metadata?

"Robert P. J. Day" <[email protected]>
Newsgroups org.yoctoproject.lists.docs
Message-ID <[email protected]>
  still poring over the docs and a couple questions about whether to
add some content, and where.

  first, in the entire kernel metadata syntax section:

https://docs.yoctoproject.org/kernel-dev/advanced.html#kernel-metadata-syntax

i don't see anything that explains that in a .scc file, the "include"
directive can take a directory as an argument (which would recursively
consume all .scc files within). a few examples from kernel-meta:

bsp/intel-x86/intel-x86-32-standard.scc:include ktypes/standard
bsp/intel-x86/intel-x86-32-preempt-rt.scc:include ktypes/preempt-rt
bsp/intel-x86/intel-x86-64-preempt-rt.scc:include ktypes/preempt-rt
bsp/intel-x86/intel-x86-64-standard.scc:include ktypes/standard
bsp/minnow/minnow-preempt-rt.scc:include ktypes/preempt-rt
bsp/minnow/minnow-tiny.scc:include ktypes/tiny
bsp/minnow/minnow-standard.scc:include ktypes/standard
... etc etc ...

i guess one could just add that to the final reference section there:

https://docs.yoctoproject.org/kernel-dev/advanced.html#scc-description-file-reference

but that seems like devaluing it as a cheap afterthought, and it seems
like it merits more than that.

  and second, there is no real explanation that the "include"
directive can also take arguments of "nocfg" and/or "inherit"
(examples under "kernel-meta/ktypes"):

preempt-rt/preempt-rt.scc:include ktypes/developer/developer.scc nocfg
tiny/tiny.scc:include ktypes/standard/standard.scc nocfg inherit

the only mention of those attributes is as part of a code snippet
here:

https://docs.yoctoproject.org/kernel-dev/advanced.html#kernel-types

but it seems like that also needs more explanation than just showing
up as a comment in a code snippet.

  thoughts?

rday
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.