From 1695f8cc631d0fedd81b3ae6a8c1f02680154454 Mon Sep 17 00:00:00 2001 From: Dean Camera Date: Wed, 4 Sep 2019 22:22:34 +1000 Subject: Documentation: Fix Doxygen grouping. --- LUFA/Drivers/USB/Class/Common/AudioClassCommon.h | 12 ++++---- LUFA/Drivers/USB/Class/Common/CDCClassCommon.h | 4 +-- LUFA/Drivers/USB/Class/Common/HIDClassCommon.h | 16 +++++------ LUFA/Drivers/USB/Class/Common/HIDReportData.h | 8 +++--- LUFA/Drivers/USB/Class/Common/MIDIClassCommon.h | 4 +-- .../USB/Class/Common/MassStorageClassCommon.h | 16 +++++------ LUFA/Drivers/USB/Class/Common/PrinterClassCommon.h | 4 +-- LUFA/Drivers/USB/Class/Common/RNDISClassCommon.h | 32 +++++++++++----------- 8 files changed, 48 insertions(+), 48 deletions(-) (limited to 'LUFA/Drivers/USB/Class') diff --git a/LUFA/Drivers/USB/Class/Common/AudioClassCommon.h b/LUFA/Drivers/USB/Class/Common/AudioClassCommon.h index 4ab201800..b545dc499 100644 --- a/LUFA/Drivers/USB/Class/Common/AudioClassCommon.h +++ b/LUFA/Drivers/USB/Class/Common/AudioClassCommon.h @@ -65,7 +65,7 @@ /* Macros: */ /** \name Audio Channel Masks */ - //@{ + /**@{*/ /** Supported channel mask for an Audio class terminal descriptor. See the Audio class specification for more details. */ #define AUDIO_CHANNEL_LEFT_FRONT (1 << 0) @@ -101,10 +101,10 @@ /** Supported channel mask for an Audio class terminal descriptor. See the Audio class specification for more details. */ #define AUDIO_CHANNEL_TOP (1 << 11) - //@} + /**@}*/ /** \name Audio Feature Masks */ - //@{ + /**@{*/ /** Supported feature mask for an Audio class feature unit descriptor. See the Audio class specification for more details. */ #define AUDIO_FEATURE_MUTE (1 << 0) @@ -134,10 +134,10 @@ /** Supported feature mask for an Audio class feature unit descriptor. See the Audio class specification for more details. */ #define AUDIO_FEATURE_BASS_LOUDNESS (1 << 9) - //@} + /**@}*/ /** \name Audio Terminal Types */ - //@{ + /**@{*/ /** Terminal type constant for an Audio class terminal descriptor. See the Audio class specification for more details. */ #define AUDIO_TERMINAL_UNDEFINED 0x0100 @@ -191,7 +191,7 @@ /** Terminal type constant for an Audio class terminal descriptor. See the Audio class specification for more details. */ #define AUDIO_TERMINAL_OUT_LOWFREQ 0x0307 - //@} + /**@}*/ /** Convenience macro to fill a 24-bit \ref USB_Audio_SampleFreq_t structure with the given sample rate as a 24-bit number. * diff --git a/LUFA/Drivers/USB/Class/Common/CDCClassCommon.h b/LUFA/Drivers/USB/Class/Common/CDCClassCommon.h index c107a36a0..cf3261185 100644 --- a/LUFA/Drivers/USB/Class/Common/CDCClassCommon.h +++ b/LUFA/Drivers/USB/Class/Common/CDCClassCommon.h @@ -65,7 +65,7 @@ /* Macros: */ /** \name Virtual Control Line Masks */ - //@{ + /**@{*/ /** Mask for the DTR handshake line for use with the \ref CDC_REQ_SetControlLineState class-specific request * from the host, to indicate that the DTR line state should be high. */ @@ -110,7 +110,7 @@ * to indicate that a data overrun error has occurred on the virtual serial port. */ #define CDC_CONTROL_LINE_IN_OVERRUNERROR (1 << 6) - //@} + /**@}*/ /* Enums: */ /** Enum for possible Class, Subclass and Protocol values of device and interface descriptors relating to the CDC diff --git a/LUFA/Drivers/USB/Class/Common/HIDClassCommon.h b/LUFA/Drivers/USB/Class/Common/HIDClassCommon.h index c59e769d8..9f50ef156 100644 --- a/LUFA/Drivers/USB/Class/Common/HIDClassCommon.h +++ b/LUFA/Drivers/USB/Class/Common/HIDClassCommon.h @@ -66,7 +66,7 @@ /* Macros: */ /** \name Keyboard Standard Report Modifier Masks */ - //@{ + /**@{*/ /** Constant for a keyboard report modifier byte, indicating that the keyboard's left control key is currently pressed. */ #define HID_KEYBOARD_MODIFIER_LEFTCTRL (1 << 0) @@ -90,10 +90,10 @@ /** Constant for a keyboard report modifier byte, indicating that the keyboard's right GUI key is currently pressed. */ #define HID_KEYBOARD_MODIFIER_RIGHTGUI (1 << 7) - //@} + /**@}*/ /** \name Keyboard Standard Report LED Masks */ - //@{ + /**@{*/ /** Constant for a keyboard output report LED byte, indicating that the host's NUM LOCK mode is currently set. */ #define HID_KEYBOARD_LED_NUMLOCK (1 << 0) @@ -108,10 +108,10 @@ /** Constant for a keyboard output report LED byte, indicating that the host's KANA mode is currently set. */ #define HID_KEYBOARD_LED_KANA (1 << 4) - //@} + /**@}*/ /** \name Keyboard Standard Report Key Scan-codes */ - //@{ + /**@{*/ #define HID_KEYBOARD_SC_RESERVED 0x00 #define HID_KEYBOARD_SC_ERROR_ROLLOVER 0x01 #define HID_KEYBOARD_SC_POST_FAIL 0x02 @@ -348,10 +348,10 @@ #define HID_KEYBOARD_SC_MEDIA_LOCK 0xF9 #define HID_KEYBOARD_SC_MEDIA_RELOAD 0xFA #define HID_KEYBOARD_SC_MEDIA_CALCULATOR 0xFB - //@} + /**@}*/ /** \name Common HID Device Report Descriptors */ - //@{ + /**@{*/ /** \hideinitializer * A list of HID report item array elements that describe a typical HID USB Joystick. The resulting report * descriptor is structured according to the following layout: @@ -537,7 +537,7 @@ HID_RI_REPORT_COUNT(8, NumBytes), \ HID_RI_OUTPUT(8, HID_IOF_DATA | HID_IOF_VARIABLE | HID_IOF_ABSOLUTE | HID_IOF_NON_VOLATILE), \ HID_RI_END_COLLECTION(0) - //@} + /**@}*/ /* Type Defines: */ /** Enum for possible Class, Subclass and Protocol values of device and interface descriptors relating to the HID diff --git a/LUFA/Drivers/USB/Class/Common/HIDReportData.h b/LUFA/Drivers/USB/Class/Common/HIDReportData.h index 979fc46c3..694a6d844 100644 --- a/LUFA/Drivers/USB/Class/Common/HIDReportData.h +++ b/LUFA/Drivers/USB/Class/Common/HIDReportData.h @@ -75,7 +75,7 @@ /* Public Interface - May be used in end-application: */ /* Macros: */ /** \name HID Input, Output and Feature Report Descriptor Item Flags */ - //@{ + /**@{*/ #define HID_IOF_CONSTANT (1 << 0) #define HID_IOF_DATA (0 << 0) #define HID_IOF_VARIABLE (1 << 1) @@ -94,10 +94,10 @@ #define HID_IOF_NON_VOLATILE (0 << 7) #define HID_IOF_BUFFERED_BYTES (1 << 8) #define HID_IOF_BITFIELD (0 << 8) - //@} + /**@}*/ /** \name HID Report Descriptor Item Macros */ - //@{ + /**@{*/ #define HID_RI_INPUT(DataBits, ...) _HID_RI_ENTRY(HID_RI_TYPE_MAIN , 0x80, DataBits, __VA_ARGS__) #define HID_RI_OUTPUT(DataBits, ...) _HID_RI_ENTRY(HID_RI_TYPE_MAIN , 0x90, DataBits, __VA_ARGS__) #define HID_RI_COLLECTION(DataBits, ...) _HID_RI_ENTRY(HID_RI_TYPE_MAIN , 0xA0, DataBits, __VA_ARGS__) @@ -118,7 +118,7 @@ #define HID_RI_USAGE(DataBits, ...) _HID_RI_ENTRY(HID_RI_TYPE_LOCAL , 0x00, DataBits, __VA_ARGS__) #define HID_RI_USAGE_MINIMUM(DataBits, ...) _HID_RI_ENTRY(HID_RI_TYPE_LOCAL , 0x10, DataBits, __VA_ARGS__) #define HID_RI_USAGE_MAXIMUM(DataBits, ...) _HID_RI_ENTRY(HID_RI_TYPE_LOCAL , 0x20, DataBits, __VA_ARGS__) - //@} + /**@}*/ /** @} */ diff --git a/LUFA/Drivers/USB/Class/Common/MIDIClassCommon.h b/LUFA/Drivers/USB/Class/Common/MIDIClassCommon.h index d4976c796..97687c10b 100644 --- a/LUFA/Drivers/USB/Class/Common/MIDIClassCommon.h +++ b/LUFA/Drivers/USB/Class/Common/MIDIClassCommon.h @@ -71,7 +71,7 @@ /** \name MIDI Command Values * See http://www.midi.org/techspecs/midimessages.php for more information. */ - //@{ + /**@{*/ /** MIDI command for System Exclusive (SysEx) single event that has one byte of data total. */ #define MIDI_COMMAND_SYSEX_1BYTE MIDI_COMMAND_SYSEX_END_1BYTE @@ -113,7 +113,7 @@ /** MIDI command for a pitch change event. */ #define MIDI_COMMAND_PITCH_WHEEL_CHANGE 0xE0 - //@} + /**@}*/ /** Standard key press velocity value used for all note events. */ #define MIDI_STANDARD_VELOCITY 64 diff --git a/LUFA/Drivers/USB/Class/Common/MassStorageClassCommon.h b/LUFA/Drivers/USB/Class/Common/MassStorageClassCommon.h index ddf2c9f12..36c8ab53f 100644 --- a/LUFA/Drivers/USB/Class/Common/MassStorageClassCommon.h +++ b/LUFA/Drivers/USB/Class/Common/MassStorageClassCommon.h @@ -77,7 +77,7 @@ #define MS_COMMAND_DIR_DATA_IN (1 << 7) /** \name SCSI Commands*/ - //@{ + /**@{*/ /** SCSI Command Code for an INQUIRY command. */ #define SCSI_CMD_INQUIRY 0x12 @@ -119,10 +119,10 @@ /** SCSI Command Code for a MODE SENSE (10) command. */ #define SCSI_CMD_MODE_SENSE_10 0x5A - //@} + /**@}*/ /** \name SCSI Sense Key Values */ - //@{ + /**@{*/ /** SCSI Sense Code to indicate no error has occurred. */ #define SCSI_SENSE_KEY_GOOD 0x00 @@ -166,10 +166,10 @@ /** SCSI Sense Code to indicate that the source data did not match the data read from the medium. */ #define SCSI_SENSE_KEY_MISCOMPARE 0x0E - //@} + /**@}*/ /** \name SCSI Additional Sense Codes */ - //@{ + /**@{*/ /** SCSI Additional Sense Code to indicate no additional sense information is available. */ #define SCSI_ASENSE_NO_ADDITIONAL_INFORMATION 0x00 @@ -198,10 +198,10 @@ /** SCSI Additional Sense Code to indicate that no removable medium is inserted into the device. */ #define SCSI_ASENSE_MEDIUM_NOT_PRESENT 0x3A - //@} + /**@}*/ /** \name SCSI Additional Sense Key Code Qualifiers */ - //@{ + /**@{*/ /** SCSI Additional Sense Qualifier Code to indicate no additional sense qualifier information is available. */ #define SCSI_ASENSEQ_NO_QUALIFIER 0x00 @@ -215,7 +215,7 @@ /** SCSI Additional Sense Qualifier Code to indicate that an operation is currently in progress. */ #define SCSI_ASENSEQ_OPERATION_IN_PROGRESS 0x07 - //@} + /**@}*/ /* Enums: */ /** Enum for possible Class, Subclass and Protocol values of device and interface descriptors relating to the Mass diff --git a/LUFA/Drivers/USB/Class/Common/PrinterClassCommon.h b/LUFA/Drivers/USB/Class/Common/PrinterClassCommon.h index 64412993d..b0602704b 100644 --- a/LUFA/Drivers/USB/Class/Common/PrinterClassCommon.h +++ b/LUFA/Drivers/USB/Class/Common/PrinterClassCommon.h @@ -65,7 +65,7 @@ /* Macros: */ /** \name Virtual Printer Status Line Masks */ - //@{ + /**@{*/ /** Port status mask for a printer device, indicating that an error has *not* occurred. */ #define PRNT_PORTSTATUS_NOTERROR (1 << 3) @@ -74,7 +74,7 @@ /** Port status mask for a printer device, indicating that the device is currently out of paper. */ #define PRNT_PORTSTATUS_PAPEREMPTY (1 << 5) - //@} + /**@}*/ /* Enums: */ /** Enum for possible Class, Subclass and Protocol values of device and interface descriptors relating to the Printer diff --git a/LUFA/Drivers/USB/Class/Common/RNDISClassCommon.h b/LUFA/Drivers/USB/Class/Common/RNDISClassCommon.h index 7bc94b703..035f5dfa8 100644 --- a/LUFA/Drivers/USB/Class/Common/RNDISClassCommon.h +++ b/LUFA/Drivers/USB/Class/Common/RNDISClassCommon.h @@ -78,7 +78,7 @@ #define REMOTE_NDIS_VERSION_MINOR 0x00 /** \name RNDIS Message Values */ - //@{ + /**@{*/ #define REMOTE_NDIS_PACKET_MSG 0x00000001UL #define REMOTE_NDIS_INITIALIZE_MSG 0x00000002UL #define REMOTE_NDIS_HALT_MSG 0x00000003UL @@ -87,46 +87,46 @@ #define REMOTE_NDIS_RESET_MSG 0x00000006UL #define REMOTE_NDIS_INDICATE_STATUS_MSG 0x00000007UL #define REMOTE_NDIS_KEEPALIVE_MSG 0x00000008UL - //@} + /**@}*/ /** \name RNDIS Response Values */ - //@{ + /**@{*/ #define REMOTE_NDIS_INITIALIZE_CMPLT 0x80000002UL #define REMOTE_NDIS_QUERY_CMPLT 0x80000004UL #define REMOTE_NDIS_SET_CMPLT 0x80000005UL #define REMOTE_NDIS_RESET_CMPLT 0x80000006UL #define REMOTE_NDIS_KEEPALIVE_CMPLT 0x80000008UL - //@} + /**@}*/ /** \name RNDIS Status Values */ - //@{ + /**@{*/ #define REMOTE_NDIS_STATUS_SUCCESS 0x00000000UL #define REMOTE_NDIS_STATUS_FAILURE 0xC0000001UL #define REMOTE_NDIS_STATUS_INVALID_DATA 0xC0010015UL #define REMOTE_NDIS_STATUS_NOT_SUPPORTED 0xC00000BBUL #define REMOTE_NDIS_STATUS_MEDIA_CONNECT 0x4001000BUL #define REMOTE_NDIS_STATUS_MEDIA_DISCONNECT 0x4001000CUL - //@} + /**@}*/ /** \name RNDIS Media States */ - //@{ + /**@{*/ #define REMOTE_NDIS_MEDIA_STATE_CONNECTED 0x00000000UL #define REMOTE_NDIS_MEDIA_STATE_DISCONNECTED 0x00000001UL - //@} + /**@}*/ /** \name RNDIS Media Types */ - //@{ + /**@{*/ #define REMOTE_NDIS_MEDIUM_802_3 0x00000000UL - //@} + /**@}*/ /** \name RNDIS Connection Types */ - //@{ + /**@{*/ #define REMOTE_NDIS_DF_CONNECTIONLESS 0x00000001UL #define REMOTE_NDIS_DF_CONNECTION_ORIENTED 0x00000002UL - //@} + /**@}*/ /** \name RNDIS Packet Types */ - //@{ + /**@{*/ #define REMOTE_NDIS_PACKET_DIRECTED 0x00000001UL #define REMOTE_NDIS_PACKET_MULTICAST 0x00000002UL #define REMOTE_NDIS_PACKET_ALL_MULTICAST 0x00000004UL @@ -139,10 +139,10 @@ #define REMOTE_NDIS_PACKET_ALL_FUNCTIONAL 0x00002000UL #define REMOTE_NDIS_PACKET_FUNCTIONAL 0x00004000UL #define REMOTE_NDIS_PACKET_MAC_FRAME 0x00008000UL - //@} + /**@}*/ /** \name RNDIS OID Values */ - //@{ + /**@{*/ #define OID_GEN_SUPPORTED_LIST 0x00010101UL #define OID_GEN_HARDWARE_STATUS 0x00010102UL #define OID_GEN_MEDIA_SUPPORTED 0x00010103UL @@ -170,7 +170,7 @@ #define OID_802_3_RCV_ERROR_ALIGNMENT 0x01020101UL #define OID_802_3_XMIT_ONE_COLLISION 0x01020102UL #define OID_802_3_XMIT_MORE_COLLISIONS 0x01020103UL - //@} + /**@}*/ /** Maximum size in bytes of an Ethernet frame according to the Ethernet standard. */ #define ETHERNET_FRAME_SIZE_MAX 1500 -- cgit v1.2.3