1
0
mirror of https://github.com/weechat/weechat.git synced 2026-06-28 13:56:37 +02:00

core, plugins: fix typos in comments on functions, use imperative

This commit is contained in:
Sébastien Helleu
2026-03-23 20:45:36 +01:00
parent d34eb40187
commit f53e7fb9ef
342 changed files with 6669 additions and 6729 deletions
+40 -40
View File
@@ -60,7 +60,7 @@
/*
* Sets plugin charset.
* Set plugin charset.
*/
void
@@ -74,7 +74,7 @@ plugin_api_charset_set (struct t_weechat_plugin *plugin, const char *charset)
}
/*
* Translates a string using gettext.
* Translate a string using gettext.
*/
const char *
@@ -84,7 +84,7 @@ plugin_api_gettext (const char *string)
}
/*
* Translates a string using gettext (with plural form).
* Translate a string using gettext (with plural form).
*/
const char *
@@ -98,9 +98,9 @@ plugin_api_ngettext (const char *single, const char *plural, int count)
}
/*
* Computes hash of data using the given algorithm.
* Compute hash of data using the given algorithm.
*
* Returns:
* Return:
* 1: OK
* 0: error
*/
@@ -128,9 +128,9 @@ plugin_api_crypto_hash (const void *data, int data_size, const char *hash_algo,
}
/*
* Computes hash of a file using the given algorithm.
* Compute hash of a file using the given algorithm.
*
* Returns:
* Return:
* 1: OK
* 0: error
*/
@@ -158,10 +158,10 @@ plugin_api_crypto_hash_file (const char *filename, const char *hash_algo,
}
/*
* Computes PKCS#5 Passphrase Based Key Derivation Function number 2 (PBKDF2)
* Compute PKCS#5 Passphrase Based Key Derivation Function number 2 (PBKDF2)
* hash of data.
*
* Returns:
* Return:
* 1: OK
* 0: error
*/
@@ -193,9 +193,9 @@ plugin_api_crypto_hash_pbkdf2 (const void *data, int data_size,
}
/*
* Computes HMAC of key + message using the given algorithm.
* Compute HMAC of key + message using the given algorithm.
*
* Returns:
* Return:
* 1: OK
* 0: error
*/
@@ -226,7 +226,7 @@ plugin_api_crypto_hmac (const void *key, int key_size,
}
/*
* Frees an option.
* Free an option.
*/
void
@@ -236,7 +236,7 @@ plugin_api_config_file_option_free (struct t_config_option *option)
}
/*
* Gets pointer on an option.
* Get pointer on an option.
*/
struct t_config_option *
@@ -250,7 +250,7 @@ plugin_api_config_get (const char *option_name)
}
/*
* Gets value of a plugin option.
* Get value of a plugin option.
*/
const char *
@@ -271,9 +271,9 @@ plugin_api_config_get_plugin (struct t_weechat_plugin *plugin,
}
/*
* Checks if a plugin option is set.
* Check if a plugin option is set.
*
* Returns:
* Return:
* 1: plugin option is set
* 0: plugin option does not exist
*/
@@ -295,7 +295,7 @@ plugin_api_config_is_set_plugin (struct t_weechat_plugin *plugin,
}
/*
* Sets value of a plugin option.
* Set value of a plugin option.
*/
int
@@ -309,7 +309,7 @@ plugin_api_config_set_plugin (struct t_weechat_plugin *plugin,
}
/*
* Sets description of a plugin option.
* Set description of a plugin option.
*/
void
@@ -322,7 +322,7 @@ plugin_api_config_set_desc_plugin (struct t_weechat_plugin *plugin,
}
/*
* Unsets a plugin option.
* Unset a plugin option.
*/
int
@@ -342,7 +342,7 @@ plugin_api_config_unset_plugin (struct t_weechat_plugin *plugin,
}
/*
* Returns a prefix for display with printf.
* Return a prefix for display with printf.
*/
const char *
@@ -366,7 +366,7 @@ plugin_api_prefix (const char *prefix)
}
/*
* Returns a WeeChat color for display with printf.
* Return a WeeChat color for display with printf.
*/
const char *
@@ -386,7 +386,7 @@ plugin_api_color (const char *color_name)
}
/*
* Executes a command on a buffer (simulates user entry) with options.
* Execute a command on a buffer (simulates user entry) with options.
*/
int
@@ -439,7 +439,7 @@ plugin_api_command_options (struct t_weechat_plugin *plugin,
}
/*
* Executes a command on a buffer (simulates user entry).
* Execute a command on a buffer (simulates user entry).
*/
int
@@ -450,7 +450,7 @@ plugin_api_command (struct t_weechat_plugin *plugin,
}
/*
* Modifier callback: decodes WeeChat colors: converts WeeChat color codes to
* Modifier callback: decode WeeChat colors: convert WeeChat color codes to
* WeeChat a replacement string.
*/
@@ -469,7 +469,7 @@ plugin_api_modifier_color_decode_cb (const void *pointer, void *data,
}
/*
* Modifier callback: decodes ANSI colors: converts ANSI color codes to WeeChat
* Modifier callback: decode ANSI colors: convert ANSI color codes to WeeChat
* colors (or removes them).
*/
@@ -491,7 +491,7 @@ plugin_api_modifier_color_decode_ansi_cb (const void *pointer, void *data,
}
/*
* Modifier callback: encodes ANSI colors: converts WeeChat colors to ANSI
* Modifier callback: encode ANSI colors: convert WeeChat colors to ANSI
* color codes.
*/
@@ -511,7 +511,7 @@ plugin_api_modifier_color_encode_ansi_cb (const void *pointer, void *data,
}
/*
* Modifier callback: evaluates a home path.
* Modifier callback: evaluate a home path.
*/
char *
@@ -552,9 +552,9 @@ plugin_api_modifier_eval_path_home_cb (const void *pointer, void *data,
}
/*
* Moves item pointer to next item in an infolist.
* Move item pointer to next item in an infolist.
*
* Returns:
* Return:
* 1: pointer is still OK
* 0: end of infolist was reached
*/
@@ -569,9 +569,9 @@ plugin_api_infolist_next (struct t_infolist *infolist)
}
/*
* Moves pointer to previous item in an infolist.
* Move pointer to previous item in an infolist.
*
* Returns:
* Return:
* 1: pointer is still OK
* 0: beginning of infolist was reached
*/
@@ -586,7 +586,7 @@ plugin_api_infolist_prev (struct t_infolist *infolist)
}
/*
* Resets item cursor in infolist.
* Reset item cursor in infolist.
*/
void
@@ -599,7 +599,7 @@ plugin_api_infolist_reset_item_cursor (struct t_infolist *infolist)
}
/*
* Gets list of fields for current infolist item.
* Get list of fields for current infolist item.
*/
const char *
@@ -612,7 +612,7 @@ plugin_api_infolist_fields (struct t_infolist *infolist)
}
/*
* Gets integer value for a variable in current infolist item.
* Get integer value for a variable in current infolist item.
*/
int
@@ -625,7 +625,7 @@ plugin_api_infolist_integer (struct t_infolist *infolist, const char *var)
}
/*
* Gets string value for a variable in current infolist item.
* Get string value for a variable in current infolist item.
*/
const char *
@@ -638,7 +638,7 @@ plugin_api_infolist_string (struct t_infolist *infolist, const char *var)
}
/*
* Gets pointer value for a variable in current infolist item.
* Get pointer value for a variable in current infolist item.
*/
void *
@@ -651,7 +651,7 @@ plugin_api_infolist_pointer (struct t_infolist *infolist, const char *var)
}
/*
* Gets buffer value for a variable in current infolist item.
* Get buffer value for a variable in current infolist item.
*
* Argument "size" is set with the size of buffer.
*/
@@ -667,7 +667,7 @@ plugin_api_infolist_buffer (struct t_infolist *infolist, const char *var,
}
/*
* Gets time value for a variable in current infolist item.
* Get time value for a variable in current infolist item.
*/
time_t
@@ -680,7 +680,7 @@ plugin_api_infolist_time (struct t_infolist *infolist, const char *var)
}
/*
* Frees an infolist.
* Free an infolist.
*/
void
@@ -691,7 +691,7 @@ plugin_api_infolist_free (struct t_infolist *infolist)
}
/*
* Initializes plugin API.
* Initialize plugin API.
*/
void