diff --git a/common/aidl/aidl_api/android.hardware.common/current/android/hardware/common/GrantorDescriptor.aidl b/common/aidl/aidl_api/android.hardware.common/current/android/hardware/common/GrantorDescriptor.aidl
index 4a9ecd9ba6..07bceb0e06 100644
--- a/common/aidl/aidl_api/android.hardware.common/current/android/hardware/common/GrantorDescriptor.aidl
+++ b/common/aidl/aidl_api/android.hardware.common/current/android/hardware/common/GrantorDescriptor.aidl
@@ -18,8 +18,6 @@
 package android.hardware.common;
 @VintfStability
 parcelable GrantorDescriptor {
-  int flags;
-  int fdIndex;
   int offset;
   long extent;
 }
diff --git a/common/aidl/android/hardware/common/GrantorDescriptor.aidl b/common/aidl/android/hardware/common/GrantorDescriptor.aidl
index 442d7fa55c..3552e9e847 100644
--- a/common/aidl/android/hardware/common/GrantorDescriptor.aidl
+++ b/common/aidl/android/hardware/common/GrantorDescriptor.aidl
@@ -16,10 +16,17 @@
 
 package android.hardware.common;
 
+/*
+ * Included in MQDescriptor, for use with libfmq.
+ */
 @VintfStability
 parcelable GrantorDescriptor {
-    int flags;
-    int fdIndex;
+    /*
+     * The offset of this descriptor in the shared memory in bytes.
+     */
     int offset;
+    /*
+     * The size of this descriptor in bytes.
+     */
     long extent;
 }
diff --git a/common/aidl/android/hardware/common/MQDescriptor.aidl b/common/aidl/android/hardware/common/MQDescriptor.aidl
index 1126a25e9e..899768890e 100644
--- a/common/aidl/android/hardware/common/MQDescriptor.aidl
+++ b/common/aidl/android/hardware/common/MQDescriptor.aidl
@@ -18,6 +18,11 @@ package android.hardware.common;
 
 import android.hardware.common.GrantorDescriptor;
 
+/*
+ * For use with libfmq. This is created from an instance of AidlMessageQueue,
+ * and is used to pass information required to create another instance of that
+ * queue for fast communication.
+ */
 @VintfStability
 parcelable MQDescriptor {
     /*