- * @text: a gchar* pointer to the text to insert, in UTF-8 encoding.
- * @length: (frankly I'm not sure this parameter should be here)
+ * @text: a string representing the text to insert, in UTF-8 encoding.
+ * @length: the number of characters of text to insert, in bytes. If the
+ * byte count of text is less than or equal to length, the entire contents
+ * of text will be inserted.