* [PATCH 01/11] what-i-wish-id-known: replace labels with references to section title
2020-11-19 9:58 [PATCH 00/11] A first pass at removing labels Nicolas Dechesne
@ 2020-11-19 9:58 ` Nicolas Dechesne
2020-11-19 9:58 ` [PATCH 02/11] sdk-manual: " Nicolas Dechesne
` (9 subsequent siblings)
10 siblings, 0 replies; 12+ messages in thread
From: Nicolas Dechesne @ 2020-11-19 9:58 UTC (permalink / raw)
To: docs; +Cc: Nicolas Dechesne
Signed-off-by: Nicolas Dechesne <nicolas.dechesne@linaro.org>
---
documentation/what-i-wish-id-known.rst | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/documentation/what-i-wish-id-known.rst b/documentation/what-i-wish-id-known.rst
index 593c6fe14..afc126382 100644
--- a/documentation/what-i-wish-id-known.rst
+++ b/documentation/what-i-wish-id-known.rst
@@ -135,7 +135,7 @@ contact us with other suggestions.
valuable links: :ref:`dev-manual/dev-manual-common-tasks:Using a Development
Shell` for information on how to build and run a specific task using
devshell. Also, the :ref:`SDK manual shows how to build out a specific recipe
- <sdk-devtool-use-devtool-modify-to-modify-the-source-of-an-existing-component>`.
+ <sdk-manual/sdk-extensible:use \`\`devtool modify\`\` to modify the source of an existing component>`.
#. **An ambiguous definition: Package vs Recipe:**
A recipe contains instructions the build system uses to create
--
2.29.2
^ permalink raw reply related [flat|nested] 12+ messages in thread
* [PATCH 02/11] sdk-manual: replace labels with references to section title
2020-11-19 9:58 [PATCH 00/11] A first pass at removing labels Nicolas Dechesne
2020-11-19 9:58 ` [PATCH 01/11] what-i-wish-id-known: replace labels with references to section title Nicolas Dechesne
@ 2020-11-19 9:58 ` Nicolas Dechesne
2020-11-19 9:58 ` [PATCH 03/11] ref-manual: " Nicolas Dechesne
` (8 subsequent siblings)
10 siblings, 0 replies; 12+ messages in thread
From: Nicolas Dechesne @ 2020-11-19 9:58 UTC (permalink / raw)
To: docs; +Cc: Nicolas Dechesne
Signed-off-by: Nicolas Dechesne <nicolas.dechesne@linaro.org>
---
documentation/sdk-manual/sdk-appendix-obtain.rst | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/documentation/sdk-manual/sdk-appendix-obtain.rst b/documentation/sdk-manual/sdk-appendix-obtain.rst
index a51c22e39..8b0753969 100644
--- a/documentation/sdk-manual/sdk-appendix-obtain.rst
+++ b/documentation/sdk-manual/sdk-appendix-obtain.rst
@@ -248,7 +248,7 @@ Follow these steps to extract the root filesystem:
installed the toolchain (e.g. ``poky_sdk``).
Following is an example based on the toolchain installed in the
- ":ref:`sdk-locating-pre-built-sdk-installers`" section:
+ ":ref:`sdk-manual/sdk-appendix-obtain:locating pre-built sdk installers`" section:
::
$ source ~/poky_sdk/environment-setup-core2-64-poky-linux
--
2.29.2
^ permalink raw reply related [flat|nested] 12+ messages in thread
* [PATCH 03/11] ref-manual: replace labels with references to section title
2020-11-19 9:58 [PATCH 00/11] A first pass at removing labels Nicolas Dechesne
2020-11-19 9:58 ` [PATCH 01/11] what-i-wish-id-known: replace labels with references to section title Nicolas Dechesne
2020-11-19 9:58 ` [PATCH 02/11] sdk-manual: " Nicolas Dechesne
@ 2020-11-19 9:58 ` Nicolas Dechesne
2020-11-19 9:58 ` [PATCH 04/11] dev-manual: " Nicolas Dechesne
` (7 subsequent siblings)
10 siblings, 0 replies; 12+ messages in thread
From: Nicolas Dechesne @ 2020-11-19 9:58 UTC (permalink / raw)
To: docs; +Cc: Nicolas Dechesne
Signed-off-by: Nicolas Dechesne <nicolas.dechesne@linaro.org>
---
documentation/ref-manual/faq.rst | 4 ++--
documentation/ref-manual/ref-devtool-reference.rst | 2 +-
2 files changed, 3 insertions(+), 3 deletions(-)
diff --git a/documentation/ref-manual/faq.rst b/documentation/ref-manual/faq.rst
index 8c2b34be5..576863eec 100644
--- a/documentation/ref-manual/faq.rst
+++ b/documentation/ref-manual/faq.rst
@@ -207,7 +207,7 @@ section in the Yocto Project Development Tasks Manual.
**Q:** How do I disable the cursor on my touchscreen device?
**A:** You need to create a form factor file as described in the
-":ref:`bsp-filelayout-misc-recipes`" section in
+":ref:`bsp-guide/bsp:miscellaneous bsp-specific recipe files`" section in
the Yocto Project Board Support Packages (BSP) Developer's Guide. Set
the ``HAVE_TOUCHSCREEN`` variable equal to one as follows:
::
@@ -220,7 +220,7 @@ default?
**A:** The default interfaces file provided by the netbase recipe does
not automatically bring up network interfaces. Therefore, you will need
to add a BSP-specific netbase that includes an interfaces file. See the
-":ref:`bsp-filelayout-misc-recipes`" section in
+":ref:`bsp-guide/bsp:miscellaneous bsp-specific recipe files`" section in
the Yocto Project Board Support Packages (BSP) Developer's Guide for
information on creating these types of miscellaneous recipe files.
diff --git a/documentation/ref-manual/ref-devtool-reference.rst b/documentation/ref-manual/ref-devtool-reference.rst
index 9b9ddf53f..ad8889ed2 100644
--- a/documentation/ref-manual/ref-devtool-reference.rst
+++ b/documentation/ref-manual/ref-devtool-reference.rst
@@ -438,7 +438,7 @@ revision to which you want to upgrade (i.e. the
forth.
You can read more on the ``devtool upgrade`` workflow in the
-":ref:`sdk-devtool-use-devtool-upgrade-to-create-a-version-of-the-recipe-that-supports-a-newer-version-of-the-software`"
+":ref:`sdk-manual/sdk-extensible:use \`\`devtool upgrade\`\` to create a version of the recipe that supports a newer version of the software`"
section in the Yocto Project Application Development and the Extensible
Software Development Kit (eSDK) manual. You can also see an example of
how to use ``devtool upgrade`` in the ":ref:`gs-using-devtool-upgrade`"
--
2.29.2
^ permalink raw reply related [flat|nested] 12+ messages in thread
* [PATCH 04/11] dev-manual: replace labels with references to section title
2020-11-19 9:58 [PATCH 00/11] A first pass at removing labels Nicolas Dechesne
` (2 preceding siblings ...)
2020-11-19 9:58 ` [PATCH 03/11] ref-manual: " Nicolas Dechesne
@ 2020-11-19 9:58 ` Nicolas Dechesne
2020-11-19 9:58 ` [PATCH 05/11] kernel-dev: " Nicolas Dechesne
` (6 subsequent siblings)
10 siblings, 0 replies; 12+ messages in thread
From: Nicolas Dechesne @ 2020-11-19 9:58 UTC (permalink / raw)
To: docs; +Cc: Nicolas Dechesne
Signed-off-by: Nicolas Dechesne <nicolas.dechesne@linaro.org>
---
.../dev-manual/dev-manual-common-tasks.rst | 15 ++++++++-------
1 file changed, 8 insertions(+), 7 deletions(-)
diff --git a/documentation/dev-manual/dev-manual-common-tasks.rst b/documentation/dev-manual/dev-manual-common-tasks.rst
index 27aacde60..201e187c3 100644
--- a/documentation/dev-manual/dev-manual-common-tasks.rst
+++ b/documentation/dev-manual/dev-manual-common-tasks.rst
@@ -1143,7 +1143,7 @@ necessary when adding a recipe to build a new piece of software to be
included in a build.
You can find a complete description of the ``devtool add`` command in
-the ":ref:`sdk-a-closer-look-at-devtool-add`" section
+the ":ref:`sdk-manual/sdk-extensible:a closer look at \`\`devtool add\`\``" section
in the Yocto Project Application Development and the Extensible Software
Development Kit (eSDK) manual.
@@ -1819,7 +1819,7 @@ Here are some common issues that cause failures.
For cases where improper paths are detected for configuration files
or for when libraries/headers cannot be found, be sure you are using
the more robust ``pkg-config``. See the note in section
- ":ref:`new-recipe-configuring-the-recipe`" for additional information.
+ ":ref:`dev-manual/dev-manual-common-tasks:Configuring the Recipe`" for additional information.
- *Parallel build failures:* These failures manifest themselves as
intermittent errors, or errors reporting that a file or directory
@@ -3048,7 +3048,7 @@ The following steps describe how to set up the AUH utility:
1. *Be Sure the Development Host is Set Up:* You need to be sure that
your development host is set up to use the Yocto Project. For
information on how to set up your host, see the
- ":ref:`dev-preparing-the-build-host`" section.
+ ":ref:`dev-manual/dev-manual-start:Preparing the Build Host`" section.
2. *Make Sure Git is Configured:* The AUH utility requires Git to be
configured because AUH uses Git to save upgrades. Thus, you must have
@@ -3216,7 +3216,7 @@ As mentioned earlier, an alternative method for upgrading recipes to
newer versions is to use
:doc:`devtool upgrade <../ref-manual/ref-devtool-reference>`.
You can read about ``devtool upgrade`` in general in the
-":ref:`sdk-devtool-use-devtool-upgrade-to-create-a-version-of-the-recipe-that-supports-a-newer-version-of-the-software`"
+":ref:`sdk-manual/sdk-extensible:use \`\`devtool upgrade\`\` to create a version of the recipe that supports a newer version of the software`"
section in the Yocto Project Application Development and the Extensible
Software Development Kit (eSDK) Manual.
@@ -3356,7 +3356,8 @@ Manually Upgrading a Recipe
---------------------------
If for some reason you choose not to upgrade recipes using
-:ref:`gs-using-the-auto-upgrade-helper` or by :ref:`gs-using-devtool-upgrade`,
+:ref:`dev-manual/dev-manual-common-tasks:Using the Auto Upgrade Helper (AUH)` or
+by :ref:`dev-manual/dev-manual-common-tasks:Using \`\`devtool upgrade\`\``,
you can manually edit the recipe files to upgrade the versions.
.. note::
@@ -4196,7 +4197,7 @@ view file dependencies in a human-readable form:
directory.
For more information on configuration fragments, see the
- ":ref:`creating-config-fragments`"
+ ":ref:`kernel-dev/kernel-dev-common:creating configuration fragments`"
section in the Yocto Project Linux Kernel Development Manual.
- ``bitbake -u taskexp -g bitbake_target``: Using the BitBake command
@@ -8143,7 +8144,7 @@ associated ``EXTRA_IMAGE_FEATURES`` variable, as in:
EXTRA_IMAGE_FEATURES = "read-only-rootfs"
For more information on how to use these variables, see the
-":ref:`usingpoky-extend-customimage-imagefeatures`"
+":ref:`dev-manual/dev-manual-common-tasks:Customizing Images Using Custom \`\`IMAGE_FEATURES\`\` and \`\`EXTRA_IMAGE_FEATURES\`\``"
section. For information on the variables, see
:term:`IMAGE_FEATURES` and
:term:`EXTRA_IMAGE_FEATURES`.
--
2.29.2
^ permalink raw reply related [flat|nested] 12+ messages in thread
* [PATCH 05/11] kernel-dev: replace labels with references to section title
2020-11-19 9:58 [PATCH 00/11] A first pass at removing labels Nicolas Dechesne
` (3 preceding siblings ...)
2020-11-19 9:58 ` [PATCH 04/11] dev-manual: " Nicolas Dechesne
@ 2020-11-19 9:58 ` Nicolas Dechesne
2020-11-19 9:58 ` [PATCH 06/11] test-manual: remove unused labels Nicolas Dechesne
` (5 subsequent siblings)
10 siblings, 0 replies; 12+ messages in thread
From: Nicolas Dechesne @ 2020-11-19 9:58 UTC (permalink / raw)
To: docs; +Cc: Nicolas Dechesne
Signed-off-by: Nicolas Dechesne <nicolas.dechesne@linaro.org>
---
documentation/kernel-dev/kernel-dev-advanced.rst | 4 ++--
documentation/kernel-dev/kernel-dev-intro.rst | 8 ++++----
2 files changed, 6 insertions(+), 6 deletions(-)
diff --git a/documentation/kernel-dev/kernel-dev-advanced.rst b/documentation/kernel-dev/kernel-dev-advanced.rst
index 444037c3a..b1537ccbe 100644
--- a/documentation/kernel-dev/kernel-dev-advanced.rst
+++ b/documentation/kernel-dev/kernel-dev-advanced.rst
@@ -245,7 +245,7 @@ two files: ``smp.scc`` and ``smp.cfg``. You can find these files in the
CONFIG_X86_BIGSMP=y
You can find general information on configuration
-fragment files in the ":ref:`creating-config-fragments`" section.
+fragment files in the ":ref:`kernel-dev/kernel-dev-common:creating configuration fragments`" section.
Within the ``smp.scc`` file, the
:term:`KFEATURE_DESCRIPTION`
@@ -559,7 +559,7 @@ You can see that in the BeagleBone example with the following:
include beaglebone.scc
For information on how to break a complete ``.config`` file into the various
-configuration fragments, see the ":ref:`creating-config-fragments`" section.
+configuration fragments, see the ":ref:`kernel-dev/kernel-dev-common:creating configuration fragments`" section.
Finally, if you have any configurations specific to the hardware that
are not in a ``*.scc`` file, you can include them as follows:
diff --git a/documentation/kernel-dev/kernel-dev-intro.rst b/documentation/kernel-dev/kernel-dev-intro.rst
index 5679a0ab8..971420b22 100644
--- a/documentation/kernel-dev/kernel-dev-intro.rst
+++ b/documentation/kernel-dev/kernel-dev-intro.rst
@@ -28,8 +28,8 @@ newly-supported platforms. Previous recipes in the release are refreshed
and supported for at least one additional Yocto Project release. As they
align, these previous releases are updated to include the latest from
the Long Term Support Initiative (LTSI) project. You can learn more
-about Yocto Linux kernels and LTSI in the ":ref:`Yocto Project Kernel
-Development and Maintenance <kernel-big-picture>`" section.
+about Yocto Linux kernels and LTSI in the
+":ref:`kernel-dev/kernel-dev-concepts-appx:yocto project kernel development and maintenance`" section.
Also included is a Yocto Linux kernel development recipe
(``linux-yocto-dev.bb``) should you want to work with the very latest in
@@ -38,7 +38,7 @@ upstream Yocto Linux kernel development and kernel Metadata development.
.. note::
For more on Yocto Linux kernels, see the
- ":ref:`Yocto Project Kernel Development and Maintenance <kernel-big-picture>`"
+ ":ref:`kernel-dev/kernel-dev-concepts-appx:yocto project kernel development and maintenance`"
section.
The Yocto Project also provides a powerful set of kernel tools for
@@ -167,7 +167,7 @@ general information and references for further information.
``menuconfig`` and you have saved them, you can directly compare the
resulting ``.config`` file against an existing original and gather
those changes into a
- :ref:`configuration fragment file <creating-config-fragments>` to be
+ :ref:`configuration fragment file <kernel-dev/kernel-dev-common:creating configuration fragments>` to be
referenced from within the kernel's ``.bbappend`` file.
Additionally, if you are working in a BSP layer and need to modify
--
2.29.2
^ permalink raw reply related [flat|nested] 12+ messages in thread
* [PATCH 06/11] test-manual: remove unused labels
2020-11-19 9:58 [PATCH 00/11] A first pass at removing labels Nicolas Dechesne
` (4 preceding siblings ...)
2020-11-19 9:58 ` [PATCH 05/11] kernel-dev: " Nicolas Dechesne
@ 2020-11-19 9:58 ` Nicolas Dechesne
2020-11-19 9:58 ` [PATCH 07/11] bsp-guide: " Nicolas Dechesne
` (4 subsequent siblings)
10 siblings, 0 replies; 12+ messages in thread
From: Nicolas Dechesne @ 2020-11-19 9:58 UTC (permalink / raw)
To: docs; +Cc: Nicolas Dechesne
Signed-off-by: Nicolas Dechesne <nicolas.dechesne@linaro.org>
---
.../test-manual/test-manual-intro.rst | 22 -------------------
.../test-manual/test-manual-test-process.rst | 2 --
.../test-manual-understand-autobuilder.rst | 20 -----------------
3 files changed, 44 deletions(-)
diff --git a/documentation/test-manual/test-manual-intro.rst b/documentation/test-manual/test-manual-intro.rst
index 25b79f7a0..b6d130591 100644
--- a/documentation/test-manual/test-manual-intro.rst
+++ b/documentation/test-manual/test-manual-intro.rst
@@ -4,8 +4,6 @@
The Yocto Project Test Environment Manual
*****************************************
-.. _test-welcome:
-
Welcome
=======
@@ -45,8 +43,6 @@ engineers:
Jenkins, or others. This repository has a branch per release of the
project defining the tests to run on a per release basis.
-.. _test-yocto-project-autobuilder-overview:
-
Yocto Project Autobuilder Overview
==================================
@@ -88,8 +84,6 @@ topology that includes a controller and a cluster of workers:
.. image:: figures/ab-test-cluster.png
:align: center
-.. _test-project-tests:
-
Yocto Project Tests - Types of Testing Overview
===============================================
@@ -169,8 +163,6 @@ thefollowing types of tests:
those new versions. If so, this target emails the maintainers with a
patch to let them know this is possible.
-.. _test-test-mapping:
-
How Tests Map to Areas of Code
==============================
@@ -326,8 +318,6 @@ directory at ``meta/lib/oeqa/selftest/cases`` directory.
For oe-selftest. bitbake testcases reside in the ``lib/bb/tests/``
directory.
-.. _bitbake-selftest-example:
-
``bitbake-selftest``
--------------------
@@ -354,8 +344,6 @@ Bitbake selftests are straightforward python unittest. Refer to the
Python unittest documentation for additional information on writing
these tests at: https://docs.python.org/3/library/unittest.html.
-.. _oe-selftest-example:
-
``oe-selftest``
---------------
@@ -399,8 +387,6 @@ builds. There is no data store available for these tests since the tests
launch the ``bitbake`` command and exist outside of its context. As a
result, common bitbake library functions (bb.\*) are also unavailable.
-.. _testimage-example:
-
``testimage``
-------------
@@ -429,8 +415,6 @@ To ensure certain test or package dependencies are met, you can use the
in this example would only make sense if python3-core is installed in
the image.
-.. _testsdk_ext-example:
-
``testsdk_ext``
---------------
@@ -463,8 +447,6 @@ In this example, the ``devtool``
command is tested to see whether a sample application can be built with
the ``devtool build`` command within the eSDK.
-.. _testsdk-example:
-
``testsdk``
-----------
@@ -488,8 +470,6 @@ In this example, if nativesdk-python3-core has been installed into the SDK, the
the python3 interpreter with a basic command to check it is working
correctly. The test would only run if python3 is installed in the SDK.
-.. _oe-build-perf-test-example:
-
``oe-build-perf-test``
----------------------
@@ -517,8 +497,6 @@ This example shows how three specific parsing timings are
measured, with and without various caches, to show how BitBake's parsing
performance trends over time.
-.. _test-writing-considerations:
-
Considerations When Writing Tests
=================================
diff --git a/documentation/test-manual/test-manual-test-process.rst b/documentation/test-manual/test-manual-test-process.rst
index b0817b091..82b9bb441 100644
--- a/documentation/test-manual/test-manual-test-process.rst
+++ b/documentation/test-manual/test-manual-test-process.rst
@@ -4,8 +4,6 @@
Project Testing and Release Process
***********************************
-.. _test-daily-devel:
-
Day to Day Development
======================
diff --git a/documentation/test-manual/test-manual-understand-autobuilder.rst b/documentation/test-manual/test-manual-understand-autobuilder.rst
index 244433376..698a266ee 100644
--- a/documentation/test-manual/test-manual-understand-autobuilder.rst
+++ b/documentation/test-manual/test-manual-understand-autobuilder.rst
@@ -73,8 +73,6 @@ The ``config.json`` file is processed by the scripts in the Helper
repository in the ``scripts`` directory. The following section details
how this works.
-.. _test-autobuilder-target-exec-overview:
-
Autobuilder Target Execution Overview
=====================================
@@ -135,16 +133,12 @@ roughly consist of:
This is another call into the Helper scripts where its expected that
the main functionality of this target will be executed.
-.. _test-autobuilder-tech:
-
Autobuilder Technology
======================
The Autobuilder has Yocto Project-specific functionality to allow builds
to operate with increased efficiency and speed.
-.. _test-clobberdir:
-
clobberdir
----------
@@ -155,8 +149,6 @@ which is run under ``ionice -c 3``. For example, the deletion only
happens when there is idle IO capacity on the Worker. The Autobuilder
Worker Janitor runs this deletion. See :ref:`test-manual/test-manual-understand-autobuilder:Autobuilder Worker Janitor`.
-.. _test-autobuilder-clone-cache:
-
Autobuilder Clone Cache
-----------------------
@@ -167,8 +159,6 @@ during clones first, then "topped up" with later revisions from any
upstream when necessary. The cache is maintained by the Autobuilder
Worker Janitor. See :ref:`test-manual/test-manual-understand-autobuilder:Autobuilder Worker Janitor`.
-.. _test-autobuilder-worker-janitor:
-
Autobuilder Worker Janitor
--------------------------
@@ -177,8 +167,6 @@ operations, including background file deletion at IO idle (see :ref:`test-manual
maintainenance of a cache of cloned repositories to improve the speed
the system can checkout repositories.
-.. _test-shared-dl-dir:
-
Shared DL_DIR
-------------
@@ -187,8 +175,6 @@ between them. This reduces network accesses from the system and allows
the build to be sped up. Usage of the directory within the build system
is designed to be able to be shared over NFS.
-.. _test-shared-sstate-cache:
-
Shared SSTATE_DIR
-----------------
@@ -197,8 +183,6 @@ directory to be shared between them. This means once a Worker has built
an artifact, all the others can benefit from it. Usage of the directory
within the directory is designed for sharing over NFS.
-.. _test-resulttool:
-
Resulttool
----------
@@ -213,8 +197,6 @@ reports of the test results and compare different result files.
For details, see :yocto_wiki:`/wiki/Resulttool`.
-.. _test-run-config-tgt-execution:
-
run-config Target Execution
===========================
@@ -264,8 +246,6 @@ of post-build steps, including:
:ref:`test-manual/test-manual-understand-autobuilder:clobberdir` if the build was successful,
else rename it to "build-renamed" for potential future debugging.
-.. _test-deploying-yp-autobuilder:
-
Deploying Yocto Autobuilder
===========================
--
2.29.2
^ permalink raw reply related [flat|nested] 12+ messages in thread
* [PATCH 07/11] bsp-guide: remove unused labels
2020-11-19 9:58 [PATCH 00/11] A first pass at removing labels Nicolas Dechesne
` (5 preceding siblings ...)
2020-11-19 9:58 ` [PATCH 06/11] test-manual: remove unused labels Nicolas Dechesne
@ 2020-11-19 9:58 ` Nicolas Dechesne
2020-11-19 9:58 ` [PATCH 08/11] kernel-dev: " Nicolas Dechesne
` (3 subsequent siblings)
10 siblings, 0 replies; 12+ messages in thread
From: Nicolas Dechesne @ 2020-11-19 9:58 UTC (permalink / raw)
To: docs; +Cc: Nicolas Dechesne
Signed-off-by: Nicolas Dechesne <nicolas.dechesne@linaro.org>
---
documentation/bsp-guide/bsp.rst | 20 --------------------
1 file changed, 20 deletions(-)
diff --git a/documentation/bsp-guide/bsp.rst b/documentation/bsp-guide/bsp.rst
index d0275eea9..408620212 100644
--- a/documentation/bsp-guide/bsp.rst
+++ b/documentation/bsp-guide/bsp.rst
@@ -241,8 +241,6 @@ section.
the script runs, your current working directory is set to the ``build``
directory.
-.. _bsp-filelayout:
-
Example Filesystem Layout
=========================
@@ -451,8 +449,6 @@ the :yocto_git:`Source Respositories <>`:
The following sections describe each part of the proposed BSP format.
-.. _bsp-filelayout-license:
-
License Files
-------------
@@ -471,8 +467,6 @@ developer. For information on how to maintain license compliance, see
the ":ref:`dev-manual/dev-manual-common-tasks:maintaining open source license compliance during your product's lifecycle`"
section in the Yocto Project Development Tasks Manual.
-.. _bsp-filelayout-readme:
-
README File
-----------
@@ -488,8 +482,6 @@ At a minimum, the ``README`` file must contain a list of dependencies,
such as the names of any other layers on which the BSP depends and the
name of the BSP maintainer with his or her contact information.
-.. _bsp-filelayout-readme-sources:
-
README.sources File
-------------------
@@ -509,8 +501,6 @@ used to generate the images that ship with the BSP.
If the BSP's ``binary`` directory is missing or the directory has no images, an
existing ``README.sources`` file is meaningless and usually does not exist.
-.. _bsp-filelayout-binary:
-
Pre-built User Binaries
-----------------------
@@ -534,8 +524,6 @@ hardware. Additionally, the
present to locate the sources used to build the images and provide
information on the Metadata.
-.. _bsp-filelayout-layer:
-
Layer Configuration File
------------------------
@@ -586,8 +574,6 @@ This file simply makes :term:`BitBake` aware of the recipes and configuration
directories. The file must exist so that the OpenEmbedded build system can
recognize the BSP.
-.. _bsp-filelayout-machine:
-
Hardware Configuration Options
------------------------------
@@ -626,8 +612,6 @@ configuration file. For example, the Raspberry Pi BSP
include conf/machine/include/rpi-base.inc
-.. _bsp-filelayout-misc-recipes:
-
Miscellaneous BSP-Specific Recipe Files
---------------------------------------
@@ -658,8 +642,6 @@ directory. Here is the ``machconfig`` file for the Raspberry Pi BSP: ::
``meta/recipes-bsp/formfactor/formfactor_0.0.bb``, which is found in
the :term:`Source Directory`.
-.. _bsp-filelayout-recipes-graphics:
-
Display Support Files
---------------------
@@ -671,8 +653,6 @@ This optional directory contains recipes for the BSP if it has special
requirements for graphics support. All files that are needed for the BSP
to support a display are kept here.
-.. _bsp-filelayout-kernel:
-
Linux Kernel Configuration
--------------------------
--
2.29.2
^ permalink raw reply related [flat|nested] 12+ messages in thread
* [PATCH 08/11] kernel-dev: remove unused labels
2020-11-19 9:58 [PATCH 00/11] A first pass at removing labels Nicolas Dechesne
` (6 preceding siblings ...)
2020-11-19 9:58 ` [PATCH 07/11] bsp-guide: " Nicolas Dechesne
@ 2020-11-19 9:58 ` Nicolas Dechesne
2020-11-19 9:58 ` [PATCH 09/11] profile-manual: " Nicolas Dechesne
` (2 subsequent siblings)
10 siblings, 0 replies; 12+ messages in thread
From: Nicolas Dechesne @ 2020-11-19 9:58 UTC (permalink / raw)
To: docs; +Cc: Nicolas Dechesne
Signed-off-by: Nicolas Dechesne <nicolas.dechesne@linaro.org>
---
documentation/kernel-dev/kernel-dev-advanced.rst | 8 --------
documentation/kernel-dev/kernel-dev-common.rst | 2 --
documentation/kernel-dev/kernel-dev-concepts-appx.rst | 2 --
documentation/kernel-dev/kernel-dev-faq.rst | 2 --
documentation/kernel-dev/kernel-dev-intro.rst | 2 --
5 files changed, 16 deletions(-)
diff --git a/documentation/kernel-dev/kernel-dev-advanced.rst b/documentation/kernel-dev/kernel-dev-advanced.rst
index b1537ccbe..ca049316e 100644
--- a/documentation/kernel-dev/kernel-dev-advanced.rst
+++ b/documentation/kernel-dev/kernel-dev-advanced.rst
@@ -4,8 +4,6 @@
Working with Advanced Metadata (``yocto-kernel-cache``)
*******************************************************
-.. _kernel-dev-advanced-overview:
-
Overview
========
@@ -478,8 +476,6 @@ concepts, and presents a detailed example using a BSP supported by the
Yocto Project (i.e. BeagleBone Board). For complete information on BSP
layer file hierarchy, see the :doc:`../bsp-guide/bsp-guide`.
-.. _bsp-description-file-overview:
-
Description Overview
~~~~~~~~~~~~~~~~~~~~
@@ -583,8 +579,6 @@ types of configurations. However, the Malta 32-bit board does
include mti-malta32.scc
kconf hardware mti-malta32-le.cfg
-.. _bsp-description-file-example-minnow:
-
Example
~~~~~~~
@@ -925,8 +919,6 @@ after any ``branch`` commands:
include mybsp-hw.scc
-.. _scc-reference:
-
SCC Description File Reference
==============================
diff --git a/documentation/kernel-dev/kernel-dev-common.rst b/documentation/kernel-dev/kernel-dev-common.rst
index 830b3e88c..72d9d7879 100644
--- a/documentation/kernel-dev/kernel-dev-common.rst
+++ b/documentation/kernel-dev/kernel-dev-common.rst
@@ -1301,8 +1301,6 @@ created to hold the configuration changes.
For more information on configuring the kernel, see the "`Changing the
Configuration <#changing-the-configuration>`__" section.
-.. _creating-config-fragments:
-
Creating Configuration Fragments
--------------------------------
diff --git a/documentation/kernel-dev/kernel-dev-concepts-appx.rst b/documentation/kernel-dev/kernel-dev-concepts-appx.rst
index 681faee52..470d6ce1c 100644
--- a/documentation/kernel-dev/kernel-dev-concepts-appx.rst
+++ b/documentation/kernel-dev/kernel-dev-concepts-appx.rst
@@ -4,8 +4,6 @@
Advanced Kernel Concepts
************************
-.. _kernel-big-picture:
-
Yocto Project Kernel Development and Maintenance
================================================
diff --git a/documentation/kernel-dev/kernel-dev-faq.rst b/documentation/kernel-dev/kernel-dev-faq.rst
index d6be98a0a..424e62617 100644
--- a/documentation/kernel-dev/kernel-dev-faq.rst
+++ b/documentation/kernel-dev/kernel-dev-faq.rst
@@ -4,8 +4,6 @@
Kernel Development FAQ
**********************
-.. _kernel-dev-faq-section:
-
Common Questions and Solutions
==============================
diff --git a/documentation/kernel-dev/kernel-dev-intro.rst b/documentation/kernel-dev/kernel-dev-intro.rst
index 971420b22..309c65b4d 100644
--- a/documentation/kernel-dev/kernel-dev-intro.rst
+++ b/documentation/kernel-dev/kernel-dev-intro.rst
@@ -4,8 +4,6 @@
Introduction
************
-.. _kernel-dev-overview:
-
Overview
========
--
2.29.2
^ permalink raw reply related [flat|nested] 12+ messages in thread
* [PATCH 09/11] profile-manual: remove unused labels
2020-11-19 9:58 [PATCH 00/11] A first pass at removing labels Nicolas Dechesne
` (7 preceding siblings ...)
2020-11-19 9:58 ` [PATCH 08/11] kernel-dev: " Nicolas Dechesne
@ 2020-11-19 9:58 ` Nicolas Dechesne
2020-11-19 9:58 ` [PATCH 10/11] sdk-manual: " Nicolas Dechesne
2020-11-19 9:58 ` [PATCH 11/11] toaster-manual: " Nicolas Dechesne
10 siblings, 0 replies; 12+ messages in thread
From: Nicolas Dechesne @ 2020-11-19 9:58 UTC (permalink / raw)
To: docs; +Cc: Nicolas Dechesne
Signed-off-by: Nicolas Dechesne <nicolas.dechesne@linaro.org>
---
.../profile-manual/profile-manual-intro.rst | 4 --
.../profile-manual/profile-manual-usage.rst | 46 -------------------
2 files changed, 50 deletions(-)
diff --git a/documentation/profile-manual/profile-manual-intro.rst b/documentation/profile-manual/profile-manual-intro.rst
index 0d435e0c0..4e1008b05 100644
--- a/documentation/profile-manual/profile-manual-intro.rst
+++ b/documentation/profile-manual/profile-manual-intro.rst
@@ -4,8 +4,6 @@
Yocto Project Profiling and Tracing Manual
******************************************
-.. _profile-intro:
-
Introduction
============
@@ -30,8 +28,6 @@ The final section of this 'HOWTO' is a collection of real-world examples
which we'll be continually adding to as we solve more problems using the
tools - feel free to add your own examples to the list!
-.. _profile-manual-general-setup:
-
General Setup
=============
diff --git a/documentation/profile-manual/profile-manual-usage.rst b/documentation/profile-manual/profile-manual-usage.rst
index d3c020a1c..cc403a554 100644
--- a/documentation/profile-manual/profile-manual-usage.rst
+++ b/documentation/profile-manual/profile-manual-usage.rst
@@ -10,8 +10,6 @@ Basic Usage (with examples) for each of the Yocto Tracing Tools
This chapter presents basic usage examples for each of the tracing
tools.
-.. _profile-manual-perf:
-
perf
====
@@ -43,8 +41,6 @@ want to apply the tool; full documentation can be found either within
the tool itself or in the man pages at
`perf(1) <http://linux.die.net/man/1/perf>`__.
-.. _perf-setup:
-
Perf Setup
----------
@@ -61,8 +57,6 @@ profile data and copy it to the host for analysis, but for the rest of
this document we assume you've ssh'ed to the host and will be running
the perf commands on the target.
-.. _perf-basic-usage:
-
Basic Perf Usage
----------------
@@ -950,8 +944,6 @@ We can look at the raw output using 'perf script' with no arguments: ::
kworker/1:1 21 [001] 6171.470082: sched_switch: prev_comm=kworker/1:1 prev_pid=21 prev_prio=120 prev_state=S ==> next_comm=perf next_pid=1383 next_prio=120
perf 1383 [001] 6171.480035: sched_wakeup: comm=kworker/1:1 pid=21 prio=120 success=1 target_cpu=001
-.. _perf-filtering:
-
Filtering
^^^^^^^^^
@@ -1138,8 +1130,6 @@ callgraphs from starting a few programs during those 30 seconds:
uprobes. kprobes and uprobes are also used by and in fact are the
main focus of SystemTap.
-.. _perf-documentation:
-
Perf Documentation
------------------
@@ -1182,8 +1172,6 @@ There's also a nice perf tutorial on the perf
wiki that goes into more detail than we do here in certain areas: `Perf
Tutorial <https://perf.wiki.kernel.org/index.php/Tutorial>`__
-.. _profile-manual-ftrace:
-
ftrace
======
@@ -1191,8 +1179,6 @@ ftrace
this encompasses a number of related tracers along with the
infrastructure that they all make use of.
-.. _ftrace-setup:
-
ftrace Setup
------------
@@ -1668,8 +1654,6 @@ trace-cmd and kernelshark in the next section.
/sys/kernel/debug/tracing will be removed and replaced with
equivalent tracers based on the 'trace events' subsystem.
-.. _trace-cmd-kernelshark:
-
trace-cmd/kernelshark
---------------------
@@ -1737,8 +1721,6 @@ The tool is pretty self-explanatory, but for more detailed information
on navigating through the data, see the `kernelshark
website <http://rostedt.homelinux.com/kernelshark/>`__.
-.. _ftrace-documentation:
-
ftrace Documentation
--------------------
@@ -1772,8 +1754,6 @@ There's more detailed documentation kernelshark usage here:
An amusing yet useful README (a tracing mini-HOWTO) can be found in
``/sys/kernel/debug/tracing/README``.
-.. _profile-manual-systemtap:
-
systemtap
=========
@@ -1835,8 +1815,6 @@ target system and 3) insert the module into the target kernel, which
arms it, and 4) collect the data generated by the probe and display it
to the user.
-.. _systemtap-setup:
-
systemtap Setup
---------------
@@ -1955,8 +1933,6 @@ no password):
matchbox-termin(1036) open ("/tmp/vte3FS2LW", O_RDWR|O_CREAT|O_EXCL|O_LARGEFILE, 0600)
matchbox-termin(1036) open ("/tmp/vteJMC7LW", O_RDWR|O_CREAT|O_EXCL|O_LARGEFILE, 0600)
-.. _systemtap-documentation:
-
systemtap Documentation
-----------------------
@@ -1967,8 +1943,6 @@ Links to other SystemTap documents, tutorials, and examples can be found
here: `SystemTap documentation
page <http://sourceware.org/systemtap/documentation.html>`__
-.. _profile-manual-sysprof:
-
Sysprof
=======
@@ -1976,8 +1950,6 @@ Sysprof is a very easy to use system-wide profiler that consists of a
single window with three panes and a few buttons which allow you to
start, stop, and view the profile from one place.
-.. _sysprof-setup:
-
Sysprof Setup
-------------
@@ -1990,8 +1962,6 @@ be running Sysprof on the target (you can use the '-X' option to ssh and
have the Sysprof GUI run on the target but display remotely on the host
if you want).
-.. _sysprof-basic-usage:
-
Basic Sysprof Usage
-------------------
@@ -2040,8 +2010,6 @@ to the selected function, and so on.
the -g (--call-graph) option that you can experiment with; one of the
options is 'caller' for an inverted caller-based callgraph display.
-.. _sysprof-documentation:
-
Sysprof Documentation
---------------------
@@ -2053,8 +2021,6 @@ Linux <http://sysprof.com/>`__
LTTng (Linux Trace Toolkit, next generation)
============================================
-.. _lttng-setup:
-
LTTng Setup
-----------
@@ -2239,8 +2205,6 @@ trace - it's still there in ~/lttng-traces): ::
root@crownbay:~# lttng destroy
Session auto-20190303-021943 destroyed at /home/root
-.. _lltng-documentation:
-
LTTng Documentation
-------------------
@@ -2254,8 +2218,6 @@ For information on LTTng in general, visit the `LTTng
Project <http://lttng.org/lttng2.0>`__ site. You can find a "Getting
Started" link on this site that takes you to an LTTng Quick Start.
-.. _profile-manual-blktrace:
-
blktrace
========
@@ -2264,8 +2226,6 @@ blktrace provides the tracing half of the equation; its output can be
piped into the blkparse program, which renders the data in a
human-readable form and does some basic analysis:
-.. _blktrace-setup:
-
blktrace Setup
--------------
@@ -2281,8 +2241,6 @@ collect and analyze the data on the host (see the
below). For the rest of this section we assume you've ssh'ed to the host and
will be running blkrace on the target.
-.. _blktrace-basic-usage:
-
Basic blktrace Usage
--------------------
@@ -2411,8 +2369,6 @@ I/O traffic during the run. You can look at the
`blkparse <http://linux.die.net/man/1/blkparse>`__ manpage to learn the
meaning of each field displayed in the trace listing.
-.. _blktrace-live-mode:
-
Live Mode
~~~~~~~~~
@@ -2603,8 +2559,6 @@ And this turns off tracing for the specified device: ::
root@crownbay:/sys/kernel/debug/tracing# echo 0 > /sys/block/sdc/trace/enable
-.. _blktrace-documentation:
-
blktrace Documentation
----------------------
--
2.29.2
^ permalink raw reply related [flat|nested] 12+ messages in thread
* [PATCH 10/11] sdk-manual: remove unused labels
2020-11-19 9:58 [PATCH 00/11] A first pass at removing labels Nicolas Dechesne
` (8 preceding siblings ...)
2020-11-19 9:58 ` [PATCH 09/11] profile-manual: " Nicolas Dechesne
@ 2020-11-19 9:58 ` Nicolas Dechesne
2020-11-19 9:58 ` [PATCH 11/11] toaster-manual: " Nicolas Dechesne
10 siblings, 0 replies; 12+ messages in thread
From: Nicolas Dechesne @ 2020-11-19 9:58 UTC (permalink / raw)
To: docs; +Cc: Nicolas Dechesne
Signed-off-by: Nicolas Dechesne <nicolas.dechesne@linaro.org>
---
.../sdk-manual/sdk-appendix-obtain.rst | 2 -
documentation/sdk-manual/sdk-extensible.rst | 44 -------------------
documentation/sdk-manual/sdk-intro.rst | 4 --
documentation/sdk-manual/sdk-using.rst | 6 ---
4 files changed, 56 deletions(-)
diff --git a/documentation/sdk-manual/sdk-appendix-obtain.rst b/documentation/sdk-manual/sdk-appendix-obtain.rst
index 8b0753969..eef425bdf 100644
--- a/documentation/sdk-manual/sdk-appendix-obtain.rst
+++ b/documentation/sdk-manual/sdk-appendix-obtain.rst
@@ -4,8 +4,6 @@
Obtaining the SDK
*****************
-.. _sdk-locating-pre-built-sdk-installers:
-
Locating Pre-Built SDK Installers
=================================
diff --git a/documentation/sdk-manual/sdk-extensible.rst b/documentation/sdk-manual/sdk-extensible.rst
index 5ff75ada2..10e4d2061 100644
--- a/documentation/sdk-manual/sdk-extensible.rst
+++ b/documentation/sdk-manual/sdk-extensible.rst
@@ -24,8 +24,6 @@ alternatively make use of the toolchain directly, for example from
Makefile and Autotools. See the "`Using the SDK Toolchain
Directly <#sdk-working-projects>`__" chapter for more information.
-.. _sdk-extensible-sdk-intro:
-
Why use the Extensible SDK and What is in It?
=============================================
@@ -40,8 +38,6 @@ Basically, it contains an SDK environment setup script, some
configuration files, an internal build system, and the ``devtool``
functionality.
-.. _sdk-installing-the-extensible-sdk:
-
Installing the Extensible SDK
=============================
@@ -138,8 +134,6 @@ architecture. The example assumes the SDK installer is located in
Each time you wish to use the SDK in a new shell session, you need to source the environment setup script e.g.
$ . /home/scottrif/poky_sdk/environment-setup-core2-64-poky-linux
-.. _sdk-running-the-extensible-sdk-environment-setup-script:
-
Running the Extensible SDK Environment Setup Script
===================================================
@@ -225,8 +219,6 @@ recipes and the source go into a "workspace" directory under the SDK.
The remainder of this section presents the ``devtool add``,
``devtool modify``, and ``devtool upgrade`` workflows.
-.. _sdk-use-devtool-to-add-an-application:
-
Use ``devtool add`` to Add an Application
-----------------------------------------
@@ -401,8 +393,6 @@ command:
proceed with your work. If you do use this command, realize that
the source tree is preserved.
-.. _sdk-devtool-use-devtool-modify-to-modify-the-source-of-an-existing-component:
-
Use ``devtool modify`` to Modify the Source of an Existing Component
--------------------------------------------------------------------
@@ -613,8 +603,6 @@ command:
proceed with your work. If you do use this command, realize that
the source tree is preserved.
-.. _sdk-devtool-use-devtool-upgrade-to-create-a-version-of-the-recipe-that-supports-a-newer-version-of-the-software:
-
Use ``devtool upgrade`` to Create a Version of the Recipe that Supports a Newer Version of the Software
-------------------------------------------------------------------------------------------------------
@@ -783,8 +771,6 @@ The following diagram shows the common development flow used with the
proceed with your work. If you do use this command, realize that
the source tree is preserved.
-.. _sdk-a-closer-look-at-devtool-add:
-
A Closer Look at ``devtool add``
================================
@@ -826,8 +812,6 @@ the source tree is assumed to be using CMake and is treated accordingly.
The remainder of this section covers specifics regarding how parts of
the recipe are generated.
-.. _sdk-name-and-version:
-
Name and Version
----------------
@@ -851,8 +835,6 @@ incorrect. For such a case, you must reset the recipe:
After running the ``devtool reset`` command, you need to
run ``devtool add`` again and provide the name or the version.
-.. _sdk-dependency-detection-and-mapping:
-
Dependency Detection and Mapping
--------------------------------
@@ -887,8 +869,6 @@ following to your recipe:
dependency with an option that disables the associated functionality
passed to the configure script.
-.. _sdk-license-detection:
-
License Detection
-----------------
@@ -920,8 +900,6 @@ with development even though the settings are unlikely to be correct in
all cases. You should check the documentation or source files for the
software you are building to determine the actual license.
-.. _sdk-adding-makefile-only-software:
-
Adding Makefile-Only Software
-----------------------------
@@ -981,8 +959,6 @@ mind:
``ldconfig``. For such cases, you might be able to apply patches that
remove these commands from the Makefile.
-.. _sdk-adding-native-tools:
-
Adding Native Tools
-------------------
@@ -1009,8 +985,6 @@ following methods when you run ``devtool add``:
"DASHDASHalso-native" option, you can add the tool using just one
recipe file.
-.. _sdk-adding-node-js-modules:
-
Adding Node.js Modules
----------------------
@@ -1053,8 +1027,6 @@ fetches the specified Git repository, detects the code as Node.js code,
fetches dependencies using ``npm``, and sets
:term:`SRC_URI` accordingly.
-.. _sdk-working-with-recipes:
-
Working With Recipes
====================
@@ -1093,8 +1065,6 @@ that most recipes typically need.
The remainder of this section presents information useful when working
with recipes.
-.. _sdk-finding-logs-and-work-files:
-
Finding Logs and Work Files
---------------------------
@@ -1127,8 +1097,6 @@ links created within the source tree:
You can use these links to get more information on what is happening at
each build step.
-.. _sdk-setting-configure-arguments:
-
Setting Configure Arguments
---------------------------
@@ -1155,8 +1123,6 @@ arguments specified through ``EXTRA_OECONF`` or
the output of the configure script's "DASHDASHhelp" option as a
reference.
-.. _sdk-sharing-files-between-recipes:
-
Sharing Files Between Recipes
-----------------------------
@@ -1179,8 +1145,6 @@ are cataloged in manifests in order to ensure they can be removed later
when a recipe is modified or removed. Thus, the sysroot is able to
remain free from stale files.
-.. _sdk-packaging:
-
Packaging
---------
@@ -1221,8 +1185,6 @@ you do not even need to set these variables in your recipe unless the
software the recipe is building installs files into non-standard
locations.
-.. _sdk-restoring-the-target-device-to-its-original-state:
-
Restoring the Target Device to its Original State
=================================================
@@ -1263,8 +1225,6 @@ target machine.
and package manager operations on the target device. Doing so could
result in a conflicting set of files.
-.. _sdk-installing-additional-items-into-the-extensible-sdk:
-
Installing Additional Items Into the Extensible SDK
===================================================
@@ -1298,8 +1258,6 @@ takes significantly longer than installing the pre-built artifact. Also,
if no recipe exists for the item you want to add to the SDK, you must
instead add the item using the ``devtool add`` command.
-.. _sdk-applying-updates-to-an-installed-extensible-sdk:
-
Applying Updates to an Installed Extensible SDK
===============================================
@@ -1327,8 +1285,6 @@ path_to_update_directory
The URL needs to point specifically to a published SDK and not to an
SDK installer that you would download and install.
-.. _sdk-creating-a-derivative-sdk-with-additional-components:
-
Creating a Derivative SDK With Additional Components
====================================================
diff --git a/documentation/sdk-manual/sdk-intro.rst b/documentation/sdk-manual/sdk-intro.rst
index acb3f455c..ca6138cce 100644
--- a/documentation/sdk-manual/sdk-intro.rst
+++ b/documentation/sdk-manual/sdk-intro.rst
@@ -4,8 +4,6 @@
Introduction
************
-.. _sdk-manual-intro:
-
eSDK Introduction
=================
@@ -127,8 +125,6 @@ script or through a :term:`Build Directory` that is based on
your metadata configuration or extension for your targeted device. The
cross-toolchain works with a matching target sysroot.
-.. _sysroot:
-
Sysroots
--------
diff --git a/documentation/sdk-manual/sdk-using.rst b/documentation/sdk-manual/sdk-using.rst
index 4b151e45c..3a1cae773 100644
--- a/documentation/sdk-manual/sdk-using.rst
+++ b/documentation/sdk-manual/sdk-using.rst
@@ -19,8 +19,6 @@ You can use a standard SDK to work on Makefile and Autotools-based
projects. See the "`Using the SDK Toolchain
Directly <#sdk-working-projects>`__" chapter for more information.
-.. _sdk-standard-sdk-intro:
-
Why use the Standard SDK and What is in It?
===========================================
@@ -37,8 +35,6 @@ usage. You can see the directory structure in the "`Installed Standard
SDK Directory
Structure <#sdk-installed-standard-sdk-directory-structure>`__" section.
-.. _sdk-installing-the-sdk:
-
Installing the SDK
==================
@@ -129,8 +125,6 @@ Structure <#sdk-installed-standard-sdk-directory-structure>`__" section
for more details on the resulting directory structure of the installed
SDK.
-.. _sdk-running-the-sdk-environment-setup-script:
-
Running the SDK Environment Setup Script
========================================
--
2.29.2
^ permalink raw reply related [flat|nested] 12+ messages in thread
* [PATCH 11/11] toaster-manual: remove unused labels
2020-11-19 9:58 [PATCH 00/11] A first pass at removing labels Nicolas Dechesne
` (9 preceding siblings ...)
2020-11-19 9:58 ` [PATCH 10/11] sdk-manual: " Nicolas Dechesne
@ 2020-11-19 9:58 ` Nicolas Dechesne
10 siblings, 0 replies; 12+ messages in thread
From: Nicolas Dechesne @ 2020-11-19 9:58 UTC (permalink / raw)
To: docs; +Cc: Nicolas Dechesne
Signed-off-by: Nicolas Dechesne <nicolas.dechesne@linaro.org>
---
.../toaster-manual/toaster-manual-intro.rst | 4 ----
.../toaster-manual-reference.rst | 22 -------------------
.../toaster-manual-setup-and-use.rst | 16 --------------
.../toaster-manual/toaster-manual-start.rst | 6 -----
4 files changed, 48 deletions(-)
diff --git a/documentation/toaster-manual/toaster-manual-intro.rst b/documentation/toaster-manual/toaster-manual-intro.rst
index 408c6fa3c..e34e7bac4 100644
--- a/documentation/toaster-manual/toaster-manual-intro.rst
+++ b/documentation/toaster-manual/toaster-manual-intro.rst
@@ -10,8 +10,6 @@ enables you to configure and run your builds. Information about builds
is collected and stored in a database. You can use Toaster to configure
and start builds on multiple remote build servers.
-.. _intro-features:
-
Toaster Features
================
@@ -82,8 +80,6 @@ For an overview of Toaster shipped with the Yocto Project &DISTRO;
Release, see the "`Toaster - Yocto Project
2.2 <https://youtu.be/BlXdOYLgPxA>`__" video.
-.. _toaster-installation-options:
-
Installation Options
====================
diff --git a/documentation/toaster-manual/toaster-manual-reference.rst b/documentation/toaster-manual/toaster-manual-reference.rst
index e5e3531e8..2202d599f 100644
--- a/documentation/toaster-manual/toaster-manual-reference.rst
+++ b/documentation/toaster-manual/toaster-manual-reference.rst
@@ -47,8 +47,6 @@ Metadata Index.
You do not have to use a layer source to use Toaster. Tying into a
layer source is optional.
-.. _layer-source-using-with-toaster:
-
Setting Up and Using a Layer Source
-----------------------------------
@@ -73,8 +71,6 @@ section in the Yocto Project Overview and Concepts Manual. For information on ho
to create layers, see the ":ref:`dev-manual/dev-manual-common-tasks:understanding and creating layers`"
section in the Yocto Project Development Tasks Manual.
-.. _configuring-toaster-to-hook-into-your-layer-source:
-
Configuring Toaster to Hook Into Your Layer Index
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -143,8 +139,6 @@ Toaster database by running the following command:
If Toaster can reach the API URL, you should see a message telling you that
Toaster is updating the layer source information.
-.. _toaster-releases:
-
Releases
========
@@ -157,8 +151,6 @@ However, you can modify, delete, and create new releases according to
your needs. This section provides some background information on
releases.
-.. _toaster-releases-supported:
-
Pre-Configured Releases
-----------------------
@@ -295,8 +287,6 @@ release selection:
<field type="CharField" name="dirpath">bitbake</field>
</object>
-.. _defining-releases:
-
Defining Release
~~~~~~~~~~~~~~~~
@@ -518,8 +508,6 @@ build:
The JSON data for this query is returned in a single line. In the
previous example the line has been artificially split for readability.
-.. _toaster-useful-commands:
-
Useful Commands
===============
@@ -548,8 +536,6 @@ tasks. You can locate these commands in the
Build Directory. To do so, the ``toastermain/settings.py`` file
must be configured to point to the correct database backend.
-.. _toaster-command-buildslist:
-
``buildslist``
--------------
@@ -580,8 +566,6 @@ command would return something like the following::
1: qemux86 poky core-image-minimal
-.. _toaster-command-builddelete:
-
``builddelete``
---------------
@@ -600,8 +584,6 @@ Prior to running the ``builddelete`` command, you need to get the ID
associated with builds by using the
:ref:`toaster-manual/toaster-manual-reference:\`\`buildslist\`\`` command.
-.. _toaster-command-perf:
-
``perf``
--------
@@ -615,8 +597,6 @@ follows:
The command is a sanity check that returns page loading times in order to
identify performance problems.
-.. _toaster-command-checksettings:
-
``checksettings``
-----------------
@@ -644,8 +624,6 @@ ready, you can run the following:
After running these commands, you can run the ``checksettings`` command.
-.. _toaster-command-runbuilds:
-
``runbuilds``
-------------
diff --git a/documentation/toaster-manual/toaster-manual-setup-and-use.rst b/documentation/toaster-manual/toaster-manual-setup-and-use.rst
index 97c5af6a0..b73caac37 100644
--- a/documentation/toaster-manual/toaster-manual-setup-and-use.rst
+++ b/documentation/toaster-manual/toaster-manual-setup-and-use.rst
@@ -121,8 +121,6 @@ can set the ``TOASTER_DIR`` environment variable, which takes precedence
over your current working directory. Setting this environment variable
causes Toaster to create and use ``$TOASTER_DIR./_toaster_clones``.
-.. _toaster-the-build-directory:
-
The Build Directory
===================
@@ -135,8 +133,6 @@ directories to be in a particular location, you can set the
current working directory. Setting this environment variable causes
Toaster to use ``$TOASTER_DIR/build`` as the build directory.
-.. _toaster-creating-a-django-super-user:
-
Creating a Django Superuser
===========================
@@ -186,8 +182,6 @@ You can use the Django administration interface to set Toaster configuration
parameters such as the build directory, layer sources, default variable
values, and BitBake versions.
-.. _toaster-setting-up-a-production-instance-of-toaster:
-
Setting Up a Production Instance of Toaster
===========================================
@@ -197,8 +191,6 @@ instance is also the setup that can handle heavier loads on the web
service. Use the instructions in the following sections to set up
Toaster to run builds through the Toaster web interface.
-.. _toaster-production-instance-requirements:
-
Requirements
------------
@@ -230,8 +222,6 @@ Be sure you meet the following requirements:
$ sudo zypper install apache2 apache2-mod_wsgi-python3 python3-pip mariadb mariadb-client python3-devel
-.. _toaster-installation-steps:
-
Installation
------------
@@ -504,8 +494,6 @@ The Toaster web interface allows you to do the following:
- See performance information such as build time, task time, CPU usage,
and disk I/O.
-.. _web-interface-videos:
-
Toaster Web Interface Videos
----------------------------
@@ -551,8 +539,6 @@ Following are several videos that show how to use the Toaster GUI:
`video <https://www.youtube.com/watch?v=qWGMrJoqusQ>`__ shows the
build performance data provided by Toaster.
-.. _a-note-on-the-local-yocto-project-release:
-
Additional Information About the Local Yocto Project Release
------------------------------------------------------------
@@ -604,8 +590,6 @@ them into your Toaster project, using the "Import layer" page.
:align: center
:scale: 75%
-.. _toaster-web-interface-preferred-version:
-
Building a Specific Recipe Given Multiple Versions
--------------------------------------------------
diff --git a/documentation/toaster-manual/toaster-manual-start.rst b/documentation/toaster-manual/toaster-manual-start.rst
index 267f9f4cd..888337416 100644
--- a/documentation/toaster-manual/toaster-manual-start.rst
+++ b/documentation/toaster-manual/toaster-manual-start.rst
@@ -9,8 +9,6 @@ Preparing to Use Toaster
This chapter describes how you need to prepare your system in order to
use Toaster.
-.. _toaster-setting-up-the-basic-system-requirements:
-
Setting Up the Basic System Requirements
========================================
@@ -22,8 +20,6 @@ also need to do an additional install of pip3. ::
$ sudo apt-get install python3-pip
-.. _toaster-establishing-toaster-system-dependencies:
-
Establishing Toaster System Dependencies
========================================
@@ -35,8 +31,6 @@ directory, which is located in the root directory of the
``poky/bitbake/toaster-requirements.txt``). The dependencies appear in a
``pip``, install-compatible format.
-.. _toaster-load-packages:
-
Install Toaster Packages
------------------------
--
2.29.2
^ permalink raw reply related [flat|nested] 12+ messages in thread