mirror of
https://git.yoctoproject.org/git/poky
synced 2026-01-01 13:58:04 +00:00
ae290dd402
The current documentation is lacking details on the different kinds of directories for putting classes as well as the order in which BitBake includes files (classes or include files). This patch does the following changes: - Mention the missing classes-recipe and classes-global when applicable. - Add a Class Types section detailed the three different directories for putting classes. - Move the existing section on locating classes/include files below the documentation on the different directives (include/require/inherit). - Extend the documentation on locating files with include/require and inherit to give proper examples, hopefully demystifying this mechanism a bit. [YOCTO #15724] (Bitbake rev: 7bd36f6c6d33211bb2a6b6fc6d40bdbd83b8b7c3) Signed-off-by: Antonin Godard <antonin.godard@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org> |
||
|---|---|---|
| .. | ||
| _templates | ||
| bitbake-user-manual | ||
| sphinx-static | ||
| template | ||
| .gitignore | ||
| bitbake.1 | ||
| conf.py | ||
| COPYING.GPL | ||
| COPYING.MIT | ||
| genindex.rst | ||
| index.rst | ||
| Makefile | ||
| README | ||
| releases.rst | ||
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.