orphan:

Welcome to Zephyr Kernel

Welcome to the Zephyr Project.

Thank you for your interest in the Zephyr Project. These instructions are designed to walk you through generating the Zephyr Project's documentation.

Documentation Notes

The project's documentation currently comprises the following items:

• An Installation Guide for Linux host systems
• A set of Collaboration Guidelines for the project.
• Doxygen output from the code base for all APIs.

Installing the documentation processors

Install the current version of Sphinx, type:

$ git clone https://github.com/sphinx-doc/sphinx.git sphinx

$ cd sphinx

$ sudo -E python setup.py install

$ cd ..

$ git clone https://github.com/michaeljones/breathe.git breathe

$ cd breathe

$ sudo -E python setup.py install

To install ReadTheDocs.org theme, use pip to install the python package:

$ pip install sphinx_rtd_theme

If the above theme is installed, it will be used instead of the default theme.

Note

Make sure that Doxygen is installed in your system. The installation of Doxygen is beyond the scope of this document.

Running the Documentation Generators

Assuming that the Zephyr Project tree with the doc directory is in DIRECTORY, type:

$ cd DIRECTORY/doc

$ make doxy html

Find the output in DIRECTORY/doc/_build/html/index.html

Review the available formats with:

$ make -C DIRECTORY/doc doxy html

If you want the LaTeX PDF output, you need to install all the Latex packages first. That installation is beyond the scope of this document.