zephyr

History

Anas Nashif dba6188b58 doc: fix formatting and move around optional requirements - Fix missing spaces between package names - Move optional software to its own section, no need to have it in the main requirement section if it is options - crosstool-NG instead of crosstool-next Generation. Treat that as a brand name. - Fixed command line for installing groups with yum - minor fixes Change-Id: Ib231bb09dea3aa6d3af00961eae8a2e3d6ded011 Signed-off-by: Anas Nashif <anas.nashif@intel.com>		2016-02-05 20:14:01 -05:00
..
collaboration	ADD Collaboration Guideline ReST content files.	2016-02-05 20:14:01 -05:00
doxygen	ADD in-code documentation integration files.	2016-02-05 20:14:00 -05:00
installation	doc: fix formatting and move around optional requirements	2016-02-05 20:14:01 -05:00
Makefile	Add tools and Makefiles for Documentation	2016-02-05 20:13:58 -05:00
README.rst	ADD framework files for ReST content.	2016-02-05 20:14:00 -05:00
conf.py	CHANGE Doxygen configuration to limit it to the doc folder.	2016-02-05 20:14:00 -05:00
documentation_license.rst	ADD framework files for ReST content.	2016-02-05 20:14:00 -05:00
doxygen.config	CHANGE Doxygen configuration to limit it to the doc folder.	2016-02-05 20:14:00 -05:00
index.rst	ADD framework files for ReST content.	2016-02-05 20:14:00 -05:00
substitutions.rst	ADD framework files for ReST content.	2016-02-05 20:14:00 -05:00

README.rst

.. include:: substitutions.rst

Welcome to |codename|
#####################

.. This document is in Restructured Text Format.

   More information at `<http://sphinx-doc.org/rest.html>`_.
   This is a comment that won't show up in formatted output

Welcome to |project|.

Thank you for your interest in |project|. Read the instructions
carefully to generate the |project|'s documentation.


Documentation Notes
*******************

The documentation of |project| currently comprises the following items:

* An Installation Guide for Linux host systems

* A set of Collaboration Guidelines for the |project| project.

* Raw Doxygen output from the code base.

Installing the documentation processors
***************************************

Install the current version of :program:`Sphinx`, type:

.. code-block:: bash

   $ git clone:: $ export http_proxy=http://PROXY:PORT $ export
   https_proxy=http://PROXY:PORT

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

   $ cd sphinx

   $ sudo -E python setup.py install

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

   $ cd breathe

   $ sudo -E python setup.py install

.. note::

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

Running the documentation generators
************************************

Assuming that the |project| tree with the doc patches is in
:file:`DIRECTORY`, type:

.. code-block:: bash

   $ cd DIRECTORY/doc

   $ make doxy html

Find the output in :file:`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.