16accb6b24
- 264 license table entries with exact download URLs (224/264 resolved) - Complete sources/ directory with all BitBake recipes - Build configuration: tqma6ul-multi-mba6ulx, spaetzle (musl) - Full traceability for Softwarefreigabeantrag - GCC 13.4.0, Linux 6.6.102, U-Boot 2023.04, musl 1.2.4 - License distribution: GPL-2.0 (24), MIT (23), GPL-2.0+ (18), BSD-3 (16)
56 lines
1.7 KiB
Plaintext
56 lines
1.7 KiB
Plaintext
Documentation
|
|
=============
|
|
|
|
This is the directory that contains the BitBake documentation.
|
|
|
|
Manual Organization
|
|
===================
|
|
|
|
Folders exist for individual manuals as follows:
|
|
|
|
* bitbake-user-manual --- The BitBake User Manual
|
|
|
|
Each folder is self-contained regarding content and figures.
|
|
|
|
If you want to find HTML versions of the BitBake manuals on the web,
|
|
go to https://www.openembedded.org/wiki/Documentation.
|
|
|
|
Sphinx
|
|
======
|
|
|
|
The BitBake documentation was migrated from the original DocBook
|
|
format to Sphinx based documentation for the Yocto Project 3.2
|
|
release.
|
|
|
|
Additional information related to the Sphinx migration, and guidelines
|
|
for developers willing to contribute to the BitBake documentation can
|
|
be found in the Yocto Project Documentation README file:
|
|
|
|
https://git.yoctoproject.org/cgit/cgit.cgi/yocto-docs/tree/documentation/README
|
|
|
|
How to build the Yocto Project documentation
|
|
============================================
|
|
|
|
Sphinx is written in Python. While it might work with Python2, for
|
|
obvious reasons, we will only support building the BitBake
|
|
documentation with Python3.
|
|
|
|
Sphinx might be available in your Linux distro packages repositories,
|
|
however it is not recommend using distro packages, as they might be
|
|
old versions, especially if you are using an LTS version of your
|
|
distro. The recommended method to install Sphinx and all required
|
|
dependencies is to use the Python Package Index (pip).
|
|
|
|
To install all required packages run:
|
|
|
|
$ pip3 install sphinx sphinx_rtd_theme pyyaml
|
|
|
|
To build the documentation locally, run:
|
|
|
|
$ cd doc
|
|
$ make html
|
|
|
|
The resulting HTML index page will be _build/html/index.html, and you
|
|
can browse your own copy of the locally generated documentation with
|
|
your browser.
|