Update plugin API reference: add "New in version x.y.z" for some functions, add missing functions

1 files changed, 204 insertions, 0 deletions

diff --git a/doc/it/weechat_plugin_api.it.txt b/doc/it/weechat_plugin_api.it.txt
index 50df831c3..9f0e2b163 100644
--- a/doc/it/weechat_plugin_api.it.txt
+++ b/doc/it/weechat_plugin_api.it.txt
@@ -601,6 +601,39 @@ Esempio in C:
 int diff = weechat_strcasecmp ("aaa", "CCC"); /* == -2 */
 ----------------------------------------
 
+weechat_strncasecmp
+^^^^^^^^^^^^^^^^^^^
+
+Confronta stringa indipendente da caso (maiuscole
+o minuscole) e da locale, for 'max' chars.
+
+Prototipo:
+
+[source,C]
+----------------------------------------
+int weechat_strncasecmp (const char *string1, const char *string2, int max);
+----------------------------------------
+
+Argomenti:
+
+* 'string1': prima stringa da comparare
+* 'string2': seconda stringa da comparare
+* 'max': max chars to compare
+
+Valore restituito:
+
+* differenze tra le due stringhe:
+** negativa se stringa1 < stringa2
+** zero se stringa1 == stringa1
+** positiva se stringa1 > stringa2
+
+Esempio in C:
+
+[source,C]
+----------------------------------------
+int diff = weechat_strncasecmp ("aabb", "aacc", 2); /* == 0 */
+----------------------------------------
+
 weechat_strcmp_ignore_chars
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -750,6 +783,8 @@ free (str);
 weechat_string_expand_home
 ^^^^^^^^^^^^^^^^^^^^^^^^^^
 
+_Nuovo nella versione 0.3.3._
+
 Sostituisce la `~` iniziale con la stringa con la cartella home. Se la stringa
 non inizia con `~`, viene restituita la stessa stringa.
 
@@ -1206,6 +1241,8 @@ str = weechat.string_remove_color(my_string, "?")
 weechat_string_encode_base64
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
+_Nuovo nella versione 0.3.2._
+
 Codifica una stringa in base64.
 
 Prototype:
@@ -1234,6 +1271,8 @@ weechat_string_encode_base64 (string, strlen (string), result);
 weechat_string_decode_base64
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
+_Nuovo nella versione 0.3.2._
+
 Decodifca una stringa in base64.
 
 Prototype:
@@ -1266,6 +1305,8 @@ length = weechat_string_decode_base64 (string, result);
 weechat_string_is_command_char
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
+_Nuovo nella versione 0.3.2._
+
 Verifica che il primo carattere della stringa sia un carattere comando
 (il comando carattere predefinito è '/').
 
@@ -1308,6 +1349,8 @@ command_char2 = weechat.string_is_command_char("test")  # == 0
 weechat_string_input_for_buffer
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
+_Nuovo nella versione 0.3.2._
+
 Restituisce il puntatore al testo in input per il buffer (puntatore all'interno
 dell'argomento "string"), oppure NULL se è un comando.
 
@@ -1504,6 +1547,33 @@ Esempio in C:
 char *next_char = weechat_utf8_next_char (string);
 ----------------------------------------
 
+weechat_utf8_char_int
+^^^^^^^^^^^^^^^^^^^^^
+
+Return UTF-8 char as integer.
+
+Prototipo:
+
+[source,C]
+----------------------------------------
+int weechat_utf8_char_int (const char *string);
+----------------------------------------
+
+Argomenti:
+
+* 'string': stringa
+
+Valore restituito:
+
+* UTF-8 char as integer
+
+Esempio in C:
+
+[source,C]
+----------------------------------------
+int char_int = weechat_utf8_char_int ("être"); /* "ê" as integer */
+----------------------------------------
+
 weechat_utf8_char_size
 ^^^^^^^^^^^^^^^^^^^^^^
 
@@ -1616,6 +1686,37 @@ Esempio in C:
 int length_on_screen = weechat_utf8_strlen_screen ("é"); /* == 1 */
 ----------------------------------------
 
+weechat_utf8_charcmp
+^^^^^^^^^^^^^^^^^^^^
+
+Confronta due caratteri UTF-8.
+
+Prototipo:
+
+[source,C]
+----------------------------------------
+int weechat_utf8_charcmp (const char *string1, const char *string2);
+----------------------------------------
+
+Argomenti:
+
+* 'string1': prima stringa da comparare
+* 'string2': seconda stringa da comparare
+
+Valore restituito:
+
+* differenza tra i primi caratteri di ogni stringa:
+** negativa se char1 < char2
+** zero se char1 == char2
+** positivao se char1 > char2
+
+Esempio in C:
+
+[source,C]
+----------------------------------------
+int diff = weechat_utf8_charcmp ("aaa", "ccc"); /* == -2 */
+----------------------------------------
+
 weechat_utf8_charcasecmp
 ^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -1960,6 +2061,39 @@ void callback (void *data, const char *filename)
 weechat_exec_on_files ("/tmp", 0, NULL, &callback);
 ----------------------------------------
 
+weechat_file_get_content
+^^^^^^^^^^^^^^^^^^^^^^^^
+
+_Nuovo nella versione 0.3.1._
+
+Get content of text file in a string.
+
+Prototipo:
+
+[source,C]
+----------------------------------------
+char *weechat_file_get_content (const char *filename);
+----------------------------------------
+
+Argomenti:
+
+* 'filename': path and file name
+
+Valore restituito:
+
+* content of file as string (must be freed by calling "free" after use)
+
+Esempio in C:
+
+[source,C]
+----------------------------------------
+char *content;
+
+content = weechat_file_get_content ("/tmp/test.txt");
+/* ... */
+free (content);
+----------------------------------------
+
 [[util]]
 Utilità
 ~~~~~~~
@@ -2054,6 +2188,8 @@ weechat_util_timeval_add (&tv, 2000); /* aggiunge 2 secondi */
 weechat_util_get_time_string
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
+_Nuovo nella versione 0.3.2._
+
 Riceve data/ora come stringa compilata con "strftime".
 
 Prototipo:
@@ -2588,6 +2724,8 @@ Funzioni per le tabelle hash.
 weechat_hashtable_new
 ^^^^^^^^^^^^^^^^^^^^^
 
+_Nuovo nella versione 0.3.3._
+
 Crea una nuova tabella hash.
 
 Prototipo:
@@ -2647,6 +2785,8 @@ struct t_hashtable *hashtable = weechat_hashtable_new (8,
 weechat_hashtable_set_with_size
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
+_Nuovo nella versione 0.3.3._
+
 Aggiunge o aggiorna un elemento nella tabella hash con la dimensione per la
 chiave ed il valore.
 
@@ -2684,6 +2824,8 @@ weechat_hashtable_set_with_size (hashtable, "my_key", 0,
 weechat_hashtable_set
 ^^^^^^^^^^^^^^^^^^^^^
 
+_Nuovo nella versione 0.3.3._
+
 Aggiunge o aggiorna un elemento nella tabella hash.
 
 Prototipo:
@@ -2714,6 +2856,8 @@ weechat_hashtable_set (hashtable, "my_key", "my_value");
 weechat_hashtable_get
 ^^^^^^^^^^^^^^^^^^^^^
 
+_Nuovo nella versione 0.3.3._
+
 Ottiene il valore associato ad una chiave in una tabella hash.
 
 Prototipo:
@@ -2742,6 +2886,8 @@ void *value = weechat_hashtable_get (hashtable, "my_key");
 weechat_hashtable_map
 ^^^^^^^^^^^^^^^^^^^^^
 
+_Nuovo nella versione 0.3.3._
+
 Chiama una funzione su tutte le voci della tabella hash.
 
 Prototipo:
@@ -2782,6 +2928,8 @@ weechat_hashtable_map (hashtable, &map_cb, NULL);
 weechat_hashtable_get_integer
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
+_Nuovo nella versione 0.3.3._
+
 Restituisce un valore intero per la proprietà di una tabella hash.
 
 Prototipo:
@@ -2813,6 +2961,8 @@ int items_count = weechat_hashtable_get_integer (hashtable, "items_count");
 weechat_hashtable_add_to_infolist
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
+_Nuovo nella versione 0.3.3._
+
 Aggiunge elementi della tabella hash ad un elemento della lista info.
 
 Prototipo:
@@ -2854,6 +3004,8 @@ weechat_hashtable_add_to_infolist (hashtable, infolist_item, "testhash");
 weechat_hashtable_remove
 ^^^^^^^^^^^^^^^^^^^^^^^^
 
+_Nuovo nella versione 0.3.3._
+
 Rimuove un elemento in una tabella hash.
 
 Prototipo:
@@ -2878,6 +3030,8 @@ weechat_hashtable_remove (hashtable, "my_key");
 weechat_hashtable_remove_all
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
+_Nuovo nella versione 0.3.3._
+
 Rimuove tutti gli elementi in una tabella hash.
 
 Prototipo:
@@ -2901,6 +3055,8 @@ weechat_hashtable_remove_all (hashtable);
 weechat_hashtable_free
 ^^^^^^^^^^^^^^^^^^^^^^
 
+_Nuovo nella versione 0.3.3._
+
 Libera una tabella hash.
 
 Prototipo:
@@ -3502,6 +3658,54 @@ option = weechat.config_search_option(config_file, section, option_name)
 option = weechat.config_search_option(config_file, section, "option")
 ----------------------------------------
 
+weechat_config_search_section_option
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Search a section and an option in a configuration file or section.
+
+Prototipo:
+
+[source,C]
+----------------------------------------
+void weechat_config_search_section_option (struct t_config_file *config_file,
+                                           struct t_config_section *section,
+                                           const char *option_name,
+                                           struct t_config_section **section_found,
+                                           struct t_config_option **option_found);
+----------------------------------------
+
+Arguments:
+
+* 'config_file': puntatore al file di configurazione
+* 'section': puntatore alla sezione
+* 'option_name': option name
+* 'section_found': puntatore al puntatore della sezione, sarà impostato alla
+  sezione dell'opzione, se viene trovata
+* 'option_found': puntatore al puntatore dell'opzione, sarà impostato al
+  puntatore di un'opzione, se viene trovata
+
+Esempio in C:
+
+[source,C]
+----------------------------------------
+struct t_config_section *ptr_section;
+struct t_config_option *ptr_option;
+
+weechat_config_search_section_option(config_file,
+                                     section,
+                                     "option",
+                                     &ptr_section,
+                                     &ptr_option);
+if (ptr_option)
+{
+    /* opzione trovata */
+}
+else
+{
+    /* opzione non trovata */
+}
+----------------------------------------
+
 weechat_config_search_with_string
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^