diff --git a/lib/usb_cdcacm.c b/lib/usb_cdcacm.c
index 3201c36..2dd1bc6 100644
--- a/lib/usb_cdcacm.c
+++ b/lib/usb_cdcacm.c
@@ -92,36 +92,36 @@ static const struct usb_endpoint_descriptor communication_endpoints[] = {{
  *  @note as defined in USB CDC specification section 5.2.3
  */
 static const struct {
-	struct usb_cdc_header_descriptor header;
-	struct usb_cdc_call_management_descriptor call_mgmt;
-	struct usb_cdc_acm_descriptor acm;
-	struct usb_cdc_union_descriptor cdc_union;
+	struct usb_cdc_header_descriptor header; /**< header */
+	struct usb_cdc_call_management_descriptor call_mgmt; /**< call management descriptor */
+	struct usb_cdc_acm_descriptor acm; /**< descriptor */
+	struct usb_cdc_union_descriptor cdc_union;  /**< descriptor */
 } __attribute__((packed)) cdcacm_functional_descriptors = {
 	.header = {
-		.bFunctionLength = sizeof(struct usb_cdc_header_descriptor),
-		.bDescriptorType = CS_INTERFACE,
-		.bDescriptorSubtype = USB_CDC_TYPE_HEADER,
-		.bcdCDC = 0x0110,
+		.bFunctionLength = sizeof(struct usb_cdc_header_descriptor), /**< descriptor length */
+		.bDescriptorType = CS_INTERFACE, /**< descriptor type */
+		.bDescriptorSubtype = USB_CDC_TYPE_HEADER, /**< descriptor subtype */
+		.bcdCDC = 0x0110, /**< CDC value */
 	},
 	.call_mgmt = {
-		.bFunctionLength = sizeof(struct usb_cdc_call_management_descriptor),
-		.bDescriptorType = CS_INTERFACE,
-		.bDescriptorSubtype = USB_CDC_TYPE_CALL_MANAGEMENT,
-		.bmCapabilities = 0,
-		.bDataInterface = 1,
+		.bFunctionLength = sizeof(struct usb_cdc_call_management_descriptor), /**< descriptor length */
+		.bDescriptorType = CS_INTERFACE,  /**< descriptor type */
+		.bDescriptorSubtype = USB_CDC_TYPE_CALL_MANAGEMENT, /**< descriptor subtype */
+		.bmCapabilities = 0, /**< capabilities */
+		.bDataInterface = 1, /**< data interface */
 	},
 	.acm = {
-		.bFunctionLength = sizeof(struct usb_cdc_acm_descriptor),
-		.bDescriptorType = CS_INTERFACE,
-		.bDescriptorSubtype = USB_CDC_TYPE_ACM,
-		.bmCapabilities = 0,
+		.bFunctionLength = sizeof(struct usb_cdc_acm_descriptor), /**< descriptor length */
+		.bDescriptorType = CS_INTERFACE, /**< descriptor type */
+		.bDescriptorSubtype = USB_CDC_TYPE_ACM, /**< descriptor subtype */
+		.bmCapabilities = 0, /**< capabilities */
 	},
 	.cdc_union = {
-		.bFunctionLength = sizeof(struct usb_cdc_union_descriptor),
-		.bDescriptorType = CS_INTERFACE,
-		.bDescriptorSubtype = USB_CDC_TYPE_UNION,
-		.bControlInterface = 0,
-		.bSubordinateInterface0 = 1,
+		.bFunctionLength = sizeof(struct usb_cdc_union_descriptor), /**< descriptor length */
+		.bDescriptorType = CS_INTERFACE, /**< descriptor type */
+		.bDescriptorSubtype = USB_CDC_TYPE_UNION, /**< descriptor subtype */
+		.bControlInterface = 0, /**< control interface */
+		.bSubordinateInterface0 = 1, /**< subordinate interface */
 	 },
 };