--- a/pidgin/pidgintalkatu.h	Fri Dec 14 18:02:19 2018 -0600
+++ b/pidgin/pidgintalkatu.h	Sat Dec 15 00:54:48 2018 -0600
@@ -51,7 +51,8 @@
  * pidgin_talkatu_buffer_new_for_connection:
  * @pc: The connection for which the buffer should be created
  *
- * Creates a new #TalkatuBuffer appropriate for use with @pc.
+ * Creates a new #TalkatuBuffer. Depending on @pc's #PurpleConnectionFlags,
+ * it will create a plain, HTML, or markdown buffer.
  *
  * Returns: (transfer full): the new #TalkatuBuffer
  */