doc: update doc of function exec_on_files (plugin API reference)

4 files changed, 26 insertions, 16 deletions

diff --git a/doc/en/weechat_plugin_api.en.asciidoc b/doc/en/weechat_plugin_api.en.asciidoc
index 002834427..9bb86f07f 100644
--- a/doc/en/weechat_plugin_api.en.asciidoc
+++ b/doc/en/weechat_plugin_api.en.asciidoc
@@ -2834,6 +2834,8 @@ weechat.mkdir_parents("/tmp/my/dir", 0755)
 
 ==== exec_on_files
 
+_Updated in 1.5._
+
 Find files in a directory and execute a callback on each file.
 
 Prototype:
@@ -2842,19 +2844,19 @@ Prototype:
 ----
 void weechat_exec_on_files (const char *directory,
                             int hidden_files,
-                            void *data,
                             void (*callback)(void *data,
-                                             const char *filename));
+                                             const char *filename),
+                            void *callback_data);
 ----
 
 Arguments:
 
 * 'directory': directory for searching files
 * 'hidden_files': 1 to include hidden files, otherwise 0
-* 'data': pointer given to callback when it is called by WeeChat
 * 'callback': function called for each file found, arguments:
 ** 'void *data': pointer
 ** 'const char *filename': filename found
+* 'callback_data': pointer given to callback when it is called by WeeChat
 
 C example:
 
@@ -2865,7 +2867,7 @@ void callback (void *data, const char *filename)
     /* ... */
 }
 ...
-weechat_exec_on_files ("/tmp", 0, NULL, &callback);
+weechat_exec_on_files ("/tmp", 0, &callback, NULL);
 ----
 
 [NOTE]
diff --git a/doc/fr/weechat_plugin_api.fr.asciidoc b/doc/fr/weechat_plugin_api.fr.asciidoc
index 5e538e60e..86346923e 100644
--- a/doc/fr/weechat_plugin_api.fr.asciidoc
+++ b/doc/fr/weechat_plugin_api.fr.asciidoc
@@ -2888,6 +2888,8 @@ weechat.mkdir_parents("/tmp/my/dir", 0755)
 
 ==== exec_on_files
 
+_Mis à jour dans la 1.5._
+
 Balayer les fichiers dans un répertoire et exécuter un "callback" pour chaque
 fichier.
 
@@ -2897,19 +2899,20 @@ Prototype :
 ----
 void weechat_exec_on_files (const char *directory,
                             int hidden_files,
-                            void *data,
                             void (*callback)(void *data,
-                                             const char *filename));
+                                             const char *filename),
+                            void *callback_data);
 ----
 
 Paramètres :
 
 * 'directory' : répertoire où chercher les fichiers
 * 'hidden_files' : 1 pour inclure les fichiers cachés, sinon 0
-* 'data' : pointeur donné au "callback" lorsqu'il est appelé par WeeChat
 * 'callback' : fonction appelée pour chaque fichier trouvé, paramètres :
 ** 'void *data' : pointeur
 ** 'const char *filename' : nom de fichier trouvé
+* 'callback_data' : pointeur donné au "callback" lorsqu'il est appelé par
+  WeeChat
 
 Exemple en C :
 
@@ -2920,7 +2923,7 @@ void callback (void *data, const char *filename)
     /* ... */
 }
 ...
-weechat_exec_on_files ("/tmp", 0, NULL, &callback);
+weechat_exec_on_files ("/tmp", 0, &callback, NULL);
 ----
 
 [NOTE]
diff --git a/doc/it/weechat_plugin_api.it.asciidoc b/doc/it/weechat_plugin_api.it.asciidoc
index af44f3e26..70237147a 100644
--- a/doc/it/weechat_plugin_api.it.asciidoc
+++ b/doc/it/weechat_plugin_api.it.asciidoc
@@ -2930,6 +2930,9 @@ weechat.mkdir_parents("/tmp/my/dir", 0755)
 
 ==== exec_on_files
 
+// TRANSLATION MISSING
+_Updated in 1.5._
+
 Cerca i file in una cartella ed esegue una callback su ogni file.
 
 Prototipo:
@@ -2938,19 +2941,19 @@ Prototipo:
 ----
 void weechat_exec_on_files (const char *directory,
                             int hidden_files,
-                            void *data,
                             void (*callback)(void *data,
-                                             const char *filename));
+                                             const char *filename),
+                            void *callback_data);
 ----
 
 Argomenti:
 
 * 'directory': cartella in cui cercare i file
 * 'hidden_files': 1 per includere i file nascosti, altrimenti 0
-* 'data': puntatore fornito alla callback quando chiamata da WeeChat
 * 'callback': funzione chiamata per ogni file trovato, argomenti:
 ** 'void *data': puntatore
 ** 'const char *filename': nome file trovato
+* 'callback_data': puntatore fornito alla callback quando chiamata da WeeChat
 
 Esempio in C:
 
@@ -2961,7 +2964,7 @@ void callback (void *data, const char *filename)
     /* ... */
 }
 ...
-weechat_exec_on_files ("/tmp", 0, NULL, &callback);
+weechat_exec_on_files ("/tmp", 0, &callback, NULL);
 ----
 
 [NOTE]
diff --git a/doc/ja/weechat_plugin_api.ja.asciidoc b/doc/ja/weechat_plugin_api.ja.asciidoc
index 59c58ad50..e931e6340 100644
--- a/doc/ja/weechat_plugin_api.ja.asciidoc
+++ b/doc/ja/weechat_plugin_api.ja.asciidoc
@@ -2835,6 +2835,8 @@ weechat.mkdir_parents("/tmp/my/dir", 0755)
 
 ==== exec_on_files
 
+_バージョン 1.5 で更新。_
+
 ディレクトリ中のファイルを探し、各ファイルに対してコールバックを実行。
 
 プロトタイプ:
@@ -2843,19 +2845,19 @@ weechat.mkdir_parents("/tmp/my/dir", 0755)
 ----
 void weechat_exec_on_files (const char *directory,
                             int hidden_files,
-                            void *data,
                             void (*callback)(void *data,
-                                             const char *filename));
+                                             const char *filename),
+                            void *callback_data);
 ----
 
 引数:
 
 * 'directory': ファイルを検索するディレクトリ
 * 'hidden_files': 検索対象に隠しファイルを含める場合は 1、含めない場合は 0
-* 'data': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ
 * 'callback': 各ファイルに対して呼び出す関数、引数:
 ** 'void *data': ポインタ
 ** 'const char *filename': 見つかったファイルの名前
+* 'callback_data': WeeChat がコールバックを呼び出す際にコールバックに渡すポインタ
 
 C 言語での使用例:
 
@@ -2866,7 +2868,7 @@ void callback (void *data, const char *filename)
     /* ... */
 }
 ...
-weechat_exec_on_files ("/tmp", 0, NULL, &callback);
+weechat_exec_on_files ("/tmp", 0, &callback, NULL);
 ----
 
 [NOTE]