diff options
Diffstat (limited to 'poky/documentation/kernel-dev')
-rw-r--r-- | poky/documentation/kernel-dev/advanced.rst | 17 | ||||
-rw-r--r-- | poky/documentation/kernel-dev/common.rst | 20 | ||||
-rw-r--r-- | poky/documentation/kernel-dev/concepts-appx.rst | 4 | ||||
-rw-r--r-- | poky/documentation/kernel-dev/faq.rst | 4 |
4 files changed, 20 insertions, 25 deletions
diff --git a/poky/documentation/kernel-dev/advanced.rst b/poky/documentation/kernel-dev/advanced.rst index 2dbcca60c1..b5290b61b3 100644 --- a/poky/documentation/kernel-dev/advanced.rst +++ b/poky/documentation/kernel-dev/advanced.rst @@ -688,12 +688,11 @@ Recipe-Space Metadata --------------------- When stored in recipe-space, the kernel Metadata files reside in a -directory hierarchy below -:term:`FILESEXTRAPATHS`. For -a linux-yocto recipe or for a Linux kernel recipe derived by copying and -modifying -``oe-core/meta-skeleton/recipes-kernel/linux/linux-yocto-custom.bb`` to -a recipe in your layer, :term:`FILESEXTRAPATHS` is typically set to +directory hierarchy below :term:`FILESEXTRAPATHS`. For +a linux-yocto recipe or for a Linux kernel recipe derived by copying +:oe_git:`meta-skeleton/recipes-kernel/linux/linux-yocto-custom.bb +</openembedded-core/tree/meta-skeleton/recipes-kernel/linux/linux-yocto-custom.bb>` +into your layer and modifying it, :term:`FILESEXTRAPATHS` is typically set to ``${``\ :term:`THISDIR`\ ``}/${``\ :term:`PN`\ ``}``. See the ":ref:`kernel-dev/common:modifying an existing recipe`" section for more information. @@ -764,7 +763,7 @@ Organizing Your Source ====================== Many recipes based on the ``linux-yocto-custom.bb`` recipe use Linux -kernel sources that have only a single branch - "master". This type of +kernel sources that have only a single branch. This type of repository structure is fine for linear development supporting a single machine and architecture. However, if you work with multiple boards and architectures, a kernel source repository with multiple branches is more @@ -773,7 +772,7 @@ board to boot. Sometimes, these patches are works-in-progress or fundamentally wrong, yet they are still necessary for specific boards. In these situations, you most likely do not want to include these patches in every kernel you build (i.e. have the patches as part of the -lone "master" branch). It is situations like these that give rise to +default branch). It is situations like these that give rise to multiple branches used within a Linux kernel sources Git repository. Here are repository organization strategies maximizing source reuse, @@ -813,7 +812,7 @@ Machine Branches When you have multiple machines and architectures to support, or you are actively working on board support, it is more efficient to create branches in the repository based on individual machines. Having machine -branches allows common source to remain in the "master" branch with any +branches allows common source to remain in the development branch with any features specific to a machine stored in the appropriate machine branch. This organization method frees you from continually reintegrating your patches into a feature. diff --git a/poky/documentation/kernel-dev/common.rst b/poky/documentation/kernel-dev/common.rst index d42ca5f99a..a5dd02ccf2 100644 --- a/poky/documentation/kernel-dev/common.rst +++ b/poky/documentation/kernel-dev/common.rst @@ -1578,13 +1578,11 @@ Maintaining format compatibility facilitates converging with linux-yocto on a future, mutually-supported kernel version. To help you use your own sources, the Yocto Project provides a -linux-yocto custom recipe (``linux-yocto-custom.bb``) that uses -``kernel.org`` sources and the Yocto Project Linux kernel tools for -managing kernel Metadata. You can find this recipe in the ``poky`` Git -repository of the Yocto Project :yocto_git:`Source Repository <>` -at:: - - poky/meta-skeleton/recipes-kernel/linux/linux-yocto-custom.bb +linux-yocto custom recipe that uses ``kernel.org`` sources and +the Yocto Project Linux kernel tools for managing kernel Metadata. +You can find this recipe in the ``poky`` Git repository: +:yocto_git:`meta-skeleton/recipes-kernel/linux/linux-yocto-custom.bb +</poky/tree/meta-skeleton/recipes-kernel/linux/linux-yocto-custom.bb>`. Here are some basic steps you can use to work with your own sources: @@ -1729,11 +1727,9 @@ Linux kernel sources, if you need an external kernel module, the create your own out-of-tree Linux kernel module recipe. This template recipe is located in the ``poky`` Git repository of the -Yocto Project :yocto_git:`Source Repository <>` at: - -.. code-block:: none - - poky/meta-skeleton/recipes-kernel/hello-mod/hello-mod_0.1.bb +Yocto Project: +:yocto_git:`meta-skeleton/recipes-kernel/hello-mod/hello-mod_0.1.bb +</poky/tree/meta-skeleton/recipes-kernel/hello-mod/hello-mod_0.1.bb>`. To get started, copy this recipe to your layer and give it a meaningful name (e.g. ``mymodule_1.0.bb``). In the same directory, create a new diff --git a/poky/documentation/kernel-dev/concepts-appx.rst b/poky/documentation/kernel-dev/concepts-appx.rst index cf2e75d853..910318e0f9 100644 --- a/poky/documentation/kernel-dev/concepts-appx.rst +++ b/poky/documentation/kernel-dev/concepts-appx.rst @@ -211,8 +211,8 @@ view, there is a linear path that travels from the baseline ``kernel.org``, through a select group of features and ends with their BSP-specific commits. In other words, the divisions of the kernel are transparent and are not relevant to the developer on a day-to-day basis. -From the developer's perspective, this path is the "master" branch in -Git terms. The developer does not need to be aware of the existence of +From the developer's perspective, this path is the development branch. +The developer does not need to be aware of the existence of any other branches at all. Of course, it can make sense to have these branches in the tree, should a person decide to explore them. For example, a comparison between two BSPs at either the commit level or at diff --git a/poky/documentation/kernel-dev/faq.rst b/poky/documentation/kernel-dev/faq.rst index 5aa702ad69..e40e3ff372 100644 --- a/poky/documentation/kernel-dev/faq.rst +++ b/poky/documentation/kernel-dev/faq.rst @@ -30,8 +30,8 @@ Refer to the ":ref:`kernel-dev/common:working with your own sources`" section for information. -How do I install/not-install the kernel image on the rootfs? ------------------------------------------------------------- +How do I install/not-install the kernel image on the root filesystem? +--------------------------------------------------------------------- The kernel image (e.g. ``vmlinuz``) is provided by the ``kernel-image`` package. Image recipes depend on ``kernel-base``. To |