summaryrefslogtreecommitdiffstats
path: root/documentation/dev-manual
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/dev-manual')
-rw-r--r--documentation/dev-manual/dev-manual-common-tasks.rst220
-rw-r--r--documentation/dev-manual/dev-manual-intro.rst2
-rw-r--r--documentation/dev-manual/dev-manual-qemu.rst14
-rw-r--r--documentation/dev-manual/dev-manual-start.rst10
4 files changed, 0 insertions, 246 deletions
diff --git a/documentation/dev-manual/dev-manual-common-tasks.rst b/documentation/dev-manual/dev-manual-common-tasks.rst
index 23c2be4f44..706d5e7a64 100644
--- a/documentation/dev-manual/dev-manual-common-tasks.rst
+++ b/documentation/dev-manual/dev-manual-common-tasks.rst
@@ -160,8 +160,6 @@ Follow these general steps to create your layer without using tools:
160 Project <#making-sure-your-layer-is-compatible-with-yocto-project>`__" 160 Project <#making-sure-your-layer-is-compatible-with-yocto-project>`__"
161 section for more information. 161 section for more information.
162 162
163.. _best-practices-to-follow-when-creating-layers:
164
165Following Best Practices When Creating Layers 163Following Best Practices When Creating Layers
166--------------------------------------------- 164---------------------------------------------
167 165
@@ -457,8 +455,6 @@ file. During the processing of each ``conf/layer.conf`` file, BitBake
457adds the recipes, classes and configurations contained within the 455adds the recipes, classes and configurations contained within the
458particular layer to the source directory. 456particular layer to the source directory.
459 457
460.. _using-bbappend-files:
461
462Using .bbappend Files in Your Layer 458Using .bbappend Files in Your Layer
463----------------------------------- 459-----------------------------------
464 460
@@ -839,16 +835,12 @@ enables the build system to locate the layer during the build.
839 During a build, the OpenEmbedded build system looks in the layers 835 During a build, the OpenEmbedded build system looks in the layers
840 from the top of the list down to the bottom in that order. 836 from the top of the list down to the bottom in that order.
841 837
842.. _usingpoky-extend-customimage:
843
844Customizing Images 838Customizing Images
845================== 839==================
846 840
847You can customize images to satisfy particular requirements. This 841You can customize images to satisfy particular requirements. This
848section describes several methods and provides guidelines for each. 842section describes several methods and provides guidelines for each.
849 843
850.. _usingpoky-extend-customimage-localconf:
851
852Customizing Images Using ``local.conf`` 844Customizing Images Using ``local.conf``
853--------------------------------------- 845---------------------------------------
854 846
@@ -891,8 +883,6 @@ You can add packages using a similar approach through the
891``CORE_IMAGE_EXTRA_INSTALL`` variable. If you use this variable, only 883``CORE_IMAGE_EXTRA_INSTALL`` variable. If you use this variable, only
892``core-image-*`` images are affected. 884``core-image-*`` images are affected.
893 885
894.. _usingpoky-extend-customimage-imagefeatures:
895
896Customizing Images Using Custom ``IMAGE_FEATURES`` and ``EXTRA_IMAGE_FEATURES`` 886Customizing Images Using Custom ``IMAGE_FEATURES`` and ``EXTRA_IMAGE_FEATURES``
897------------------------------------------------------------------------------- 887-------------------------------------------------------------------------------
898 888
@@ -949,8 +939,6 @@ configures the image you are working with to include
949 Project Reference Manual for a complete list of image features that ship 939 Project Reference Manual for a complete list of image features that ship
950 with the Yocto Project. 940 with the Yocto Project.
951 941
952.. _usingpoky-extend-customimage-custombb:
953
954Customizing Images Using Custom .bb Files 942Customizing Images Using Custom .bb Files
955----------------------------------------- 943-----------------------------------------
956 944
@@ -977,8 +965,6 @@ image, copy the ``meta/recipes-sato/images/core-image-sato.bb`` to a new
977 965
978 IMAGE_INSTALL += "strace" 966 IMAGE_INSTALL += "strace"
979 967
980.. _usingpoky-extend-customimage-customtasks:
981
982Customizing Images Using Custom Package Groups 968Customizing Images Using Custom Package Groups
983---------------------------------------------- 969----------------------------------------------
984 970
@@ -1039,8 +1025,6 @@ build an image using these package group packages, you need to add
1039``IMAGE_INSTALL``. For other forms of image dependencies see the other 1025``IMAGE_INSTALL``. For other forms of image dependencies see the other
1040areas of this section. 1026areas of this section.
1041 1027
1042.. _usingpoky-extend-customimage-image-name:
1043
1044Customizing an Image Hostname 1028Customizing an Image Hostname
1045----------------------------- 1029-----------------------------
1046 1030
@@ -1080,8 +1064,6 @@ unsets the variable in a configuration file:
1080Having no default hostname in the filesystem is suitable for 1064Having no default hostname in the filesystem is suitable for
1081environments that use dynamic hostnames such as virtual machines. 1065environments that use dynamic hostnames such as virtual machines.
1082 1066
1083.. _new-recipe-writing-a-new-recipe:
1084
1085Writing a New Recipe 1067Writing a New Recipe
1086==================== 1068====================
1087 1069
@@ -1097,8 +1079,6 @@ how to create, write, and test a new recipe.
1097 ":ref:`ref-manual/ref-varlocality:recipes`" section of the Yocto Project 1079 ":ref:`ref-manual/ref-varlocality:recipes`" section of the Yocto Project
1098 Reference Manual. 1080 Reference Manual.
1099 1081
1100.. _new-recipe-overview:
1101
1102Overview 1082Overview
1103-------- 1083--------
1104 1084
@@ -1108,8 +1088,6 @@ The remainder of the section provides details for the steps.
1108.. image:: figures/recipe-workflow.png 1088.. image:: figures/recipe-workflow.png
1109 :align: center 1089 :align: center
1110 1090
1111.. _new-recipe-locate-or-automatically-create-a-base-recipe:
1112
1113Locate or Automatically Create a Base Recipe 1091Locate or Automatically Create a Base Recipe
1114-------------------------------------------- 1092--------------------------------------------
1115 1093
@@ -1130,8 +1108,6 @@ that can help you quickly get a start on a new recipe:
1130 For information on recipe syntax, see the 1108 For information on recipe syntax, see the
1131 ":ref:`dev-manual/dev-manual-common-tasks:recipe syntax`" section. 1109 ":ref:`dev-manual/dev-manual-common-tasks:recipe syntax`" section.
1132 1110
1133.. _new-recipe-creating-the-base-recipe-using-devtool:
1134
1135Creating the Base Recipe Using ``devtool add`` 1111Creating the Base Recipe Using ``devtool add``
1136~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 1112~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1137 1113
@@ -1147,8 +1123,6 @@ the ":ref:`sdk-manual/sdk-extensible:a closer look at \`\`devtool add\`\``" sect
1147in the Yocto Project Application Development and the Extensible Software 1123in the Yocto Project Application Development and the Extensible Software
1148Development Kit (eSDK) manual. 1124Development Kit (eSDK) manual.
1149 1125
1150.. _new-recipe-creating-the-base-recipe-using-recipetool:
1151
1152Creating the Base Recipe Using ``recipetool create`` 1126Creating the Base Recipe Using ``recipetool create``
1153~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 1127~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1154 1128
@@ -1213,8 +1187,6 @@ Following are some syntax examples:
1213 1187
1214 recipetool create -d -o OUTFILE source 1188 recipetool create -d -o OUTFILE source
1215 1189
1216.. _new-recipe-locating-and-using-a-similar-recipe:
1217
1218Locating and Using a Similar Recipe 1190Locating and Using a Similar Recipe
1219~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 1191~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1220 1192
@@ -1254,8 +1226,6 @@ get started. Here are some points on both methods:
1254 1226
1255 SRC_URI = "" 1227 SRC_URI = ""
1256 1228
1257.. _new-recipe-storing-and-naming-the-recipe:
1258
1259Storing and Naming the Recipe 1229Storing and Naming the Recipe
1260----------------------------- 1230-----------------------------
1261 1231
@@ -1298,8 +1268,6 @@ the recipe.
1298 gawk_4.0.2.bb 1268 gawk_4.0.2.bb
1299 irssi_0.8.16-rc1.bb 1269 irssi_0.8.16-rc1.bb
1300 1270
1301.. _new-recipe-running-a-build-on-the-recipe:
1302
1303Running a Build on the Recipe 1271Running a Build on the Recipe
1304----------------------------- 1272-----------------------------
1305 1273
@@ -1354,8 +1322,6 @@ You can find more information about the build process in
1354":doc:`../overview-manual/overview-manual-development-environment`" 1322":doc:`../overview-manual/overview-manual-development-environment`"
1355chapter of the Yocto Project Overview and Concepts Manual. 1323chapter of the Yocto Project Overview and Concepts Manual.
1356 1324
1357.. _new-recipe-fetching-code:
1358
1359Fetching Code 1325Fetching Code
1360------------- 1326-------------
1361 1327
@@ -1490,8 +1456,6 @@ compressed suffixes such as ``diff.gz`` and ``patch.bz2``, for example.
1490The build system automatically applies patches as described in the 1456The build system automatically applies patches as described in the
1491"`Patching Code <#new-recipe-patching-code>`__" section. 1457"`Patching Code <#new-recipe-patching-code>`__" section.
1492 1458
1493.. _new-recipe-unpacking-code:
1494
1495Unpacking Code 1459Unpacking Code
1496-------------- 1460--------------
1497 1461
@@ -1512,8 +1476,6 @@ If processing your recipe using BitBake successfully unpacks the source
1512files, you need to be sure that the directory pointed to by ``${S}`` 1476files, you need to be sure that the directory pointed to by ``${S}``
1513matches the structure of the source. 1477matches the structure of the source.
1514 1478
1515.. _new-recipe-patching-code:
1516
1517Patching Code 1479Patching Code
1518------------- 1480-------------
1519 1481
@@ -1539,8 +1501,6 @@ named the same as the base name of the recipe
1539(:term:`BP` and 1501(:term:`BP` and
1540:term:`BPN`) or "files". 1502:term:`BPN`) or "files".
1541 1503
1542.. _new-recipe-licensing:
1543
1544Licensing 1504Licensing
1545--------- 1505---------
1546 1506
@@ -1597,8 +1557,6 @@ variables:
1597 correct string that you can substitute into the recipe file for a 1557 correct string that you can substitute into the recipe file for a
1598 subsequent build. 1558 subsequent build.
1599 1559
1600.. _new-dependencies:
1601
1602Dependencies 1560Dependencies
1603------------ 1561------------
1604 1562
@@ -1645,8 +1603,6 @@ system will automatically add a runtime dependency to "mypackage" on
1645section in the Yocto Project Overview and Concepts Manual for further 1603section in the Yocto Project Overview and Concepts Manual for further
1646details. 1604details.
1647 1605
1648.. _new-recipe-configuring-the-recipe:
1649
1650Configuring the Recipe 1606Configuring the Recipe
1651---------------------- 1607----------------------
1652 1608
@@ -1741,8 +1697,6 @@ the software you are building, you can consult the output of the
1741``./configure --help`` command within ``${S}`` or consult the software's 1697``./configure --help`` command within ``${S}`` or consult the software's
1742upstream documentation. 1698upstream documentation.
1743 1699
1744.. _new-recipe-using-headers-to-interface-with-devices:
1745
1746Using Headers to Interface with Devices 1700Using Headers to Interface with Devices
1747--------------------------------------- 1701---------------------------------------
1748 1702
@@ -1802,8 +1756,6 @@ out-of-tree modules. Your recipe will also need the following:
1802 1756
1803 do_configure[depends] += "virtual/kernel:do_shared_workdir" 1757 do_configure[depends] += "virtual/kernel:do_shared_workdir"
1804 1758
1805.. _new-recipe-compilation:
1806
1807Compilation 1759Compilation
1808----------- 1760-----------
1809 1761
@@ -1867,8 +1819,6 @@ Here are some common issues that cause failures.
1867 ``STAGING_BINDIR``, ``STAGING_INCDIR``, ``STAGING_DATADIR``, and so 1819 ``STAGING_BINDIR``, ``STAGING_INCDIR``, ``STAGING_DATADIR``, and so
1868 forth). 1820 forth).
1869 1821
1870.. _new-recipe-installing:
1871
1872Installing 1822Installing
1873---------- 1823----------
1874 1824
@@ -1956,8 +1906,6 @@ installed correctly.
1956 files to ``${D}${datadir}/cmake/Modules`` during 1906 files to ``${D}${datadir}/cmake/Modules`` during
1957 :ref:`ref-tasks-install`. 1907 :ref:`ref-tasks-install`.
1958 1908
1959.. _new-recipe-enabling-system-services:
1960
1961Enabling System Services 1909Enabling System Services
1962------------------------ 1910------------------------
1963 1911
@@ -2009,8 +1957,6 @@ different ways:
2009 section for 1957 section for
2010 more information. 1958 more information.
2011 1959
2012.. _new-recipe-packaging:
2013
2014Packaging 1960Packaging
2015--------- 1961---------
2016 1962
@@ -2089,8 +2035,6 @@ take. The following list describes the process:
2089 target machine, particularly if you run separate builds for more than 2035 target machine, particularly if you run separate builds for more than
2090 one target machine. 2036 one target machine.
2091 2037
2092.. _new-sharing-files-between-recipes:
2093
2094Sharing Files Between Recipes 2038Sharing Files Between Recipes
2095----------------------------- 2039-----------------------------
2096 2040
@@ -2137,8 +2081,6 @@ For a more complete description of the
2137task and its associated functions, see the 2081task and its associated functions, see the
2138:ref:`staging <ref-classes-staging>` class. 2082:ref:`staging <ref-classes-staging>` class.
2139 2083
2140.. _metadata-virtual-providers:
2141
2142Using Virtual Providers 2084Using Virtual Providers
2143----------------------- 2085-----------------------
2144 2086
@@ -2251,8 +2193,6 @@ example:
2251 REALPV = "0.8.16-rc1" 2193 REALPV = "0.8.16-rc1"
2252 PV = "0.8.15+${REALPV}" 2194 PV = "0.8.15+${REALPV}"
2253 2195
2254.. _new-recipe-post-installation-scripts:
2255
2256Post-Installation Scripts 2196Post-Installation Scripts
2257------------------------- 2197-------------------------
2258 2198
@@ -2313,8 +2253,6 @@ script to first boot is undesirable and for read-only rootfs impossible.
2313 because of when they run, they are not applicable to being run at image 2253 because of when they run, they are not applicable to being run at image
2314 creation time like ``pkg_postinst``. 2254 creation time like ``pkg_postinst``.
2315 2255
2316.. _new-recipe-testing:
2317
2318Testing 2256Testing
2319------- 2257-------
2320 2258
@@ -2326,8 +2264,6 @@ For information on how to customize your image by adding specific
2326packages, see the "`Customizing 2264packages, see the "`Customizing
2327Images <#usingpoky-extend-customimage>`__" section. 2265Images <#usingpoky-extend-customimage>`__" section.
2328 2266
2329.. _new-recipe-testing-examples:
2330
2331Examples 2267Examples
2332-------- 2268--------
2333 2269
@@ -2344,8 +2280,6 @@ examples given various scenarios:
2344 2280
2345- Adding binaries to an image 2281- Adding binaries to an image
2346 2282
2347.. _new-recipe-single-c-file-package-hello-world:
2348
2349Single .c File Package (Hello World!) 2283Single .c File Package (Hello World!)
2350~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 2284~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
2351 2285
@@ -2382,8 +2316,6 @@ customize the packaging process, see the "`Splitting an Application into
2382Multiple Packages <#splitting-an-application-into-multiple-packages>`__" 2316Multiple Packages <#splitting-an-application-into-multiple-packages>`__"
2383section. 2317section.
2384 2318
2385.. _new-recipe-autotooled-package:
2386
2387Autotooled Package 2319Autotooled Package
2388~~~~~~~~~~~~~~~~~~ 2320~~~~~~~~~~~~~~~~~~
2389 2321
@@ -2413,8 +2345,6 @@ changes as described in the
2413the Yocto Project Overview and Concepts Manual. You can quickly create 2345the Yocto Project Overview and Concepts Manual. You can quickly create
2414Autotool-based recipes in a manner similar to the previous example. 2346Autotool-based recipes in a manner similar to the previous example.
2415 2347
2416.. _new-recipe-makefile-based-package:
2417
2418Makefile-Based Package 2348Makefile-Based Package
2419~~~~~~~~~~~~~~~~~~~~~~ 2349~~~~~~~~~~~~~~~~~~~~~~
2420 2350
@@ -2864,8 +2794,6 @@ in the BitBake User Manual.
2864 might wish to use. If in doubt, you should check with multiple 2794 might wish to use. If in doubt, you should check with multiple
2865 implementations - including those from BusyBox. 2795 implementations - including those from BusyBox.
2866 2796
2867.. _platdev-newmachine:
2868
2869Adding a New Machine 2797Adding a New Machine
2870==================== 2798====================
2871 2799
@@ -2885,8 +2813,6 @@ For a complete example that shows how to add a new machine, see the
2885section in the Yocto Project Board Support Package (BSP) Developer's 2813section in the Yocto Project Board Support Package (BSP) Developer's
2886Guide. 2814Guide.
2887 2815
2888.. _platdev-newmachine-conffile:
2889
2890Adding the Machine Configuration File 2816Adding the Machine Configuration File
2891------------------------------------- 2817-------------------------------------
2892 2818
@@ -2920,8 +2846,6 @@ You can find full details on these variables in the reference section.
2920You can leverage existing machine ``.conf`` files from 2846You can leverage existing machine ``.conf`` files from
2921``meta-yocto-bsp/conf/machine/``. 2847``meta-yocto-bsp/conf/machine/``.
2922 2848
2923.. _platdev-newmachine-kernel:
2924
2925Adding a Kernel for the Machine 2849Adding a Kernel for the Machine
2926------------------------------- 2850-------------------------------
2927 2851
@@ -2956,8 +2880,6 @@ For more information on ``defconfig`` files, see the
2956":ref:`kernel-dev/kernel-dev-common:changing the configuration`" 2880":ref:`kernel-dev/kernel-dev-common:changing the configuration`"
2957section in the Yocto Project Linux Kernel Development Manual. 2881section in the Yocto Project Linux Kernel Development Manual.
2958 2882
2959.. _platdev-newmachine-formfactor:
2960
2961Adding a Formfactor Configuration File 2883Adding a Formfactor Configuration File
2962-------------------------------------- 2884--------------------------------------
2963 2885
@@ -2990,8 +2912,6 @@ Following is an example for "qemuarm" machine:
2990 DISPLAY_DPI=150 2912 DISPLAY_DPI=150
2991 DISPLAY_SUBPIXEL_ORDER=vrgb 2913 DISPLAY_SUBPIXEL_ORDER=vrgb
2992 2914
2993.. _gs-upgrading-recipes:
2994
2995Upgrading Recipes 2915Upgrading Recipes
2996================= 2916=================
2997 2917
@@ -3011,8 +2931,6 @@ automatic version upgrades. Alternatively, you can use
3011``devtool upgrade`` to set up semi-automatic version upgrades. Finally, 2931``devtool upgrade`` to set up semi-automatic version upgrades. Finally,
3012you can manually upgrade a recipe by editing the recipe itself. 2932you can manually upgrade a recipe by editing the recipe itself.
3013 2933
3014.. _gs-using-the-auto-upgrade-helper:
3015
3016Using the Auto Upgrade Helper (AUH) 2934Using the Auto Upgrade Helper (AUH)
3017----------------------------------- 2935-----------------------------------
3018 2936
@@ -3207,8 +3125,6 @@ a cron job. See the
3207:yocto_git:`weeklyjob.sh </cgit/cgit.cgi/auto-upgrade-helper/tree/weeklyjob.sh>` 3125:yocto_git:`weeklyjob.sh </cgit/cgit.cgi/auto-upgrade-helper/tree/weeklyjob.sh>`
3208file distributed with the utility for an example. 3126file distributed with the utility for an example.
3209 3127
3210.. _gs-using-devtool-upgrade:
3211
3212Using ``devtool upgrade`` 3128Using ``devtool upgrade``
3213------------------------- 3129-------------------------
3214 3130
@@ -3350,8 +3266,6 @@ Using the ``devtool finish`` command cleans up the workspace and creates a patch
3350file based on your commits. The tool puts all patch files back into the 3266file based on your commits. The tool puts all patch files back into the
3351source directory in a sub-directory named ``nano`` in this case. 3267source directory in a sub-directory named ``nano`` in this case.
3352 3268
3353.. _dev-manually-upgrading-a-recipe:
3354
3355Manually Upgrading a Recipe 3269Manually Upgrading a Recipe
3356--------------------------- 3270---------------------------
3357 3271
@@ -3419,8 +3333,6 @@ To manually upgrade recipe versions, follow these general steps:
3419 builds work and any testing is successful, you can create commits for 3333 builds work and any testing is successful, you can create commits for
3420 any changes in the layer holding your upgraded recipe. 3334 any changes in the layer holding your upgraded recipe.
3421 3335
3422.. _finding-the-temporary-source-code:
3423
3424Finding Temporary Source Code 3336Finding Temporary Source Code
3425============================= 3337=============================
3426 3338
@@ -3491,8 +3403,6 @@ build system uses to build the package would be as follows:
3491 3403
3492 poky/build/tmp/work/qemux86-poky-linux/foo/1.3.0-r0 3404 poky/build/tmp/work/qemux86-poky-linux/foo/1.3.0-r0
3493 3405
3494.. _using-a-quilt-workflow:
3495
3496Using Quilt in Your Workflow 3406Using Quilt in Your Workflow
3497============================ 3407============================
3498 3408
@@ -3587,8 +3497,6 @@ Follow these general steps:
3587 3497
3588 SRC_URI += "file://my_changes.patch" 3498 SRC_URI += "file://my_changes.patch"
3589 3499
3590.. _platdev-appdev-devshell:
3591
3592Using a Development Shell 3500Using a Development Shell
3593========================= 3501=========================
3594 3502
@@ -3671,8 +3579,6 @@ terminal window.
3671 - It is also worth noting that ``devshell`` still works over X11 3579 - It is also worth noting that ``devshell`` still works over X11
3672 forwarding and similar situations. 3580 forwarding and similar situations.
3673 3581
3674.. _platdev-appdev-devpyshell:
3675
3676Using a Development Python Shell 3582Using a Development Python Shell
3677================================ 3583================================
3678 3584
@@ -3720,8 +3626,6 @@ controls what type of shell is opened.
3720When you are finished using ``devpyshell``, you can exit the shell 3626When you are finished using ``devpyshell``, you can exit the shell
3721either by using Ctrl+d or closing the terminal window. 3627either by using Ctrl+d or closing the terminal window.
3722 3628
3723.. _dev-building:
3724
3725Building 3629Building
3726======== 3630========
3727 3631
@@ -3729,8 +3633,6 @@ This section describes various build procedures. For example, the steps
3729needed for a simple build, a target that uses multiple configurations, 3633needed for a simple build, a target that uses multiple configurations,
3730building an image for more than one machine, and so forth. 3634building an image for more than one machine, and so forth.
3731 3635
3732.. _dev-building-a-simple-image:
3733
3734Building a Simple Image 3636Building a Simple Image
3735----------------------- 3637-----------------------
3736 3638
@@ -3833,8 +3735,6 @@ The following figure and list overviews the build process:
3833 information about how to install these images, see the documentation 3735 information about how to install these images, see the documentation
3834 for your particular board or machine. 3736 for your particular board or machine.
3835 3737
3836.. _dev-building-images-for-multiple-targets-using-multiple-configurations:
3837
3838Building Images for Multiple Targets Using Multiple Configurations 3738Building Images for Multiple Targets Using Multiple Configurations
3839------------------------------------------------------------------ 3739------------------------------------------------------------------
3840 3740
@@ -3848,8 +3748,6 @@ This section describes how to set up for multiple configuration builds
3848and how to account for cross-build dependencies between the 3748and how to account for cross-build dependencies between the
3849multiconfigs. 3749multiconfigs.
3850 3750
3851.. _dev-setting-up-and-running-a-multiple-configuration-build:
3852
3853Setting Up and Running a Multiple Configuration Build 3751Setting Up and Running a Multiple Configuration Build
3854~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 3752~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
3855 3753
@@ -3942,8 +3840,6 @@ Follow these steps to set up and execute multiple configuration builds:
3942 directories, the build either loads from an existing sstate cache for 3840 directories, the build either loads from an existing sstate cache for
3943 that build at the start or builds the object fresh. 3841 that build at the start or builds the object fresh.
3944 3842
3945.. _dev-enabling-multiple-configuration-build-dependencies:
3946
3947Enabling Multiple Configuration Build Dependencies 3843Enabling Multiple Configuration Build Dependencies
3948~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 3844~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
3949 3845
@@ -4003,8 +3899,6 @@ and have separate configuration files, BitBake places the artifacts for
4003each build in the respective temporary build directories (i.e. 3899each build in the respective temporary build directories (i.e.
4004:term:`TMPDIR`). 3900:term:`TMPDIR`).
4005 3901
4006.. _building-an-initramfs-image:
4007
4008Building an Initial RAM Filesystem (initramfs) Image 3902Building an Initial RAM Filesystem (initramfs) Image
4009---------------------------------------------------- 3903----------------------------------------------------
4010 3904
@@ -4095,8 +3989,6 @@ distribution to even smaller sizes than the ``poky-tiny`` distribution,
4095which is around 5 Mbytes, that can be built out-of-the-box using the 3989which is around 5 Mbytes, that can be built out-of-the-box using the
4096Yocto Project. 3990Yocto Project.
4097 3991
4098.. _tiny-system-overview:
4099
4100Tiny System Overview 3992Tiny System Overview
4101~~~~~~~~~~~~~~~~~~~~ 3993~~~~~~~~~~~~~~~~~~~~
4102 3994
@@ -4145,8 +4037,6 @@ very small distributions:
4145 information on how to create layers, see the "`Understanding and 4037 information on how to create layers, see the "`Understanding and
4146 Creating Layers <#understanding-and-creating-layers>`__" section. 4038 Creating Layers <#understanding-and-creating-layers>`__" section.
4147 4039
4148.. _understand-what-gives-your-image-size:
4149
4150Understand What Contributes to Your Image Size 4040Understand What Contributes to Your Image Size
4151~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 4041~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
4152 4042
@@ -4812,8 +4702,6 @@ that can help you speed up the build:
4812 the static libraries. If so, you might need to exclude them as 4702 the static libraries. If so, you might need to exclude them as
4813 well. 4703 well.
4814 4704
4815.. _platdev-working-with-libraries:
4816
4817Working With Libraries 4705Working With Libraries
4818====================== 4706======================
4819 4707
@@ -4889,8 +4777,6 @@ how the static library files are defined:
4889 SECTION_${PN}-staticdev = "devel" 4777 SECTION_${PN}-staticdev = "devel"
4890 RDEPENDS_${PN}-staticdev = "${PN}-dev (= ${EXTENDPKGV})" 4778 RDEPENDS_${PN}-staticdev = "${PN}-dev (= ${EXTENDPKGV})"
4891 4779
4892.. _combining-multiple-versions-library-files-into-one-image:
4893
4894Combining Multiple Versions of Library Files into One Image 4780Combining Multiple Versions of Library Files into One Image
4895----------------------------------------------------------- 4781-----------------------------------------------------------
4896 4782
@@ -5299,8 +5185,6 @@ The following know issues exist for GObject Introspection Support:
5299 under 32-bit host machines. In particular, "qemumips64" is known to 5185 under 32-bit host machines. In particular, "qemumips64" is known to
5300 not work under i686. 5186 not work under i686.
5301 5187
5302.. _dev-optionally-using-an-external-toolchain:
5303
5304Optionally Using an External Toolchain 5188Optionally Using an External Toolchain
5305====================================== 5189======================================
5306 5190
@@ -5368,8 +5252,6 @@ you need to have in place to run the tool, provides instruction on how
5368to use the Wic utility, provides information on using the Wic plugins 5252to use the Wic utility, provides information on using the Wic plugins
5369interface, and provides several examples that show how to use Wic. 5253interface, and provides several examples that show how to use Wic.
5370 5254
5371.. _wic-background:
5372
5373Background 5255Background
5374---------- 5256----------
5375 5257
@@ -5395,8 +5277,6 @@ this information is required to use Wic, you might find it interesting.
5395 general-purpose partitioning language, which is based on Redhat 5277 general-purpose partitioning language, which is based on Redhat
5396 kickstart syntax. 5278 kickstart syntax.
5397 5279
5398.. _wic-requirements:
5399
5400Requirements 5280Requirements
5401------------ 5281------------
5402 5282
@@ -5435,8 +5315,6 @@ system needs to meet the following requirements:
5435- Include the name of the :ref:`wic kickstart file <openembedded-kickstart-wks-reference>` 5315- Include the name of the :ref:`wic kickstart file <openembedded-kickstart-wks-reference>`
5436 as part of the :term:`WKS_FILE` variable 5316 as part of the :term:`WKS_FILE` variable
5437 5317
5438.. _wic-getting-help:
5439
5440Getting Help 5318Getting Help
5441------------ 5319------------
5442 5320
@@ -5610,8 +5488,6 @@ The general form of the ``wic`` command using Cooked Mode is as follows:
5610 name of the image to use the artifacts from e.g. core- 5488 name of the image to use the artifacts from e.g. core-
5611 image-sato 5489 image-sato
5612 5490
5613.. _using-a-provided-kickstart-file:
5614
5615Using an Existing Kickstart File 5491Using an Existing Kickstart File
5616-------------------------------- 5492--------------------------------
5617 5493
@@ -5661,8 +5537,6 @@ Here are the actual partition language commands used in the
5661 5537
5662 bootloader --ptable gpt --timeout=5 --append="rootfstype=ext4 console=ttyS0,115200 console=tty0" 5538 bootloader --ptable gpt --timeout=5 --append="rootfstype=ext4 console=ttyS0,115200 console=tty0"
5663 5539
5664.. _wic-using-the-wic-plugin-interface:
5665
5666Using the Wic Plugin Interface 5540Using the Wic Plugin Interface
5667------------------------------ 5541------------------------------
5668 5542
@@ -5802,8 +5676,6 @@ by filling up a dict with keys that contain the method names of
5802interest. On success, these will be filled in with the actual methods. 5676interest. On success, these will be filled in with the actual methods.
5803See the Wic implementation for examples and details. 5677See the Wic implementation for examples and details.
5804 5678
5805.. _wic-usage-examples:
5806
5807Wic Examples 5679Wic Examples
5808------------ 5680------------
5809 5681
@@ -5813,8 +5685,6 @@ utility. All the examples assume the list of requirements in the
5813examples assume the previously generated image is 5685examples assume the previously generated image is
5814``core-image-minimal``. 5686``core-image-minimal``.
5815 5687
5816.. _generate-an-image-using-a-provided-kickstart-file:
5817
5818Generate an Image using an Existing Kickstart File 5688Generate an Image using an Existing Kickstart File
5819~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 5689~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
5820 5690
@@ -6495,8 +6365,6 @@ Changing the listed common targets is as easy as editing your version of
6495``conf-notes.txt`` in your custom template configuration directory and 6365``conf-notes.txt`` in your custom template configuration directory and
6496making sure you have ``TEMPLATECONF`` set to your directory. 6366making sure you have ``TEMPLATECONF`` set to your directory.
6497 6367
6498.. _dev-saving-memory-during-a-build:
6499
6500Conserving Disk Space During Builds 6368Conserving Disk Space During Builds
6501=================================== 6369===================================
6502 6370
@@ -6573,8 +6441,6 @@ Yocto Project Reference Manual's glossary chapter.
6573 prevent the installation of a package whose presence is required by 6441 prevent the installation of a package whose presence is required by
6574 an installed package. 6442 an installed package.
6575 6443
6576.. _incrementing-a-binary-package-version:
6577
6578Incrementing a Package Version 6444Incrementing a Package Version
6579------------------------------ 6445------------------------------
6580 6446
@@ -6777,8 +6643,6 @@ Guidelines <https://www.debian.org/doc/debian-policy/ch-controlfields.html>`__.
6777These guidelines define how versions are compared and what "increasing" 6643These guidelines define how versions are compared and what "increasing"
6778a version means. 6644a version means.
6779 6645
6780.. _automatically-incrementing-a-binary-package-revision-number:
6781
6782Automatically Incrementing a Package Version Number 6646Automatically Incrementing a Package Version Number
6783~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 6647~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
6784 6648
@@ -7077,8 +6941,6 @@ use of runtime package management, you need to do a couple things above
7077and beyond the basics. The remainder of this section describes what you 6941and beyond the basics. The remainder of this section describes what you
7078need to do. 6942need to do.
7079 6943
7080.. _runtime-package-management-build:
7081
7082Build Considerations 6944Build Considerations
7083~~~~~~~~~~~~~~~~~~~~ 6945~~~~~~~~~~~~~~~~~~~~
7084 6946
@@ -7165,8 +7027,6 @@ When your build is complete, your packages reside in the
7165``tmp`` and your selected package type is RPM, then your RPM packages 7027``tmp`` and your selected package type is RPM, then your RPM packages
7166are available in ``tmp/deploy/rpm``. 7028are available in ``tmp/deploy/rpm``.
7167 7029
7168.. _runtime-package-management-server:
7169
7170Host or Server Machine Setup 7030Host or Server Machine Setup
7171~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 7031~~~~~~~~~~~~~~~~~~~~~~~~~~~~
7172 7032
@@ -7193,16 +7053,12 @@ setting of "package_rpm":
7193 $ cd ~/poky/build/tmp/deploy/rpm 7053 $ cd ~/poky/build/tmp/deploy/rpm
7194 $ python3 -m http.server 7054 $ python3 -m http.server
7195 7055
7196.. _runtime-package-management-target:
7197
7198Target Setup 7056Target Setup
7199~~~~~~~~~~~~ 7057~~~~~~~~~~~~
7200 7058
7201Setting up the target differs depending on the package management 7059Setting up the target differs depending on the package management
7202system. This section provides information for RPM, IPK, and DEB. 7060system. This section provides information for RPM, IPK, and DEB.
7203 7061
7204.. _runtime-package-management-target-rpm:
7205
7206Using RPM 7062Using RPM
7207^^^^^^^^^ 7063^^^^^^^^^
7208 7064
@@ -7283,8 +7139,6 @@ upgrade packages from the specified repository or repositories.
7283 See the `DNF documentation <https://dnf.readthedocs.io/en/latest/>`__ for 7139 See the `DNF documentation <https://dnf.readthedocs.io/en/latest/>`__ for
7284 additional information. 7140 additional information.
7285 7141
7286.. _runtime-package-management-target-ipk:
7287
7288Using IPK 7142Using IPK
7289^^^^^^^^^ 7143^^^^^^^^^
7290 7144
@@ -7325,8 +7179,6 @@ repository information:
7325The ``opkg`` application is now able to find, install, and upgrade packages 7179The ``opkg`` application is now able to find, install, and upgrade packages
7326from the specified repository. 7180from the specified repository.
7327 7181
7328.. _runtime-package-management-target-deb:
7329
7330Using DEB 7182Using DEB
7331^^^^^^^^^ 7183^^^^^^^^^
7332 7184
@@ -7583,8 +7435,6 @@ method.
7583 7435
7584Additionally, some requirements and caveats exist. 7436Additionally, some requirements and caveats exist.
7585 7437
7586.. _npm-package-creation-requirements:
7587
7588Requirements and Caveats 7438Requirements and Caveats
7589~~~~~~~~~~~~~~~~~~~~~~~~ 7439~~~~~~~~~~~~~~~~~~~~~~~~
7590 7440
@@ -7619,8 +7469,6 @@ NPM packages:
7619 useful to have NPM on your target. The NPM package name is 7469 useful to have NPM on your target. The NPM package name is
7620 ``nodejs-npm``. 7470 ``nodejs-npm``.
7621 7471
7622.. _npm-using-the-registry-modules-method:
7623
7624Using the Registry Modules Method 7472Using the Registry Modules Method
7625~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 7473~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
7626 7474
@@ -7731,8 +7579,6 @@ go to ``http://192.168.7.2:3000`` and you see the following:
7731You can find the recipe in ``workspace/recipes/cute-files``. You can use 7579You can find the recipe in ``workspace/recipes/cute-files``. You can use
7732the recipe in any layer you choose. 7580the recipe in any layer you choose.
7733 7581
7734.. _npm-using-the-npm-projects-method:
7735
7736Using the NPM Projects Code Method 7582Using the NPM Projects Code Method
7737~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 7583~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
7738 7584
@@ -7956,8 +7802,6 @@ image cannot use this package group. However, it can install SysVinit
7956and the appropriate packages will have support for both systemd and 7802and the appropriate packages will have support for both systemd and
7957SysVinit. 7803SysVinit.
7958 7804
7959.. _selecting-dev-manager:
7960
7961Selecting a Device Manager 7805Selecting a Device Manager
7962========================== 7806==========================
7963 7807
@@ -7974,8 +7818,6 @@ The Yocto Project provides multiple ways to manage the device manager
7974 configuration of device nodes is done in user space by a device 7818 configuration of device nodes is done in user space by a device
7975 manager like ``udev`` or ``busybox-mdev``. 7819 manager like ``udev`` or ``busybox-mdev``.
7976 7820
7977.. _static-dev-management:
7978
7979Using Persistent and Pre-Populated\ ``/dev`` 7821Using Persistent and Pre-Populated\ ``/dev``
7980-------------------------------------------- 7822--------------------------------------------
7981 7823
@@ -8002,8 +7844,6 @@ If you do not define the ``IMAGE_DEVICE_TABLES`` variable, the default
8002The population is handled by the ``makedevs`` utility during image 7844The population is handled by the ``makedevs`` utility during image
8003creation: 7845creation:
8004 7846
8005.. _devtmpfs-dev-management:
8006
8007Using ``devtmpfs`` and a Device Manager 7847Using ``devtmpfs`` and a Device Manager
8008--------------------------------------- 7848---------------------------------------
8009 7849
@@ -8036,8 +7876,6 @@ your ``local.conf`` configuration file:
8036 # VIRTUAL-RUNTIME_dev_manager = "busybox-mdev" 7876 # VIRTUAL-RUNTIME_dev_manager = "busybox-mdev"
8037 # VIRTUAL-RUNTIME_dev_manager = "systemd" 7877 # VIRTUAL-RUNTIME_dev_manager = "systemd"
8038 7878
8039.. _platdev-appdev-srcrev:
8040
8041Using an External SCM 7879Using an External SCM
8042===================== 7880=====================
8043 7881
@@ -8628,8 +8466,6 @@ hardware, you have to take different steps to enable the tests. See the
8628following subsections for information on how to enable both types of 8466following subsections for information on how to enable both types of
8629tests. 8467tests.
8630 8468
8631.. _qemu-image-enabling-tests:
8632
8633Enabling Runtime Tests on QEMU 8469Enabling Runtime Tests on QEMU
8634~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 8470~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
8635 8471
@@ -8714,8 +8550,6 @@ Once you start running the tests, the following happens:
8714 You can find the output from the ``unittest`` in the task log at 8550 You can find the output from the ``unittest`` in the task log at
8715 ``${WORKDIR}/temp/log.do_testimage``. 8551 ``${WORKDIR}/temp/log.do_testimage``.
8716 8552
8717.. _hardware-image-enabling-tests:
8718
8719Enabling Runtime Tests on Hardware 8553Enabling Runtime Tests on Hardware
8720~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 8554~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
8721 8555
@@ -8931,8 +8765,6 @@ wrapper, simply prefix the terminal command with
8931 8765
8932 TEST_SERIALCONTROL_CMD = "${COREBASE}/scripts/contrib/serdevtry picocom -b 115200 /dev/ttyUSB0" 8766 TEST_SERIALCONTROL_CMD = "${COREBASE}/scripts/contrib/serdevtry picocom -b 115200 /dev/ttyUSB0"
8933 8767
8934.. _qemu-image-running-tests:
8935
8936Running Tests 8768Running Tests
8937------------- 8769-------------
8938 8770
@@ -9077,8 +8909,6 @@ the build environment using the following:
9077 $ cd tmp/testexport/core-image-sato 8909 $ cd tmp/testexport/core-image-sato
9078 $ ./runexported.py testdata.json 8910 $ ./runexported.py testdata.json
9079 8911
9080.. _qemu-image-writing-new-tests:
9081
9082Writing New Tests 8912Writing New Tests
9083----------------- 8913-----------------
9084 8914
@@ -9110,8 +8940,6 @@ You will notice that all test classes inherit ``oeRuntimeTest``, which
9110is found in ``meta/lib/oetest.py``. This base class offers some helper 8940is found in ``meta/lib/oetest.py``. This base class offers some helper
9111attributes, which are described in the following sections: 8941attributes, which are described in the following sections:
9112 8942
9113.. _qemu-image-writing-tests-class-methods:
9114
9115Class Methods 8943Class Methods
9116~~~~~~~~~~~~~ 8944~~~~~~~~~~~~~
9117 8945
@@ -9125,8 +8953,6 @@ Class methods are as follows:
9125 :term:`IMAGE_FEATURES` or 8953 :term:`IMAGE_FEATURES` or
9126 :term:`DISTRO_FEATURES`. 8954 :term:`DISTRO_FEATURES`.
9127 8955
9128.. _qemu-image-writing-tests-class-attributes:
9129
9130Class Attributes 8956Class Attributes
9131~~~~~~~~~~~~~~~~ 8957~~~~~~~~~~~~~~~~
9132 8958
@@ -9174,8 +9000,6 @@ Class attributes are as follows:
9174 - *copy_from(remotepath, localpath):* 9000 - *copy_from(remotepath, localpath):*
9175 ``scp root@host:remotepath localpath``. 9001 ``scp root@host:remotepath localpath``.
9176 9002
9177.. _qemu-image-writing-tests-instance-attributes:
9178
9179Instance Attributes 9003Instance Attributes
9180~~~~~~~~~~~~~~~~~~~ 9004~~~~~~~~~~~~~~~~~~~
9181 9005
@@ -9241,8 +9065,6 @@ Once the test is complete, the packages are removed from the DUT.
9241 ] 9065 ]
9242 } 9066 }
9243 9067
9244.. _usingpoky-debugging-tools-and-techniques:
9245
9246Debugging Tools and Techniques 9068Debugging Tools and Techniques
9247============================== 9069==============================
9248 9070
@@ -9333,8 +9155,6 @@ section:
9333- "`Other Debugging Tips <#dev-other-debugging-others>`__" describes 9155- "`Other Debugging Tips <#dev-other-debugging-others>`__" describes
9334 miscellaneous debugging tips that can be useful. 9156 miscellaneous debugging tips that can be useful.
9335 9157
9336.. _dev-debugging-viewing-logs-from-failed-tasks:
9337
9338Viewing Logs from Failed Tasks 9158Viewing Logs from Failed Tasks
9339------------------------------ 9159------------------------------
9340 9160
@@ -9354,8 +9174,6 @@ links to ``log.do_``\ `taskname`\ ``.``\ `pid` and
9354when it ran. The symlinks always point to the files corresponding to the 9174when it ran. The symlinks always point to the files corresponding to the
9355most recent run. 9175most recent run.
9356 9176
9357.. _dev-debugging-viewing-variable-values:
9358
9359Viewing Variable Values 9177Viewing Variable Values
9360----------------------- 9178-----------------------
9361 9179
@@ -9477,8 +9295,6 @@ facility:
9477 $ oe-pkgdata-util --help 9295 $ oe-pkgdata-util --help
9478 $ oe-pkgdata-util subcommand --help 9296 $ oe-pkgdata-util subcommand --help
9479 9297
9480.. _dev-viewing-dependencies-between-recipes-and-tasks:
9481
9482Viewing Dependencies Between Recipes and Tasks 9298Viewing Dependencies Between Recipes and Tasks
9483---------------------------------------------- 9299----------------------------------------------
9484 9300
@@ -9545,8 +9361,6 @@ This command
9545displays a GUI window from which you can view build-time and runtime 9361displays a GUI window from which you can view build-time and runtime
9546dependencies for the recipes involved in building recipename. 9362dependencies for the recipes involved in building recipename.
9547 9363
9548.. _dev-viewing-task-variable-dependencies:
9549
9550Viewing Task Variable Dependencies 9364Viewing Task Variable Dependencies
9551---------------------------------- 9365----------------------------------
9552 9366
@@ -9638,8 +9452,6 @@ Using BitBake with either of these options causes BitBake to dump out
9638``sigdata`` files in the ``stamps`` directory for every task it would 9452``sigdata`` files in the ``stamps`` directory for every task it would
9639have executed instead of building the specified target package. 9453have executed instead of building the specified target package.
9640 9454
9641.. _dev-viewing-metadata-used-to-create-the-input-signature-of-a-shared-state-task:
9642
9643Viewing Metadata Used to Create the Input Signature of a Shared State Task 9455Viewing Metadata Used to Create the Input Signature of a Shared State Task
9644-------------------------------------------------------------------------- 9456--------------------------------------------------------------------------
9645 9457
@@ -9655,8 +9467,6 @@ For conceptual information on shared state, see the
9655":ref:`overview-manual/overview-manual-concepts:shared state`" 9467":ref:`overview-manual/overview-manual-concepts:shared state`"
9656section in the Yocto Project Overview and Concepts Manual. 9468section in the Yocto Project Overview and Concepts Manual.
9657 9469
9658.. _dev-invalidating-shared-state-to-force-a-task-to-run:
9659
9660Invalidating Shared State to Force a Task to Run 9470Invalidating Shared State to Force a Task to Run
9661------------------------------------------------ 9471------------------------------------------------
9662 9472
@@ -9703,8 +9513,6 @@ the build system to run the task again.
9703 shared state, see this 9513 shared state, see this
9704 :yocto_git:`commit </cgit.cgi/poky/commit/meta/classes/package.bbclass?id=737f8bbb4f27b4837047cb9b4fbfe01dfde36d54>`. 9514 :yocto_git:`commit </cgit.cgi/poky/commit/meta/classes/package.bbclass?id=737f8bbb4f27b4837047cb9b4fbfe01dfde36d54>`.
9705 9515
9706.. _dev-debugging-taskrunning:
9707
9708Running Specific Tasks 9516Running Specific Tasks
9709---------------------- 9517----------------------
9710 9518
@@ -9812,8 +9620,6 @@ You can view a list of tasks in a given package by running the
9812The results appear as output to the console and are also in 9620The results appear as output to the console and are also in
9813the file ``${WORKDIR}/temp/log.do_listtasks``. 9621the file ``${WORKDIR}/temp/log.do_listtasks``.
9814 9622
9815.. _dev-debugging-bitbake:
9816
9817General BitBake Problems 9623General BitBake Problems
9818------------------------ 9624------------------------
9819 9625
@@ -9827,8 +9633,6 @@ chose a certain version of a package or why BitBake picked a certain
9827provider. This command could also help you in a situation where you 9633provider. This command could also help you in a situation where you
9828think BitBake did something unexpected. 9634think BitBake did something unexpected.
9829 9635
9830.. _dev-debugging-buildfile:
9831
9832Building with No Dependencies 9636Building with No Dependencies
9833----------------------------- 9637-----------------------------
9834 9638
@@ -10190,8 +9994,6 @@ problem is taken care of at its source. See the "`Submitting a Change to
10190the Yocto Project <#how-to-submit-a-change>`__" section for more 9994the Yocto Project <#how-to-submit-a-change>`__" section for more
10191information. 9995information.
10192 9996
10193.. _platdev-gdb-remotedebug:
10194
10195Debugging With the GNU Project Debugger (GDB) Remotely 9997Debugging With the GNU Project Debugger (GDB) Remotely
10196------------------------------------------------------ 9998------------------------------------------------------
10197 9999
@@ -10453,8 +10255,6 @@ To support this kind of debugging, you need do the following:
10453 Consider that this will reduce the application's performance and is 10255 Consider that this will reduce the application's performance and is
10454 recommended only for debugging purposes. 10256 recommended only for debugging purposes.
10455 10257
10456.. _dev-other-debugging-others:
10457
10458Other Debugging Tips 10258Other Debugging Tips
10459-------------------- 10259--------------------
10460 10260
@@ -10596,8 +10396,6 @@ categorization, progress, or comments on the bug result in Bugzilla
10596sending you an automated email concerning the particular change or 10396sending you an automated email concerning the particular change or
10597progress to the bug. 10397progress to the bug.
10598 10398
10599.. _how-to-submit-a-change:
10600
10601Submitting a Change to the Yocto Project 10399Submitting a Change to the Yocto Project
10602---------------------------------------- 10400----------------------------------------
10603 10401
@@ -10691,8 +10489,6 @@ layers you are contributing to.
10691 10489
10692The following sections provide procedures for submitting a change. 10490The following sections provide procedures for submitting a change.
10693 10491
10694.. _preparing-changes-for-submissions:
10695
10696Preparing Changes for Submission 10492Preparing Changes for Submission
10697~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 10493~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
10698 10494
@@ -10776,8 +10572,6 @@ Preparing Changes for Submission
10776 10572
10777 detailed description of change 10573 detailed description of change
10778 10574
10779.. _submitting-a-patch:
10780
10781Using Email to Submit a Patch 10575Using Email to Submit a Patch
10782~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 10576~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
10783 10577
@@ -10868,8 +10662,6 @@ reduce the burden of patch review on maintainers.
10868 Asking about the status of a patch or change is reasonable if the change 10662 Asking about the status of a patch or change is reasonable if the change
10869 has been idle for a while with no feedback. 10663 has been idle for a while with no feedback.
10870 10664
10871.. _pushing-a-change-upstream:
10872
10873Using Scripts to Push a Change Upstream and Request a Pull 10665Using Scripts to Push a Change Upstream and Request a Pull
10874~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 10666~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
10875 10667
@@ -11077,8 +10869,6 @@ licensing text and covers how to maintain open source license compliance
11077during your project's lifecycle. The section also describes how to 10869during your project's lifecycle. The section also describes how to
11078enable commercially licensed recipes, which by default are disabled. 10870enable commercially licensed recipes, which by default are disabled.
11079 10871
11080.. _usingpoky-configuring-LIC_FILES_CHKSUM:
11081
11082Tracking License Changes 10872Tracking License Changes
11083------------------------ 10873------------------------
11084 10874
@@ -11089,8 +10879,6 @@ variable tracks changes to the license text. The checksums are validated
11089at the end of the configure step, and if the checksums do not match, the 10879at the end of the configure step, and if the checksums do not match, the
11090build will fail. 10880build will fail.
11091 10881
11092.. _usingpoky-specifying-LIC_FILES_CHKSUM:
11093
11094Specifying the ``LIC_FILES_CHKSUM`` Variable 10882Specifying the ``LIC_FILES_CHKSUM`` Variable
11095~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 10883~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
11096 10884
@@ -11134,8 +10922,6 @@ five through 16 as license text. The second line refers to a file in
11134Note that ``LIC_FILES_CHKSUM`` variable is mandatory for all recipes, 10922Note that ``LIC_FILES_CHKSUM`` variable is mandatory for all recipes,
11135unless the ``LICENSE`` variable is set to "CLOSED". 10923unless the ``LICENSE`` variable is set to "CLOSED".
11136 10924
11137.. _usingpoky-LIC_FILES_CHKSUM-explanation-of-syntax:
11138
11139Explanation of Syntax 10925Explanation of Syntax
11140~~~~~~~~~~~~~~~~~~~~~ 10926~~~~~~~~~~~~~~~~~~~~~
11141 10927
@@ -11704,8 +11490,6 @@ If you want to set up your own error reporting server, you can obtain
11704the code from the Git repository at :yocto_git:`/cgit/cgit.cgi/error-report-web/`. 11490the code from the Git repository at :yocto_git:`/cgit/cgit.cgi/error-report-web/`.
11705Instructions on how to set it up are in the README document. 11491Instructions on how to set it up are in the README document.
11706 11492
11707.. _dev-using-wayland-and-weston:
11708
11709Using Wayland and Weston 11493Using Wayland and Weston
11710======================== 11494========================
11711 11495
@@ -11748,8 +11532,6 @@ Enabling Wayland in an Image
11748To enable Wayland, you need to enable it to be built and enable it to be 11532To enable Wayland, you need to enable it to be built and enable it to be
11749included (installed) in the image. 11533included (installed) in the image.
11750 11534
11751.. _enable-building:
11752
11753Building Wayland 11535Building Wayland
11754~~~~~~~~~~~~~~~~ 11536~~~~~~~~~~~~~~~~
11755 11537
@@ -11768,8 +11550,6 @@ statement in your ``local.conf`` file:
11768 If X11 has been enabled elsewhere, Weston will build Wayland with X11 11550 If X11 has been enabled elsewhere, Weston will build Wayland with X11
11769 support 11551 support
11770 11552
11771.. _enable-installation-in-an-image:
11772
11773Installing Wayland and Weston 11553Installing Wayland and Weston
11774~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 11554~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
11775 11555
diff --git a/documentation/dev-manual/dev-manual-intro.rst b/documentation/dev-manual/dev-manual-intro.rst
index 05136f7353..9bbac9610c 100644
--- a/documentation/dev-manual/dev-manual-intro.rst
+++ b/documentation/dev-manual/dev-manual-intro.rst
@@ -4,8 +4,6 @@
4The Yocto Project Development Tasks Manual 4The Yocto Project Development Tasks Manual
5****************************************** 5******************************************
6 6
7.. _dev-welcome:
8
9Welcome 7Welcome
10======= 8=======
11 9
diff --git a/documentation/dev-manual/dev-manual-qemu.rst b/documentation/dev-manual/dev-manual-qemu.rst
index 63640411d4..4e58fc1b67 100644
--- a/documentation/dev-manual/dev-manual-qemu.rst
+++ b/documentation/dev-manual/dev-manual-qemu.rst
@@ -10,8 +10,6 @@ This chapter provides both procedures that show you how to use the Quick
10EMUlator (QEMU) and other QEMU information helpful for development 10EMUlator (QEMU) and other QEMU information helpful for development
11purposes. 11purposes.
12 12
13.. _qemu-dev-overview:
14
15Overview 13Overview
16======== 14========
17 15
@@ -39,8 +37,6 @@ following references:
39- `Documentation <https://wiki.qemu.org/Manual>`__\ *:* The QEMU user 37- `Documentation <https://wiki.qemu.org/Manual>`__\ *:* The QEMU user
40 manual. 38 manual.
41 39
42.. _qemu-running-qemu:
43
44Running QEMU 40Running QEMU
45============ 41============
46 42
@@ -187,8 +183,6 @@ allow input of absolute coordinates. This default means that the mouse
187can enter and leave the main window without the grab taking effect 183can enter and leave the main window without the grab taking effect
188leading to a better user experience. 184leading to a better user experience.
189 185
190.. _qemu-running-under-a-network-file-system-nfs-server:
191
192Running Under a Network File System (NFS) Server 186Running Under a Network File System (NFS) Server
193================================================ 187================================================
194 188
@@ -243,8 +237,6 @@ using an NFS server.
243 237
244 runqemu-export-rootfs restart file-system-location 238 runqemu-export-rootfs restart file-system-location
245 239
246.. _qemu-kvm-cpu-compatibility:
247
248QEMU CPU Compatibility Under KVM 240QEMU CPU Compatibility Under KVM
249================================ 241================================
250 242
@@ -266,8 +258,6 @@ directory. This setting specifies a ``-cpu`` option passed into QEMU in
266the ``runqemu`` script. Running ``qemu -cpu help`` returns a list of 258the ``runqemu`` script. Running ``qemu -cpu help`` returns a list of
267available supported CPU types. 259available supported CPU types.
268 260
269.. _qemu-dev-performance:
270
271QEMU Performance 261QEMU Performance
272================ 262================
273 263
@@ -320,8 +310,6 @@ present, the toolchain is also automatically used.
320 Server <#qemu-running-under-a-network-file-system-nfs-server>`__" 310 Server <#qemu-running-under-a-network-file-system-nfs-server>`__"
321 section for more information. 311 section for more information.
322 312
323.. _qemu-dev-command-line-syntax:
324
325QEMU Command-Line Syntax 313QEMU Command-Line Syntax
326======================== 314========================
327 315
@@ -377,8 +365,6 @@ Following is the command-line help output for the ``runqemu`` command:
377 runqemu path/to/<image>-<machine>.wic 365 runqemu path/to/<image>-<machine>.wic
378 runqemu path/to/<image>-<machine>.wic.vmdk 366 runqemu path/to/<image>-<machine>.wic.vmdk
379 367
380.. _qemu-dev-runqemu-command-line-options:
381
382``runqemu`` Command-Line Options 368``runqemu`` Command-Line Options
383================================ 369================================
384 370
diff --git a/documentation/dev-manual/dev-manual-start.rst b/documentation/dev-manual/dev-manual-start.rst
index a85b86fbfb..f768f092be 100644
--- a/documentation/dev-manual/dev-manual-start.rst
+++ b/documentation/dev-manual/dev-manual-start.rst
@@ -11,8 +11,6 @@ host <dev-manual/dev-manual-start:preparing the build host>`, how to locate
11Yocto Project source repositories, and how to create local Git 11Yocto Project source repositories, and how to create local Git
12repositories. 12repositories.
13 13
14.. _usingpoky-changes-collaborate:
15
16Creating a Team Development Environment 14Creating a Team Development Environment
17======================================= 15=======================================
18 16
@@ -261,8 +259,6 @@ particular working environment and set of practices.
261 of the available mailing lists, see the ":ref:`resources-mailinglist`" section in 259 of the available mailing lists, see the ":ref:`resources-mailinglist`" section in
262 the Yocto Project Reference Manual. 260 the Yocto Project Reference Manual.
263 261
264.. _dev-preparing-the-build-host:
265
266Preparing the Build Host 262Preparing the Build Host
267======================== 263========================
268 264
@@ -352,8 +348,6 @@ Kit (eSDK) manual. If you want to work on the kernel, see the :doc:`../kernel-de
352Toaster, see the ":doc:`../toaster-manual/toaster-manual-setup-and-use`" 348Toaster, see the ":doc:`../toaster-manual/toaster-manual-setup-and-use`"
353section in the Toaster User Manual. 349section in the Toaster User Manual.
354 350
355.. _setting-up-to-use-crops:
356
357Setting Up to Use CROss PlatformS (CROPS) 351Setting Up to Use CROss PlatformS (CROPS)
358----------------------------------------- 352-----------------------------------------
359 353
@@ -454,8 +448,6 @@ Kit (eSDK) manual. If you are going to use the Toaster container, see
454the ":doc:`../toaster-manual/toaster-manual-setup-and-use`" 448the ":doc:`../toaster-manual/toaster-manual-setup-and-use`"
455section in the Toaster User Manual. 449section in the Toaster User Manual.
456 450
457.. _setting-up-to-use-wsl:
458
459Setting Up to Use Windows Subsystem For Linux (WSLv2) 451Setting Up to Use Windows Subsystem For Linux (WSLv2)
460----------------------------------------------------- 452-----------------------------------------------------
461 453
@@ -855,8 +847,6 @@ and then specifically check out that development branch.
855 master 847 master
856 * &DISTRO_NAME_NO_CAP; 848 * &DISTRO_NAME_NO_CAP;
857 849
858.. _checkout-out-by-tag-in-poky:
859
860Checking Out by Tag in Poky 850Checking Out by Tag in Poky
861--------------------------- 851---------------------------
862 852