diff --git a/src/hb-ot-color-colr-table.hh b/src/hb-ot-color-colr-table.hh
index 8f81cfb2d..35e058c6c 100644
--- a/src/hb-ot-color-colr-table.hh
+++ b/src/hb-ot-color-colr-table.hh
@@ -137,13 +137,13 @@ struct COLR
   }
 
   protected:
-  HBUINT16	version;	/* Table version number */
-  HBUINT16	numBaseGlyphs;	/* Number of Base Glyph Records */
+  HBUINT16	version;	/* Table version number (starts at 0). */
+  HBUINT16	numBaseGlyphs;	/* Number of Base Glyph Records. */
   LOffsetTo<UnsizedArrayOf<BaseGlyphRecord>, false>
 		baseGlyphsZ;	/* Offset to Base Glyph records. */
   LOffsetTo<UnsizedArrayOf<LayerRecord>, false>
-		layersZ;	/* Offset to Layer Records */
-  HBUINT16	numLayers;	/* Number of Layer Records */
+		layersZ;	/* Offset to Layer Records. */
+  HBUINT16	numLayers;	/* Number of Layer Records. */
   public:
   DEFINE_SIZE_STATIC (14);
 };