summaryrefslogtreecommitdiff
path: root/poky/documentation/kernel-dev/kernel-dev-intro.rst
diff options
context:
space:
mode:
Diffstat (limited to 'poky/documentation/kernel-dev/kernel-dev-intro.rst')
-rw-r--r--poky/documentation/kernel-dev/kernel-dev-intro.rst25
1 files changed, 11 insertions, 14 deletions
diff --git a/poky/documentation/kernel-dev/kernel-dev-intro.rst b/poky/documentation/kernel-dev/kernel-dev-intro.rst
index 21d43d5e8..309c65b4d 100644
--- a/poky/documentation/kernel-dev/kernel-dev-intro.rst
+++ b/poky/documentation/kernel-dev/kernel-dev-intro.rst
@@ -1,11 +1,9 @@
-.. SPDX-License-Identifier: CC-BY-2.0-UK
+.. SPDX-License-Identifier: CC-BY-SA-2.0-UK
************
Introduction
************
-.. _kernel-dev-overview:
-
Overview
========
@@ -23,13 +21,13 @@ Each Yocto Project release has a set of Yocto Linux kernel recipes,
whose Git repositories you can view in the Yocto
:yocto_git:`Source Repositories <>` under the "Yocto Linux Kernel"
heading. New recipes for the release track the latest Linux kernel
-upstream developments from http://www.kernel.org> and introduce
+upstream developments from https://www.kernel.org and introduce
newly-supported platforms. Previous recipes in the release are refreshed
and supported for at least one additional Yocto Project release. As they
align, these previous releases are updated to include the latest from
the Long Term Support Initiative (LTSI) project. You can learn more
-about Yocto Linux kernels and LTSI in the ":ref:`Yocto Project Kernel
-Development and Maintenance <kernel-big-picture>`" section.
+about Yocto Linux kernels and LTSI in the
+":ref:`kernel-dev/kernel-dev-concepts-appx:yocto project kernel development and maintenance`" section.
Also included is a Yocto Linux kernel development recipe
(``linux-yocto-dev.bb``) should you want to work with the very latest in
@@ -37,8 +35,8 @@ upstream Yocto Linux kernel development and kernel Metadata development.
.. note::
- For more on Yocto Linux kernels, see the "
- Yocto Project Kernel Development and Maintenance
+ For more on Yocto Linux kernels, see the
+ ":ref:`kernel-dev/kernel-dev-concepts-appx:yocto project kernel development and maintenance`"
section.
The Yocto Project also provides a powerful set of kernel tools for
@@ -75,7 +73,7 @@ tools with your own kernel sources.
The remainder of this manual provides instructions for completing
specific Linux kernel development tasks. These instructions assume you
are comfortable working with
-`BitBake <http://openembedded.org/wiki/Bitbake>`__ recipes and basic
+`BitBake <https://openembedded.org/wiki/Bitbake>`__ recipes and basic
open-source development tools. Understanding these concepts will
facilitate the process of working with the kernel recipes. If you find
you need some additional background, please be sure to review and
@@ -158,8 +156,7 @@ general information and references for further information.
.. note::
- Try to resist the temptation to directly edit an existing
- .config
+ Try to resist the temptation to directly edit an existing ``.config``
file, which is found in the Build Directory among the source code
used for the build. Doing so, can produce unexpected results when
the OpenEmbedded build system regenerates the configuration file.
@@ -167,9 +164,9 @@ general information and references for further information.
Once you are satisfied with the configuration changes made using
``menuconfig`` and you have saved them, you can directly compare the
resulting ``.config`` file against an existing original and gather
- those changes into a `configuration fragment
- file <#creating-config-fragments>`__ to be referenced from within the
- kernel's ``.bbappend`` file.
+ those changes into a
+ :ref:`configuration fragment file <kernel-dev/kernel-dev-common:creating configuration fragments>` to be
+ referenced from within the kernel's ``.bbappend`` file.
Additionally, if you are working in a BSP layer and need to modify
the BSP's kernel's configuration, you can use ``menuconfig``.