From 424567d629b08785a6594d16427ee0fa8c31f384 Mon Sep 17 00:00:00 2001 From: Nicolas Dechesne Date: Mon, 27 Jul 2020 17:38:09 +0200 Subject: sphinx: manual updates for some links Some links were not found by the regexp, especially because of they are spanning across multiple lines. This patch is a manual fixup for these patterns. (From yocto-docs rev: 7a5cf8b372903d959d4a1f0882e6198f31f3cba5) Signed-off-by: Nicolas Dechesne Signed-off-by: Richard Purdie --- documentation/bsp-guide/bsp.rst | 30 ++++++++++++++---------------- 1 file changed, 14 insertions(+), 16 deletions(-) (limited to 'documentation/bsp-guide') diff --git a/documentation/bsp-guide/bsp.rst b/documentation/bsp-guide/bsp.rst index e06b1259f0..361951b592 100644 --- a/documentation/bsp-guide/bsp.rst +++ b/documentation/bsp-guide/bsp.rst @@ -74,12 +74,12 @@ section in the Yocto Project Development Tasks Manual. The BSP layer's base directory (``meta-bsp_root_name``) is the root directory of that Layer. This directory is what you add to the :term:`BBLAYERS` variable in the -``conf/bblayers.conf`` file found in your `Build -Directory <&YOCTO_DOCS_REF_URL;#build-directory>`__, which is +``conf/bblayers.conf`` file found in your +:term:`Build Directory`, which is established after you run the OpenEmbedded build environment setup script (i.e. ````` <&YOCTO_DOCS_REF_URL;#structure-core-script>`__). -Adding the root directory allows the `OpenEmbedded build -system <&YOCTO_DOCS_REF_URL;#build-system-term>`__ to recognize the BSP +Adding the root directory allows the :term:`OpenEmbedded Build System` +to recognize the BSP layer and from it build an image. Here is an example: BBLAYERS ?= " \\ /usr/local/src/yocto/meta \\ /usr/local/src/yocto/meta-poky \\ /usr/local/src/yocto/meta-yocto-bsp \\ /usr/local/src/yocto/meta-mylayer @@ -144,8 +144,7 @@ section. machine that uses CROPS. 2. *Clone the ``poky`` Repository:* You need to have a local copy of the - Yocto Project `Source - Directory <&YOCTO_DOCS_REF_URL;#source-directory>`__ (i.e. a local + Yocto Project :term:`Source Directory` (i.e. a local ``poky`` repository). See the "`Cloning the ``poky`` Repository <&YOCTO_DOCS_DEV_URL;#cloning-the-poky-repository>`__" and possibly the "`Checking Out by Branch in @@ -169,8 +168,7 @@ section. file. 1. *Navigate to Your Source Directory:* Typically, you set up the - ``meta-intel`` Git repository inside the `Source - Directory <&YOCTO_DOCS_REF_URL;#source-directory>`__ (e.g. + ``meta-intel`` Git repository inside the :term:`Source Directory` (e.g. ``poky``). $ cd /home/you/poky 2. *Clone the Layer:* $ git clone @@ -218,10 +216,10 @@ section. ````` <&YOCTO_DOCS_REF_URL;#structure-core-script>`__ environment setup script to define the OpenEmbedded build environment on your build host. $ source OE_INIT_FILE Among other things, the script - creates the `Build - Directory <&YOCTO_DOCS_REF_URL;#build-directory>`__, which is - ``build`` in this case and is located in the `Source - Directory <&YOCTO_DOCS_REF_URL;#source-directory>`__. After the + creates the + :term:`Build Directory`, which is + ``build`` in this case and is located in the :term:`Source Directory`. + After the script runs, your current working directory is set to the ``build`` directory. @@ -629,8 +627,8 @@ types of files although, in practice, it is likely that you would have one or the other. For your BSP, you typically want to use an existing Yocto Project kernel -recipe found in the `Source -Directory <&YOCTO_DOCS_REF_URL;#source-directory>`__ at +recipe found in the :term:`Source Directory` +at ``meta/recipes-kernel/linux``. You can append machine-specific changes to the kernel recipe by using a similarly named append file, which is located in the BSP Layer for your target device (e.g. the @@ -848,8 +846,8 @@ Yocto Project: - *File System Layout:* When possible, use the same directory names in your BSP layer as listed in the ``recipes.txt`` file, which is found - in ``poky/meta`` directory of the `Source - Directory <&YOCTO_DOCS_REF_URL;#source-directory>`__ or in the + in ``poky/meta`` directory of the :term:`Source Directory` + or in the OpenEmbedded-Core Layer (``openembedded-core``) at ` `__. -- cgit v1.2.3-54-g00ecf