mirror of
https://github.com/espressif/esp-idf.git
synced 2024-10-05 20:47:46 -04:00
adae42fd85
- reflected template in other DRAFT API dcouments - DRAFT of Bluetooth API - link fixes in CONTRIBUTING.rst
62 lines
1.2 KiB
ReStructuredText
62 lines
1.2 KiB
ReStructuredText
Template API
|
|
=============
|
|
|
|
Overview
|
|
--------
|
|
|
|
INSTRUCTIONS: Provide overview where and how this API may be used. For large number of functions, break down description into groups.
|
|
|
|
|
|
Application Example
|
|
-------------------
|
|
|
|
INSTRUCTIONS: Provide one or more pratical examples to demonstrate functionality of this API.
|
|
|
|
|
|
Reference
|
|
---------
|
|
|
|
INSTRUCTIONS: Provide list of API memebers divided into sections. Use coresponding **.. doxygen** directices, so member documentation is auto updated.
|
|
|
|
* Data Structures **.. doxygenstruct**
|
|
* Macros **.. doxygendefine**
|
|
* Type Definitions **.. doxygentypedef**
|
|
* Enumerations **.. doxygenenum**
|
|
* Functions **.. doxygenfunction**
|
|
* Variables **.. doxygenvariable**
|
|
|
|
Include code snippotes to ilustrate functionality of particular functions where applicable. Skip section hearder if empty.
|
|
|
|
|
|
Data Structures
|
|
^^^^^^^^^^^^^^^
|
|
|
|
.. Data Structures .. doxygenstruct
|
|
|
|
Macros
|
|
^^^^^^
|
|
|
|
.. Macros .. doxygendefine
|
|
|
|
Type Definitions
|
|
^^^^^^^^^^^^^^^^
|
|
|
|
.. Type Definitions .. doxygentypedef
|
|
|
|
Enumerations
|
|
^^^^^^^^^^^^
|
|
|
|
.. Enumerations .. doxygenenum
|
|
|
|
Functions
|
|
^^^^^^^^^
|
|
|
|
.. Functions .. doxygenfunction
|
|
|
|
Variables
|
|
^^^^^^^^^
|
|
|
|
.. Variables .. doxygenvariable
|
|
|
|
|