ucm: docs: typeset lists of identifiers explicitly

Doxygen doesn't preserve formatting that relies only on indentation,
typeset lists of identifiers explicitly.

This makes the HTML docs a lot more readable.

This change comes along the lines of commit 72aa0f8332fb ("ucm: reformat
snd_use_case_get() doc").

Some TABs has been added too in order to preserve the aligned look when
reading the source code.

Signed-off-by: Antonio Ospite <ao2@ao2.it>
Signed-off-by: Takashi Iwai <tiwai@suse.de>

diff --git a/include/use-case.h b/include/use-case.h
index 9aac6e2fb51d0c55674dcdd91e6225c5a0945716..8911645b5c4d3cb543f0685dde8214d69f37a17d 100644 (file)
--- a/include/use-case.h
+++ b/include/use-case.h
@@ -192,20 +192,21 @@ int snd_use_case_free_list(const char *list[], int items);
  * \return Number of list entries if success, otherwise a negative error code
  *
  * Defined identifiers:
- *   NULL              - get card list
- *                       (in pair cardname+comment)
- *   _verbs            - get verb list
- *                       (in pair verb+comment)
- *   _devices[/{verb}] - get list of supported devices
- *                       (in pair device+comment)
- *   _modifiers[/{verb}]- get list of supported modifiers
- *                       (in pair modifier+comment)
- *   TQ[/{verb}]       - get list of TQ identifiers
- *   _enadevs          - get list of enabled devices
- *   _enamods          - get list of enabled modifiers
+ *   - NULL                    - get card list
+ *                              (in pair cardname+comment)
+ *   - _verbs                  - get verb list
+ *                               (in pair verb+comment)
+ *   - _devices[/{verb}]       - get list of supported devices
+ *                               (in pair device+comment)
+ *   - _modifiers[/{verb}]     - get list of supported modifiers
+ *                               (in pair modifier+comment)
+ *   - TQ[/{verb}]             - get list of TQ identifiers
+ *   - _enadevs                        - get list of enabled devices
+ *   - _enamods                        - get list of enabled modifiers
+ *
+ *   - _supporteddevs/{modifier}|{device}[/{verb}]   - list of supported devices
+ *   - _conflictingdevs/{modifier}|{device}[/{verb}] - list of conflicting devices
  *
- *   _supporteddevs/{modifier}|{device}[/{verb}]   - list of supported devices
- *   _conflictingdevs/{modifier}|{device}[/{verb}] - list of conflicting devices
  *   Note that at most one of the supported/conflicting devs lists has
  *   any entries, and when neither is present, all devices are supported.
  *
@@ -331,8 +332,8 @@ int snd_use_case_get(snd_use_case_mgr_t *uc_mgr,
  * \return Zero if success, otherwise a negative error code
  *
  * Known identifiers:
- *   _devstatus/{device}       - return status for given device
- *   _modstatus/{modifier}     - return status for given modifier
+ *   - _devstatus/{device}     - return status for given device
+ *   - _modstatus/{modifier}   - return status for given modifier
  */
 int snd_use_case_geti(snd_use_case_mgr_t *uc_mgr,
                      const char *identifier,
@@ -346,19 +347,19 @@ int snd_use_case_geti(snd_use_case_mgr_t *uc_mgr,
  * \return Zero if success, otherwise a negative error code
  *
  * Known identifiers:
- *   _verb             - set current verb = value
- *   _enadev           - enable given device = value
- *   _disdev           - disable given device = value
- *   _swdev/{old_device} - new_device = value
- *                     - disable old_device and then enable new_device
- *                     - if old_device is not enabled just return
- *                     - check transmit sequence firstly
- *   _enamod           - enable given modifier = value
- *   _dismod           - disable given modifier = value
- *   _swmod/{old_modifier} - new_modifier = value
- *                     - disable old_modifier and then enable new_modifier
- *                     - if old_modifier is not enabled just return
- *                     - check transmit sequence firstly
+ *   - _verb                   - set current verb = value
+ *   - _enadev                 - enable given device = value
+ *   - _disdev                 - disable given device = value
+ *   - _swdev/{old_device}     - new_device = value
+ *                               - disable old_device and then enable new_device
+ *                               - if old_device is not enabled just return
+ *                               - check transmit sequence firstly
+ *   - _enamod                 - enable given modifier = value
+ *   - _dismod                 - disable given modifier = value
+ *   - _swmod/{old_modifier}   - new_modifier = value
+ *                               - disable old_modifier and then enable new_modifier
+ *                               - if old_modifier is not enabled just return
+ *                               - check transmit sequence firstly
  */
 int snd_use_case_set(snd_use_case_mgr_t *uc_mgr,
                      const char *identifier,