diff options
author | Trevor Woerner <twoerner@gmail.com> | 2025-05-23 21:49:02 -0400 |
---|---|---|
committer | Steve Sakoman <steve@sakoman.com> | 2025-06-02 10:26:30 -0700 |
commit | e27ee8c2680d85eb8fbb016fa38714e1d2bc8691 (patch) | |
tree | fad790dbad7a63489241e0dd49225a005b8ebdf4 /documentation/ref-manual | |
parent | 89da6e7a4a75536697fa9b5a7b3c9682fc802325 (diff) | |
download | poky-e27ee8c2680d85eb8fbb016fa38714e1d2bc8691.tar.gz |
sphinx-lint: unbalanced inline literal markup
Fix as many instances of unbalanced-inline-literals-delimiters as reported
by 'make sphinx-lint' as possible. Sphinx and/or its linter seem to get
tripped up randomly when references contain links to a heading which
contain literals enclosed in double-back-tics; especially in the cases
where a heading either contains multiple literals or when the literal is
not at the end of the heading. Not all of them can be "fixed" to pass both
building and linting.
(From yocto-docs rev: 73f4a3e3efce8c4e43939e5053f128faae5b41b1)
Signed-off-by: Trevor Woerner <twoerner@gmail.com>
Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
(cherry picked from commit 3460177c46d360b0f2f852cdab23f21bd4ec6d5a)
Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
Signed-off-by: Steve Sakoman <steve@sakoman.com>
Diffstat (limited to 'documentation/ref-manual')
-rw-r--r-- | documentation/ref-manual/devtool-reference.rst | 2 | ||||
-rw-r--r-- | documentation/ref-manual/structure.rst | 2 | ||||
-rw-r--r-- | documentation/ref-manual/tasks.rst | 4 | ||||
-rw-r--r-- | documentation/ref-manual/terms.rst | 2 | ||||
-rw-r--r-- | documentation/ref-manual/variables.rst | 8 |
5 files changed, 9 insertions, 9 deletions
diff --git a/documentation/ref-manual/devtool-reference.rst b/documentation/ref-manual/devtool-reference.rst index e173720e1a..5ac567591c 100644 --- a/documentation/ref-manual/devtool-reference.rst +++ b/documentation/ref-manual/devtool-reference.rst | |||
@@ -435,7 +435,7 @@ You can read more on the ``devtool upgrade`` workflow in the | |||
435 | ":ref:`dev-manual/devtool:use \`\`devtool upgrade\`\` to create a version of the recipe that supports a newer version of the software`" | 435 | ":ref:`dev-manual/devtool:use \`\`devtool upgrade\`\` to create a version of the recipe that supports a newer version of the software`" |
436 | section in the Yocto Project Application Development and the Extensible | 436 | section in the Yocto Project Application Development and the Extensible |
437 | Software Development Kit (eSDK) manual. You can also see an example of | 437 | Software Development Kit (eSDK) manual. You can also see an example of |
438 | how to use ``devtool upgrade`` in the ":ref:`dev-manual/upgrading-recipes:using \`\`devtool upgrade\`\``" | 438 | how to use ``devtool upgrade`` in the ":ref:`dev-manual/upgrading-recipes:using ``devtool upgrade```" |
439 | section in the Yocto Project Development Tasks Manual. | 439 | section in the Yocto Project Development Tasks Manual. |
440 | 440 | ||
441 | .. _devtool-resetting-a-recipe: | 441 | .. _devtool-resetting-a-recipe: |
diff --git a/documentation/ref-manual/structure.rst b/documentation/ref-manual/structure.rst index 616c3c4c9b..2190f5b90e 100644 --- a/documentation/ref-manual/structure.rst +++ b/documentation/ref-manual/structure.rst | |||
@@ -515,7 +515,7 @@ generated during the :ref:`ref-tasks-packagedata` task. The files stored in this | |||
515 | directory contain information about each output package produced by the | 515 | directory contain information about each output package produced by the |
516 | OpenEmbedded build system, and are used in different ways by the build system | 516 | OpenEmbedded build system, and are used in different ways by the build system |
517 | such as ":ref:`dev-manual/debugging:viewing package information with | 517 | such as ":ref:`dev-manual/debugging:viewing package information with |
518 | \`\`oe-pkgdata-util\`\``". | 518 | ``oe-pkgdata-util```". |
519 | 519 | ||
520 | .. _structure-build-tmp-sstate-control: | 520 | .. _structure-build-tmp-sstate-control: |
521 | 521 | ||
diff --git a/documentation/ref-manual/tasks.rst b/documentation/ref-manual/tasks.rst index d2e1f4ce14..d85d1151f0 100644 --- a/documentation/ref-manual/tasks.rst +++ b/documentation/ref-manual/tasks.rst | |||
@@ -726,7 +726,7 @@ tool, which you then use to modify the kernel configuration. | |||
726 | $ bitbake linux-yocto -c menuconfig | 726 | $ bitbake linux-yocto -c menuconfig |
727 | 727 | ||
728 | 728 | ||
729 | See the ":ref:`kernel-dev/common:using \`\`menuconfig\`\``" | 729 | See the ":ref:`kernel-dev/common:using ``menuconfig```" |
730 | section in the Yocto Project Linux Kernel Development Manual for more | 730 | section in the Yocto Project Linux Kernel Development Manual for more |
731 | information on this configuration tool. | 731 | information on this configuration tool. |
732 | 732 | ||
@@ -750,7 +750,7 @@ which can then be applied by subsequent tasks such as | |||
750 | 750 | ||
751 | Runs ``make menuconfig`` for the kernel. For information on | 751 | Runs ``make menuconfig`` for the kernel. For information on |
752 | ``menuconfig``, see the | 752 | ``menuconfig``, see the |
753 | ":ref:`kernel-dev/common:using \`\`menuconfig\`\``" | 753 | ":ref:`kernel-dev/common:using ``menuconfig```" |
754 | section in the Yocto Project Linux Kernel Development Manual. | 754 | section in the Yocto Project Linux Kernel Development Manual. |
755 | 755 | ||
756 | .. _ref-tasks-savedefconfig: | 756 | .. _ref-tasks-savedefconfig: |
diff --git a/documentation/ref-manual/terms.rst b/documentation/ref-manual/terms.rst index 9d765c89c8..9f61061415 100644 --- a/documentation/ref-manual/terms.rst +++ b/documentation/ref-manual/terms.rst | |||
@@ -63,7 +63,7 @@ universal, the list includes them just in case: | |||
63 | This term refers to the area used by the OpenEmbedded build system for | 63 | This term refers to the area used by the OpenEmbedded build system for |
64 | builds. The area is created when you ``source`` the setup environment | 64 | builds. The area is created when you ``source`` the setup environment |
65 | script that is found in the Source Directory | 65 | script that is found in the Source Directory |
66 | (i.e. :ref:`ref-manual/structure:\`\`oe-init-build-env\`\``). The | 66 | (i.e. :ref:`ref-manual/structure:``oe-init-build-env```). The |
67 | :term:`TOPDIR` variable points to the :term:`Build Directory`. | 67 | :term:`TOPDIR` variable points to the :term:`Build Directory`. |
68 | 68 | ||
69 | You have a lot of flexibility when creating the :term:`Build Directory`. | 69 | You have a lot of flexibility when creating the :term:`Build Directory`. |
diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst index 00ab881011..6b4acd2244 100644 --- a/documentation/ref-manual/variables.rst +++ b/documentation/ref-manual/variables.rst | |||
@@ -2243,7 +2243,7 @@ system and gives an overview of their function and contents. | |||
2243 | resides within the :term:`Build Directory` as ``${TMPDIR}/deploy``. | 2243 | resides within the :term:`Build Directory` as ``${TMPDIR}/deploy``. |
2244 | 2244 | ||
2245 | For more information on the structure of the Build Directory, see | 2245 | For more information on the structure of the Build Directory, see |
2246 | ":ref:`ref-manual/structure:the build directory --- \`\`build/\`\``" section. | 2246 | ":ref:`ref-manual/structure:the build directory --- ``build/```" section. |
2247 | For more detail on the contents of the ``deploy`` directory, see the | 2247 | For more detail on the contents of the ``deploy`` directory, see the |
2248 | ":ref:`overview-manual/concepts:images`", | 2248 | ":ref:`overview-manual/concepts:images`", |
2249 | ":ref:`overview-manual/concepts:package feeds`", and | 2249 | ":ref:`overview-manual/concepts:package feeds`", and |
@@ -2285,7 +2285,7 @@ system and gives an overview of their function and contents. | |||
2285 | contents of :term:`IMGDEPLOYDIR` by the :ref:`ref-classes-image` class. | 2285 | contents of :term:`IMGDEPLOYDIR` by the :ref:`ref-classes-image` class. |
2286 | 2286 | ||
2287 | For more information on the structure of the :term:`Build Directory`, see | 2287 | For more information on the structure of the :term:`Build Directory`, see |
2288 | ":ref:`ref-manual/structure:the build directory --- \`\`build/\`\``" section. | 2288 | ":ref:`ref-manual/structure:the build directory --- ``build/```" section. |
2289 | For more detail on the contents of the ``deploy`` directory, see the | 2289 | For more detail on the contents of the ``deploy`` directory, see the |
2290 | ":ref:`overview-manual/concepts:images`" and | 2290 | ":ref:`overview-manual/concepts:images`" and |
2291 | ":ref:`overview-manual/concepts:application development sdk`" sections both in | 2291 | ":ref:`overview-manual/concepts:application development sdk`" sections both in |
@@ -7084,7 +7084,7 @@ system and gives an overview of their function and contents. | |||
7084 | For examples of how this data is used, see the | 7084 | For examples of how this data is used, see the |
7085 | ":ref:`overview-manual/concepts:automatically added runtime dependencies`" | 7085 | ":ref:`overview-manual/concepts:automatically added runtime dependencies`" |
7086 | section in the Yocto Project Overview and Concepts Manual and the | 7086 | section in the Yocto Project Overview and Concepts Manual and the |
7087 | ":ref:`dev-manual/debugging:viewing package information with \`\`oe-pkgdata-util\`\``" | 7087 | ":ref:`dev-manual/debugging:viewing package information with ``oe-pkgdata-util```" |
7088 | section in the Yocto Project Development Tasks Manual. For more | 7088 | section in the Yocto Project Development Tasks Manual. For more |
7089 | information on the shared, global-state directory, see | 7089 | information on the shared, global-state directory, see |
7090 | :term:`STAGING_DIR_HOST`. | 7090 | :term:`STAGING_DIR_HOST`. |
@@ -7138,7 +7138,7 @@ system and gives an overview of their function and contents. | |||
7138 | the package is built, the version information can be retrieved with | 7138 | the package is built, the version information can be retrieved with |
7139 | ``oe-pkgdata-util package-info <package name>``. See the | 7139 | ``oe-pkgdata-util package-info <package name>``. See the |
7140 | :ref:`dev-manual/debugging:Viewing Package Information with | 7140 | :ref:`dev-manual/debugging:Viewing Package Information with |
7141 | \`\`oe-pkgdata-util\`\`` section of the Yocto Project Development Tasks | 7141 | ``oe-pkgdata-util``` section of the Yocto Project Development Tasks |
7142 | Manual for more information on ``oe-pkgdata-util``. | 7142 | Manual for more information on ``oe-pkgdata-util``. |
7143 | 7143 | ||
7144 | 7144 | ||