diff options
| -rw-r--r-- | documentation/dev-manual/dev-manual-common-tasks.rst | 220 | ||||
| -rw-r--r-- | documentation/dev-manual/dev-manual-intro.rst | 2 | ||||
| -rw-r--r-- | documentation/dev-manual/dev-manual-qemu.rst | 14 | ||||
| -rw-r--r-- | documentation/dev-manual/dev-manual-start.rst | 10 |
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 | |||
| 165 | Following Best Practices When Creating Layers | 163 | Following Best Practices When Creating Layers |
| 166 | --------------------------------------------- | 164 | --------------------------------------------- |
| 167 | 165 | ||
| @@ -457,8 +455,6 @@ file. During the processing of each ``conf/layer.conf`` file, BitBake | |||
| 457 | adds the recipes, classes and configurations contained within the | 455 | adds the recipes, classes and configurations contained within the |
| 458 | particular layer to the source directory. | 456 | particular layer to the source directory. |
| 459 | 457 | ||
| 460 | .. _using-bbappend-files: | ||
| 461 | |||
| 462 | Using .bbappend Files in Your Layer | 458 | Using .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 | |||
| 844 | Customizing Images | 838 | Customizing Images |
| 845 | ================== | 839 | ================== |
| 846 | 840 | ||
| 847 | You can customize images to satisfy particular requirements. This | 841 | You can customize images to satisfy particular requirements. This |
| 848 | section describes several methods and provides guidelines for each. | 842 | section describes several methods and provides guidelines for each. |
| 849 | 843 | ||
| 850 | .. _usingpoky-extend-customimage-localconf: | ||
| 851 | |||
| 852 | Customizing Images Using ``local.conf`` | 844 | Customizing 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 | |||
| 896 | Customizing Images Using Custom ``IMAGE_FEATURES`` and ``EXTRA_IMAGE_FEATURES`` | 886 | Customizing 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 | |||
| 954 | Customizing Images Using Custom .bb Files | 942 | Customizing 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 | |||
| 982 | Customizing Images Using Custom Package Groups | 968 | Customizing 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 |
| 1040 | areas of this section. | 1026 | areas of this section. |
| 1041 | 1027 | ||
| 1042 | .. _usingpoky-extend-customimage-image-name: | ||
| 1043 | |||
| 1044 | Customizing an Image Hostname | 1028 | Customizing an Image Hostname |
| 1045 | ----------------------------- | 1029 | ----------------------------- |
| 1046 | 1030 | ||
| @@ -1080,8 +1064,6 @@ unsets the variable in a configuration file: | |||
| 1080 | Having no default hostname in the filesystem is suitable for | 1064 | Having no default hostname in the filesystem is suitable for |
| 1081 | environments that use dynamic hostnames such as virtual machines. | 1065 | environments that use dynamic hostnames such as virtual machines. |
| 1082 | 1066 | ||
| 1083 | .. _new-recipe-writing-a-new-recipe: | ||
| 1084 | |||
| 1085 | Writing a New Recipe | 1067 | Writing 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 | |||
| 1102 | Overview | 1082 | Overview |
| 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 | |||
| 1113 | Locate or Automatically Create a Base Recipe | 1091 | Locate 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 | |||
| 1135 | Creating the Base Recipe Using ``devtool add`` | 1111 | Creating 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 | |||
| 1147 | in the Yocto Project Application Development and the Extensible Software | 1123 | in the Yocto Project Application Development and the Extensible Software |
| 1148 | Development Kit (eSDK) manual. | 1124 | Development Kit (eSDK) manual. |
| 1149 | 1125 | ||
| 1150 | .. _new-recipe-creating-the-base-recipe-using-recipetool: | ||
| 1151 | |||
| 1152 | Creating the Base Recipe Using ``recipetool create`` | 1126 | Creating 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 | |||
| 1218 | Locating and Using a Similar Recipe | 1190 | Locating 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 | |||
| 1259 | Storing and Naming the Recipe | 1229 | Storing 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 | |||
| 1303 | Running a Build on the Recipe | 1271 | Running 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`" |
| 1355 | chapter of the Yocto Project Overview and Concepts Manual. | 1323 | chapter of the Yocto Project Overview and Concepts Manual. |
| 1356 | 1324 | ||
| 1357 | .. _new-recipe-fetching-code: | ||
| 1358 | |||
| 1359 | Fetching Code | 1325 | Fetching Code |
| 1360 | ------------- | 1326 | ------------- |
| 1361 | 1327 | ||
| @@ -1490,8 +1456,6 @@ compressed suffixes such as ``diff.gz`` and ``patch.bz2``, for example. | |||
| 1490 | The build system automatically applies patches as described in the | 1456 | The 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 | |||
| 1495 | Unpacking Code | 1459 | Unpacking Code |
| 1496 | -------------- | 1460 | -------------- |
| 1497 | 1461 | ||
| @@ -1512,8 +1476,6 @@ If processing your recipe using BitBake successfully unpacks the source | |||
| 1512 | files, you need to be sure that the directory pointed to by ``${S}`` | 1476 | files, you need to be sure that the directory pointed to by ``${S}`` |
| 1513 | matches the structure of the source. | 1477 | matches the structure of the source. |
| 1514 | 1478 | ||
| 1515 | .. _new-recipe-patching-code: | ||
| 1516 | |||
| 1517 | Patching Code | 1479 | Patching 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 | |||
| 1544 | Licensing | 1504 | Licensing |
| 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 | |||
| 1602 | Dependencies | 1560 | Dependencies |
| 1603 | ------------ | 1561 | ------------ |
| 1604 | 1562 | ||
| @@ -1645,8 +1603,6 @@ system will automatically add a runtime dependency to "mypackage" on | |||
| 1645 | section in the Yocto Project Overview and Concepts Manual for further | 1603 | section in the Yocto Project Overview and Concepts Manual for further |
| 1646 | details. | 1604 | details. |
| 1647 | 1605 | ||
| 1648 | .. _new-recipe-configuring-the-recipe: | ||
| 1649 | |||
| 1650 | Configuring the Recipe | 1606 | Configuring 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 |
| 1742 | upstream documentation. | 1698 | upstream documentation. |
| 1743 | 1699 | ||
| 1744 | .. _new-recipe-using-headers-to-interface-with-devices: | ||
| 1745 | |||
| 1746 | Using Headers to Interface with Devices | 1700 | Using 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 | |||
| 1807 | Compilation | 1759 | Compilation |
| 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 | |||
| 1872 | Installing | 1822 | Installing |
| 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 | |||
| 1961 | Enabling System Services | 1909 | Enabling 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 | |||
| 2014 | Packaging | 1960 | Packaging |
| 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 | |||
| 2094 | Sharing Files Between Recipes | 2038 | Sharing Files Between Recipes |
| 2095 | ----------------------------- | 2039 | ----------------------------- |
| 2096 | 2040 | ||
| @@ -2137,8 +2081,6 @@ For a more complete description of the | |||
| 2137 | task and its associated functions, see the | 2081 | task 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 | |||
| 2142 | Using Virtual Providers | 2084 | Using 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 | |||
| 2256 | Post-Installation Scripts | 2196 | Post-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 | |||
| 2318 | Testing | 2256 | Testing |
| 2319 | ------- | 2257 | ------- |
| 2320 | 2258 | ||
| @@ -2326,8 +2264,6 @@ For information on how to customize your image by adding specific | |||
| 2326 | packages, see the "`Customizing | 2264 | packages, see the "`Customizing |
| 2327 | Images <#usingpoky-extend-customimage>`__" section. | 2265 | Images <#usingpoky-extend-customimage>`__" section. |
| 2328 | 2266 | ||
| 2329 | .. _new-recipe-testing-examples: | ||
| 2330 | |||
| 2331 | Examples | 2267 | Examples |
| 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 | |||
| 2349 | Single .c File Package (Hello World!) | 2283 | Single .c File Package (Hello World!) |
| 2350 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | 2284 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| 2351 | 2285 | ||
| @@ -2382,8 +2316,6 @@ customize the packaging process, see the "`Splitting an Application into | |||
| 2382 | Multiple Packages <#splitting-an-application-into-multiple-packages>`__" | 2316 | Multiple Packages <#splitting-an-application-into-multiple-packages>`__" |
| 2383 | section. | 2317 | section. |
| 2384 | 2318 | ||
| 2385 | .. _new-recipe-autotooled-package: | ||
| 2386 | |||
| 2387 | Autotooled Package | 2319 | Autotooled Package |
| 2388 | ~~~~~~~~~~~~~~~~~~ | 2320 | ~~~~~~~~~~~~~~~~~~ |
| 2389 | 2321 | ||
| @@ -2413,8 +2345,6 @@ changes as described in the | |||
| 2413 | the Yocto Project Overview and Concepts Manual. You can quickly create | 2345 | the Yocto Project Overview and Concepts Manual. You can quickly create |
| 2414 | Autotool-based recipes in a manner similar to the previous example. | 2346 | Autotool-based recipes in a manner similar to the previous example. |
| 2415 | 2347 | ||
| 2416 | .. _new-recipe-makefile-based-package: | ||
| 2417 | |||
| 2418 | Makefile-Based Package | 2348 | Makefile-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 | |||
| 2869 | Adding a New Machine | 2797 | Adding 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 | |||
| 2885 | section in the Yocto Project Board Support Package (BSP) Developer's | 2813 | section in the Yocto Project Board Support Package (BSP) Developer's |
| 2886 | Guide. | 2814 | Guide. |
| 2887 | 2815 | ||
| 2888 | .. _platdev-newmachine-conffile: | ||
| 2889 | |||
| 2890 | Adding the Machine Configuration File | 2816 | Adding the Machine Configuration File |
| 2891 | ------------------------------------- | 2817 | ------------------------------------- |
| 2892 | 2818 | ||
| @@ -2920,8 +2846,6 @@ You can find full details on these variables in the reference section. | |||
| 2920 | You can leverage existing machine ``.conf`` files from | 2846 | You 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 | |||
| 2925 | Adding a Kernel for the Machine | 2849 | Adding 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`" |
| 2957 | section in the Yocto Project Linux Kernel Development Manual. | 2881 | section in the Yocto Project Linux Kernel Development Manual. |
| 2958 | 2882 | ||
| 2959 | .. _platdev-newmachine-formfactor: | ||
| 2960 | |||
| 2961 | Adding a Formfactor Configuration File | 2883 | Adding 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 | |||
| 2995 | Upgrading Recipes | 2915 | Upgrading 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, |
| 3012 | you can manually upgrade a recipe by editing the recipe itself. | 2932 | you can manually upgrade a recipe by editing the recipe itself. |
| 3013 | 2933 | ||
| 3014 | .. _gs-using-the-auto-upgrade-helper: | ||
| 3015 | |||
| 3016 | Using the Auto Upgrade Helper (AUH) | 2934 | Using 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>` |
| 3208 | file distributed with the utility for an example. | 3126 | file distributed with the utility for an example. |
| 3209 | 3127 | ||
| 3210 | .. _gs-using-devtool-upgrade: | ||
| 3211 | |||
| 3212 | Using ``devtool upgrade`` | 3128 | Using ``devtool upgrade`` |
| 3213 | ------------------------- | 3129 | ------------------------- |
| 3214 | 3130 | ||
| @@ -3350,8 +3266,6 @@ Using the ``devtool finish`` command cleans up the workspace and creates a patch | |||
| 3350 | file based on your commits. The tool puts all patch files back into the | 3266 | file based on your commits. The tool puts all patch files back into the |
| 3351 | source directory in a sub-directory named ``nano`` in this case. | 3267 | source directory in a sub-directory named ``nano`` in this case. |
| 3352 | 3268 | ||
| 3353 | .. _dev-manually-upgrading-a-recipe: | ||
| 3354 | |||
| 3355 | Manually Upgrading a Recipe | 3269 | Manually 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 | |||
| 3424 | Finding Temporary Source Code | 3336 | Finding 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 | |||
| 3496 | Using Quilt in Your Workflow | 3406 | Using 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 | |||
| 3592 | Using a Development Shell | 3500 | Using 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 | |||
| 3676 | Using a Development Python Shell | 3582 | Using a Development Python Shell |
| 3677 | ================================ | 3583 | ================================ |
| 3678 | 3584 | ||
| @@ -3720,8 +3626,6 @@ controls what type of shell is opened. | |||
| 3720 | When you are finished using ``devpyshell``, you can exit the shell | 3626 | When you are finished using ``devpyshell``, you can exit the shell |
| 3721 | either by using Ctrl+d or closing the terminal window. | 3627 | either by using Ctrl+d or closing the terminal window. |
| 3722 | 3628 | ||
| 3723 | .. _dev-building: | ||
| 3724 | |||
| 3725 | Building | 3629 | Building |
| 3726 | ======== | 3630 | ======== |
| 3727 | 3631 | ||
| @@ -3729,8 +3633,6 @@ This section describes various build procedures. For example, the steps | |||
| 3729 | needed for a simple build, a target that uses multiple configurations, | 3633 | needed for a simple build, a target that uses multiple configurations, |
| 3730 | building an image for more than one machine, and so forth. | 3634 | building an image for more than one machine, and so forth. |
| 3731 | 3635 | ||
| 3732 | .. _dev-building-a-simple-image: | ||
| 3733 | |||
| 3734 | Building a Simple Image | 3636 | Building 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 | |||
| 3838 | Building Images for Multiple Targets Using Multiple Configurations | 3738 | Building 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 | |||
| 3848 | and how to account for cross-build dependencies between the | 3748 | and how to account for cross-build dependencies between the |
| 3849 | multiconfigs. | 3749 | multiconfigs. |
| 3850 | 3750 | ||
| 3851 | .. _dev-setting-up-and-running-a-multiple-configuration-build: | ||
| 3852 | |||
| 3853 | Setting Up and Running a Multiple Configuration Build | 3751 | Setting 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 | |||
| 3947 | Enabling Multiple Configuration Build Dependencies | 3843 | Enabling Multiple Configuration Build Dependencies |
| 3948 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | 3844 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| 3949 | 3845 | ||
| @@ -4003,8 +3899,6 @@ and have separate configuration files, BitBake places the artifacts for | |||
| 4003 | each build in the respective temporary build directories (i.e. | 3899 | each build in the respective temporary build directories (i.e. |
| 4004 | :term:`TMPDIR`). | 3900 | :term:`TMPDIR`). |
| 4005 | 3901 | ||
| 4006 | .. _building-an-initramfs-image: | ||
| 4007 | |||
| 4008 | Building an Initial RAM Filesystem (initramfs) Image | 3902 | Building an Initial RAM Filesystem (initramfs) Image |
| 4009 | ---------------------------------------------------- | 3903 | ---------------------------------------------------- |
| 4010 | 3904 | ||
| @@ -4095,8 +3989,6 @@ distribution to even smaller sizes than the ``poky-tiny`` distribution, | |||
| 4095 | which is around 5 Mbytes, that can be built out-of-the-box using the | 3989 | which is around 5 Mbytes, that can be built out-of-the-box using the |
| 4096 | Yocto Project. | 3990 | Yocto Project. |
| 4097 | 3991 | ||
| 4098 | .. _tiny-system-overview: | ||
| 4099 | |||
| 4100 | Tiny System Overview | 3992 | Tiny 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 | |||
| 4150 | Understand What Contributes to Your Image Size | 4040 | Understand 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 | |||
| 4817 | Working With Libraries | 4705 | Working 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 | |||
| 4894 | Combining Multiple Versions of Library Files into One Image | 4780 | Combining 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 | |||
| 5304 | Optionally Using an External Toolchain | 5188 | Optionally 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 | |||
| 5368 | to use the Wic utility, provides information on using the Wic plugins | 5252 | to use the Wic utility, provides information on using the Wic plugins |
| 5369 | interface, and provides several examples that show how to use Wic. | 5253 | interface, and provides several examples that show how to use Wic. |
| 5370 | 5254 | ||
| 5371 | .. _wic-background: | ||
| 5372 | |||
| 5373 | Background | 5255 | Background |
| 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 | |||
| 5400 | Requirements | 5280 | Requirements |
| 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 | |||
| 5440 | Getting Help | 5318 | Getting 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 | |||
| 5615 | Using an Existing Kickstart File | 5491 | Using 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 | |||
| 5666 | Using the Wic Plugin Interface | 5540 | Using 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 | |||
| 5802 | interest. On success, these will be filled in with the actual methods. | 5676 | interest. On success, these will be filled in with the actual methods. |
| 5803 | See the Wic implementation for examples and details. | 5677 | See the Wic implementation for examples and details. |
| 5804 | 5678 | ||
| 5805 | .. _wic-usage-examples: | ||
| 5806 | |||
| 5807 | Wic Examples | 5679 | Wic Examples |
| 5808 | ------------ | 5680 | ------------ |
| 5809 | 5681 | ||
| @@ -5813,8 +5685,6 @@ utility. All the examples assume the list of requirements in the | |||
| 5813 | examples assume the previously generated image is | 5685 | examples 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 | |||
| 5818 | Generate an Image using an Existing Kickstart File | 5688 | Generate 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 |
| 6496 | making sure you have ``TEMPLATECONF`` set to your directory. | 6366 | making sure you have ``TEMPLATECONF`` set to your directory. |
| 6497 | 6367 | ||
| 6498 | .. _dev-saving-memory-during-a-build: | ||
| 6499 | |||
| 6500 | Conserving Disk Space During Builds | 6368 | Conserving 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 | |||
| 6578 | Incrementing a Package Version | 6444 | Incrementing a Package Version |
| 6579 | ------------------------------ | 6445 | ------------------------------ |
| 6580 | 6446 | ||
| @@ -6777,8 +6643,6 @@ Guidelines <https://www.debian.org/doc/debian-policy/ch-controlfields.html>`__. | |||
| 6777 | These guidelines define how versions are compared and what "increasing" | 6643 | These guidelines define how versions are compared and what "increasing" |
| 6778 | a version means. | 6644 | a version means. |
| 6779 | 6645 | ||
| 6780 | .. _automatically-incrementing-a-binary-package-revision-number: | ||
| 6781 | |||
| 6782 | Automatically Incrementing a Package Version Number | 6646 | Automatically 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 | |||
| 7077 | and beyond the basics. The remainder of this section describes what you | 6941 | and beyond the basics. The remainder of this section describes what you |
| 7078 | need to do. | 6942 | need to do. |
| 7079 | 6943 | ||
| 7080 | .. _runtime-package-management-build: | ||
| 7081 | |||
| 7082 | Build Considerations | 6944 | Build 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 |
| 7166 | are available in ``tmp/deploy/rpm``. | 7028 | are available in ``tmp/deploy/rpm``. |
| 7167 | 7029 | ||
| 7168 | .. _runtime-package-management-server: | ||
| 7169 | |||
| 7170 | Host or Server Machine Setup | 7030 | Host 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 | |||
| 7198 | Target Setup | 7056 | Target Setup |
| 7199 | ~~~~~~~~~~~~ | 7057 | ~~~~~~~~~~~~ |
| 7200 | 7058 | ||
| 7201 | Setting up the target differs depending on the package management | 7059 | Setting up the target differs depending on the package management |
| 7202 | system. This section provides information for RPM, IPK, and DEB. | 7060 | system. This section provides information for RPM, IPK, and DEB. |
| 7203 | 7061 | ||
| 7204 | .. _runtime-package-management-target-rpm: | ||
| 7205 | |||
| 7206 | Using RPM | 7062 | Using 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 | |||
| 7288 | Using IPK | 7142 | Using IPK |
| 7289 | ^^^^^^^^^ | 7143 | ^^^^^^^^^ |
| 7290 | 7144 | ||
| @@ -7325,8 +7179,6 @@ repository information: | |||
| 7325 | The ``opkg`` application is now able to find, install, and upgrade packages | 7179 | The ``opkg`` application is now able to find, install, and upgrade packages |
| 7326 | from the specified repository. | 7180 | from the specified repository. |
| 7327 | 7181 | ||
| 7328 | .. _runtime-package-management-target-deb: | ||
| 7329 | |||
| 7330 | Using DEB | 7182 | Using DEB |
| 7331 | ^^^^^^^^^ | 7183 | ^^^^^^^^^ |
| 7332 | 7184 | ||
| @@ -7583,8 +7435,6 @@ method. | |||
| 7583 | 7435 | ||
| 7584 | Additionally, some requirements and caveats exist. | 7436 | Additionally, some requirements and caveats exist. |
| 7585 | 7437 | ||
| 7586 | .. _npm-package-creation-requirements: | ||
| 7587 | |||
| 7588 | Requirements and Caveats | 7438 | Requirements 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 | |||
| 7624 | Using the Registry Modules Method | 7472 | Using 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: | |||
| 7731 | You can find the recipe in ``workspace/recipes/cute-files``. You can use | 7579 | You can find the recipe in ``workspace/recipes/cute-files``. You can use |
| 7732 | the recipe in any layer you choose. | 7580 | the recipe in any layer you choose. |
| 7733 | 7581 | ||
| 7734 | .. _npm-using-the-npm-projects-method: | ||
| 7735 | |||
| 7736 | Using the NPM Projects Code Method | 7582 | Using the NPM Projects Code Method |
| 7737 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | 7583 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| 7738 | 7584 | ||
| @@ -7956,8 +7802,6 @@ image cannot use this package group. However, it can install SysVinit | |||
| 7956 | and the appropriate packages will have support for both systemd and | 7802 | and the appropriate packages will have support for both systemd and |
| 7957 | SysVinit. | 7803 | SysVinit. |
| 7958 | 7804 | ||
| 7959 | .. _selecting-dev-manager: | ||
| 7960 | |||
| 7961 | Selecting a Device Manager | 7805 | Selecting 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 | |||
| 7979 | Using Persistent and Pre-Populated\ ``/dev`` | 7821 | Using 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 | |||
| 8002 | The population is handled by the ``makedevs`` utility during image | 7844 | The population is handled by the ``makedevs`` utility during image |
| 8003 | creation: | 7845 | creation: |
| 8004 | 7846 | ||
| 8005 | .. _devtmpfs-dev-management: | ||
| 8006 | |||
| 8007 | Using ``devtmpfs`` and a Device Manager | 7847 | Using ``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 | |||
| 8041 | Using an External SCM | 7879 | Using an External SCM |
| 8042 | ===================== | 7880 | ===================== |
| 8043 | 7881 | ||
| @@ -8628,8 +8466,6 @@ hardware, you have to take different steps to enable the tests. See the | |||
| 8628 | following subsections for information on how to enable both types of | 8466 | following subsections for information on how to enable both types of |
| 8629 | tests. | 8467 | tests. |
| 8630 | 8468 | ||
| 8631 | .. _qemu-image-enabling-tests: | ||
| 8632 | |||
| 8633 | Enabling Runtime Tests on QEMU | 8469 | Enabling 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 | |||
| 8719 | Enabling Runtime Tests on Hardware | 8553 | Enabling 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 | |||
| 8936 | Running Tests | 8768 | Running 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 | |||
| 9082 | Writing New Tests | 8912 | Writing New Tests |
| 9083 | ----------------- | 8913 | ----------------- |
| 9084 | 8914 | ||
| @@ -9110,8 +8940,6 @@ You will notice that all test classes inherit ``oeRuntimeTest``, which | |||
| 9110 | is found in ``meta/lib/oetest.py``. This base class offers some helper | 8940 | is found in ``meta/lib/oetest.py``. This base class offers some helper |
| 9111 | attributes, which are described in the following sections: | 8941 | attributes, which are described in the following sections: |
| 9112 | 8942 | ||
| 9113 | .. _qemu-image-writing-tests-class-methods: | ||
| 9114 | |||
| 9115 | Class Methods | 8943 | Class 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 | |||
| 9130 | Class Attributes | 8956 | Class 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 | |||
| 9179 | Instance Attributes | 9003 | Instance 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 | |||
| 9246 | Debugging Tools and Techniques | 9068 | Debugging 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 | |||
| 9338 | Viewing Logs from Failed Tasks | 9158 | Viewing Logs from Failed Tasks |
| 9339 | ------------------------------ | 9159 | ------------------------------ |
| 9340 | 9160 | ||
| @@ -9354,8 +9174,6 @@ links to ``log.do_``\ `taskname`\ ``.``\ `pid` and | |||
| 9354 | when it ran. The symlinks always point to the files corresponding to the | 9174 | when it ran. The symlinks always point to the files corresponding to the |
| 9355 | most recent run. | 9175 | most recent run. |
| 9356 | 9176 | ||
| 9357 | .. _dev-debugging-viewing-variable-values: | ||
| 9358 | |||
| 9359 | Viewing Variable Values | 9177 | Viewing 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 | |||
| 9482 | Viewing Dependencies Between Recipes and Tasks | 9298 | Viewing Dependencies Between Recipes and Tasks |
| 9483 | ---------------------------------------------- | 9299 | ---------------------------------------------- |
| 9484 | 9300 | ||
| @@ -9545,8 +9361,6 @@ This command | |||
| 9545 | displays a GUI window from which you can view build-time and runtime | 9361 | displays a GUI window from which you can view build-time and runtime |
| 9546 | dependencies for the recipes involved in building recipename. | 9362 | dependencies for the recipes involved in building recipename. |
| 9547 | 9363 | ||
| 9548 | .. _dev-viewing-task-variable-dependencies: | ||
| 9549 | |||
| 9550 | Viewing Task Variable Dependencies | 9364 | Viewing 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 |
| 9639 | have executed instead of building the specified target package. | 9453 | have 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 | |||
| 9643 | Viewing Metadata Used to Create the Input Signature of a Shared State Task | 9455 | Viewing 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`" |
| 9656 | section in the Yocto Project Overview and Concepts Manual. | 9468 | section in the Yocto Project Overview and Concepts Manual. |
| 9657 | 9469 | ||
| 9658 | .. _dev-invalidating-shared-state-to-force-a-task-to-run: | ||
| 9659 | |||
| 9660 | Invalidating Shared State to Force a Task to Run | 9470 | Invalidating 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 | |||
| 9708 | Running Specific Tasks | 9516 | Running Specific Tasks |
| 9709 | ---------------------- | 9517 | ---------------------- |
| 9710 | 9518 | ||
| @@ -9812,8 +9620,6 @@ You can view a list of tasks in a given package by running the | |||
| 9812 | The results appear as output to the console and are also in | 9620 | The results appear as output to the console and are also in |
| 9813 | the file ``${WORKDIR}/temp/log.do_listtasks``. | 9621 | the file ``${WORKDIR}/temp/log.do_listtasks``. |
| 9814 | 9622 | ||
| 9815 | .. _dev-debugging-bitbake: | ||
| 9816 | |||
| 9817 | General BitBake Problems | 9623 | General BitBake Problems |
| 9818 | ------------------------ | 9624 | ------------------------ |
| 9819 | 9625 | ||
| @@ -9827,8 +9633,6 @@ chose a certain version of a package or why BitBake picked a certain | |||
| 9827 | provider. This command could also help you in a situation where you | 9633 | provider. This command could also help you in a situation where you |
| 9828 | think BitBake did something unexpected. | 9634 | think BitBake did something unexpected. |
| 9829 | 9635 | ||
| 9830 | .. _dev-debugging-buildfile: | ||
| 9831 | |||
| 9832 | Building with No Dependencies | 9636 | Building 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 | |||
| 10190 | the Yocto Project <#how-to-submit-a-change>`__" section for more | 9994 | the Yocto Project <#how-to-submit-a-change>`__" section for more |
| 10191 | information. | 9995 | information. |
| 10192 | 9996 | ||
| 10193 | .. _platdev-gdb-remotedebug: | ||
| 10194 | |||
| 10195 | Debugging With the GNU Project Debugger (GDB) Remotely | 9997 | Debugging 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 | |||
| 10458 | Other Debugging Tips | 10258 | Other Debugging Tips |
| 10459 | -------------------- | 10259 | -------------------- |
| 10460 | 10260 | ||
| @@ -10596,8 +10396,6 @@ categorization, progress, or comments on the bug result in Bugzilla | |||
| 10596 | sending you an automated email concerning the particular change or | 10396 | sending you an automated email concerning the particular change or |
| 10597 | progress to the bug. | 10397 | progress to the bug. |
| 10598 | 10398 | ||
| 10599 | .. _how-to-submit-a-change: | ||
| 10600 | |||
| 10601 | Submitting a Change to the Yocto Project | 10399 | Submitting a Change to the Yocto Project |
| 10602 | ---------------------------------------- | 10400 | ---------------------------------------- |
| 10603 | 10401 | ||
| @@ -10691,8 +10489,6 @@ layers you are contributing to. | |||
| 10691 | 10489 | ||
| 10692 | The following sections provide procedures for submitting a change. | 10490 | The following sections provide procedures for submitting a change. |
| 10693 | 10491 | ||
| 10694 | .. _preparing-changes-for-submissions: | ||
| 10695 | |||
| 10696 | Preparing Changes for Submission | 10492 | Preparing 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 | |||
| 10781 | Using Email to Submit a Patch | 10575 | Using 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 | |||
| 10873 | Using Scripts to Push a Change Upstream and Request a Pull | 10665 | Using 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 | |||
| 11077 | during your project's lifecycle. The section also describes how to | 10869 | during your project's lifecycle. The section also describes how to |
| 11078 | enable commercially licensed recipes, which by default are disabled. | 10870 | enable commercially licensed recipes, which by default are disabled. |
| 11079 | 10871 | ||
| 11080 | .. _usingpoky-configuring-LIC_FILES_CHKSUM: | ||
| 11081 | |||
| 11082 | Tracking License Changes | 10872 | Tracking License Changes |
| 11083 | ------------------------ | 10873 | ------------------------ |
| 11084 | 10874 | ||
| @@ -11089,8 +10879,6 @@ variable tracks changes to the license text. The checksums are validated | |||
| 11089 | at the end of the configure step, and if the checksums do not match, the | 10879 | at the end of the configure step, and if the checksums do not match, the |
| 11090 | build will fail. | 10880 | build will fail. |
| 11091 | 10881 | ||
| 11092 | .. _usingpoky-specifying-LIC_FILES_CHKSUM: | ||
| 11093 | |||
| 11094 | Specifying the ``LIC_FILES_CHKSUM`` Variable | 10882 | Specifying 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 | |||
| 11134 | Note that ``LIC_FILES_CHKSUM`` variable is mandatory for all recipes, | 10922 | Note that ``LIC_FILES_CHKSUM`` variable is mandatory for all recipes, |
| 11135 | unless the ``LICENSE`` variable is set to "CLOSED". | 10923 | unless the ``LICENSE`` variable is set to "CLOSED". |
| 11136 | 10924 | ||
| 11137 | .. _usingpoky-LIC_FILES_CHKSUM-explanation-of-syntax: | ||
| 11138 | |||
| 11139 | Explanation of Syntax | 10925 | Explanation of Syntax |
| 11140 | ~~~~~~~~~~~~~~~~~~~~~ | 10926 | ~~~~~~~~~~~~~~~~~~~~~ |
| 11141 | 10927 | ||
| @@ -11704,8 +11490,6 @@ If you want to set up your own error reporting server, you can obtain | |||
| 11704 | the code from the Git repository at :yocto_git:`/cgit/cgit.cgi/error-report-web/`. | 11490 | the code from the Git repository at :yocto_git:`/cgit/cgit.cgi/error-report-web/`. |
| 11705 | Instructions on how to set it up are in the README document. | 11491 | Instructions on how to set it up are in the README document. |
| 11706 | 11492 | ||
| 11707 | .. _dev-using-wayland-and-weston: | ||
| 11708 | |||
| 11709 | Using Wayland and Weston | 11493 | Using Wayland and Weston |
| 11710 | ======================== | 11494 | ======================== |
| 11711 | 11495 | ||
| @@ -11748,8 +11532,6 @@ Enabling Wayland in an Image | |||
| 11748 | To enable Wayland, you need to enable it to be built and enable it to be | 11532 | To enable Wayland, you need to enable it to be built and enable it to be |
| 11749 | included (installed) in the image. | 11533 | included (installed) in the image. |
| 11750 | 11534 | ||
| 11751 | .. _enable-building: | ||
| 11752 | |||
| 11753 | Building Wayland | 11535 | Building 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 | |||
| 11773 | Installing Wayland and Weston | 11553 | Installing 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 @@ | |||
| 4 | The Yocto Project Development Tasks Manual | 4 | The Yocto Project Development Tasks Manual |
| 5 | ****************************************** | 5 | ****************************************** |
| 6 | 6 | ||
| 7 | .. _dev-welcome: | ||
| 8 | |||
| 9 | Welcome | 7 | Welcome |
| 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 | |||
| 10 | EMUlator (QEMU) and other QEMU information helpful for development | 10 | EMUlator (QEMU) and other QEMU information helpful for development |
| 11 | purposes. | 11 | purposes. |
| 12 | 12 | ||
| 13 | .. _qemu-dev-overview: | ||
| 14 | |||
| 15 | Overview | 13 | Overview |
| 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 | |||
| 44 | Running QEMU | 40 | Running QEMU |
| 45 | ============ | 41 | ============ |
| 46 | 42 | ||
| @@ -187,8 +183,6 @@ allow input of absolute coordinates. This default means that the mouse | |||
| 187 | can enter and leave the main window without the grab taking effect | 183 | can enter and leave the main window without the grab taking effect |
| 188 | leading to a better user experience. | 184 | leading to a better user experience. |
| 189 | 185 | ||
| 190 | .. _qemu-running-under-a-network-file-system-nfs-server: | ||
| 191 | |||
| 192 | Running Under a Network File System (NFS) Server | 186 | Running 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 | |||
| 248 | QEMU CPU Compatibility Under KVM | 240 | QEMU CPU Compatibility Under KVM |
| 249 | ================================ | 241 | ================================ |
| 250 | 242 | ||
| @@ -266,8 +258,6 @@ directory. This setting specifies a ``-cpu`` option passed into QEMU in | |||
| 266 | the ``runqemu`` script. Running ``qemu -cpu help`` returns a list of | 258 | the ``runqemu`` script. Running ``qemu -cpu help`` returns a list of |
| 267 | available supported CPU types. | 259 | available supported CPU types. |
| 268 | 260 | ||
| 269 | .. _qemu-dev-performance: | ||
| 270 | |||
| 271 | QEMU Performance | 261 | QEMU 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 | |||
| 325 | QEMU Command-Line Syntax | 313 | QEMU 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 | |||
| 11 | Yocto Project source repositories, and how to create local Git | 11 | Yocto Project source repositories, and how to create local Git |
| 12 | repositories. | 12 | repositories. |
| 13 | 13 | ||
| 14 | .. _usingpoky-changes-collaborate: | ||
| 15 | |||
| 16 | Creating a Team Development Environment | 14 | Creating 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 | |||
| 266 | Preparing the Build Host | 262 | Preparing 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 | |||
| 352 | Toaster, see the ":doc:`../toaster-manual/toaster-manual-setup-and-use`" | 348 | Toaster, see the ":doc:`../toaster-manual/toaster-manual-setup-and-use`" |
| 353 | section in the Toaster User Manual. | 349 | section in the Toaster User Manual. |
| 354 | 350 | ||
| 355 | .. _setting-up-to-use-crops: | ||
| 356 | |||
| 357 | Setting Up to Use CROss PlatformS (CROPS) | 351 | Setting 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 | |||
| 454 | the ":doc:`../toaster-manual/toaster-manual-setup-and-use`" | 448 | the ":doc:`../toaster-manual/toaster-manual-setup-and-use`" |
| 455 | section in the Toaster User Manual. | 449 | section in the Toaster User Manual. |
| 456 | 450 | ||
| 457 | .. _setting-up-to-use-wsl: | ||
| 458 | |||
| 459 | Setting Up to Use Windows Subsystem For Linux (WSLv2) | 451 | Setting 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 | |||
| 860 | Checking Out by Tag in Poky | 850 | Checking Out by Tag in Poky |
| 861 | --------------------------- | 851 | --------------------------- |
| 862 | 852 | ||
