[draw] Fix some introspection warnings
diff --git a/src/hb-draw.cc b/src/hb-draw.cc
index e83c267..023cb81 100644
--- a/src/hb-draw.cc
+++ b/src/hb-draw.cc
@@ -107,10 +107,17 @@
 #undef HB_DRAW_FUNC_IMPLEMENT
 
 /**
- * hb_draw_funcs_create:
+ * hb_draw_funcs_create: (Xconstructor)
  *
  * Creates a new draw callbacks object.
  *
+ * Return value: (transfer full):
+ * A newly allocated #hb_draw_funcs_t with a reference count of 1. The initial
+ * reference count should be released with hb_draw_funcs_destroy when you are
+ * done using the #hb_draw_funcs_t. This function never returns %NULL. If
+ * memory cannot be allocated, a special singleton #hb_draw_funcs_t object will
+ * be returned.
+ *
  * Since: REPLACEME
  **/
 hb_draw_funcs_t *
@@ -138,12 +145,15 @@
 
 
 /**
- * hb_draw_funcs_reference:
+ * hb_draw_funcs_reference: (skip)
  * @dfuncs: draw functions
  *
- * Add to callbacks object refcount.
+ * Increases the reference count on @dfuncs by one. This prevents @buffer from
+ * being destroyed until a matching call to hb_draw_funcs_destroy() is made.
  *
- * Returns: The same object.
+ * Return value: (transfer full):
+ * The referenced #hb_draw_funcs_t.
+ *
  * Since: REPLACEME
  **/
 hb_draw_funcs_t *
@@ -153,11 +163,12 @@
 }
 
 /**
- * hb_draw_funcs_destroy:
+ * hb_draw_funcs_destroy: (skip)
  * @dfuncs: draw functions
  *
- * Decreases refcount of callbacks object and deletes the object if it reaches
- * to zero.
+ * Deallocate the @dfuncs.
+ * Decreases the reference count on @dfuncs by one. If the result is zero, then
+ * @dfuncs and all associated resources are freed. See hb_draw_funcs_reference().
  *
  * Since: REPLACEME
  **/
@@ -179,7 +190,7 @@
  * hb_draw_funcs_make_immutable:
  * @dfuncs: draw functions
  *
- * Makes dfuncs object immutable.
+ * Makes @dfuncs object immutable.
  *
  * Since: REPLACEME
  **/
@@ -196,9 +207,10 @@
  * hb_draw_funcs_is_immutable:
  * @dfuncs: draw functions
  *
- * Checks whether dfuncs is immutable.
+ * Checks whether @dfuncs is immutable.
  *
- * Returns: If is immutable.
+ * Return value: %true if @dfuncs is immutable, %false otherwise
+ *
  * Since: REPLACEME
  **/
 hb_bool_t