From e52b83d873994c9e470565c97062c3118744c856 Mon Sep 17 00:00:00 2001
From: s1lent <s1lentsk@yandex.ru>
Date: Tue, 3 Oct 2017 18:47:17 +0700
Subject: [PATCH] Add more comments

---
 .../amxmodx/scripting/include/reapi_gamedll.inc      | 12 +++++++++++-
 reapi/src/natives/natives_common.cpp                 | 12 +++++++++++-
 2 files changed, 22 insertions(+), 2 deletions(-)

diff --git a/reapi/extra/amxmodx/scripting/include/reapi_gamedll.inc b/reapi/extra/amxmodx/scripting/include/reapi_gamedll.inc
index 07c69e0..a88a240 100644
--- a/reapi/extra/amxmodx/scripting/include/reapi_gamedll.inc
+++ b/reapi/extra/amxmodx/scripting/include/reapi_gamedll.inc
@@ -11,6 +11,8 @@
 *
 * @param entity     Entity index
 * @param callback   The forward to call
+* @param params     Optional set of data to pass through to callback
+* @param len        Optional size of data
 *
 * @note Use "" to reset callback
 * @note Callback should be contains passing arguments as "public Think_Callback(const ent)"
@@ -24,6 +26,8 @@ native SetThink(const ent, const callback[], const params[] = "", const len = 0)
 *
 * @param entity     Entity index
 * @param callback   The forward to call
+* @param params     Optional set of data to pass through to callback
+* @param len        Optional size of data
 *
 * @note Use "" to reset callback
 * @note Callback should be contains passing arguments as "public Touch_Callback(const ent, const other)"
@@ -37,6 +41,8 @@ native SetTouch(const ent, const callback[], const params[] = "", const len = 0)
 *
 * @param entity     Entity index
 * @param callback   The forward to call
+* @param params     Optional set of data to pass through to callback
+* @param len        Optional size of data
 *
 * @note Use "" to reset callback
 * @note Callback should be contains passing arguments as "public Use_Callback(const ent, const activator, const caller, USE_TYPE:useType, Float:value)"
@@ -50,6 +56,8 @@ native SetUse(const ent, const callback[], const params[] = "", const len = 0);
 *
 * @param entity     Entity index
 * @param callback   The forward to call
+* @param params     Optional set of data to pass through to callback
+* @param len        Optional size of data
 *
 * @note Use "" to reset callback
 * @note Callback should be contains passing arguments as "public Blocked_Callback(const ent, const other)"
@@ -63,10 +71,12 @@ native SetBlocked(const ent, const callback[], const params[] = "", const len =
 *
 * @param entity     Entity index
 * @param callback   The forward to call
+* @param params     Optional set of data to pass through to callback
+* @param len        Optional size of data
 *
 * @note Use "" to reset callback
 * @note Entity should be inherited from CBaseToggle, otherwise server can crash
-* @note Callback should be contains passing arguments as "public MoveDone_Callback(const ent, const other)"
+* @note Callback should be contains passing arguments as "public MoveDone_Callback(const ent)"
 *
 * @noreturn
 */
diff --git a/reapi/src/natives/natives_common.cpp b/reapi/src/natives/natives_common.cpp
index 95b8d1f..bae8c32 100644
--- a/reapi/src/natives/natives_common.cpp
+++ b/reapi/src/natives/natives_common.cpp
@@ -260,6 +260,8 @@ cell AMX_NATIVE_CALL amx_GetAttachment(AMX *amx, cell *params)
 *
 * @param entity     Entity index
 * @param callback   The forward to call
+* @param params     Optional set of data to pass through to callback
+* @param len        Optional size of data
 *
 * @note Use "" to reset callback
 * @note Callback should be contains passing arguments as "public Think_Callback(const ent)"
@@ -301,6 +303,8 @@ cell AMX_NATIVE_CALL amx_SetThink(AMX *amx, cell *params)
 *
 * @param entity     Entity index
 * @param callback   The forward to call
+* @param params     Optional set of data to pass through to callback
+* @param len        Optional size of data
 *
 * @note Use "" to reset callback
 * @note Callback should be contains passing arguments as "public Touch_Callback(const ent, const other)"
@@ -342,6 +346,8 @@ cell AMX_NATIVE_CALL amx_SetTouch(AMX *amx, cell *params)
 *
 * @param entity     Entity index
 * @param callback   The forward to call
+* @param params     Optional set of data to pass through to callback
+* @param len        Optional size of data
 *
 * @note Use "" to reset callback
 * @note Callback should be contains passing arguments as "public Use_Callback(const ent, const activator, const caller, USE_TYPE:useType, Float:value)"
@@ -383,6 +389,8 @@ cell AMX_NATIVE_CALL amx_SetUse(AMX *amx, cell *params)
 *
 * @param entity     Entity index
 * @param callback   The forward to call
+* @param params     Optional set of data to pass through to callback
+* @param len        Optional size of data
 *
 * @note Use "" to reset callback
 * @note Callback should be contains passing arguments as "public Blocked_Callback(const ent, const other)"
@@ -424,10 +432,12 @@ cell AMX_NATIVE_CALL amx_SetBlocked(AMX *amx, cell *params)
 *
 * @param entity     Entity index
 * @param callback   The forward to call
+* @param params     Optional set of data to pass through to callback
+* @param len        Optional size of data
 *
 * @note Use "" to reset callback
 * @note Entity should be inherited from CBaseToggle, otherwise server can crash
-* @note Callback should be contains passing arguments as "public MoveDone_Callback(const ent, const other)"
+* @note Callback should be contains passing arguments as "public MoveDone_Callback(const ent)"
 *
 * @noreturn
 *