michaelh/zephyr
1
0
Fork 0
Code Releases Activity

doc: fix ordered lists in doxygen comments

Browse source 
doxygen does not support ordered (numbered) lists using reST syntax
``1)`` or ``a)`` unless the doxygen comments are bounded by ``@rst`` and
``@endrst`` markers.  The "doxygen" way to do ordered lists is to use
``-#``.  This PR cleans this up for our API documentation.

Signed-off-by: David B. Kinder <david.b.kinder@intel.com>
This commit is contained in:
David B. Kinder 2019-11-20 10:12:15 -08:00 • committed by Anas Nashif
commit 38914679f2
3 changed files with 7 additions and 6 deletions
Download patch file Download diff file Expand all files Collapse all files

4
include/sys/arch_interface.h
View file

@ -136,13 +136,13 @@ void arch_cpu_idle(void);
*
* The requirements for arch_cpu_atomic_idle() are as follows:
*
* 1) Enabling interrupts and entering a low-power mode needs to be
* -# Enabling interrupts and entering a low-power mode needs to be
* atomic, i.e. there should be no period of time where interrupts are
* enabled before the processor enters a low-power mode. See the comments
* in k_lifo_get(), for example, of the race condition that
* occurs if this requirement is not met.
*
* 2) After waking up from the low-power mode, the interrupt lockout state
* -# After waking up from the low-power mode, the interrupt lockout state
* must be restored as indicated in the 'key' input parameter.
*
* @see k_cpu_atomic_idle()