[PATCH 1/2] ref-manual: classes: kernel: remove incorrect sentence opening

[PATCH 1/2] ref-manual: classes: kernel: remove incorrect sentence opening

[Luca Ceresoli]

"This means that" implies that this sentence is a consequence of the
previous, but this is not the case, the two sentences being quite unrelated
to each other.

Signed-off-by: Luca Ceresoli <luca.ceresoli@bootlin.com>
---
 documentation/ref-manual/classes.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/documentation/ref-manual/classes.rst b/documentation/ref-manual/classes.rst
index a78368b380f6..de2d97de3038 100644
--- a/documentation/ref-manual/classes.rst
+++ b/documentation/ref-manual/classes.rst
@@ -1532,11 +1532,11 @@ code to build all kernel trees. All needed headers are staged into the
 :term:`STAGING_KERNEL_DIR` directory to allow out-of-tree module builds
 using the :ref:`ref-classes-module` class.
 
-This means that each built kernel module is packaged separately and
-inter-module dependencies are created by parsing the ``modinfo`` output.
-If all modules are required, then installing the ``kernel-modules``
-package installs all packages with modules and various other kernel
-packages such as ``kernel-vmlinux``.
+Each built kernel module is packaged separately and inter-module
+dependencies are created by parsing the ``modinfo`` output.  If all modules
+are required, then installing the ``kernel-modules`` package installs all
+packages with modules and various other kernel packages such as
+``kernel-vmlinux``.
 
 The :ref:`ref-classes-kernel` class contains logic that allows you to embed an initial
 RAM filesystem (:term:`Initramfs`) image when you build the kernel image. For
-- 
2.34.1

[PATCH 2/2] ref-manual: classes: kernel: document automatic defconfig usage

[Luca Ceresoli]

Since a very long time the kernel bbclass uses a defconfig file from
SRC_URI automatically. Document this feature.

Signed-off-by: Luca Ceresoli <luca.ceresoli@bootlin.com>
---
 documentation/ref-manual/classes.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/documentation/ref-manual/classes.rst b/documentation/ref-manual/classes.rst
index de2d97de3038..8f7cbf2b456e 100644
--- a/documentation/ref-manual/classes.rst
+++ b/documentation/ref-manual/classes.rst
@@ -1532,6 +1532,13 @@ code to build all kernel trees. All needed headers are staged into the
 :term:`STAGING_KERNEL_DIR` directory to allow out-of-tree module builds
 using the :ref:`ref-classes-module` class.
 
+If a file named ``defconfig`` is listed in :term:`SRC_URI`, then by default
+:ref:`ref-tasks-configure` copies it as ``.config`` in the build directory,
+so it is automatically used as the kernel configuration for the build. This
+copy is not performed in case ``.config`` already exists there: this allows
+recipes to produce a configuration by other means in
+``do_configure:prepend``.
+
 Each built kernel module is packaged separately and inter-module
 dependencies are created by parsing the ``modinfo`` output.  If all modules
 are required, then installing the ``kernel-modules`` package installs all
-- 
2.34.1

Re: [docs] [PATCH 2/2] ref-manual: classes: kernel: document automatic defconfig usage

[Michael Opdenacker]

On 05.05.23 at 11:10, Luca Ceresoli via lists.yoctoproject.org wrote:
> Since a very long time the kernel bbclass uses a defconfig file from
> SRC_URI automatically. Document this feature.
>
> Signed-off-by: Luca Ceresoli <luca.ceresoli@bootlin.com>


Hi Luca,

That's great to document this behavior. Good catch!
For both patches: Reviewed-by: Michael Opdenacker 
<michael.opdenacker@bootlin.com>
... and merged into "master-next".

Cheers
Michael.

-- 
Michael Opdenacker, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com

Re: [docs] [PATCH 2/2] ref-manual: classes: kernel: document automatic defconfig usage

[Michael Opdenacker]

Hi Luca,

On 05.05.23 at 17:10, Michael Opdenacker via lists.yoctoproject.org wrote:
>
> On 05.05.23 at 11:10, Luca Ceresoli via lists.yoctoproject.org wrote:
>> Since a very long time the kernel bbclass uses a defconfig file from
>> SRC_URI automatically. Document this feature.
>>
>> Signed-off-by: Luca Ceresoli <luca.ceresoli@bootlin.com>
>
>
> Hi Luca,
>
> That's great to document this behavior. Good catch!
> For both patches: Reviewed-by: Michael Opdenacker 
> <michael.opdenacker@bootlin.com>
> ... and merged into "master-next".


Oops, I realize you should run a few git commands to have a proper 
identity in your git commits.

See 
https://www.openembedded.org/wiki/How_to_submit_a_patch_to_OpenEmbedded#Fixing_your_From_identity

Don't need to send your patches again, I will fix your last two commits 
by myself.

Thanks in advance for next time.
Cheers
Michael.

-- 
Michael Opdenacker, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com

Re: [docs] [PATCH 2/2] ref-manual: classes: kernel: document automatic defconfig usage

[Luca Ceresoli]

Hi Mike,

On Fri, 5 May 2023 18:40:21 +0200
Michael Opdenacker <michael.opdenacker@bootlin.com> wrote:

> Hi Luca,
> 
> On 05.05.23 at 17:10, Michael Opdenacker via lists.yoctoproject.org wrote:
> >
> > On 05.05.23 at 11:10, Luca Ceresoli via lists.yoctoproject.org wrote:  
> >> Since a very long time the kernel bbclass uses a defconfig file from
> >> SRC_URI automatically. Document this feature.
> >>
> >> Signed-off-by: Luca Ceresoli <luca.ceresoli@bootlin.com>  
> >
> >
> > Hi Luca,
> >
> > That's great to document this behavior. Good catch!
> > For both patches: Reviewed-by: Michael Opdenacker 
> > <michael.opdenacker@bootlin.com>
> > ... and merged into "master-next".  
> 
> 
> Oops, I realize you should run a few git commands to have a proper 
> identity in your git commits.
> 
> See 
> https://www.openembedded.org/wiki/How_to_submit_a_patch_to_OpenEmbedded#Fixing_your_From_identity
> 
> Don't need to send your patches again, I will fix your last two commits 
> by myself.

My bad, I forgot to add --identity=yocto when running git send-email! I
now added it to the local git config for the various yocto
repositories, so it hopefully won't happen again.

> Thanks in advance for next time.

Thank you very much!

Cheers,
Luca

-- 
Luca Ceresoli, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com