zephyr/doc
Andrew Boie d73a9bb9c6 microkernel: remove deprecated task IRQs
Change-Id: I06393c8ee0e864105cd0183c92e453638679fe81
Signed-off-by: Andrew Boie <andrew.p.boie@intel.com>
2016-08-05 16:55:42 +00:00
..
api microkernel: remove deprecated task IRQs 2016-08-05 16:55:42 +00:00
application doc: Remove contributor documentation moved to wiki 2016-08-04 22:01:10 +00:00
bluetooth
board board: nitrogen: Add support for the Nitrogen board 2016-07-29 14:08:06 +00:00
contribute doc: Remove contributor documentation moved to wiki 2016-08-04 22:01:10 +00:00
crypto
drivers doc: Purge inappropriate fundamentals info from Kernel Primer 2016-07-08 20:32:25 +00:00
getting_started doc: add ncurses to linux dev host setup doc 2016-08-04 22:13:50 +00:00
introduction
kernel doc: Update floating point docs for ARM 2016-07-14 17:26:09 +00:00
porting
reference
scripts/genrest
subsystems
themes/zephyr
conf.py
doxygen.config
index.rst doc: Add 1.5.0 docs link to Zephyr/doc home page 2016-08-02 05:23:18 +00:00
Makefile doc: makefile doesn't print unneeded output of pwd 2016-08-02 06:47:21 +00:00
README.rst

:orphan:

Welcome to Zephyr Kernel
########################

.. This document is in Restructured Text Format.
   Find more information regarding the ReST markup in the
   `ReST documentation`_.
   This is a comment that won't show up in formatted output

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:

.. code-block:: bash

   $ 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

.. 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:

.. code-block:: bash

   $ cd DIRECTORY/doc

   $ make doxy html

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

Review the available formats with:

.. code-block:: bash

   $ 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.

.. _ReST documentation: http://sphinx-doc.org/rest.html