1 files changed, 3 insertions, 0 deletions

diff --git a/toxcore/tox.h b/toxcore/tox.h
index e6cf0322..718f817b 100644
--- a/toxcore/tox.h
+++ b/toxcore/tox.h
@@ -204,6 +204,9 @@ int tox_get_statusmessage_size(Tox *tox, int friendnumber);
 /* Copy friendnumber's status message into buf, truncating if size is over maxlen.
  * Get the size you need to allocate from m_get_statusmessage_size.
  * The self variant will copy our own status message.
+ *
+ * returns the length of the copied data on success
+ * retruns -1 on failure.
  */
 int tox_copy_statusmessage(Tox *tox, int friendnumber, uint8_t *buf, uint32_t maxlen);
 int tox_copy_self_statusmessage(Tox *tox, uint8_t *buf, uint32_t maxlen);