diff --git a/src/hb-ot-color.cc b/src/hb-ot-color.cc
index 78c462f0e..8150b5e79 100644
--- a/src/hb-ot-color.cc
+++ b/src/hb-ot-color.cc
@@ -40,6 +40,16 @@
 #include "hb-ot-layout.hh"
 
 
+/**
+ * SECTION:hb-ot-color
+ * @title: hb-ot-color
+ * @short_description: OpenType Color Fonts
+ * @include: hb-ot.h
+ *
+ * Functions for fetching color-font information from OpenType font faces.
+ **/
+
+
 static inline const OT::COLR&
 _get_colr (hb_face_t *face)
 {
diff --git a/src/hb-ot-font.cc b/src/hb-ot-font.cc
index f0b620898..7a4516889 100644
--- a/src/hb-ot-font.cc
+++ b/src/hb-ot-font.cc
@@ -41,6 +41,16 @@
 #include "hb-ot-color-cbdt-table.hh"
 
 
+/**
+ * SECTION:hb-ot-font
+ * @title: hb-ot-font
+ * @short_description: OpenType font implementation
+ * @include: hb-ot.h
+ *
+ * Functions for using OpenType fonts with hb_shape().
+ **/
+
+
 static hb_bool_t
 hb_ot_get_nominal_glyph (hb_font_t *font HB_UNUSED,
 			 void *font_data,
diff --git a/src/hb-ot-layout.cc b/src/hb-ot-layout.cc
index befa838f3..6c5f0d401 100644
--- a/src/hb-ot-layout.cc
+++ b/src/hb-ot-layout.cc
@@ -45,6 +45,16 @@
 #include "hb-ot-name-table.hh"
 
 
+/**
+ * SECTION:hb-ot-layout
+ * @title: hb-ot-layout
+ * @short_description: OpenType Layout
+ * @include: hb-ot.h
+ *
+ * Functions for querying OpenType Layout features in the font face.
+ **/
+
+
 static const OT::kern::accelerator_t& _get_kern (hb_face_t *face)
 {
   if (unlikely (!hb_ot_shaper_face_data_ensure (face))) return Null(OT::kern::accelerator_t);
diff --git a/src/hb-ot-math.cc b/src/hb-ot-math.cc
index c693f4807..92c29480d 100644
--- a/src/hb-ot-math.cc
+++ b/src/hb-ot-math.cc
@@ -29,6 +29,17 @@
 #include "hb-ot-face.hh"
 #include "hb-ot-math-table.hh"
 
+
+/**
+ * SECTION:hb-ot-math
+ * @title: hb-ot-math
+ * @short_description: OpenType Math information
+ * @include: hb-ot.h
+ *
+ * Functions for fetching mathematics layout data from OpenType fonts.
+ **/
+
+
 static inline const OT::MATH&
 _get_math (hb_face_t *face)
 {
diff --git a/src/hb-ot-name.cc b/src/hb-ot-name.cc
index 28a45f010..2bf2ae58b 100644
--- a/src/hb-ot-name.cc
+++ b/src/hb-ot-name.cc
@@ -32,6 +32,16 @@
 #include "hb-utf.hh"
 
 
+/**
+ * SECTION:hb-ot-name
+ * @title: hb-ot-name
+ * @short_description: OpenType font name information
+ * @include: hb-ot.h
+ *
+ * Functions for fetching name strings from OpenType fonts.
+ **/
+
+
 static inline const OT::name_accelerator_t&
 _get_name (hb_face_t *face)
 {
diff --git a/src/hb-ot-shape.cc b/src/hb-ot-shape.cc
index 32c502048..c55d8dcb8 100644
--- a/src/hb-ot-shape.cc
+++ b/src/hb-ot-shape.cc
@@ -42,6 +42,16 @@
 #include "hb-aat-layout.hh"
 
 
+/**
+ * SECTION:hb-ot-shape
+ * @title: hb-ot-shape
+ * @short_description: OpenType shaping support
+ * @include: hb-ot.h
+ *
+ * Support functions for OpenType shaping related queries.
+ **/
+
+
 static bool
 _hb_apply_morx (hb_face_t *face)
 {