doc: fix missing NVS API documentation

Sphinx only displays API documentation for items within the specified
doxygen defgroup, and importantly, not the subgroups of this defgroup.

If you define a defgroup with defgroup children, you need to tell Sphinx
to display API information about the child defgroups too.  (If the
parent defgroup has no entities of it's own, you can leave that out.)

This patch replaces the (empty) display of the parent defgroup with that
of its two child defgroups.

It also fixes an unnecessarily long text line while I was in there.

Fixes: #7666

Signed-off-by: David B. Kinder <david.b.kinder@intel.com>
This commit is contained in:
David B. Kinder 2018-05-18 14:27:20 -07:00 committed by Anas Nashif
parent 38e8f06fdb
commit d1d0dd45ed
1 changed files with 6 additions and 3 deletions

View File

@ -32,8 +32,8 @@ already performing such a check you can disable the extra flash protection
(``CONFIG_NVS_FLASH_PROTECTION=n``).
To protect the storage system against frequent sector erases the size of
id-data pairs is limited to ``CONFIG_NVS_MAX_ELEM_SIZE``. This limit is by default set to 1/4 of the sector
size.
id-data pairs is limited to ``CONFIG_NVS_MAX_ELEM_SIZE``. This limit is
by default set to 1/4 of the sector size.
For NVS the file system is declared as:
@ -107,5 +107,8 @@ API
The NVS subsystem APIs are provided by ``nvs.h``:
.. doxygengroup:: nvs
.. doxygengroup:: nvs_data_structures
:project: Zephyr
.. doxygengroup:: nvs_high_level_api
:project: Zephyr