From ddc9e2fd33abe6a0de7b4e0dacdb6f530ee99871 Mon Sep 17 00:00:00 2001 From: Nicolas Dechesne Date: Wed, 7 Apr 2021 18:35:06 +0200 Subject: docs: add a top level page for bitbake documentation The top level index file includes a link to the Bitbake documentation. This link is static, however the location of the Bitbake documentation depends on the intersphinx configuration. As such, when looking at an old YP docs release, the link to the bitbake documentation is always the same (and wrong). Since we cannot use a cross reference in a toc index, this patch creates an intermediate page for bitbake documentation, and in that page we insert the right link to the bibtake documentation (e.g. :doc:`bitbake:index`) which will be adjusted dynamically based on intersphinx config. (From yocto-docs rev: 4f7f451df266a307b34bf145b29291ca85eb882f) Signed-off-by: Nicolas Dechesne Tested-by: Michael Opdenacker Signed-off-by: Richard Purdie --- documentation/bitbake.rst | 19 +++++++++++++++++++ documentation/index.rst | 2 +- 2 files changed, 20 insertions(+), 1 deletion(-) create mode 100644 documentation/bitbake.rst diff --git a/documentation/bitbake.rst b/documentation/bitbake.rst new file mode 100644 index 0000000000..7702f9322c --- /dev/null +++ b/documentation/bitbake.rst @@ -0,0 +1,19 @@ +.. SPDX-License-Identifier: CC-BY-SA-2.0-UK + +===================== +BitBake Documentation +===================== + +| + +BitBake was originally a part of the OpenEmbedded project. It was inspired by +the Portage package management system used by the Gentoo Linux distribution. In +2004, the OpenEmbedded project was split the project into two distinct pieces: + +- BitBake, a generic task executor +- OpenEmbedded, a metadata set utilized by BitBake + +Today, BitBake is the primary build tool of OpenEmbedded based projects, such as +the Yocto Project. + +The BitBake documentation can be found :doc:`here `. diff --git a/documentation/index.rst b/documentation/index.rst index 9f41daf4b4..6aeeb2197b 100644 --- a/documentation/index.rst +++ b/documentation/index.rst @@ -34,7 +34,7 @@ Welcome to the Yocto Project Documentation Application Development and the Extensible SDK (eSDK) Toaster Manual Test Environment Manual - Bitbake User Manual + bitbake .. toctree:: :maxdepth: 1 -- cgit v1.2.3-54-g00ecf