zephyr/doc/reference/kbuild.rst
Rodrigo Caballero d7c32911c4 Doc: Create the Reference Guides part.
Placeholders were created for the missing content. The automatically
generated API docs were separated from the Doxygen collaboration guide.
The Kbuild User's Guide was moved unchanged.

Change-Id: I07dfed61bfbb3cad60372c57dc3cbdf627c872f0
Signed-off-by: Rodrigo Caballero <rodrigo.caballero.abraham@intel.com>
2016-02-05 20:15:20 -05:00

35 lines
1.1 KiB
ReStructuredText

.. _kbuild:
Kbuild User Guide
#################
The |project| build system is based on the Kbuild system used in the
Linux kernel (version 3.19-rc7). This way the |codename| embraces
the recursive model proposed by Linux and the configuration model
proposed by Kconfig.
The main difference between the Linux Kbuild system and the |codename|
build system is that the build is project centered. The consequence
is the need to define a project or application. The project drives
the build of the operating system.
For that reason, the build structure follows the Kbuild
architecture but it requires a project directory. The project
directory hosts the project's definition and code. Kbuild build the
kernel around the project directory.
Scope
*****
This document provides the details of the Kbuild implementation. It is
intended for application developers wanting to use the |project| as a
development platform and for kernel developers looking to modify or
expand the kernel functionality.
.. toctree::
:maxdepth:2
kbuild_kconfig
kbuild_makefiles
kbuild_projects
kbuild_targets
kbuild_toolchains