api: add function file_compare (issue #2250)

doc/en/weechat_plugin_api.en.adoc

@@ -4624,6 +4624,43 @@ if (weechat_file_compress ("/tmp/test.txt", "/tmp/test.txt.zst", "zstd", 50))
 [NOTE]
 This function is not available in scripting API.
 
+==== file_compare
+
+_WeeChat ≥ 4.7.0._
+
+Compare the content of two files.
+
+Prototype:
+
+[source,c]
+----
+int weechat_file_compare (const char *filename1, const char *filename2);
+----
+
+Arguments:
+
+* _filename1_: first file to compare
+* _filename2_: second file to compare
+
+Return value:
+
+* 0: both files have same content
+* 1: content is different
+* 2: error (file not found or read error)
+
+C example:
+
+[source,c]
+----
+if (weechat_file_compare ("/tmp/test.txt", "/tmp/test2.txt") == 0)
+{
+    /* same content */
+}
+----
+
+[NOTE]
+This function is not available in scripting API.
+
 [[util]]
 === Util
 

doc/fr/weechat_plugin_api.fr.adoc

@@ -4703,6 +4703,43 @@ if (weechat_file_compress ("/tmp/test.txt", "/tmp/test.txt.zst", "zstd", 50))
 [NOTE]
 Cette fonction n'est pas disponible dans l'API script.
 
+==== file_compare
+
+_WeeChat ≥ 4.7.0._
+
+Compare the content of two files.
+
+Prototype:
+
+[source,c]
+----
+int weechat_file_compare (const char *filename1, const char *filename2);
+----
+
+Arguments:
+
+* _filename1_: first file to compare
+* _filename2_: second file to compare
+
+Return value:
+
+* 0: both files have same content
+* 1: content is different
+* 2: error (file not found or read error)
+
+C example:
+
+[source,c]
+----
+if (weechat_file_compare ("/tmp/test.txt", "/tmp/test2.txt") == 0)
+{
+    /* same content */
+}
+----
+
+[NOTE]
+This function is not available in scripting API.
+
 [[util]]
 === Util
 

doc/it/weechat_plugin_api.it.adoc

@@ -4831,6 +4831,44 @@ if (weechat_file_compress ("/tmp/test.txt", "/tmp/test.txt.zst", "zstd", 50))
 [NOTE]
 Questa funzione non è disponibile nelle API per lo scripting.
 
+// TRANSLATION MISSING
+==== file_compare
+
+_WeeChat ≥ 4.7.0._
+
+Compare the content of two files.
+
+Prototipo:
+
+[source,c]
+----
+int weechat_file_compare (const char *filename1, const char *filename2);
+----
+
+Argomenti:
+
+* _filename1_: first file to compare
+* _filename2_: second file to compare
+
+Valore restituito:
+
+* 0: both files have same content
+* 1: content is different
+* 2: error (file not found or read error)
+
+Esempio in C:
+
+[source,c]
+----
+if (weechat_file_compare ("/tmp/test.txt", "/tmp/test2.txt") == 0)
+{
+    /* same content */
+}
+----
+
+[NOTE]
+Questa funzione non è disponibile nelle API per lo scripting.
+
 [[util]]
 === Utilità
 

doc/ja/weechat_plugin_api.ja.adoc

@@ -4756,6 +4756,44 @@ if (weechat_file_compress ("/tmp/test.txt", "/tmp/test.txt.zst", "zstd", 50))
 [NOTE]
 スクリプト API ではこの関数を利用できません。
 
+// TRANSLATION MISSING
+==== file_compare
+
+_WeeChat ≥ 4.7.0._
+
+Compare the content of two files.
+
+プロトタイプ:
+
+[source,c]
+----
+int weechat_file_compare (const char *filename1, const char *filename2);
+----
+
+引数:
+
+* _filename1_: first file to compare
+* _filename2_: second file to compare
+
+戻り値:
+
+* 0: both files have same content
+* 1: content is different
+* 2: error (file not found or read error)
+
+C 言語での使用例:
+
+[source,c]
+----
+if (weechat_file_compare ("/tmp/test.txt", "/tmp/test2.txt") == 0)
+{
+    /* same content */
+}
+----
+
+[NOTE]
+スクリプト API ではこの関数を利用できません。
+
 [[util]]
 === ユーティリティ
 

doc/sr/weechat_plugin_api.sr.adoc

@@ -4484,6 +4484,44 @@ if (weechat_file_compress ("/tmp/test.txt", "/tmp/test.txt.zst", "zstd", 50))
 [NOTE]
 Ова функција није доступна у API скриптовања.
 
+// TRANSLATION MISSING
+==== file_compare
+
+_WeeChat ≥ 4.7.0._
+
+Compare the content of two files.
+
+Прототип:
+
+[source,c]
+----
+int weechat_file_compare (const char *filename1, const char *filename2);
+----
+
+Аргументи:
+
+* _filename1_: first file to compare
+* _filename2_: second file to compare
+
+Повратна вредност:
+
+* 0: both files have same content
+* 1: content is different
+* 2: error (file not found or read error)
+
+C пример:
+
+[source,c]
+----
+if (weechat_file_compare ("/tmp/test.txt", "/tmp/test2.txt") == 0)
+{
+    /* same content */
+}
+----
+
+[NOTE]
+Ова функција није доступна у API скриптовања.
+
 [[util]]
 === Алати