From b7693b7321bbc3f973d0f805a0da0b3469c10e7d Mon Sep 17 00:00:00 2001 From: Michael Opdenacker Date: Tue, 23 Nov 2021 09:30:12 +0100 Subject: manuals: add hyperlinks to files in meta-skeleton This makes the manuals easier to use. Note the care to keep the paths visible, so that people reading a printed version still know where to find the files. (From yocto-docs rev: 501917f65530f14ea686b69d6e96407c3f970a28) Signed-off-by: Michael Opdenacker Signed-off-by: Richard Purdie --- documentation/kernel-dev/advanced.rst | 11 +++++------ documentation/kernel-dev/common.rst | 20 ++++++++------------ 2 files changed, 13 insertions(+), 18 deletions(-) (limited to 'documentation/kernel-dev') diff --git a/documentation/kernel-dev/advanced.rst b/documentation/kernel-dev/advanced.rst index 2dbcca60c1..5a6b466ffb 100644 --- a/documentation/kernel-dev/advanced.rst +++ b/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 +` +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. diff --git a/documentation/kernel-dev/common.rst b/documentation/kernel-dev/common.rst index d42ca5f99a..a5dd02ccf2 100644 --- a/documentation/kernel-dev/common.rst +++ b/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 +`. 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 +`. 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 -- cgit v1.2.3-54-g00ecf