pegasus/weechat
1
0
Fork 0
mirror of https://github.com/weechat/weechat.git synced 2026-06-30 23:06:38 +02:00
Code Activity

doc: fix arguments in hook functions (plugin API reference)

Browse Source
This commit is contained in:
Sébastien Helleu
2016-03-24 11:02:25 +01:00
parent 17d20b9ca6
commit 0b697629d5
4 changed files with 392 additions and 306 deletions
Download Patch File Download Diff File Expand all files Collapse all files
doc/en/weechat_plugin_api.en.asciidoc
+86 -68
View File
@@ -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
doc/fr/weechat_plugin_api.fr.asciidoc
+102 -68
View File
@@ -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
doc/it/weechat_plugin_api.it.asciidoc
+102 -85
View File
@@ -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
doc/ja/weechat_plugin_api.ja.asciidoc
+102 -85
View File
@@ -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