diff --git a/src/libcamera/control_ids.yaml b/src/libcamera/control_ids.yaml
index 4befec74..5bbe65ae 100644
--- a/src/libcamera/control_ids.yaml
+++ b/src/libcamera/control_ids.yaml
@@ -44,10 +44,17 @@ controls:
 
   - ManualExposure:
       type: int32_t
-      description: Specify a fixed exposure time in milli-seconds
+      description: |
+        Specify a fixed exposure time in micro-seconds to be applied in the
+        sensor device.
+
+        \sa ManualGain
 
   - ManualGain:
-      type: int32_t
-      description: Specify a fixed gain parameter
+      type: float
+      description: |
+        Specify a fixed gain value to be applied in the pipeline.  This gain is
+        applied to all colour channels.
 
+        \sa ManualExposure
 ...