+ * Create a random UUID
+ * \param msg_id Descriptor
+ * \internal
+ * Crams the msg_id ID buffer with random 32-bit numbers; because we
+ * use a byte based buffer, we play the cast to guint32 trick (as that
+ * is what g_random_int() returns).
can we just stick with gtk-doc like you had in your previous patches. I
think intermixing it with doxygen is a bad idea.