diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/en/weechat_plugin_api.en.asciidoc | 154 | ||||
| -rw-r--r-- | doc/fr/weechat_plugin_api.fr.asciidoc | 170 | ||||
| -rw-r--r-- | doc/it/weechat_plugin_api.it.asciidoc | 187 | ||||
| -rw-r--r-- | doc/ja/weechat_plugin_api.ja.asciidoc | 187 |
4 files changed, 392 insertions, 306 deletions
diff --git a/doc/en/weechat_plugin_api.en.asciidoc b/doc/en/weechat_plugin_api.en.asciidoc index 1c9e757c8..a87538b32 100644 --- a/doc/en/weechat_plugin_api.en.asciidoc +++ b/doc/en/weechat_plugin_api.en.asciidoc @@ -7030,6 +7030,7 @@ struct t_hook *weechat_hook_command (const char *command, int argc, char **argv, char **argv_eol), + const void *callback_pointer, void *callback_data); ---- @@ -7046,9 +7047,7 @@ Arguments: separated by "||". * 'callback': function called when command is used, arguments and return value: ** 'const void *pointer': pointer -** 'void *data': pointer; if not NULL, it must have been allocated with malloc - (or similar function) and it will be automatically freed when the hook is - deleted +** 'void *data': pointer ** 'struct t_gui_buffer *buffer': buffer where command is executed ** 'int argc': number of arguments given for command ** 'char **argv': arguments given for command @@ -7057,7 +7056,10 @@ Arguments: ** return value: *** 'WEECHAT_RC_OK' *** 'WEECHAT_RC_ERROR' -* 'callback_data': pointer given to callback when it is called by WeeChat +* 'callback_pointer': pointer given to callback when it is called by WeeChat +* 'callback_data': pointer given to callback when it is called by WeeChat; + if not NULL, it must have been allocated with malloc (or similar function) + and it will be automatically freed when the hook is deleted Default completion codes are: @@ -7173,16 +7175,17 @@ Arguments: (priority allowed, see note about <<hook_priority,priority>>) * 'callback': function called when command is run, arguments and return value: ** 'const void *pointer': pointer -** 'void *data': pointer; if not NULL, it must have been allocated with malloc - (or similar function) and it will be automatically freed when the hook is - deleted +** 'void *data': pointer ** 'struct t_gui_buffer *buffer': buffer where command is executed ** 'const char *command': the command executed, with its arguments ** return value: *** 'WEECHAT_RC_OK' *** 'WEECHAT_RC_OK_EAT' *** 'WEECHAT_RC_ERROR' -* 'callback_data': pointer given to callback when it is called by WeeChat +* 'callback_pointer': pointer given to callback when it is called by WeeChat +* 'callback_data': pointer given to callback when it is called by WeeChat; + if not NULL, it must have been allocated with malloc (or similar function) + and it will be automatically freed when the hook is deleted [NOTE] Callback can return 'WEECHAT_RC_OK' or 'WEECHAT_RC_OK_EAT' (command will not @@ -7250,14 +7253,15 @@ Arguments: * 'max_calls': number of calls to timer (if 0, then timer has no end) * 'callback': function called when time is reached, arguments and return value: ** 'const void *pointer': pointer -** 'void *data': pointer; if not NULL, it must have been allocated with malloc - (or similar function) and it will be automatically freed when the hook is - deleted +** 'void *data': pointer ** 'int remaining_calls': remaining calls (-1 if timer has no end) ** return value: *** 'WEECHAT_RC_OK' *** 'WEECHAT_RC_ERROR' -* 'callback_data': pointer given to callback when it is called by WeeChat +* 'callback_pointer': pointer given to callback when it is called by WeeChat +* 'callback_data': pointer given to callback when it is called by WeeChat; + if not NULL, it must have been allocated with malloc (or similar function) + and it will be automatically freed when the hook is deleted Return value: @@ -7325,14 +7329,15 @@ Arguments: * 'callback': function called a selected event occurs for file (or socket), arguments and return value: ** 'const void *pointer': pointer -** 'void *data': pointer; if not NULL, it must have been allocated with malloc - (or similar function) and it will be automatically freed when the hook is - deleted +** 'void *data': pointer ** 'int fd': file descriptor ** return value: *** 'WEECHAT_RC_OK' *** 'WEECHAT_RC_ERROR' -* 'callback_data': pointer given to callback when it is called by WeeChat +* 'callback_pointer': pointer given to callback when it is called by WeeChat +* 'callback_data': pointer given to callback when it is called by WeeChat; + if not NULL, it must have been allocated with malloc (or similar function) + and it will be automatically freed when the hook is deleted Return value: @@ -7409,9 +7414,7 @@ Arguments: * 'callback': function called when data from child is available, or when child has ended, arguments and return value: ** 'const void *pointer': pointer -** 'void *data': pointer; if not NULL, it must have been allocated with malloc - (or similar function) and it will be automatically freed when the hook is - deleted +** 'void *data': pointer ** 'const char *command': command executed by child ** 'int return_code': return code: *** '>= 0': child return code for a command, and for URL possible values are: @@ -7427,7 +7430,10 @@ Arguments: ** return value: *** 'WEECHAT_RC_OK' *** 'WEECHAT_RC_ERROR' -* 'callback_data': pointer given to callback when it is called by WeeChat +* 'callback_pointer': pointer given to callback when it is called by WeeChat +* 'callback_data': pointer given to callback when it is called by WeeChat; + if not NULL, it must have been allocated with malloc (or similar function) + and it will be automatically freed when the hook is deleted Return value: @@ -7773,9 +7779,7 @@ Arguments: * 'callback': function called when connection is OK or failed, arguments and return value: ** 'const void *pointer': pointer -** 'void *data': pointer; if not NULL, it must have been allocated with malloc - (or similar function) and it will be automatically freed when the hook is - deleted +** 'void *data': pointer ** 'int status': connection status: *** 'WEECHAT_HOOK_CONNECT_OK': connection OK *** 'WEECHAT_HOOK_CONNECT_ADDRESS_NOT_FOUND': address not found @@ -7795,7 +7799,10 @@ Arguments: ** return value: *** 'WEECHAT_RC_OK' *** 'WEECHAT_RC_ERROR' -* 'callback_data': pointer given to callback when it is called by WeeChat +* 'callback_pointer': pointer given to callback when it is called by WeeChat +* 'callback_data': pointer given to callback when it is called by WeeChat; + if not NULL, it must have been allocated with malloc (or similar function) + and it will be automatically freed when the hook is deleted Return value: @@ -7937,9 +7944,7 @@ Arguments: * 'callback': function called when a message is printed, arguments and return value: ** 'const void *pointer': pointer -** 'void *data': pointer; if not NULL, it must have been allocated with malloc - (or similar function) and it will be automatically freed when the hook is - deleted +** 'void *data': pointer ** 'struct t_gui_buffer *buffer': buffer pointer ** 'time_t date': date ** 'int tags_count': number of tags for line @@ -7951,7 +7956,10 @@ Arguments: ** return value: *** 'WEECHAT_RC_OK' *** 'WEECHAT_RC_ERROR' -* 'callback_data': pointer given to callback when it is called by WeeChat +* 'callback_pointer': pointer given to callback when it is called by WeeChat +* 'callback_data': pointer given to callback when it is called by WeeChat; + if not NULL, it must have been allocated with malloc (or similar function) + and it will be automatically freed when the hook is deleted Return value: @@ -8024,9 +8032,7 @@ Arguments: * 'callback': function called when signal is received, arguments and return value: ** 'const void *pointer': pointer -** 'void *data': pointer; if not NULL, it must have been allocated with malloc - (or similar function) and it will be automatically freed when the hook is - deleted +** 'void *data': pointer ** 'const char *signal': signal received ** 'const char *type_data': type of data sent with signal: *** 'WEECHAT_HOOK_SIGNAL_STRING': string @@ -8038,7 +8044,10 @@ Arguments: *** 'WEECHAT_RC_OK_EAT' (stop sending the signal immediately) _(WeeChat ≥ 0.4.0)_ *** 'WEECHAT_RC_ERROR' -* 'callback_data': pointer given to callback when it is called by WeeChat +* 'callback_pointer': pointer given to callback when it is called by WeeChat +* 'callback_data': pointer given to callback when it is called by WeeChat; + if not NULL, it must have been allocated with malloc (or similar function) + and it will be automatically freed when the hook is deleted Return value: @@ -8941,9 +8950,7 @@ Arguments: * 'callback': function called when signal is received, arguments and return value: ** 'const void *pointer': pointer -** 'void *data': pointer; if not NULL, it must have been allocated with malloc - (or similar function) and it will be automatically freed when the hook is - deleted +** 'void *data': pointer ** 'const char *signal': signal received ** 'struct t_hashtable *hashtable': hashtable ** return value: @@ -8951,7 +8958,10 @@ Arguments: *** 'WEECHAT_RC_OK_EAT' (stop sending the signal immediately) _(WeeChat ≥ 0.4.0)_ *** 'WEECHAT_RC_ERROR' -* 'callback_data': pointer given to callback when it is called by WeeChat +* 'callback_pointer': pointer given to callback when it is called by WeeChat +* 'callback_data': pointer given to callback when it is called by WeeChat; + if not NULL, it must have been allocated with malloc (or similar function) + and it will be automatically freed when the hook is deleted Return value: @@ -9300,15 +9310,16 @@ Arguments: * 'callback': function called when configuration option is changed, arguments and return value: ** 'const void *pointer': pointer -** 'void *data': pointer; if not NULL, it must have been allocated with malloc - (or similar function) and it will be automatically freed when the hook is - deleted +** 'void *data': pointer ** 'const char *option': name of option ** 'const char *value': new value for option ** return value: *** 'WEECHAT_RC_OK' *** 'WEECHAT_RC_ERROR' -* 'callback_data': pointer given to callback when it is called by WeeChat +* 'callback_pointer': pointer given to callback when it is called by WeeChat +* 'callback_data': pointer given to callback when it is called by WeeChat; + if not NULL, it must have been allocated with malloc (or similar function) + and it will be automatically freed when the hook is deleted Return value: @@ -9373,9 +9384,7 @@ Arguments: * 'callback': function called when completion item is used (user is completing something using this item), arguments and return value: ** 'const void *pointer': pointer -** 'void *data': pointer; if not NULL, it must have been allocated with malloc - (or similar function) and it will be automatically freed when the hook is - deleted +** 'void *data': pointer ** 'const char *completion_item': name of completion item ** 'struct t_gui_buffer *buffer': buffer where completion is made ** 'struct t_gui_completion *completion': structure used to add words for @@ -9384,7 +9393,10 @@ Arguments: ** return value: *** 'WEECHAT_RC_OK' *** 'WEECHAT_RC_ERROR' -* 'callback_data': pointer given to callback when it is called by WeeChat +* 'callback_pointer': pointer given to callback when it is called by WeeChat +* 'callback_data': pointer given to callback when it is called by WeeChat; + if not NULL, it must have been allocated with malloc (or similar function) + and it will be automatically freed when the hook is deleted [NOTE] Completion names are global (shared across WeeChat and plugins). So it is @@ -9559,14 +9571,15 @@ Arguments: (see table below) * 'callback': function called when modifier is used, arguments and return value: ** 'const void *pointer': pointer -** 'void *data': pointer; if not NULL, it must have been allocated with malloc - (or similar function) and it will be automatically freed when the hook is - deleted +** 'void *data': pointer ** 'const char *modifier': name of modifier ** 'const char *modifier_data': data for modifier ** 'const char *string': string to modify ** return value: new string -* 'callback_data': pointer given to callback when it is called by WeeChat +* 'callback_pointer': pointer given to callback when it is called by WeeChat +* 'callback_data': pointer given to callback when it is called by WeeChat; + if not NULL, it must have been allocated with malloc (or similar function) + and it will be automatically freed when the hook is deleted Return value: @@ -9800,13 +9813,14 @@ Arguments: * 'args_description': description of arguments (optional, can be NULL) * 'callback': function called when info is asked, arguments and return value: ** 'const void *pointer': pointer -** 'void *data': pointer; if not NULL, it must have been allocated with malloc - (or similar function) and it will be automatically freed when the hook is - deleted +** 'void *data': pointer ** 'const char *info_name': name of info ** 'const char *arguments': additional arguments, depending on info ** return value: value of info asked -* 'callback_data': pointer given to callback when it is called by WeeChat +* 'callback_pointer': pointer given to callback when it is called by WeeChat +* 'callback_data': pointer given to callback when it is called by WeeChat; + if not NULL, it must have been allocated with malloc (or similar function) + and it will be automatically freed when the hook is deleted Return value: @@ -9876,13 +9890,14 @@ Arguments: (optional, can be NULL) * 'callback': function called when info is asked, arguments and return value: ** 'const void *pointer': pointer -** 'void *data': pointer; if not NULL, it must have been allocated with malloc - (or similar function) and it will be automatically freed when the hook is - deleted +** 'void *data': pointer ** 'const char *info_name': name of info ** 'struct t_hashtable *hashtable': hashtable, depending on info ** return value: hashtable asked -* 'callback_data': pointer given to callback when it is called by WeeChat +* 'callback_pointer': pointer given to callback when it is called by WeeChat +* 'callback_data': pointer given to callback when it is called by WeeChat; + if not NULL, it must have been allocated with malloc (or similar function) + and it will be automatically freed when the hook is deleted Return value: @@ -9955,15 +9970,16 @@ Arguments: * 'callback': function called when infolist is asked, arguments and return value: ** 'const void *pointer': pointer -** 'void *data': pointer; if not NULL, it must have been allocated with malloc - (or similar function) and it will be automatically freed when the hook is - deleted +** 'void *data': pointer ** 'const char *infolist_name': name of infolist ** 'void *pointer': pointer to an object that infolist must return (to get only one item in infolist) ** 'const char *arguments': additional arguments, depending on infolist ** return value: infolist asked -* 'callback_data': pointer given to callback when it is called by WeeChat +* 'callback_pointer': pointer given to callback when it is called by WeeChat +* 'callback_data': pointer given to callback when it is called by WeeChat; + if not NULL, it must have been allocated with malloc (or similar function) + and it will be automatically freed when the hook is deleted Return value: @@ -10036,12 +10052,13 @@ Arguments: * 'callback': function called when hdata is asked, arguments and return value: ** 'const void *pointer': pointer -** 'void *data': pointer; if not NULL, it must have been allocated with malloc - (or similar function) and it will be automatically freed when the hook is - deleted +** 'void *data': pointer ** 'const char *hdata_name': name of hdata ** return value: hdata asked -* 'callback_data': pointer given to callback when it is called by WeeChat +* 'callback_pointer': pointer given to callback when it is called by WeeChat +* 'callback_data': pointer given to callback when it is called by WeeChat; + if not NULL, it must have been allocated with malloc (or similar function) + and it will be automatically freed when the hook is deleted Return value: @@ -10094,16 +10111,17 @@ Arguments: * 'callback': function called when focus is made, arguments and return value: ** 'const void *pointer': pointer -** 'void *data': pointer; if not NULL, it must have been allocated with malloc - (or similar function) and it will be automatically freed when the hook is - deleted +** 'void *data': pointer ** 'struct t_hashtable *info': hashtable with info on focus and strings returned by other calls to focus callbacks (with higher priority) (see table below) ** return value: either "info" pointer (hashtable completed), or pointer to a new hashtable (created by callback, with keys and values of type "string"), this new hashtable content will be added to 'info' for other calls to focus callbacks -* 'callback_data': pointer given to callback when it is called by WeeChat +* 'callback_pointer': pointer given to callback when it is called by WeeChat +* 'callback_data': pointer given to callback when it is called by WeeChat; + if not NULL, it must have been allocated with malloc (or similar function) + and it will be automatically freed when the hook is deleted [IMPORTANT] For a mouse gesture, your callback will be called two times: first time when diff --git a/doc/fr/weechat_plugin_api.fr.asciidoc b/doc/fr/weechat_plugin_api.fr.asciidoc index e59953951..5e880d77e 100644 --- a/doc/fr/weechat_plugin_api.fr.asciidoc +++ b/doc/fr/weechat_plugin_api.fr.asciidoc @@ -7164,9 +7164,7 @@ Paramètres : * 'callback' : fonction appelée lorsque la commande est utilisée, paramètres et valeur de retour : ** 'const void *pointer' : pointeur -** 'void *data' : pointeur ; si non NULL, doit avoir été alloué par malloc - (ou une fonction similaire) et sera automatiquement libéré (par free) - lorsque le "hook" est supprimé +** 'void *data' : pointeur ** 'struct t_gui_buffer *buffer' : tampon où la commande est exécutée ** 'int argc' : nombre de paramètres passés à la commande ** 'char **argv' : paramètres pour la commande @@ -7175,8 +7173,12 @@ Paramètres : ** valeur de retour : *** 'WEECHAT_RC_OK' *** 'WEECHAT_RC_ERROR' -* 'callback_data' : pointeur donné au "callback" lorsqu'il est appelé par +* 'callback_pointer' : pointeur donné au "callback" lorsqu'il est appelé par WeeChat +* 'callback_data' : pointeur donné au "callback" lorsqu'il est appelé par + WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction + similaire) et sera automatiquement libéré (par free) lorsque le "hook" est + supprimé Les codes complétions par défaut sont : @@ -7293,17 +7295,19 @@ Paramètres : * 'callback' : fonction appelée lorsque la commande est exécutée, paramètres et valeur de retour : ** 'const void *pointer' : pointeur -** 'void *data' : pointeur ; si non NULL, doit avoir été alloué par malloc - (ou une fonction similaire) et sera automatiquement libéré (par free) - lorsque le "hook" est supprimé +** 'void *data' : pointeur ** 'struct t_gui_buffer *buffer' : tampon où la commande est exécutée ** 'const char *command' : la commande exécutée, avec ses paramètres ** valeur de retour : *** 'WEECHAT_RC_OK' *** 'WEECHAT_RC_OK_EAT' *** 'WEECHAT_RC_ERROR' -* 'callback_data' : pointeur donné au "callback" lorsqu'il est appelé par +* 'callback_pointer' : pointeur donné au "callback" lorsqu'il est appelé par WeeChat +* 'callback_data' : pointeur donné au "callback" lorsqu'il est appelé par + WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction + similaire) et sera automatiquement libéré (par free) lorsque le "hook" est + supprimé [NOTE] Le "callback" peut retourner 'WEECHAT_RC_OK' ou 'WEECHAT_RC_OK_EAT' (la @@ -7373,16 +7377,18 @@ Paramètres : * 'callback' : fonction appelée quand le délai est atteint, paramètres et valeur de retour : ** 'const void *pointer' : pointeur -** 'void *data' : pointeur ; si non NULL, doit avoir été alloué par malloc - (ou une fonction similaire) et sera automatiquement libéré (par free) - lorsque le "hook" est supprimé +** 'void *data' : pointeur ** 'int remaining_calls' : nombre d'appels restants (-1 si le minuteur n'a pas de fin) ** valeur de retour : *** 'WEECHAT_RC_OK' *** 'WEECHAT_RC_ERROR' -* 'callback_data' : pointeur donné au "callback" lorsqu'il est appelé par +* 'callback_pointer' : pointeur donné au "callback" lorsqu'il est appelé par WeeChat +* 'callback_data' : pointeur donné au "callback" lorsqu'il est appelé par + WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction + similaire) et sera automatiquement libéré (par free) lorsque le "hook" est + supprimé Valeur de retour : @@ -7450,15 +7456,17 @@ Paramètres : * 'callback' : fonction appelée lorsqu'un des évènements sélectionnés se produit pour le fichier (ou le socket), paramètres et valeur de retour : ** 'const void *pointer' : pointeur -** 'void *data' : pointeur ; si non NULL, doit avoir été alloué par malloc - (ou une fonction similaire) et sera automatiquement libéré (par free) - lorsque le "hook" est supprimé +** 'void *data' : pointeur ** 'int fd' : descripteur de fichier ** valeur de retour : *** 'WEECHAT_RC_OK' *** 'WEECHAT_RC_ERROR' -* 'callback_data' : pointeur donné au "callback" lorsqu'il est appelé par +* 'callback_pointer' : pointeur donné au "callback" lorsqu'il est appelé par WeeChat +* 'callback_data' : pointeur donné au "callback" lorsqu'il est appelé par + WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction + similaire) et sera automatiquement libéré (par free) lorsque le "hook" est + supprimé Valeur de retour : @@ -7535,9 +7543,7 @@ Paramètres : * 'callback' : fonction appelée quand des données du fils sont disponibles, or ou quand le fils s'est terminé, paramètres et valeur de retour : ** 'const void *pointer' : pointeur -** 'void *data' : pointeur ; si non NULL, doit avoir été alloué par malloc - (ou une fonction similaire) et sera automatiquement libéré (par free) - lorsque le "hook" est supprimé +** 'void *data' : pointeur ** 'const char *command' : commande exécutée par le fils ** 'int return_code' : code retour : *** '>= 0' : code retour du fils pour une commande, et pour l'URL, les valeurs @@ -7555,8 +7561,12 @@ Paramètres : ** valeur de retour : *** 'WEECHAT_RC_OK' *** 'WEECHAT_RC_ERROR' -* 'callback_data' : pointeur donné au "callback" lorsqu'il est appelé par +* 'callback_pointer' : pointeur donné au "callback" lorsqu'il est appelé par WeeChat +* 'callback_data' : pointeur donné au "callback" lorsqu'il est appelé par + WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction + similaire) et sera automatiquement libéré (par free) lorsque le "hook" est + supprimé Valeur de retour : @@ -7914,9 +7924,7 @@ Paramètres : * 'callback' : fonction appelée lorsque la connexion est ok ou a échoué, paramètres et valeur de retour : ** 'const void *pointer' : pointeur -** 'void *data' : pointeur ; si non NULL, doit avoir été alloué par malloc - (ou une fonction similaire) et sera automatiquement libéré (par free) - lorsque le "hook" est supprimé +** 'void *data' : pointeur ** 'int status' : statut de connexion : *** 'WEECHAT_HOOK_CONNECT_OK' : connexion ok *** 'WEECHAT_HOOK_CONNECT_ADDRESS_NOT_FOUND' : adresse non trouvée @@ -7937,8 +7945,12 @@ Paramètres : ** valeur de retour : *** 'WEECHAT_RC_OK' *** 'WEECHAT_RC_ERROR' -* 'callback_data' : pointeur donné au "callback" lorsqu'il est appelé par +* 'callback_pointer' : pointeur donné au "callback" lorsqu'il est appelé par WeeChat +* 'callback_data' : pointeur donné au "callback" lorsqu'il est appelé par + WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction + similaire) et sera automatiquement libéré (par free) lorsque le "hook" est + supprimé Valeur de retour : @@ -8082,9 +8094,7 @@ Paramètres : * 'callback' : fonction appelée lorsqu'un message est affiché, paramètres et valeur de retour : ** 'const void *pointer' : pointeur -** 'void *data' : pointeur ; si non NULL, doit avoir été alloué par malloc - (ou une fonction similaire) et sera automatiquement libéré (par free) - lorsque le "hook" est supprimé +** 'void *data' : pointeur ** 'struct t_gui_buffer *buffer' : pointeur vers le tampon ** 'time_t date' : date ** 'int tags_count' : nombre d'étiquettes de la ligne @@ -8096,8 +8106,12 @@ Paramètres : ** valeur de retour : *** 'WEECHAT_RC_OK' *** 'WEECHAT_RC_ERROR' -* 'callback_data' : pointeur donné au "callback" lorsqu'il est appelé par +* 'callback_pointer' : pointeur donné au "callback" lorsqu'il est appelé par WeeChat +* 'callback_data' : pointeur donné au "callback" lorsqu'il est appelé par + WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction + similaire) et sera automatiquement libéré (par free) lorsque le "hook" est + supprimé Valeur de retour : @@ -8171,9 +8185,7 @@ Paramètres : * 'callback' : fonction appelée quand le signal est reçu, paramètres et valeur de retour : ** 'const void *pointer' : pointeur -** 'void *data' : pointeur ; si non NULL, doit avoir été alloué par malloc - (ou une fonction similaire) et sera automatiquement libéré (par free) - lorsque le "hook" est supprimé +** 'void *data' : pointeur ** 'const char *signal' : signal reçu ** 'const char *type_data' : type de donnée reçu avec le signal : *** 'WEECHAT_HOOK_SIGNAL_STRING' : chaîne de caractères @@ -8185,8 +8197,12 @@ Paramètres : *** 'WEECHAT_RC_OK_EAT' (arrêter l'envoi du signal immédiatement) _(WeeChat ≥ 0.4.0)_ *** 'WEECHAT_RC_ERROR' -* 'callback_data' : pointeur donné au "callback" lorsqu'il est appelé par +* 'callback_pointer' : pointeur donné au "callback" lorsqu'il est appelé par WeeChat +* 'callback_data' : pointeur donné au "callback" lorsqu'il est appelé par + WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction + similaire) et sera automatiquement libéré (par free) lorsque le "hook" est + supprimé Valeur de retour : @@ -9099,9 +9115,7 @@ Paramètres : * 'callback' : fonction appelée quand le signal est reçu, paramètres et valeur de retour : ** 'const void *pointer' : pointeur -** 'void *data' : pointeur ; si non NULL, doit avoir été alloué par malloc - (ou une fonction similaire) et sera automatiquement libéré (par free) - lorsque le "hook" est supprimé +** 'void *data' : pointeur ** 'const char *signal' : signal reçu ** 'struct t_hashtable *hashtable' : table de hachage ** valeur de retour : @@ -9109,8 +9123,12 @@ Paramètres : *** 'WEECHAT_RC_OK_EAT' (arrêter l'envoi du signal immédiatement) _(WeeChat ≥ 0.4.0)_ *** 'WEECHAT_RC_ERROR' -* 'callback_data' : pointeur donné au "callback" lorsqu'il est appelé par +* 'callback_pointer' : pointeur donné au "callback" lorsqu'il est appelé par WeeChat +* 'callback_data' : pointeur donné au "callback" lorsqu'il est appelé par + WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction + similaire) et sera automatiquement libéré (par free) lorsque le "hook" est + supprimé Valeur de retour : @@ -9470,16 +9488,18 @@ Paramètres : * 'callback' : fonction appelée lorsque l'option de configuration est modifiée, paramètres et valeur de retour : ** 'const void *pointer' : pointeur -** 'void *data' : pointeur ; si non NULL, doit avoir été alloué par malloc - (ou une fonction similaire) et sera automatiquement libéré (par free) - lorsque le "hook" est supprimé +** 'void *data' : pointeur ** 'const char *option' : nom de l'option ** 'const char *value' : nouvelle valeur pour l'option ** valeur de retour : *** 'WEECHAT_RC_OK' *** 'WEECHAT_RC_ERROR' -* 'callback_data' : pointeur donné au "callback" lorsqu'il est appelé par +* 'callback_pointer' : pointeur donné au "callback" lorsqu'il est appelé par WeeChat +* 'callback_data' : pointeur donné au "callback" lorsqu'il est appelé par + WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction + similaire) et sera automatiquement libéré (par free) lorsque le "hook" est + supprimé Valeur de retour : @@ -9545,9 +9565,7 @@ Paramètres : (l'utilisateur est en train de compléter quelque chose qui fait appel à cette complétion), paramètres et valeur de retour : ** 'const void *pointer' : pointeur -** 'void *data' : pointeur ; si non NULL, doit avoir été alloué par malloc - (ou une fonction similaire) et sera automatiquement libéré (par free) - lorsque le "hook" est supprimé +** 'void *data' : pointeur ** 'const char *completion_item' : nom de la complétion ** 'struct t_gui_buffer *buffer' : tampon où la complétion est effectuée ** 'struct t_gui_completion *completion' : structure utilisée pour ajouter @@ -9556,8 +9574,12 @@ Paramètres : ** valeur de retour : *** 'WEECHAT_RC_OK' *** 'WEECHAT_RC_ERROR' -* 'callback_data' : pointeur donné au "callback" lorsqu'il est appelé par +* 'callback_pointer' : pointeur donné au "callback" lorsqu'il est appelé par WeeChat +* 'callback_data' : pointeur donné au "callback" lorsqu'il est appelé par + WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction + similaire) et sera automatiquement libéré (par free) lorsque le "hook" est + supprimé [NOTE] Les noms de complétion sont globaux (partagés entre WeeChat et les extensions). @@ -9735,15 +9757,17 @@ Paramètres : * 'callback' : fonction appelée lorsque le modificateur est utilisé, paramètres et valeur de retour : ** 'const void *pointer' : pointeur -** 'void *data' : pointeur ; si non NULL, doit avoir été alloué par malloc - (ou une fonction similaire) et sera automatiquement libéré (par free) - lorsque le "hook" est supprimé +** 'void *data' : pointeur ** 'const char *modifier' : nom du modificateur ** 'const char *modifier_data' : données pour le modificateur ** 'const char *string' : chaîne à modifier ** valeur de retour : nouvelle chaîne -* 'callback_data' : pointeur donné au "callback" lorsqu'il est appelé par +* 'callback_pointer' : pointeur donné au "callback" lorsqu'il est appelé par WeeChat +* 'callback_data' : pointeur donné au "callback" lorsqu'il est appelé par + WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction + similaire) et sera automatiquement libéré (par free) lorsque le "hook" est + supprimé Valeur de retour : @@ -9986,15 +10010,17 @@ Paramètres : * 'callback' : fonction appelée quand l'information est demandée, paramètres et valeur de retour : ** 'const void *pointer' : pointeur -** 'void *data' : pointeur ; si non NULL, doit avoir été alloué par malloc - (ou une fonction similaire) et sera automatiquement libéré (par free) - lorsque le "hook" est supprimé +** 'void *data' : pointeur ** 'const char *info_name' : nom de l'information ** 'const char *arguments' : paramètres additionnels, dépendant de l'information ** valeur de retour : valeur de l'information demandée -* 'callback_data' : pointeur donné au "callback" lorsqu'il est appelé par +* 'callback_pointer' : pointeur donné au "callback" lorsqu'il est appelé par WeeChat +* 'callback_data' : pointeur donné au "callback" lorsqu'il est appelé par + WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction + similaire) et sera automatiquement libéré (par free) lorsque le "hook" est + supprimé Valeur de retour : @@ -10068,15 +10094,17 @@ Paramètres : * 'callback' : fonction appelée quand l'information est demandée, paramètres et valeur de retour : ** 'const void *pointer' : pointeur -** 'void *data' : pointeur ; si non NULL, doit avoir été alloué par malloc - (ou une fonction similaire) et sera automatiquement libéré (par free) - lorsque le "hook" est supprimé +** 'void *data' : pointeur ** 'const char *info_name' : nom de l'information ** 'struct t_hashtable *hashtable' : table de hachage, dépendant de l'information ** valeur de retour : table de hachage demandée -* 'callback_data' : pointeur donné au "callback" lorsqu'il est appelé par +* 'callback_pointer' : pointeur donné au "callback" lorsqu'il est appelé par WeeChat +* 'callback_data' : pointeur donné au "callback" lorsqu'il est appelé par + WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction + similaire) et sera automatiquement libéré (par free) lorsque le "hook" est + supprimé Valeur de retour : @@ -10150,16 +10178,18 @@ Paramètres : * 'callback' : fonction appelée quand l'infolist est demandée, paramètres et valeur de retour : ** 'const void *pointer' : pointeur -** 'void *data' : pointeur ; si non NULL, doit avoir été alloué par malloc - (ou une fonction similaire) et sera automatiquement libéré (par free) - lorsque le "hook" est supprimé +** 'void *data' : pointeur ** 'const char *infolist_name' : nom de l'infolist ** 'void *pointer' : pointeur vers un objet que l'infolist doit retourner (pour obtenir uniquement cet objet dans l'infolist) ** 'const char *arguments' : paramètres additionnels, dépendant de l'infolist ** valeur de retour : infolist demandée -* 'callback_data' : pointeur donné au "callback" lorsqu'il est appelé par +* 'callback_pointer' : pointeur donné au "callback" lorsqu'il est appelé par WeeChat +* 'callback_data' : pointeur donné au "callback" lorsqu'il est appelé par + WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction + similaire) et sera automatiquement libéré (par free) lorsque le "hook" est + supprimé Valeur de retour : @@ -10232,13 +10262,15 @@ Paramètres : * 'callback' : fonction appelée quand le hdata est demandé, paramètres et valeur de retour : ** 'const void *pointer' : pointeur -** 'void *data' : pointeur ; si non NULL, doit avoir été alloué par malloc - (ou une fonction similaire) et sera automatiquement libéré (par free) - lorsque le "hook" est supprimé +** 'void *data' : pointeur ** 'const char *hdata_name' : nom du hdata ** valeur de retour : hdata demandé -* 'callback_data' : pointeur donné au "callback" lorsqu'il est appelé par +* 'callback_pointer' : pointeur donné au "callback" lorsqu'il est appelé par WeeChat +* 'callback_data' : pointeur donné au "callback" lorsqu'il est appelé par + WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction + similaire) et sera automatiquement libéré (par free) lorsque le "hook" est + supprimé Valeur de retour : @@ -10291,9 +10323,7 @@ Paramètres : * 'callback' : fonction appelée quand le focus est fait, paramètres et valeur de retour : ** 'const void *pointer' : pointeur -** 'void *data' : pointeur ; si non NULL, doit avoir été alloué par malloc - (ou une fonction similaire) et sera automatiquement libéré (par free) - lorsque le "hook" est supprimé +** 'void *data' : pointeur ** 'struct t_hashtable *info' : table de hachage avec les informations sur le focus et les chaînes retournées par les autres appels aux "callbacks" de focus (avec plus haute priorité) (voir le tableau ci-dessous) @@ -10302,8 +10332,12 @@ Paramètres : hachage (créée par le "callback", avec clés et valeurs de type "string"), le contenu de cette nouvelle table de hachage sera ajouté à 'info' pour les autres appels aux "callbacks" focus +* 'callback_pointer' : pointeur donné au "callback" lorsqu'il est appelé par + WeeChat * 'callback_data' : pointeur donné au "callback" lorsqu'il est appelé par - WeeChat + WeeChat; si non NULL, doit avoir été alloué par malloc (ou une fonction + similaire) et sera automatiquement libéré (par free) lorsque le "hook" est + supprimé [IMPORTANT] Pour un geste de souris, votre "callback" sera appelé deux fois : la première diff --git a/doc/it/weechat_plugin_api.it.asciidoc b/doc/it/weechat_plugin_api.it.asciidoc index f922aec0f..f0b36b85f 100644 --- a/doc/it/weechat_plugin_api.it.asciidoc +++ b/doc/it/weechat_plugin_api.it.asciidoc @@ -7207,10 +7207,7 @@ Argomenti: * 'callback': funzione chiamata quando viene utilizzato il comando, argomenti e valore restituito: ** 'const void *pointer': puntatore -// TRANSLATION MISSING -** 'void *data': puntatore; if not NULL, it must have been allocated with malloc - (or similar function) and it will be automatically freed when the hook is - deleted +** 'void *data': puntatore ** 'struct t_gui_buffer *buffer': buffer quando il comando viene eseguito ** 'int argc': numero di argomenti forniti per un comando ** 'char **argv': argomenti forniti per un comando @@ -7219,7 +7216,11 @@ Argomenti: ** valore restituito: *** 'WEECHAT_RC_OK' *** 'WEECHAT_RC_ERROR' -* 'callback_data': puntatore fornito dalla callback quando chiamata da WeeChat +* 'callback_pointer': puntatore fornito alla callback quando chiamata da WeeChat +// TRANSLATION MISSING +* 'callback_data': puntatore fornito dalla callback quando chiamata da WeeChat; + if not NULL, it must have been allocated with malloc (or similar function) + and it will be automatically freed when the hook is deleted I codici predefiniti per il completamento sono: @@ -7340,17 +7341,18 @@ Argomenti: * 'callback': funzione chiamata quando il comando è in esecuzione, argomenti e valore restituito: ** 'const void *pointer': puntatore -// TRANSLATION MISSING -** 'void *data': puntatore; if not NULL, it must have been allocated with malloc - (or similar function) and it will be automatically freed when the hook is - deleted +** 'void *data': puntatore ** 'struct t_gui_buffer *buffer': buffer dove viene eseguito il comando ** 'const char *command': il comando eseguito, con i propri argomenti ** valore restituito: *** 'WEECHAT_RC_OK' *** 'WEECHAT_RC_OK_EAT' *** 'WEECHAT_RC_ERROR' -* 'callback_data': puntatore fornito alla callback quando chiamata da WeeChat +* 'callback_pointer': puntatore fornito alla callback quando chiamata da WeeChat +// TRANSLATION MISSING +* 'callback_data': puntatore fornito alla callback quando chiamata da WeeChat; + if not NULL, it must have been allocated with malloc (or similar function) + and it will be automatically freed when the hook is deleted [NOTE] La callback può restituire 'WEECHAT_RC_OK' o 'WEECHAT_RC_OK_EAT' (il comando @@ -7422,15 +7424,16 @@ Argomenti: * 'callback': function called when time is reached, argomenti e valore restituito: ** 'const void *pointer': puntatore -// TRANSLATION MISSING -** 'void *data': pointer; if not NULL, it must have been allocated with malloc - (or similar function) and it will be automatically freed when the hook is - deleted +** 'void *data': puntatore ** 'int remaining_calls': remaining calls (-1 if timer has no end) ** valore restituito: *** 'WEECHAT_RC_OK' *** 'WEECHAT_RC_ERROR' -* 'callback_data': pointer given to callback when it is called by WeeChat +* 'callback_pointer': puntatore fornito alla callback quando chiamata da WeeChat +// TRANSLATION MISSING +* 'callback_data': puntatore fornito alla callback quando chiamata da WeeChat; + if not NULL, it must have been allocated with malloc (or similar function) + and it will be automatically freed when the hook is deleted Valore restituito: @@ -7500,15 +7503,16 @@ Argomenti: * 'callback': funzione che chiama un evento selezionato che si verifica per un file (o un socket), argomenti e valore restituito: ** 'const void *pointer': puntatore -// TRANSLATION MISSING -** 'void *data': puntatore; if not NULL, it must have been allocated with malloc - (or similar function) and it will be automatically freed when the hook is - deleted +** 'void *data': puntatore ** 'int fd': descrittore file ** valore restituito: *** 'WEECHAT_RC_OK' *** 'WEECHAT_RC_ERROR' -* 'callback_data': puntatore fornito alla callback quando chiamata da WeeChat +* 'callback_pointer': puntatore fornito alla callback quando chiamata da WeeChat +// TRANSLATION MISSING +* 'callback_data': puntatore fornito alla callback quando chiamata da WeeChat; + if not NULL, it must have been allocated with malloc (or similar function) + and it will be automatically freed when the hook is deleted Valore restituito: @@ -7585,10 +7589,7 @@ Argomenti: * 'callback': funzione chiamata quando i dati dal processo figlio sono disponibili, oppure quando è terminato, argomenti e valore restituito: ** 'const void *pointer': puntatore -// TRANSLATION MISSING -** 'void *data': puntatore; if not NULL, it must have been allocated with malloc - (or similar function) and it will be automatically freed when the hook is - deleted +** 'void *data': puntatore ** 'const char *command': comando eseguito dal processo figlio ** 'int return_code': codice restituito: *** '>= 0': codice ritorno figlio per un comando, e per un URL i valori @@ -7606,7 +7607,11 @@ Argomenti: ** valore restituito: *** 'WEECHAT_RC_OK' *** 'WEECHAT_RC_ERROR' -* 'callback_data': puntatore fornito alla callback quando chiamata da WeeChat +* 'callback_pointer': puntatore fornito alla callback quando chiamata da WeeChat +// TRANSLATION MISSING +* 'callback_data': puntatore fornito alla callback quando chiamata da WeeChat; + if not NULL, it must have been allocated with malloc (or similar function) + and it will be automatically freed when the hook is deleted Valore restituito: @@ -7967,10 +7972,7 @@ Argomenti: * 'callback': funzione chiamata quando la connessione è avvenuta con successo oppure no, argomenti e valore restituito: ** 'const void *pointer': puntatore -// TRANSLATION MISSING -** 'void *data': puntatore; if not NULL, it must have been allocated with malloc - (or similar function) and it will be automatically freed when the hook is - deleted +** 'void *data': puntatore ** 'int status': stato della connessione: *** 'WEECHAT_HOOK_CONNECT_OK': connessione avvenuta con successo *** 'WEECHAT_HOOK_CONNECT_ADDRESS_NOT_FOUND': indirizzo non trovato @@ -7990,7 +7992,11 @@ Argomenti: ** valore restituito: *** 'WEECHAT_RC_OK' *** 'WEECHAT_RC_ERROR' -* 'callback_data': puntatore fornito alla callback quando chiamata da WeeChat +* 'callback_pointer': puntatore fornito alla callback quando chiamata da WeeChat +// TRANSLATION MISSING +* 'callback_data': puntatore fornito alla callback quando chiamata da WeeChat; + if not NULL, it must have been allocated with malloc (or similar function) + and it will be automatically freed when the hook is deleted Valore restituito: @@ -8137,10 +8143,7 @@ Argomenti: * 'callback': funzione chiamata quando viene stampato un messaggio, argomenti e valore restituito: ** 'const void *pointer': puntatore -// TRANSLATION MISSING -** 'void *data': puntatore; if not NULL, it must have been allocated with malloc - (or similar function) and it will be automatically freed when the hook is - deleted +** 'void *data': puntatore ** 'struct t_gui_buffer *buffer': puntatore al buffer ** 'time_t date': data ** 'int tags_count': numero di tag per riga @@ -8152,7 +8155,11 @@ Argomenti: ** valore restituito: *** 'WEECHAT_RC_OK' *** 'WEECHAT_RC_ERROR' -* 'callback_data': puntatore fornito alla callback quando chiamata da WeeChat +* 'callback_pointer': puntatore fornito alla callback quando chiamata da WeeChat +// TRANSLATION MISSING +* 'callback_data': puntatore fornito alla callback quando chiamata da WeeChat; + if not NULL, it must have been allocated with malloc (or similar function) + and it will be automatically freed when the hook is deleted Valore restituito: @@ -8227,10 +8234,7 @@ Argomenti: * 'callback': funzione chiamata a segnale ricevuto, argomenti e valore restituito: ** 'const void *pointer': puntatore -// TRANSLATION MISSING -** 'void *data': puntatore; if not NULL, it must have been allocated with malloc - (or similar function) and it will be automatically freed when the hook is - deleted +** 'void *data': puntatore ** 'const char *signal': segnale ricevuto ** 'const char *type_data': tipo di dati inviati con il segnale: *** 'WEECHAT_HOOK_SIGNAL_STRING': stringa @@ -8243,7 +8247,11 @@ Argomenti: *** 'WEECHAT_RC_OK_EAT' (stop sending the signal immediately) _(WeeChat ≥ 0.4.0)_ *** 'WEECHAT_RC_ERROR' -* 'callback_data': puntatore fornito alla callback quando chiamata da WeeChat +* 'callback_pointer': puntatore fornito alla callback quando chiamata da WeeChat +// TRANSLATION MISSING +* 'callback_data': puntatore fornito alla callback quando chiamata da WeeChat; + if not NULL, it must have been allocated with malloc (or similar function) + and it will be automatically freed when the hook is deleted Valore restituito: @@ -9234,10 +9242,7 @@ Argomenti: * 'callback': funzione chiamata a segnale ricevuto, argomenti e valore restituito: ** 'const void *pointer': puntatore -// TRANSLATION MISSING -** 'void *data': puntatore; if not NULL, it must have been allocated with malloc - (or similar function) and it will be automatically freed when the hook is - deleted +** 'void *data': puntatore ** 'const char *signal': segnale ricevuto ** 'struct t_hashtable *hashtable': tabella hash ** valore restituito: @@ -9246,7 +9251,11 @@ Argomenti: *** 'WEECHAT_RC_OK_EAT' (stop sending the signal immediately) _(WeeChat ≥ 0.4.0)_ *** 'WEECHAT_RC_ERROR' -* 'callback_data': puntatore fornito alla callback quando chiamata da WeeChat +* 'callback_pointer': puntatore fornito alla callback quando chiamata da WeeChat +// TRANSLATION MISSING +* 'callback_data': puntatore fornito alla callback quando chiamata da WeeChat; + if not NULL, it must have been allocated with malloc (or similar function) + and it will be automatically freed when the hook is deleted Valore restituito: @@ -9610,16 +9619,17 @@ Argomenti: * 'callback': funzione chiamata quando l'opzione di configurazione è cambiata, argomenti e valore restituito: ** 'const void *pointer': puntatore -// TRANSLATION MISSING -** 'void *data': puntatore; if not NULL, it must have been allocated with malloc - (or similar function) and it will be automatically freed when the hook is - deleted +** 'void *data': puntatore ** 'const char *option': nome dell'opzione ** 'const char *value': nuovo valore per l'opzione ** valore restituito: *** 'WEECHAT_RC_OK' *** 'WEECHAT_RC_ERROR' -* 'callback_data': puntatore fornito alla callback quando chiamata da WeeChat +* 'callback_pointer': puntatore fornito alla callback quando chiamata da WeeChat +// TRANSLATION MISSING +* 'callback_data': puntatore fornito alla callback quando chiamata da WeeChat; + if not NULL, it must have been allocated with malloc (or similar function) + and it will be automatically freed when the hook is deleted Valore restituito: @@ -9685,10 +9695,7 @@ Argomenti: (l'utente sta completando qualcosa usando questo elemento), argomenti e valore restituito: ** 'const void *pointer': puntatore -// TRANSLATION MISSING -** 'void *data': puntatore; if not NULL, it must have been allocated with malloc - (or similar function) and it will be automatically freed when the hook is - deleted +** 'void *data': puntatore ** 'const char *completion_item': nome dell'elemento del completamento ** 'struct t_gui_buffer *buffer': buffer dove viene eseguito il completamento ** 'struct t_gui_completion *completion': struttura usata per aggiungere @@ -9697,7 +9704,11 @@ Argomenti: ** valore restituito: *** 'WEECHAT_RC_OK' *** 'WEECHAT_RC_ERROR' -* 'callback_data': puntatore fornito alla callback quando chiamata da WeeChat +* 'callback_pointer': puntatore fornito alla callback quando chiamata da WeeChat +// TRANSLATION MISSING +* 'callback_data': puntatore fornito alla callback quando chiamata da WeeChat; + if not NULL, it must have been allocated with malloc (or similar function) + and it will be automatically freed when the hook is deleted [NOTE] I nomi del completamento sono globali (condivisi tra WeeChat e plugin). Si @@ -9877,15 +9888,16 @@ Argomenti: * 'callback': funzione chiamata quando viene usato il modificatore, argomenti e valore restituito: ** 'const void *pointer': puntatore -// TRANSLATION MISSING -** 'void *data': puntatore; if not NULL, it must have been allocated with malloc - (or similar function) and it will be automatically freed when the hook is - deleted +** 'void *data': puntatore ** 'const char *modifier': nome del modificatore ** 'const char *modifier_data': dati per il modificatore ** 'const char *string': stringa da modificare ** valore restituito: nuova stringa -* 'callback_data': puntatore fornito alla callback quando chiamata da WeeChat +* 'callback_pointer': puntatore fornito alla callback quando chiamata da WeeChat +// TRANSLATION MISSING +* 'callback_data': puntatore fornito alla callback quando chiamata da WeeChat; + if not NULL, it must have been allocated with malloc (or similar function) + and it will be automatically freed when the hook is deleted Valore restituito: @@ -10125,14 +10137,15 @@ Argomenti: * 'callback': funzione chiamata alla richiesta di una info, argomenti e valore restituito: ** 'const void *pointer': puntatore -// TRANSLATION MISSING -** 'void *data': puntatore; if not NULL, it must have been allocated with malloc - (or similar function) and it will be automatically freed when the hook is - deleted +** 'void *data': puntatore ** 'const char *info_name': nome della info ** 'const char *arguments': argomenti addizionali, dipendono dalle info ** valore restituito: valore dell'info richiesta -* 'callback_data': puntatore fornito alla callback quando chiamata da WeeChat +* 'callback_pointer': puntatore fornito alla callback quando chiamata da WeeChat +// TRANSLATION MISSING +* 'callback_data': puntatore fornito alla callback quando chiamata da WeeChat; + if not NULL, it must have been allocated with malloc (or similar function) + and it will be automatically freed when the hook is deleted Valore restituito: @@ -10205,14 +10218,15 @@ Argomenti: * 'callback': funzione chiamata alla richiesta della info, argomenti e valore restituito: ** 'const void *pointer': puntatore -// TRANSLATION MISSING -** 'void *data': puntatore; if not NULL, it must have been allocated with malloc - (or similar function) and it will be automatically freed when the hook is - deleted +** 'void *data': puntatore ** 'const char *info_name': nome della info ** 'struct t_hashtable *hashtable': tabella hash, in base alla info ** valore restituito: tabella hash richiesta -* 'callback_data': puntatore fornito alla callback quando chiamata da WeeChat +* 'callback_pointer': puntatore fornito alla callback quando chiamata da WeeChat +// TRANSLATION MISSING +* 'callback_data': puntatore fornito alla callback quando chiamata da WeeChat; + if not NULL, it must have been allocated with malloc (or similar function) + and it will be automatically freed when the hook is deleted Valore restituito: @@ -10287,16 +10301,17 @@ Argomenti: * 'callback': funzione chiamata alla richiesta della lista info, argomenti e valore restituito: ** 'const void *pointer': puntatore -// TRANSLATION MISSING -** 'void *data': puntatore; if not NULL, it must have been allocated with malloc - (or similar function) and it will be automatically freed when the hook is - deleted +** 'void *data': puntatore ** 'const char *infolist_name': nome della lista info ** 'void *pointer': puntatore ad un oggetto che la lista info deve restituire (per ricevere un solo elemento della lista info) ** 'const char *arguments': argomento aggiuntivo, dipende dalla lista info ** valore restituito: lista info richiesta -* 'callback_data': puntatore fornito alla callback quando chiamata da WeeChat +* 'callback_pointer': puntatore fornito alla callback quando chiamata da WeeChat +// TRANSLATION MISSING +* 'callback_data': puntatore fornito alla callback quando chiamata da WeeChat; + if not NULL, it must have been allocated with malloc (or similar function) + and it will be automatically freed when the hook is deleted Valore restituito: @@ -10368,13 +10383,14 @@ Argomenti: * 'description': descrizione * 'callback': funzione chiamata alla richiesta di hdata, argomenti e valore restituito: ** 'const void *pointer': puntatore -// TRANSLATION MISSING -** 'void *data': puntatore; if not NULL, it must have been allocated with malloc - (or similar function) and it will be automatically freed when the hook is - deleted +** 'void *data': puntatore ** 'const char *hdata_name': nome dell'hdata ** return value: hdata richiesto -* 'callback_data': puntatore fornito alla callback quando chiamata da WeeChat +* 'callback_pointer': puntatore fornito alla callback quando chiamata da WeeChat +// TRANSLATION MISSING +* 'callback_data': puntatore fornito alla callback quando chiamata da WeeChat; + if not NULL, it must have been allocated with malloc (or similar function) + and it will be automatically freed when the hook is deleted Valore restituito: @@ -10426,10 +10442,7 @@ Argomenti: (priorità consentita, consultare la nota a riguardo di <<hook_priority,priority>>) * 'callback': funzione chiamata al momento del focus, argomenti e valore restituito: ** 'const void *pointer': puntatore -// TRANSLATION MISSING -** 'void *data': puntatore; if not NULL, it must have been allocated with malloc - (or similar function) and it will be automatically freed when the hook is - deleted +** 'void *data': puntatore ** 'struct t_hashtable *info': tabella hash con informazioni sul focus e stringhe restituite da altre chiamate alle callback sul focus (con la priorità più alta) (consultare la tabella in basso) @@ -10437,7 +10450,11 @@ Argomenti: puntatore ad una nuova tabella hash (creata dalla callback, con chiavi e valori di tipo "string), questa nuovo contenuto della tabella hash verrà aggiunto ad 'info' per le altre chiamate alle callback del focus -* 'callback_data': puntatore fornito alla callback quando chiamata da WeeChat +* 'callback_pointer': puntatore fornito alla callback quando chiamata da WeeChat +// TRANSLATION MISSING +* 'callback_data': puntatore fornito alla callback quando chiamata da WeeChat; + if not NULL, it must have been allocated with malloc (or similar function) + and it will be automatically freed when the hook is deleted [IMPORTANT] Per l'azione di un mouse, la callback verrà chiamata due volte: la prima quando diff --git a/doc/ja/weechat_plugin_api.ja.asciidoc b/doc/ja/weechat_plugin_api.ja.asciidoc index 51be29960..98b38f94a 100644 --- a/doc/ja/weechat_plugin_api.ja.asciidoc +++ b/doc/ja/weechat_plugin_api.ja.asciidoc @@ -7045,10 +7045,7 @@ struct t_hook *weechat_hook_command (const char *command, "||" で区切ってください。 * 'callback': コマンドが使用された際に呼び出す関数、引数と戻り値: ** 'const void *pointer': ポインタ -// TRANSLATION MISSING -** 'void *data': ポインタ; if not NULL, it must have been allocated with malloc - (or similar function) and it will be automatically freed when the hook is - deleted +** 'void *data': ポインタ ** 'struct t_gui_buffer *buffer': コマンドを実行するバッファ ** 'int argc': コマンドに渡す引数の個数 ** 'char **argv': コマンドに渡す引数 @@ -7057,7 +7054,11 @@ struct t_hook *weechat_hook_command (const char *command, ** 戻り値: *** 'WEECHAT_RC_OK' *** 'WEECHAT_RC_ERROR' -* 'callback_data': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ +* 'callback_pointer': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ +// TRANSLATION MISSING +* 'callback_data': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ; + if not NULL, it must have been allocated with malloc (or similar function) + and it will be automatically freed when the hook is deleted デフォルトの補完候補コードは: @@ -7173,17 +7174,18 @@ struct t_hook *weechat_hook_command_run (const char *command, (優先度の設定が可能、<<hook_priority,優先度>>に関する注意を参照) * 'callback': コマンドが実行される際に呼び出す関数、引数と戻り値: ** 'const void *pointer': ポインタ -// TRANSLATION MISSING -** 'void *data': ポインタ; if not NULL, it must have been allocated with malloc - (or similar function) and it will be automatically freed when the hook is - deleted +** 'void *data': ポインタ ** 'struct t_gui_buffer *buffer': コマンドを実行するバッファ ** 'const char *command': 実行するコマンド、引数付き ** 戻り値: *** 'WEECHAT_RC_OK' *** 'WEECHAT_RC_OK_EAT' *** 'WEECHAT_RC_ERROR' -* 'callback_data': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ +* 'callback_pointer': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ +// TRANSLATION MISSING +* 'callback_data': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ; + if not NULL, it must have been allocated with malloc (or similar function) + and it will be automatically freed when the hook is deleted [NOTE] コールバックは 'WEECHAT_RC_OK' または 'WEECHAT_RC_OK_EAT' @@ -7251,15 +7253,16 @@ struct t_hook *weechat_hook_timer (long interval, * 'max_calls': タイマを呼び出す回数 (0 の場合、タイマを無限に呼び出す) * 'callback': 時間が来たら呼び出す関数、引数と戻り値: ** 'const void *pointer': ポインタ -// TRANSLATION MISSING -** 'void *data': ポインタ; if not NULL, it must have been allocated with malloc - (or similar function) and it will be automatically freed when the hook is - deleted +** 'void *data': ポインタ ** 'int remaining_calls': 呼び出し残り回数 (タイマを無限に呼び出す場合は -1) ** 戻り値: *** 'WEECHAT_RC_OK' *** 'WEECHAT_RC_ERROR' -* 'callback_data': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ +* 'callback_pointer': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ +// TRANSLATION MISSING +* 'callback_data': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ; + if not NULL, it must have been allocated with malloc (or similar function) + and it will be automatically freed when the hook is deleted 戻り値: @@ -7327,15 +7330,16 @@ struct t_hook *weechat_hook_fd (int fd, * 'callback': ファイル (またはソケット) に対してキャッチしたいイベントが発生した場合に実行する関数、 引数と戻り値: ** 'const void *pointer': ポインタ -// TRANSLATION MISSING -** 'void *data': ポインタ; if not NULL, it must have been allocated with malloc - (or similar function) and it will be automatically freed when the hook is - deleted +** 'void *data': ポインタ ** 'int fd': ファイルディスクリプタ ** 戻り値: *** 'WEECHAT_RC_OK' *** 'WEECHAT_RC_ERROR' -* 'callback_data': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ +* 'callback_pointer': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ +// TRANSLATION MISSING +* 'callback_data': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ; + if not NULL, it must have been allocated with malloc (or similar function) + and it will be automatically freed when the hook is deleted 戻り値: @@ -7412,10 +7416,7 @@ struct t_hook *weechat_hook_process (const char *command, * 'callback': 子プロセスからのデータが利用可能になるか、子プロセスが終了したら呼び出す関数、引数と戻り値: ** 'const void *pointer': ポインタ -// TRANSLATION MISSING -** 'void *data': ポインタ; if not NULL, it must have been allocated with malloc - (or similar function) and it will be automatically freed when the hook is - deleted +** 'void *data': ポインタ ** 'const char *command': 子プロセスが実行するコマンド ** 'int return_code': リターンコード: *** '>= 0': コマンドを実行した子プロセスのまたは URL に対するリターンコード。URL の場合取取り得る値は: @@ -7431,7 +7432,11 @@ struct t_hook *weechat_hook_process (const char *command, ** 戻り値: *** 'WEECHAT_RC_OK' *** 'WEECHAT_RC_ERROR' -* 'callback_data': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ +* 'callback_pointer': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ +// TRANSLATION MISSING +* 'callback_data': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ; + if not NULL, it must have been allocated with malloc (or similar function) + and it will be automatically freed when the hook is deleted 戻り値: @@ -7777,10 +7782,7 @@ struct t_hook *weechat_hook_connect (const char *proxy, * 'callback': 接続に成功および失敗した際に呼び出す関数、引数と戻り値: ** 'const void *pointer': ポインタ -// TRANSLATION MISSING -** 'void *data': ポインタ; if not NULL, it must have been allocated with malloc - (or similar function) and it will be automatically freed when the hook is - deleted +** 'void *data': ポインタ ** 'int status': 接続状態: *** 'WEECHAT_HOOK_CONNECT_OK': 接続成功 *** 'WEECHAT_HOOK_CONNECT_ADDRESS_NOT_FOUND': アドレスが見つかりません @@ -7800,7 +7802,11 @@ struct t_hook *weechat_hook_connect (const char *proxy, ** 戻り値: *** 'WEECHAT_RC_OK' *** 'WEECHAT_RC_ERROR' -* 'callback_data': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ +* 'callback_pointer': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ +// TRANSLATION MISSING +* 'callback_data': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ; + if not NULL, it must have been allocated with malloc (or similar function) + and it will be automatically freed when the hook is deleted 戻り値: @@ -7942,10 +7948,7 @@ struct t_hook *weechat_hook_print (struct t_gui_buffer *buffer, * 'callback': メッセージが表示される際に呼び出すコールバック、引数と戻り値: ** 'const void *pointer': ポインタ -// TRANSLATION MISSING -** 'void *data': ポインタ; if not NULL, it must have been allocated with malloc - (or similar function) and it will be automatically freed when the hook is - deleted +** 'void *data': ポインタ ** 'struct t_gui_buffer *buffer': バッファへのポインタ ** 'time_t date': 日付 ** 'int tags_count': 行に付けられたタグの個数 @@ -7957,7 +7960,11 @@ struct t_hook *weechat_hook_print (struct t_gui_buffer *buffer, ** 戻り値: *** 'WEECHAT_RC_OK' *** 'WEECHAT_RC_ERROR' -* 'callback_data': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ +* 'callback_pointer': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ +// TRANSLATION MISSING +* 'callback_data': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ; + if not NULL, it must have been allocated with malloc (or similar function) + and it will be automatically freed when the hook is deleted 戻り値: @@ -8030,10 +8037,7 @@ struct t_hook *weechat_hook_signal (const char *signal, * 'callback': シグナルを受信した際に呼び出す関数、引数と戻り値: ** 'const void *pointer': ポインタ -// TRANSLATION MISSING -** 'void *data': ポインタ; if not NULL, it must have been allocated with malloc - (or similar function) and it will be automatically freed when the hook is - deleted +** 'void *data': ポインタ ** 'const char *signal': 受信したシグナル ** 'const char *type_data': シグナルが送信したデータの型 *** 'WEECHAT_HOOK_SIGNAL_STRING': 文字列 @@ -8045,7 +8049,11 @@ struct t_hook *weechat_hook_signal (const char *signal, *** 'WEECHAT_RC_OK_EAT' (直ちにシグナルの送信を止める) _(WeeChat バージョン 0.4.0 以上で利用可)_ *** 'WEECHAT_RC_ERROR' -* 'callback_data': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ +* 'callback_pointer': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ +// TRANSLATION MISSING +* 'callback_data': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ; + if not NULL, it must have been allocated with malloc (or similar function) + and it will be automatically freed when the hook is deleted 戻り値: @@ -8948,10 +8956,7 @@ Arguments: * 'callback': シグナルを受信した際に呼び出す関数、引数と戻り値: ** 'const void *pointer': ポインタ -// TRANSLATION MISSING -** 'void *data': ポインタ; if not NULL, it must have been allocated with malloc - (or similar function) and it will be automatically freed when the hook is - deleted +** 'void *data': ポインタ ** 'const char *signal': 受信したシグナル ** 'struct t_hashtable *hashtable': ハッシュテーブル ** 戻り値: @@ -8959,7 +8964,11 @@ Arguments: *** 'WEECHAT_RC_OK_EAT' (直ちにシグナルの送信を止める) _(WeeChat バージョン 0.4.0 以上で利用可)_ *** 'WEECHAT_RC_ERROR' -* 'callback_data': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ +* 'callback_pointer': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ +// TRANSLATION MISSING +* 'callback_data': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ; + if not NULL, it must have been allocated with malloc (or similar function) + and it will be automatically freed when the hook is deleted 戻り値: @@ -9308,16 +9317,17 @@ struct t_hook *weechat_hook_config (const char *option, * 'callback': 設定オプションが変更されたら呼び出す関数、引数と戻り値: ** 'const void *pointer': ポインタ -// TRANSLATION MISSING -** 'void *data': ポインタ; if not NULL, it must have been allocated with malloc - (or similar function) and it will be automatically freed when the hook is - deleted +** 'void *data': ポインタ ** 'const char *option': オプションの名前 ** 'const char *value': オプションの新しい値 ** 戻り値: *** 'WEECHAT_RC_OK' *** 'WEECHAT_RC_ERROR' -* 'callback_data': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ +* 'callback_pointer': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ +// TRANSLATION MISSING +* 'callback_data': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ; + if not NULL, it must have been allocated with malloc (or similar function) + and it will be automatically freed when the hook is deleted 戻り値: @@ -9382,10 +9392,7 @@ struct t_hook *weechat_hook_completion (const char *completion_item, * 'callback': 補完要素 (ユーザはこの要素を使って何かを補完している) が使われた場合に呼び出す関数、引数と戻り値: ** 'const void *pointer': ポインタ -// TRANSLATION MISSING -** 'void *data': ポインタ; if not NULL, it must have been allocated with malloc - (or similar function) and it will be automatically freed when the hook is - deleted +** 'void *data': ポインタ ** 'const char *completion_item': 補完要素の名前 ** 'struct t_gui_buffer *buffer': 補完が行われたバッファ ** 'struct t_gui_completion *completion': @@ -9394,7 +9401,11 @@ struct t_hook *weechat_hook_completion (const char *completion_item, ** 戻り値: *** 'WEECHAT_RC_OK' *** 'WEECHAT_RC_ERROR' -* 'callback_data': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ +* 'callback_pointer': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ +// TRANSLATION MISSING +* 'callback_data': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ; + if not NULL, it must have been allocated with malloc (or similar function) + and it will be automatically freed when the hook is deleted [NOTE] 補完名はグローバルです (WeeChat @@ -9569,15 +9580,16 @@ struct t_hook *weechat_hook_modifier (const char *modifier, (以下の表を参照) * 'callback': 修飾子が使われた際に呼び出す関数、引数と戻り値: ** 'const void *pointer': ポインタ -// TRANSLATION MISSING -** 'void *data': ポインタ; if not NULL, it must have been allocated with malloc - (or similar function) and it will be automatically freed when the hook is - deleted +** 'void *data': ポインタ ** 'const char *modifier': 修飾子の名前 ** 'const char *modifier_data': 修飾子に渡すデータ ** 'const char *string': 修飾子に渡す文字列 ** 戻り値: 新しい文字列 -* 'callback_data': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ +* 'callback_pointer': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ +// TRANSLATION MISSING +* 'callback_data': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ; + if not NULL, it must have been allocated with malloc (or similar function) + and it will be automatically freed when the hook is deleted 戻り値: @@ -9809,14 +9821,15 @@ struct t_hook *weechat_hook_info (const char *info_name, * 'args_description': 引数の説明 (任意、NULL にすることも可) * 'callback': 情報が要求されたら呼び出す関数、引数と戻り値: ** 'const void *pointer': ポインタ -// TRANSLATION MISSING -** 'void *data': ポインタ; if not NULL, it must have been allocated with malloc - (or similar function) and it will be automatically freed when the hook is - deleted +** 'void *data': ポインタ ** 'const char *info_name': 情報の名前 ** 'const char *arguments': 追加の引数、情報に依存 ** 戻り値: 要求された情報の値 -* 'callback_data': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ +* 'callback_pointer': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ +// TRANSLATION MISSING +* 'callback_data': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ; + if not NULL, it must have been allocated with malloc (or similar function) + and it will be automatically freed when the hook is deleted 戻り値: @@ -9886,14 +9899,15 @@ struct t_hook *weechat_hook_info_hashtable (const char *info_name, (任意、NULL でも可) * 'callback': 情報を要求する際に呼び出す関数、引数と戻り値: ** 'const void *pointer': ポインタ -// TRANSLATION MISSING -** 'void *data': ポインタ; if not NULL, it must have been allocated with malloc - (or similar function) and it will be automatically freed when the hook is - deleted +** 'void *data': ポインタ ** 'const char *info_name': 情報の名前 ** 'struct t_hashtable *hashtable': ハッシュテーブル、情報に依存 ** 戻り値: 要求したハッシュテーブル -* 'callback_data': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ +* 'callback_pointer': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ +// TRANSLATION MISSING +* 'callback_data': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ; + if not NULL, it must have been allocated with malloc (or similar function) + and it will be automatically freed when the hook is deleted 戻り値: @@ -9966,16 +9980,17 @@ struct t_hook *weechat_hook_infolist (const char *infolist_name, * 'callback': インフォリストが要求された際に呼び出すコールバック、引数と戻り値: ** 'const void *pointer': ポインタ -// TRANSLATION MISSING -** 'void *data': ポインタ; if not NULL, it must have been allocated with malloc - (or similar function) and it will be automatically freed when the hook is - deleted +** 'void *data': ポインタ ** 'const char *infolist_name': インフォリストの名前 ** 'void *pointer': インフォリストが返すオブジェクトへのポインタ (インフォリストの要素を 1 つだけ返す) ** 'const char *arguments': 追加の引数、インフォリストに依存 ** 戻り値: 要求したインフォリスト -* 'callback_data': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ +* 'callback_pointer': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ +// TRANSLATION MISSING +* 'callback_data': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ; + if not NULL, it must have been allocated with malloc (or similar function) + and it will be automatically freed when the hook is deleted 戻り値: @@ -10048,13 +10063,14 @@ struct t_hook *weechat_hook_hdata (const char *hdata_name, * 'callback': hdata が要求された際に呼び出す関数、引数と戻り値: ** 'const void *pointer': ポインタ -// TRANSLATION MISSING -** 'void *data': ポインタ; if not NULL, it must have been allocated with malloc - (or similar function) and it will be automatically freed when the hook is - deleted +** 'void *data': ポインタ ** 'const char *hdata_name': hdata の名前 ** 戻り値: 要求された hdata -* 'callback_data': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ +* 'callback_pointer': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ +// TRANSLATION MISSING +* 'callback_data': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ; + if not NULL, it must have been allocated with malloc (or similar function) + and it will be automatically freed when the hook is deleted 戻り値: @@ -10107,17 +10123,18 @@ struct t_hook *weechat_hook_focus (const char *area, * 'callback': フォーカスが当たったら呼び出す関数、引数と戻り値: ** 'const void *pointer': ポインタ -// TRANSLATION MISSING -** 'void *data': ポインタ; if not NULL, it must have been allocated with malloc - (or similar function) and it will be automatically freed when the hook is - deleted +** 'void *data': ポインタ ** 'struct t_hashtable *info': フォーカスの情報を含むハッシュテーブルと、他の (より高い優先度を持つ) フォーカスコールバックを呼び出して返された文字列 (以下のテーブルを参照) ** 戻り値: "info" ポインタ (完全なハッシュテーブル) または新しいハッシュテーブル (コールバックが作成、キーと値は "string" 型) へのポインタ、この新しいハッシュテーブルの内容は 'info' に追加され、他のフォーカスコールバックに渡されます -* 'callback_data': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ +* 'callback_pointer': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ +// TRANSLATION MISSING +* 'callback_data': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ; + if not NULL, it must have been allocated with malloc (or similar function) + and it will be automatically freed when the hook is deleted [IMPORTANT] マウスジェスチャの場合、コールバックを 2 回呼び出します: 1 |