zephyr/doc
Anas Nashif 98f372ac16 doc: arduino 101: adapt documentation for DFU flashing
The Arduino 101 board in Zephyr now support the original bootloader
and thus supports flashing over DFU. Adapt documentation and remove
reference to alternate bootloader which has been causing issues
and does not support flashing of the bluetooth firmware.

Jira: ZEP-301
Change-Id: I0298d8938bb636319b213909594d8cb42417559a
Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2016-05-14 14:47:53 +00:00
..
api doc: power_mgmt: Added Power Management documentation 2016-04-27 00:57:53 +00:00
application
bluetooth
board doc: arduino 101: adapt documentation for DFU flashing 2016-05-14 14:47:53 +00:00
contribute
crypto
drivers
getting_started doc: update installation to add PLY library to Python3 2016-05-04 22:57:40 +00:00
kernel kernel event profiler: add dynamic enable/disable/configure 2016-05-12 02:19:19 +00:00
porting doc: Edit arch.rst markup 2016-05-03 13:09:16 -05:00
reference
scripts/genrest doc: use table for Kconfig option reference 2016-05-11 15:15:44 +00:00
subsystems doc: fixed bullet list for bluetooth 2016-04-30 09:48:49 -04:00
themes/zephyr
about_zephyr.rst
conf.py
doxygen.config kernel event profiler: add dynamic enable/disable/configure 2016-05-12 02:19:19 +00:00
index.rst doc: Fixed broken link to development documentation 2016-05-04 14:54:24 +00:00
Makefile
README.rst
substitutions.rst

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