Add briefs for the library core structures.

[pub/USBasp.git] / LUFA / Drivers / USB / Class / Common / MIDI.h

diff --git a/LUFA/Drivers/USB/Class/Common/MIDI.h b/LUFA/Drivers/USB/Class/Common/MIDI.h
index 72a72de..aa84382 100644 (file)
--- a/LUFA/Drivers/USB/Class/Common/MIDI.h
+++ b/LUFA/Drivers/USB/Class/Common/MIDI.h
@@ -31,6 +31,8 @@
 /** \file\r
  *  \brief Common definitions and declarations for the library USB MIDI Class driver.\r
  *\r
+ *  Common definitions and declarations for the library USB MIDI Class driver.\r
+ *\r
  *  \note This file should not be included directly. It is automatically included as needed by the class driver\r
  *        dispatch header located in LUFA/Drivers/USB/Class/MIDI.h.\r
  */\r
@@ -97,7 +99,9 @@
                #define MIDI_CHANNEL(channel)        ((channel) - 1)\r
                \r
        /* Type Defines: */\r
-               /** Type define for an Audio class specific MIDI streaming interface descriptor. This indicates to the host\r
+               /** \brief MIDI Class Specific Streaming Interface Descriptor.\r
+                *\r
+                *  Type define for an Audio class specific MIDI streaming interface descriptor. This indicates to the host\r
                 *  how MIDI the specification compliance of the device and the total length of the Audio class specific descriptors.\r
                 *  See the USB Audio specification for more details.\r
                 */\r
@@ -110,7 +114,9 @@
                        uint16_t                  TotalLength; /**< Total length of the Audio class specific descriptors, including this descriptor */\r
                } USB_MIDI_AudioInterface_AS_t;\r
                \r
-               /** Type define for an Audio class specific MIDI IN jack. This gives information to the host on a MIDI input, either\r
+               /** \brief MIDI Class Specific Input Jack Descriptor.\r
+                *\r
+                *  Type define for an Audio class specific MIDI IN jack. This gives information to the host on a MIDI input, either\r
                 *  a physical input jack, or a logical jack (receiving input data internally, or from the host via an endpoint).\r
                 */\r
                typedef struct\r
@@ -124,7 +130,9 @@
                        uint8_t                   JackStrIndex; /**< Index of a string descriptor describing this descriptor within the device */\r
                } USB_MIDI_In_Jack_t;\r
 \r
-               /** Type define for an Audio class specific MIDI OUT jack. This gives information to the host on a MIDI output, either\r
+               /** \brief MIDI Class Specific Output Jack Descriptor.\r
+                *\r
+                *  Type define for an Audio class specific MIDI OUT jack. This gives information to the host on a MIDI output, either\r
                 *  a physical output jack, or a logical jack (sending output data internally, or to the host via an endpoint).\r
                 */\r
                typedef struct\r
@@ -142,7 +150,9 @@
                        uint8_t                   JackStrIndex; /**< Index of a string descriptor describing this descriptor within the device */\r
                } USB_MIDI_Out_Jack_t;\r
                \r
-               /** Type define for an Audio class specific extended MIDI jack endpoint descriptor. This contains extra information\r
+               /** \brief Audio Class Specific Jack Endpoint Descriptor.\r
+                *\r
+                *  Type define for an Audio class specific extended MIDI jack endpoint descriptor. This contains extra information\r
                 *  on the usage of MIDI endpoints used to stream MIDI events in and out of the USB Audio device, and follows an Audio\r
                 *  class specific extended MIDI endpoint descriptor. See the USB Audio specification for more details.\r
                 */\r
@@ -155,7 +165,10 @@
                        uint8_t                   AssociatedJackID[1]; /**< IDs of each jack inside the endpoint */\r
                } USB_MIDI_Jack_Endpoint_t;\r
 \r
-               /** Type define for a USB MIDI event packet, used to encapsulate sent and received MIDI messages from a USB MIDI interface. */\r
+               /** \brief MIDI Class Driver Event Packet.\r
+                *\r
+                *  Type define for a USB MIDI event packet, used to encapsulate sent and received MIDI messages from a USB MIDI interface.\r
+                */\r
                typedef struct\r
                {\r
                        unsigned char Command     : 4; /**< Upper nibble of the MIDI command being sent or received in the event packet */\r