2 files changed, 4 insertions, 0 deletions

diff --git a/other/apidsl/tox.in.h b/other/apidsl/tox.in.h
index b769135a..5b371c17 100644
--- a/other/apidsl/tox.in.h
+++ b/other/apidsl/tox.in.h
@@ -516,6 +516,8 @@ static class options {
  *   NULL, the default options are used.
  *
  * @see $iterate for the event loop.
+ *
+ * @return A new Tox instance pointer on success or NULL on failure.
  */
 static this new(const options_t *options) {
   NULL,
diff --git a/toxcore/tox.h b/toxcore/tox.h
index b556d138..038a366f 100644
--- a/toxcore/tox.h
+++ b/toxcore/tox.h
@@ -609,6 +609,8 @@ typedef enum TOX_ERR_NEW {
  *   NULL, the default options are used.
  *
  * @see tox_iterate for the event loop.
+ *
+ * @return A new Tox instance pointer on success or NULL on failure.
  */
 Tox *tox_new(const struct Tox_Options *options, TOX_ERR_NEW *error);