mirror of
https://git.yoctoproject.org/poky
synced 2026-01-29 21:08:42 +01:00
sphinx: replace bitbake labels with references to corresponding title
In order to remove autogenerated labels in the bibtake docs, let's use section titles in all YP docs. (From yocto-docs rev: 0f44b6027f16cc37260abc7e00042d98e2e0427f) Signed-off-by: Nicolas Dechesne <nicolas.dechesne@linaro.org> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
committed by
Richard Purdie
parent
308cffcef1
commit
63710fc913
@@ -246,7 +246,7 @@ an entire Linux distribution, including the toolchain, from source.
|
||||
For information on using the ``bitbake`` command, see the
|
||||
:ref:`usingpoky-components-bitbake` section in the Yocto Project Overview and
|
||||
Concepts Manual, or see the ":ref:`BitBake Command
|
||||
<bitbake:bitbake-user-manual-command>`" section in the BitBake User Manual.
|
||||
<bitbake:bitbake-user-manual/bitbake-user-manual-intro:the bitbake command>`" section in the BitBake User Manual.
|
||||
|
||||
#. **Simulate Your Image Using QEMU:** Once this particular image is
|
||||
built, you can start QEMU, which is a Quick EMUlator that ships with
|
||||
|
||||
@@ -1369,7 +1369,7 @@ the Yocto Project Overview and Concepts Manual.
|
||||
|
||||
The :ref:`ref-tasks-fetch` task uses
|
||||
the prefix of each entry in the ``SRC_URI`` variable value to determine
|
||||
which :ref:`fetcher <bitbake:bb-fetchers>` to use to get your
|
||||
which :ref:`fetcher <bitbake:bitbake-user-manual/bitbake-user-manual-fetching:fetchers>` to use to get your
|
||||
source files. It is the ``SRC_URI`` variable that triggers the fetcher.
|
||||
The :ref:`ref-tasks-patch` task uses
|
||||
the variable after source is fetched to apply patches. The OpenEmbedded
|
||||
@@ -7567,7 +7567,7 @@ Creating Node Package Manager (NPM) Packages
|
||||
|
||||
`NPM <https://en.wikipedia.org/wiki/Npm_(software)>`__ is a package
|
||||
manager for the JavaScript programming language. The Yocto Project
|
||||
supports the NPM :ref:`fetcher <bitbake:bb-fetchers>`. You can
|
||||
supports the NPM :ref:`fetcher <bitbake:bitbake-user-manual/bitbake-user-manual-fetching:fetchers>`. You can
|
||||
use this fetcher in combination with
|
||||
:doc:`devtool <../ref-manual/ref-devtool-reference>` to create
|
||||
recipes that produce NPM packages.
|
||||
|
||||
@@ -369,7 +369,7 @@ in the "`Features <#features>`__" section. The
|
||||
variable in the kernel recipe selects the kernel type. For example, in
|
||||
the ``linux-yocto_4.12.bb`` kernel recipe found in
|
||||
``poky/meta/recipes-kernel/linux``, a
|
||||
:ref:`require <bitbake:require-inclusion>` directive
|
||||
:ref:`require <bitbake:bitbake-user-manual/bitbake-user-manual-metadata:\`\`require\`\` directive>` directive
|
||||
includes the ``poky/meta/recipes-kernel/linux/linux-yocto.inc`` file,
|
||||
which has the following statement that defines the default kernel type:
|
||||
::
|
||||
|
||||
@@ -78,7 +78,7 @@ versions of ``matchbox-desktop`` might exist. BitBake chooses the one
|
||||
selected by the distribution configuration. You can get more details
|
||||
about how BitBake chooses between different target versions and
|
||||
providers in the
|
||||
":ref:`Preferences <bitbake:bb-bitbake-preferences>`" section
|
||||
":ref:`Preferences <bitbake:bitbake-user-manual/bitbake-user-manual-execution:preferences>`" section
|
||||
of the BitBake User Manual.
|
||||
|
||||
BitBake also tries to execute any dependent tasks first. So for example,
|
||||
@@ -607,7 +607,7 @@ Source Control Managers (Optional)
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
Another place from which the build system can get source files is with
|
||||
:ref:`fetchers <bitbake:bb-fetchers>` employing various Source
|
||||
:ref:`fetchers <bitbake:bitbake-user-manual/bitbake-user-manual-fetching:fetchers>` employing various Source
|
||||
Control Managers (SCMs) such as Git or Subversion. In such cases, a
|
||||
repository is cloned or checked out. The
|
||||
:ref:`ref-tasks-fetch` task inside
|
||||
@@ -1949,7 +1949,7 @@ The following list explains the previous example:
|
||||
extra metadata to the `stamp
|
||||
file <#stamp-files-and-the-rerunning-of-tasks>`__. In this case, the
|
||||
metadata makes the task specific to a machine's architecture. See
|
||||
":ref:`bitbake:ref-bitbake-tasklist`"
|
||||
":ref:`bitbake:bitbake-user-manual/bitbake-user-manual-execution:the task list`"
|
||||
section in the BitBake User Manual for more information on the
|
||||
``stamp-extra-info`` flag.
|
||||
|
||||
|
||||
@@ -198,7 +198,7 @@ The following changes took place for BitBake:
|
||||
fetcher passes the new parameter through the ``SVN_SSH`` environment
|
||||
variable during the :ref:`ref-tasks-fetch` task.
|
||||
|
||||
See the ":ref:`bitbake:svn-fetcher`"
|
||||
See the ":ref:`bitbake:bitbake-user-manual/bitbake-user-manual-fetching:subversion (svn) fetcher (\`\`svn://\`\`)`"
|
||||
section in the BitBake
|
||||
User Manual for additional information.
|
||||
|
||||
|
||||
@@ -278,7 +278,7 @@ The following changes have occurred:
|
||||
specifying list items to remove, be aware that leading and trailing
|
||||
whitespace resulting from the removal is retained.
|
||||
|
||||
See the ":ref:`bitbake:removing-override-style-syntax`"
|
||||
See the ":ref:`bitbake:bitbake-user-manual/bitbake-user-manual-metadata:removal (override style syntax)`"
|
||||
section in the BitBake User Manual for a detailed example.
|
||||
|
||||
.. _migration-2.6-systemd-configuration-now-split-out-to-system-conf:
|
||||
|
||||
@@ -352,7 +352,7 @@ particular recipe.
|
||||
`maintainers.inc <http://git.yoctoproject.org/cgit/cgit.cgi/poky/tree/meta/conf/distro/include/maintainers.inc>`_
|
||||
file.
|
||||
|
||||
- If the recipe is using the :ref:`bitbake:git-fetcher`
|
||||
- If the recipe is using the :ref:`bitbake:bitbake-user-manual/bitbake-user-manual-fetching:git fetcher (\`\`git://\`\`)`
|
||||
rather than a
|
||||
tarball, the commit hash points to the commit that matches the
|
||||
recipe's latest version tag.
|
||||
|
||||
@@ -122,7 +122,7 @@ If the ``do_deploy`` task re-executes, any previous output is removed
|
||||
|
||||
Fetches the source code. This task uses the
|
||||
:term:`SRC_URI` variable and the argument's prefix to
|
||||
determine the correct :ref:`fetcher <bitbake:bb-fetchers>`
|
||||
determine the correct :ref:`fetcher <bitbake:bitbake-user-manual/bitbake-user-manual-fetching:fetchers>`
|
||||
module.
|
||||
|
||||
.. _ref-tasks-image:
|
||||
|
||||
@@ -3062,7 +3062,7 @@ system and gives an overview of their function and contents.
|
||||
section in the Yocto Project Development Tasks Manual.
|
||||
|
||||
- Using ``IMAGE_INSTALL`` with the
|
||||
:ref:`+= <bitbake:appending-and-prepending>`
|
||||
:ref:`+= <bitbake:bitbake-user-manual/bitbake-user-manual-metadata:appending (+=) and prepending (=+) with spaces>`
|
||||
BitBake operator within the ``/conf/local.conf`` file or from
|
||||
within an image recipe is not recommended. Use of this operator
|
||||
in these ways can cause ordering issues. Since
|
||||
@@ -7018,7 +7018,7 @@ system and gives an overview of their function and contents.
|
||||
protocols are highly dependent on particular BitBake Fetcher
|
||||
submodules. Depending on the fetcher BitBake uses, various URL
|
||||
parameters are employed. For specifics on the supported Fetchers, see
|
||||
the ":ref:`Fetchers <bitbake:bb-fetchers>`" section in the
|
||||
the ":ref:`Fetchers <bitbake:bitbake-user-manual/bitbake-user-manual-fetching:fetchers>`" section in the
|
||||
BitBake User Manual.
|
||||
|
||||
- ``file://`` - Fetches files, which are usually files shipped
|
||||
|
||||
@@ -627,7 +627,7 @@ specify source code revision and versioning schemes, extract code into
|
||||
or out of the ``devtool``
|
||||
:ref:`devtool-the-workspace-layer-structure`,
|
||||
and work with any source file forms that the
|
||||
:ref:`fetchers <bitbake:bb-fetchers>` support.
|
||||
:ref:`fetchers <bitbake:bitbake-user-manual/bitbake-user-manual-fetching:fetchers>` support.
|
||||
|
||||
The following diagram shows the common development flow used with the
|
||||
``devtool upgrade`` command:
|
||||
|
||||
Reference in New Issue
Block a user