Stub out doc comments for new symbols

8 files changed, 65 insertions, 12 deletions

diff --git a/src/hb-common.cc b/src/hb-common.cc
index a804f822..64e77d43 100644
--- a/src/hb-common.cc
+++ b/src/hb-common.cc
@@ -898,6 +898,11 @@ parse_one_variation (const char **pp, const char *end, hb_variation_t *variation
 	 *pp == end;
 }
 
+/**
+ * hb_variation_from_string:
+ *
+ * Since: 1.4.2
+ */
 hb_bool_t
 hb_variation_from_string (const char *str, int len,
 			  hb_variation_t *variation)
@@ -919,6 +924,11 @@ hb_variation_from_string (const char *str, int len,
   return false;
 }
 
+/**
+ * hb_variation_to_string:
+ *
+ * Since: 1.4.2
+ */
 void
 hb_variation_to_string (hb_variation_t *variation,
 			char *buf, unsigned int size)
diff --git a/src/hb-common.h b/src/hb-common.h
index ed0b97df..634cb96a 100644
--- a/src/hb-common.h
+++ b/src/hb-common.h
@@ -379,6 +379,11 @@ HB_EXTERN void
 hb_feature_to_string (hb_feature_t *feature,
 		      char *buf, unsigned int size);
 
+/**
+ * hb_variation_t:
+ *
+ * Since: 1.4.2
+ */
 typedef struct hb_variation_t {
   hb_tag_t tag;
   float    value;
diff --git a/src/hb-directwrite.cc b/src/hb-directwrite.cc
index 11b93531..d63bc047 100644
--- a/src/hb-directwrite.cc
+++ b/src/hb-directwrite.cc
@@ -915,7 +915,7 @@ _hb_directwrite_shape(hb_shape_plan_t    *shape_plan,
  */
 
 hb_bool_t
-hb_shape_dwrite_experimental_width(hb_font_t          *font,
+hb_directwrite_shape_experimental_width(hb_font_t          *font,
   hb_buffer_t        *buffer,
   const hb_feature_t *features,
   unsigned int        num_features,
diff --git a/src/hb-directwrite.h b/src/hb-directwrite.h
index 0eb116f4..e743af21 100644
--- a/src/hb-directwrite.h
+++ b/src/hb-directwrite.h
@@ -30,7 +30,7 @@
 HB_BEGIN_DECLS
 
 HB_EXTERN hb_bool_t
-hb_shape_dwrite_experimental_width(hb_font_t *font, hb_buffer_t *buffer,
+hb_directwrite_shape_experimental_width(hb_font_t *font, hb_buffer_t *buffer,
   const hb_feature_t *features, unsigned int num_features, float width);
 
 HB_END_DECLS
diff --git a/src/hb-font.cc b/src/hb-font.cc
index 607bd489..3140ee47 100644
--- a/src/hb-font.cc
+++ b/src/hb-font.cc
@@ -1551,6 +1551,11 @@ _hb_font_adopt_var_coords_normalized (hb_font_t *font,
   font->num_coords = coords_length;
 }
 
+/**
+ * hb_font_set_variations:
+ *
+ * Since: 1.4.2
+ */
 void
 hb_font_set_variations (hb_font_t *font,
 			const hb_variation_t *variations,
@@ -1584,6 +1589,11 @@ hb_font_set_variations (hb_font_t *font,
   _hb_font_adopt_var_coords_normalized (font, normalized, coords_length);
 }
 
+/**
+ * hb_font_set_var_coords_design:
+ *
+ * Since: 1.4.2
+ */
 void
 hb_font_set_var_coords_design (hb_font_t *font,
 			       const float *coords,
@@ -1603,6 +1613,11 @@ hb_font_set_var_coords_design (hb_font_t *font,
   _hb_font_adopt_var_coords_normalized (font, normalized, coords_length);
 }
 
+/**
+ * hb_font_set_var_coords_normalized:
+ *
+ * Since: 1.4.2
+ */
 void
 hb_font_set_var_coords_normalized (hb_font_t *font,
 				   const int *coords, /* 2.14 normalized */
@@ -1621,6 +1636,11 @@ hb_font_set_var_coords_normalized (hb_font_t *font,
   _hb_font_adopt_var_coords_normalized (font, copy, coords_length);
 }
 
+/**
+ * hb_font_set_var_coords_normalized:
+ *
+ * Since: 1.4.2
+ */
 int *
 hb_font_get_var_coords_normalized (hb_font_t *font,
 				   unsigned int *length)
diff --git a/src/hb-ot-var.cc b/src/hb-ot-var.cc
index d1e97257..50804247 100644
--- a/src/hb-ot-var.cc
+++ b/src/hb-ot-var.cc
@@ -63,6 +63,11 @@ hb_ot_var_has_data (hb_face_t *face)
   return &_get_fvar (face) != &OT::Null(OT::fvar);
 }
 
+/**
+ * hb_ot_var_get_axis_count:
+ *
+ * Since: 1.4.2
+ **/
 unsigned int
 hb_ot_var_get_axis_count (hb_face_t *face)
 {
@@ -70,6 +75,11 @@ hb_ot_var_get_axis_count (hb_face_t *face)
   return fvar.get_axis_count ();
 }
 
+/**
+ * hb_ot_var_get_axes:
+ *
+ * Since: 1.4.2
+ **/
 unsigned int
 hb_ot_var_get_axes (hb_face_t        *face,
 		    unsigned int      start_offset,
@@ -80,7 +90,12 @@ hb_ot_var_get_axes (hb_face_t        *face,
   return fvar.get_axis_infos (start_offset, axes_count, axes_array);
 }
 
-HB_EXTERN hb_bool_t
+/**
+ * hb_ot_var_find_axis:
+ *
+ * Since: 1.4.2
+ **/
+hb_bool_t
 hb_ot_var_find_axis (hb_face_t        *face,
 		     hb_tag_t          axis_tag,
 		     unsigned int     *axis_index,
@@ -90,7 +105,12 @@ hb_ot_var_find_axis (hb_face_t        *face,
   return fvar.find_axis (axis_tag, axis_index, axis_info);
 }
 
-HB_EXTERN int
+/**
+ * hb_ot_var_normalize_axis_value:
+ *
+ * Since: 1.4.2
+ **/
+int
 hb_ot_var_normalize_axis_value (hb_face_t    *face,
 				unsigned int  axis_index,
 				float         v)
diff --git a/src/hb-ot-var.h b/src/hb-ot-var.h
index 4023b29f..652a78d0 100644
--- a/src/hb-ot-var.h
+++ b/src/hb-ot-var.h
@@ -60,6 +60,11 @@ typedef struct hb_ot_var_axis_t {
 HB_EXTERN hb_bool_t
 hb_ot_var_has_data (hb_face_t *face);
 
+/**
+ * HB_OT_VAR_NO_AXIS_INDEX:
+ *
+ * Since: 1.4.2
+ */
 #define HB_OT_VAR_NO_AXIS_INDEX		0xFFFFFFFFu
 
 HB_EXTERN unsigned int
@@ -83,13 +88,6 @@ hb_ot_var_normalize_axis_value (hb_face_t    *face,
 				unsigned int  axis_index,
 				float         v);
 
-#if 0
-
-HB_EXTERN unsigned int
-Xhb_ot_var_get_named_instances (hb_face_t        *face, ... );
-
-#endif
-
 
 HB_END_DECLS
 
diff --git a/src/hb-set.cc b/src/hb-set.cc
index cb7fcdbf..f3fe1ba4 100644
--- a/src/hb-set.cc
+++ b/src/hb-set.cc
@@ -105,7 +105,7 @@ hb_set_destroy (hb_set_t *set)
  * @set: a set.
  * @key:
  * @data:
- * @destroy (closure data):
+ * @destroy:
  * @replace:
  *
  * Return value: