Hello,

The INITRAMFS_IMAGE_BUNDLE glossary entry gets caught up in implementation details and doesn't make it clear that this variable is simply an on/off switch for creating a kernel image with the initramfs bundled inside it. The description of the implementation details are hard to understand too (I had to stare at it for a long time).

I suggest the following changes:

1. Rewrite

     Using an extra compilation pass ensures that when a kernel attempts
     to use an initramfs, it does not encounter circular dependencies should
     the initramfs include kernel modules.

   to

     Using an extra compilation pass to bundle the initramfs avoids a circular
     dependency between the kernel recipe and the initramfs recipe in case
     the initramfs includes kernel modules. In that case, the initramfs recipe
     depends on the kernel for the kernel modules, and the kernel on the
     initramfs recipe since it bundles in the initramfs inside the kernel image.


2. Turn the rewritten part into a Note.


3. Rewrite

     Setting the variable to "1" in a configuration file causes the
     OpenEmbedded build system to make the extra pass during kernel
     compilation:

   to

     Setting the variable to "1" in a configuration file causes the
     OpenEmbedded build system to generate a kernel image with the
     initramfs specified in INITRAMFS_IMAGE bundled inside it.


4. Change

     INITRAMFS_IMAGE_BUNDLE = ""

   to

     INITRAMFS_IMAGE_BUNDLE ?= ""

   This matches what kernel.bbclass actually does.