zephyr/doc/reference/index.rst
Martí Bolívar 04df8124ac api: promote sys/util.h to experimental
This file contains definitions for macros which are integral to
significant Zephyr use cases, such as CONTAINER_OF() and various
macros used by devicetree.h internally.

As such, in practice we expect at least advanced (if not intermediate)
users to understand it, so the fact that it's not formally documented
as an API with a stability level is a problem.

Fix that by giving the docstrings a once-over and adding new ones
where they are missing. Move all the remaining non-API macros to
util_internal.h.

Add a Sphinx API page for this header, and include it in the API
overview at "experimental" stability level.

Signed-off-by: Martí Bolívar <marti.bolivar@nordicsemi.no>
2020-06-18 19:38:10 +02:00

35 lines
641 B
ReStructuredText

.. _api_reference:
API Reference
#############
.. toctree::
:maxdepth: 1
overview.rst
terminology.rst
audio/index.rst
misc/notify.rst
bluetooth/index.rst
kconfig/index.rst
crypto/index.rst
devicetree/index.rst
drivers/index.rst
display/index.rst
file_system/index.rst
kernel/index.rst
logging/index.rst
misc/index
misc/data_structures.rst
networking/index.rst
peripherals/index.rst
power_management/index.rst
random/index.rst
resource_management/index.rst
shell/index.rst
storage/index.rst
usb/index.rst
usermode/index.rst
util/index.rst
settings/index.rst