From 695fa4373aef9f9632a93c70a4138688325499e2 Mon Sep 17 00:00:00 2001
From: "zugz (tox)" <mbays+tox@sdf.org>
Date: Sun, 10 Feb 2019 00:00:00 +0000
Subject: [PATCH] explain enabling in API comment

---
 toxav/toxav.h     | 8 ++++++++
 toxav/toxav_old.c | 8 ++++++++
 2 files changed, 16 insertions(+)

diff --git a/toxav/toxav.h b/toxav/toxav.h
index 5d4f3bd3..bfb7617c 100644
--- a/toxav/toxav.h
+++ b/toxav/toxav.h
@@ -783,6 +783,14 @@ int toxav_group_send_audio(Tox *tox, uint32_t groupnumber, const int16_t *pcm, u
                            uint32_t sample_rate);
 
 /* Enable A/V in a groupchat.
+ *
+ * A/V must be enabled on a groupchat for audio to be sent to it and for
+ * received audio to be handled.
+ *
+ * An A/V group created with toxav_add_av_groupchat or toxav_join_av_groupchat
+ * will start with A/V enabled.
+ *
+ * An A/V group loaded from a savefile will start with A/V disabled.
  *
  * return 0 on success.
  * return -1 on failure.
diff --git a/toxav/toxav_old.c b/toxav/toxav_old.c
index 0ae9231d..1362798d 100644
--- a/toxav/toxav_old.c
+++ b/toxav/toxav_old.c
@@ -82,6 +82,14 @@ int toxav_group_send_audio(Tox *tox, uint32_t groupnumber, const int16_t *pcm, u
 }
 
 /* Enable A/V in a groupchat.
+ *
+ * A/V must be enabled on a groupchat for audio to be sent to it and for
+ * received audio to be handled.
+ *
+ * An A/V group created with toxav_add_av_groupchat or toxav_join_av_groupchat
+ * will start with A/V enabled.
+ *
+ * An A/V group loaded from a savefile will start with A/V disabled.
  *
  * return 0 on success.
  * return -1 on failure.