diff --git a/plugins/include/amxmodx.inc b/plugins/include/amxmodx.inc index d9745a5e7..77855f334 100755 --- a/plugins/include/amxmodx.inc +++ b/plugins/include/amxmodx.inc @@ -441,7 +441,7 @@ native client_print(index, type, const message[], any:...); * * @param index Client index, use 0 to display to all clients * @param sender Client index used as the message sender - * @param fmt Formatting rules + * @param message Formatting rules * @param ... Variable number of formatting parameters * * @return Number of printed characters @@ -475,7 +475,7 @@ native engclient_print(player, type, const message[], any:...); /** * Sends a message to the console of a client or the server. * - * @param index Client index, or 0 to print to the server console + * @param id Client index, or 0 to print to the server console * @param message Formatting rules * @param ... Variable number of formatting parameters * @@ -1347,7 +1347,7 @@ native log_amx(const string[], any:...); * * @note The log will include a timestamp with the message. * - * @param string Formatting rules + * @param message Formatting rules * @param ... Variable number of formatting parameters * * @return Number of printed characters @@ -1360,7 +1360,7 @@ native log_message(const message[], any:...); * @note The log will include a timestamp with the message. * @note The message can be hooked using "register_logevent". * - * @param string Formatting rules + * @param message Formatting rules * @param ... Variable number of formatting parameters * * @return Number of printed characters @@ -1372,6 +1372,7 @@ native elog_message(const message[], any:...); * * @note The log will include a timestamp with the message. * + * @param file Log filename * @param string Formatting rules * @param ... Variable number of formatting parameters * @@ -1917,7 +1918,7 @@ native register_clcmd(const client_cmd[], const function[], flags = -1, const in * has required privileges (flags is not -1) and it is not a command * starting with "say". * - * @param client_cmd Command to register + * @param cmd Command to register * @param function Callback function * @param flags Admin privilege flags required * @param info Command description @@ -1938,7 +1939,7 @@ native register_concmd(const cmd[], const function[], flags = -1, const info[] = * @note For a list of possible access flags, see the ADMIN_* constants in * amxconst.inc * - * @param client_cmd Command to register + * @param server_cmd Command to register * @param function Callback function * @param flags Admin privilege flags required * @param info Command description @@ -1989,17 +1990,17 @@ native get_clcmdsnum(flag); * @note For a list of possible access flags, see the ADMIN_* constants in * amxconst.inc * - * @param index Command index - * @param command Buffer to copy command name to - * @param len1 Maximum name buffer size - * @param flags Variable to store privilege flags to - * @param info Buffer to copy command description to - * @param len2 Maximum description buffer size - * @param flag Only considers commands that can be accessed with - * the specified privilege flags - * @param info_ml Variable to store whether the parameter "info" is a multilingual key + * @param index Command index + * @param server_cmd Buffer to copy command name to + * @param len1 Maximum name buffer size + * @param flags Variable to store privilege flags to + * @param info Buffer to copy command description to + * @param len2 Maximum description buffer size + * @param flag Only considers commands that can be accessed with + * the specified privilege flags + * @param info_ml Variable to store whether the parameter "info" is a multilingual key * - * @return 1 on success, 0 if command was not found + * @return 1 on success, 0 if command was not found */ native get_srvcmd(index, server_cmd[], len1, &flags, info[], len2, flag, &bool:info_ml = false); @@ -2023,7 +2024,7 @@ native get_srvcmdsnum(flag); * amxconst.inc * * @param index Command index - * @param command Buffer to copy command name to + * @param cmd Buffer to copy command name to * @param len1 Maximum name buffer size * @param flags Variable to store privilege flags to * @param info Buffer to copy command description to @@ -2720,6 +2721,8 @@ native register_native(const name[], const handler[], style = 0); * #pragma loadlib * #endif * + * @param library Library name + * * @noreturn */ native register_library(const library[]); @@ -2862,7 +2865,7 @@ native set_float_byref(param, Float:value); * * @param param Argument to retrieve, starting from 1 * @param dest Buffer to copy array to - * @param maxlen Size of buffer + * @param size Size of buffer * * @noreturn * @error If used outside of a native callback, or the native was @@ -2875,7 +2878,7 @@ native get_array(param, dest[], size); * * @param param Argument to retrieve, starting from 1 * @param dest Buffer to copy array to - * @param maxlen Size of buffer + * @param size Size of buffer * * @noreturn * @error If used outside of a native callback, or the native was @@ -2888,7 +2891,7 @@ native get_array_f(param, Float:dest[], size); * * @param param Argument to set, starting from 1 * @param source Buffer to copy array from - * @param maxlen Size of buffer + * @param size Size of buffer * * @noreturn * @error If used outside of a native callback, or the native was @@ -2901,7 +2904,7 @@ native set_array(param, const source[], size); * * @param param Argument to set, starting from 1 * @param source Buffer to copy array from - * @param maxlen Size of buffer + * @param size Size of buffer * * @noreturn * @error If used outside of a native callback, or the native was @@ -3034,6 +3037,8 @@ native set_native_filter(const handler[]); * @note Errors occuring inside the handler will not be filtered and cause the * plugin to fail load as if the handler returned PLUGIN_CONTINUE. * + * @param handler Function name to call + * * @return 0 on success, -1 if filtering is not available, -2 if handler * could not be found. */ diff --git a/plugins/include/cellarray.inc b/plugins/include/cellarray.inc index 203134406..3c6ffcde6 100644 --- a/plugins/include/cellarray.inc +++ b/plugins/include/cellarray.inc @@ -361,7 +361,8 @@ native ArrayInsertStringBefore(Array:which, item, const input[]); * Swaps the position of two items. * * @param which Array handle - * @param item1,item2 Item pair to swap + * @param item1 Item pair to swap + * @param item2 Item pair to swap * * @noreturn * @error If an invalid handle or an invalid index is provided an diff --git a/plugins/include/celltrie.inc b/plugins/include/celltrie.inc index cf69dfebe..0d4938447 100644 --- a/plugins/include/celltrie.inc +++ b/plugins/include/celltrie.inc @@ -298,6 +298,8 @@ native TrieSnapshotDestroy(&Snapshot:handle); * reading directly from the map. * @note Just like in snapshots the keys are not sorted. * + * @param handle Map handle + * * @return New iterator handle, which must be freed via TrieIterDestroy(). * @error Invalid Handle */ diff --git a/plugins/include/core.inc b/plugins/include/core.inc index d78e9b217..019100648 100755 --- a/plugins/include/core.inc +++ b/plugins/include/core.inc @@ -55,6 +55,7 @@ native getarg(arg, index = 0); * * @param arg Argument index * @param index Index to set in the argument (for arrays and strings) + * @param value Argument value */ native setarg(arg, index = 0, value); diff --git a/plugins/include/csx.inc b/plugins/include/csx.inc index 4ce554c31..b6625f3ff 100755 --- a/plugins/include/csx.inc +++ b/plugins/include/csx.inc @@ -47,7 +47,7 @@ enum MapObjective * @param damage Damage dealt to victim * @param wpnindex Weapon id * @param hitplace Body hitplace - * @param ta If nonzero the attack was a team attack + * @param TA If nonzero the attack was a team attack * * @noreturn */ @@ -61,11 +61,11 @@ forward client_damage(attacker, victim, damage, wpnindex, hitplace, TA); * @note For a list of possible body hitplaces see the HIT_* constants in * amxconst.inc * - * @param attacker Attacker client index + * @param killer Killer client index * @param victim Victim client index * @param wpnindex Weapon id * @param hitplace Body hitplace - * @param tk If nonzero the death was a teamkill + * @param TK If nonzero the death was a teamkill * * @noreturn */ diff --git a/plugins/include/cvars.inc b/plugins/include/cvars.inc index 74b633381..908180d47 100644 --- a/plugins/include/cvars.inc +++ b/plugins/include/cvars.inc @@ -212,7 +212,7 @@ native remove_cvar_flags(const cvar[], flags=-1); * why the otherwise equivalent get_pcvar_string() function should be used * instead. * - * @param cvar Cvar name to retrieve value from + * @param cvarname Cvar name to retrieve value from * @param output Buffer to copy cvar value to * @param iLen Maximum size of the buffer * @@ -281,7 +281,7 @@ native get_cvar_num(const cvarname[]); * why the otherwise equivalent set_pcvar_num() function should be used * instead. * - * @param cvar Cvar name to set value of + * @param cvarname Cvar name to set value of * @param value Value to set cvar to * * @noreturn diff --git a/plugins/include/fakemeta.inc b/plugins/include/fakemeta.inc index 35171a847..c3af47786 100755 --- a/plugins/include/fakemeta.inc +++ b/plugins/include/fakemeta.inc @@ -89,14 +89,21 @@ native pev_valid(entindex); */ native pev_serial(entindex); -/* Returns any global variable inside globalvars_t structure. Use the glb_* enum. - * - * When returning data from glb_pStringBase (the global string table), you may give a pointer into that table - * in order to get different strings. - * Example: - * new model[128] - * new ptr = pev(id, pev_viewmodel) - * global_get(glb_pStringBase, ptr, model, 127) +/** + * Returns any global variable inside globalvars_t structure. Use the glb_* enum. + * + * @note When returning data from glb_pStringBase (the global string table), + * @note you may give a pointer into that table in order to get different strings. + * @note Example: + * new model[128] + * new ptr = pev(id, pev_viewmodel) + * global_get(glb_pStringBase, ptr, model, 127) + * + * @param _value Global string table. + * @return 0 if unsuccess. + * 1 if success. + * Otherwise, an global index is returned. + * To get the value of int, you need to use the value returned by the function. */ native global_get(_value, any:...); diff --git a/plugins/include/file.inc b/plugins/include/file.inc index db0b96c17..e05c2b5e6 100755 --- a/plugins/include/file.inc +++ b/plugins/include/file.inc @@ -386,7 +386,7 @@ native fputs(file, const text[], bool:null_term = false); * Writes a line of formatted text to a text file. * * @param file Handle to the file - * @param format Formatting rules + * @param fmt Formatting rules * @param ... Variable number of format parameters * * @return Total number of characters written on success, 0 otherwise @@ -475,7 +475,7 @@ native rmdir(const path[]); /** * Creates a directory. * - * @param path Path to create + * @param dirname Path to create * @param mode Permissions (default is o=rx,g=rx,u=rwx). Note that folders must have * the execute bit set on Linux. On Windows, the mode is ignored. * @param use_valve_fs If true, the Valve file system will be used instead diff --git a/plugins/include/float.inc b/plugins/include/float.inc index a731ffb6f..f9a25ad5f 100755 --- a/plugins/include/float.inc +++ b/plugins/include/float.inc @@ -162,7 +162,7 @@ native Float:floattan(Float:value, anglemode:mode=radian); * * @note For available units of measurements(modes) look at the anglemode enum * - * @param value The angle to calculate the hyperbolic sine from + * @param angle The angle to calculate the hyperbolic sine from * @param mode What unit of measurement is the angle specified in * Defaults to radians * @@ -175,7 +175,7 @@ native Float:floatsinh(Float:angle, anglemode:mode=radian); * * @note For available units of measurements(modes) look at the anglemode enum * - * @param value The angle to calculate the hyperbolic cosine from + * @param angle The angle to calculate the hyperbolic cosine from * @param mode What unit of measurement is the angle specified in * Defaults to radians * @@ -188,7 +188,7 @@ native Float:floatcosh(Float:angle, anglemode:mode=radian); * * @note For available units of measurements(modes) look at the anglemode enum * - * @param value The angle to calculate the hyperbolic tangent from + * @param angle The angle to calculate the hyperbolic tangent from * @param mode What unit of measurement is the angle specified in * Defaults to radians * @@ -213,8 +213,8 @@ native Float:floatabs(Float:value); * * @note For available units of measurements(modes) look at the anglemode enum * - * @param value The tangent to calculate the angle from - * @param mode What unit of measurement should the output angle be in + * @param angle The tangent to calculate the angle from + * @param radix What unit of measurement should the output angle be in * * @return The angle of a tangent */ @@ -225,8 +225,8 @@ native Float:floatatan(Float:angle, {anglemode,_}:radix); * * @note For available units of measurements(modes) look at the anglemode enum * - * @param value The cosine to calculate the angle from - * @param mode What unit of measurement should the output angle be in + * @param angle The cosine to calculate the angle from + * @param radix What unit of measurement should the output angle be in * * @return The angle of a cosine */ @@ -237,8 +237,8 @@ native Float:floatacos(Float:angle, {anglemode,_}:radix); * * @note For available units of measurements(modes) look at the anglemode enum * - * @param value The sine to calculate the angle from - * @param mode What unit of measurement should the output angle be in + * @param angle The sine to calculate the angle from + * @param radix What unit of measurement should the output angle be in * * @return The angle of a sine */ @@ -252,7 +252,7 @@ native Float:floatasin(Float:angle, {anglemode,_}:radix); * * @param x Value representing the proportion of the x-coordinate. * @param y Value representing the proportion of the x-coordinate. - * @param mode What unit of measurement should the output angle be in + * @param radix What unit of measurement should the output angle be in * * @return Arctangent of y/x */ diff --git a/plugins/include/geoip.inc b/plugins/include/geoip.inc index 9bc211f51..809a9bb7b 100755 --- a/plugins/include/geoip.inc +++ b/plugins/include/geoip.inc @@ -55,7 +55,7 @@ native bool:geoip_code3_ex(const ip[], result[4]); * Use geoip_code2_ex instead. * * @param ip The IP address to lookup. - * @param result The result buffer. + * @param ccode The result buffer. * * @return The result length. */ diff --git a/plugins/include/hamsandwich.inc b/plugins/include/hamsandwich.inc index 8eb65c271..fa3432968 100644 --- a/plugins/include/hamsandwich.inc +++ b/plugins/include/hamsandwich.inc @@ -39,8 +39,8 @@ * * @param function The function to hook. * @param EntityClass The entity classname to hook. - * @param callback The forward to call. - * @param post Whether or not to forward this in post. + * @param Callback The forward to call. + * @param Post Whether or not to forward this in post. * @param specialbot Whether or not to enable support for bot without "player" classname. * @return Returns a handle to the forward. Use EnableHamForward/DisableHamForward to toggle the forward on or off. */ @@ -52,8 +52,8 @@ native HamHook:RegisterHam(Ham:function, const EntityClass[], const Callback[], * Look at the Ham enum for parameter lists. * * @param function The function to hook. - * @param callback The forward to call. - * @param post Whether or not to forward this in post. + * @param Callback The forward to call. + * @param Post Whether or not to forward this in post. * @return Returns a handle to the forward. Use EnableHamForward/DisableHamForward to toggle the forward on or off. */ stock HamHook:RegisterHamPlayer(Ham:function, const Callback[], Post=0) @@ -70,8 +70,8 @@ stock HamHook:RegisterHamPlayer(Ham:function, const Callback[], Post=0) * * @param function The function to hook. * @param EntityId The entity classname to hook. - * @param callback The forward to call. - * @param post Whether or not to forward this in post. + * @param Callback The forward to call. + * @param Post Whether or not to forward this in post. * @return Returns a handle to the forward. Use EnableHamForward/DisableHamForward to toggle the forward on or off. */ native HamHook:RegisterHamFromEntity(Ham:function, EntityId, const Callback[], Post=0); @@ -98,7 +98,7 @@ native EnableHamForward(HamHook:fwd); * Look at the Ham enum for parameter lists. * * @param function The function to call. - * @param id The id of the entity to execute it on. + * @param this The id of the entity to execute it on. */ native ExecuteHam(Ham:function, this, any:...); @@ -108,7 +108,7 @@ native ExecuteHam(Ham:function, this, any:...); * Look at the Ham enum for parameter lists. * * @param function The function to call. - * @param id The id of the entity to execute it on. + * @param this The id of the entity to execute it on. */ native ExecuteHamB(Ham:function, this, any:...); diff --git a/plugins/include/lang.inc b/plugins/include/lang.inc index a88c66c43..7c8b8c54d 100755 --- a/plugins/include/lang.inc +++ b/plugins/include/lang.inc @@ -51,6 +51,8 @@ native register_dictionary(const filename[]); /** * Checks if the language is loaded. * + * @param name Language name (ISO 639-1) + * * @return 1 if it is, 0 otherwise */ native lang_exists(const name[]); diff --git a/plugins/include/newmenus.inc b/plugins/include/newmenus.inc index f89fa71ed..654039daf 100644 --- a/plugins/include/newmenus.inc +++ b/plugins/include/newmenus.inc @@ -346,7 +346,7 @@ native menu_addtext(menu, const text[], slot=1); * @error Invalid menu resource. * Too many items on non-paginated menu (max is 10) */ -native menu_addblank2( menu ); +native menu_addblank2(menu); /** * Adds a text line to a menu, always shifting the numbering down. @@ -362,7 +362,7 @@ native menu_addblank2( menu ); * @error Invalid menu resource. * Too many items on non-paginated menu (max is 10) */ -native menu_addtext2( menu, const text[] ); +native menu_addtext2(menu, const text[]); /** * Sets a menu property. diff --git a/plugins/include/ns.inc b/plugins/include/ns.inc index 75f1b5ba2..bf79f8710 100755 --- a/plugins/include/ns.inc +++ b/plugins/include/ns.inc @@ -351,7 +351,7 @@ native ns_set_points(id, points); * Adds to the player's points spent count in combat. * * @param id The player to add this to. - * @param value The value to add to the points spent. + * @param points The value to add to the points spent. * @return The new value of the points spent variable. */ native ns_add_points(id,points); @@ -389,7 +389,7 @@ native Float:ns_get_weap_range(idWeapon); * * @note Use weapon index, not player index! * @param idWeapon The entity index of the weapon to set. - * @param range The maximum range this weapon will have. + * @param range The maximum range this weapon will have. * @noreturn */ native ns_set_weap_range(idWeapon, Float:range); @@ -490,7 +490,7 @@ native ns_set_fov(idPlayer,Float:_fov=0.0); * Give the player an item. * * @param id The player to give the item to. - * @param class The map-classname of the entity to give to the player. + * @param class The map-classname of the entity to give to the player. * @noreturn */ native ns_give_item(id, const class[]); @@ -544,7 +544,7 @@ native ns_takedamage(IDVictim, IDInflictor, IDAttacker, Float:Damage, DamageType * Attempts to unstick a player. * * @param id Player to unstick. - * @param StartDistance Distance to start from the player to check for a new location. + * @param StartDistance Distance to start from the player to check for a new location. * @param MaxAttempts How many attempts to try to find a new spot before giving up. * @return 1 on success, 0 on cannot find a place to move player to, * -1 on invalid state (stunned/webbed), -2 on invalid class (comm/egg) @@ -672,8 +672,8 @@ native Float:ns_add_obs_energy(idObs,Float:value); * make it so the player no longer receives the upgrade on spawn. * * @note This only works in combat. - * @params idPlayer The player index to change upgrades for. - * @params ugprade The impulse number for the upgrade to strip. + * @param idPlayer The player index to change upgrades for. + * @param ugprade The impulse number for the upgrade to strip. * @return 2 for upgrade removed from player's bought and active list. * 1 for upgrade removed from player's bought list only. * 3 for upgrade removed from player's active list only (shouldn't happen, just incase.) diff --git a/plugins/include/regex.inc b/plugins/include/regex.inc index 5c777e486..2415d8b5d 100755 --- a/plugins/include/regex.inc +++ b/plugins/include/regex.inc @@ -241,8 +241,8 @@ native Regex:regex_compile_ex(const pattern[], flags = 0, error[]= "", maxLen = * @note Use the regex handle passed to this function to extract * matches with regex_substr(). * - * @param pattern The regular expression pattern. * @param string The string to check. + * @param pattern The regular expression pattern. * @param ret Error code, if applicable, or number of results on success. * See REGEX_ERROR_* defines. * diff --git a/plugins/include/textparse_ini.inc b/plugins/include/textparse_ini.inc index 56171722c..3f95cf765 100644 --- a/plugins/include/textparse_ini.inc +++ b/plugins/include/textparse_ini.inc @@ -181,9 +181,9 @@ native INI_SetParseEnd(INIParser:handle, const func[]); * * public bool:OnKeyValue(INIParser:handle, const key[], const value[], bool:invalid_tokens, bool:equal_token, bool:quotes, curtok, any:data) * - - * @param handle Handle to an INI Parse structure. - * @param kv A KeyValue callback. - * @param ns An optional NewSection callback. + * @param smc Handle to an INI Parse structure. + * @param kvFunc A KeyValue callback. + * @param nsFunc An optional NewSection callback. * * @noreturn */ @@ -196,7 +196,7 @@ native INI_SetReaders(INIParser:smc, const kvFunc[], const nsFunc[] = "" ); * - * Called whenever a raw line is read. * - * @param handle The INI Parse handle. + * @param smc The INI Parse handle. * @param line Contents of line. * @param lineno The line number it occurs on. * @param curtok Pointer to optionally store failed position in string. diff --git a/plugins/include/textparse_smc.inc b/plugins/include/textparse_smc.inc index f97f24479..39e5a8a1d 100644 --- a/plugins/include/textparse_smc.inc +++ b/plugins/include/textparse_smc.inc @@ -214,10 +214,10 @@ native SMC_SetParseEnd(SMCParser:handle, const func[]); * * public SMCResult:OnEndSection(SMCParser:handle, any:data) * - - * @param handle Handle to an SMC Parse structure. - * @param kv A KeyValue callback. - * @param ns An optional NewSection callback. - * @param es An optional EndSection callback. + * @param smc Handle to an SMC Parse structure. + * @param kvFunc A KeyValue callback. + * @param nsFunc An optional NewSection callback. + * @param esFunc An optional EndSection callback. * * @noreturn */ diff --git a/plugins/include/vector.inc b/plugins/include/vector.inc index ee764294a..31d61d78f 100644 --- a/plugins/include/vector.inc +++ b/plugins/include/vector.inc @@ -36,8 +36,8 @@ native get_distance(const origin1[3], const origin2[3]); /** * Calculates the distance between two input float vectors. * - * @param origin1 The first vector - * @param origin2 The second vector + * @param Origin1 The first vector + * @param Origin2 The second vector * * @return The distance between two input vectors */