diff --git a/include/ntfs/attrib.h b/include/ntfs/attrib.h
index d0d68b19..a12cf917 100644
--- a/include/ntfs/attrib.h
+++ b/include/ntfs/attrib.h
@@ -228,9 +228,10 @@ GenNAttrIno(Compressed, COMPRESSED)
 GenNAttrIno(Encrypted, ENCRYPTED)
 GenNAttrIno(Sparse, SPARSE_FILE)
 
-/*
- * Union of all known attribute values. For convenience. Used in the attr
- * structure.
+/**
+ * union attr_val - Union of all known attribute values
+ *
+ * For convenience. Used in the attr structure.
  */
 typedef union {
 	u8 _default;	/* Unnamed u8 to serve as default when just using
diff --git a/include/ntfs/layout.h b/include/ntfs/layout.h
index b564426e..c4e78752 100644
--- a/include/ntfs/layout.h
+++ b/include/ntfs/layout.h
@@ -1340,8 +1340,8 @@ typedef enum {					/* Identifier authority. */
  *	(Built-in domain)	S-1-5-0x20
  */
 
-/*
- * The SID_IDENTIFIER_AUTHORITY is a 48-bit value used in the SID structure.
+/**
+ * union SID_IDENTIFIER_AUTHORITY - A 48-bit value used in the SID structure
  *
  * NOTE: This is stored as a big endian number.
  */