From 0b697629d526cd1e6502d5b19d572926fb3da178 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?S=C3=A9bastien=20Helleu?= Date: Thu, 24 Mar 2016 11:02:25 +0100 Subject: doc: fix arguments in hook functions (plugin API reference) --- doc/it/weechat_plugin_api.it.asciidoc | 187 ++++++++++++++++++---------------- 1 file changed, 102 insertions(+), 85 deletions(-) (limited to 'doc/it/weechat_plugin_api.it.asciidoc') 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 <>) * '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 -- cgit v1.2.3