zephyr/doc
Jukka Rissanen 5f3f331d48 net: Adapt to new behavior of net_buf_frag_add v2
This change is related to patch called
"net: Adapt to new behavior of net_buf_frag_add"

This version removes extra net_nbuf_unref() from
the code. The unref was done because net_buf_frag_del()
did not remove the double ref from the list element.

Because of the other patch, the list does not have
double ref any more, so we need to remove the extra
unref in couple of extra places.

Change-Id: If90e01c24b9b4e68afbfa283850d2a1ecb3065ed
Signed-off-by: Jukka Rissanen <jukka.rissanen@linux.intel.com>
2016-12-02 12:40:54 +02:00
..
api doc: Revise kernel event logger documentation 2016-11-18 23:17:51 +00:00
application build: Document outputexports 2016-11-12 02:08:08 +00:00
board
contribute
crypto
drivers kernel: deprecate old init levels 2016-11-09 17:59:44 +00:00
getting_started docs: remove usage of ARCH=arm 2016-11-10 17:24:45 +00:00
introduction
kernel_v2 doc: fix ring_buffer code snippet 2016-11-22 21:09:13 +05:30
porting kernel: delete old micro and nanokernel documentation 2016-11-04 20:51:01 +00:00
reference unified/doc: Update Kbuild Reference 2016-11-01 21:45:39 +00:00
scripts/genrest
subsystems net: Adapt to new behavior of net_buf_frag_add v2 2016-12-02 12:40:54 +02:00
themes/zephyr
conf.py
doxygen.config
index.rst LICENSING: clarify licenses of imported / reused code 2016-11-11 01:36:14 +00:00
LICENSING.rst LICENSING: clarify licenses of imported / reused code 2016-11-11 01:36:14 +00:00
Makefile
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