1 files changed, 3 insertions, 0 deletions

diff --git a/toxcore/tox.h b/toxcore/tox.h
index 39beb004..8caa01e0 100644
--- a/toxcore/tox.h
+++ b/toxcore/tox.h
@@ -488,6 +488,8 @@ uint32_t tox_get_chatlist(const Tox *tox, int *out_list, uint32_t list_size);
  * 2. Wait for the callback set with tox_callback_file_control(...) to be called with receive_send == 1 and control_type == TOX_FILECONTROL_ACCEPT
  * 3. Send the data with tox_file_send_data(...) with chunk size tox_file_data_size(...)
  * 4. When sending is done, send a tox_file_send_control(...) with send_receive = 0 and message_id = TOX_FILECONTROL_FINISHED
+ * 5. when the callback set with tox_callback_file_control(...) is called with receive_send == 1 and control_type == TOX_FILECONTROL_FINISHED
+ * the other person has received the file correctly.
  *
  * HOW TO RECEIVE FILES CORRECTLY:
  * 1. wait for the callback set with tox_callback_file_send_request(...)
@@ -495,6 +497,7 @@ uint32_t tox_get_chatlist(const Tox *tox, int *out_list, uint32_t list_size);
  * 3. save all the data received with the callback set with tox_callback_file_data(...) to a file.
  * 4. when the callback set with tox_callback_file_control(...) is called with receive_send == 0 and control_type == TOX_FILECONTROL_FINISHED
  * the file is done transferring.
+ * 5. send a tox_file_send_control(...) with send_receive = 1 and message_id = TOX_FILECONTROL_FINISHED to confirm that we did receive the file.
  *
  * tox_file_data_remaining(...) can be used to know how many bytes are left to send/receive.
  *