From 2b59a8e888e68bf8330256d0548924b3d0b26b61 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?S=C3=A9bastien=20Helleu?= <flashcode@flashtux.org>
Date: Sat, 15 Nov 2025 17:26:49 +0100
Subject: [PATCH] doc/api: add "error_code" and "error_code_pthread" in
 hook_url output hashtable (issue #2284)

---
 doc/en/weechat_plugin_api.en.adoc | 10 ++++++++++
 doc/fr/weechat_plugin_api.fr.adoc | 10 ++++++++++
 doc/it/weechat_plugin_api.it.adoc | 10 ++++++++++
 doc/ja/weechat_plugin_api.ja.adoc | 10 ++++++++++
 doc/sr/weechat_plugin_api.sr.adoc | 10 ++++++++++
 5 files changed, 50 insertions(+)

diff --git a/doc/en/weechat_plugin_api.en.adoc b/doc/en/weechat_plugin_api.en.adoc
index 0ec146f58..eea30f5ab 100644
--- a/doc/en/weechat_plugin_api.en.adoc
+++ b/doc/en/weechat_plugin_api.en.adoc
@@ -11064,6 +11064,16 @@ Arguments:
 *** _headers_: HTTP headers in response
 *** _output_: standard output (set only if _file_out_ was not set in options)
 *** _error_: error message (set only in case of error)
+*** _error_code_: error code (integer, set only in case of error):
+**** `1`: invalid URL
+**** `2`: transfer error (Curl error)
+**** `3`: not enough memory
+**** `4`: file error
+**** `5`: transfer stopped (hook removed during the transfer)
+**** `6`: transfer timeout
+**** `100`: thread creation error
+*** _error_code_pthread_: return code of function _pthread_create_
+    (integer, set only if _error_code_ is `100`)
 ** return value:
 *** _WEECHAT_RC_OK_
 *** _WEECHAT_RC_ERROR_
diff --git a/doc/fr/weechat_plugin_api.fr.adoc b/doc/fr/weechat_plugin_api.fr.adoc
index 9217ca5b4..70f8317cd 100644
--- a/doc/fr/weechat_plugin_api.fr.adoc
+++ b/doc/fr/weechat_plugin_api.fr.adoc
@@ -11270,6 +11270,16 @@ Paramètres :
 *** _output_ : sortie standard (défini seulement si _file_out_ n'était pas défini
     dans les options)
 *** _error_ : message d'erreur (défini seulement en cas d'erreur)
+*** _error_code_ : code d'erreur (entier, défini seulement en cas d'erreur) :
+**** `1` : URL invalide
+**** `2` : erreur de transfert (erreur Curl)
+**** `3` : mémoire insuffisante
+**** `4` : erreur de fichier
+**** `5` : transfert stoppé (hook supprimé durant le transfert)
+**** `6` : délai d'attente dépassé pour le transfert ("timeout")
+**** `100` : erreur de création du thread
+*** _error_code_pthread_ : code retour de la fonction _pthread_create_
+    (entier, défini seulement si _error_code_ vaut `100`)
 ** valeur de retour :
 *** _WEECHAT_RC_OK_
 *** _WEECHAT_RC_ERROR_
diff --git a/doc/it/weechat_plugin_api.it.adoc b/doc/it/weechat_plugin_api.it.adoc
index 10410d44c..2fd3278db 100644
--- a/doc/it/weechat_plugin_api.it.adoc
+++ b/doc/it/weechat_plugin_api.it.adoc
@@ -11475,6 +11475,16 @@ Argomenti:
 *** _headers_: HTTP headers in response
 *** _output_: standard output (set only if _file_out_ was not set in options)
 *** _error_: error message (set only in case of error)
+*** _error_code_: error code (integer, set only in case of error):
+**** `1`: invalid URL
+**** `2`: transfer error (Curl error)
+**** `3`: not enough memory
+**** `4`: file error
+**** `5`: transfer stopped (hook removed during the transfer)
+**** `6`: transfer timeout
+**** `100`: thread creation error
+*** _error_code_pthread_: return code of function _pthread_create_
+    (integer, set only if _error_code_ is `100`)
 ** return value:
 *** _WEECHAT_RC_OK_
 *** _WEECHAT_RC_ERROR_
diff --git a/doc/ja/weechat_plugin_api.ja.adoc b/doc/ja/weechat_plugin_api.ja.adoc
index 51c6a71b1..6f33cf025 100644
--- a/doc/ja/weechat_plugin_api.ja.adoc
+++ b/doc/ja/weechat_plugin_api.ja.adoc
@@ -11209,6 +11209,16 @@ struct t_hook *weechat_hook_url (const char *url,
 *** _headers_: HTTP headers in response
 *** _output_: standard output (set only if _file_out_ was not set in options)
 *** _error_: error message (set only in case of error)
+*** _error_code_: error code (integer, set only in case of error):
+**** `1`: invalid URL
+**** `2`: transfer error (Curl error)
+**** `3`: not enough memory
+**** `4`: file error
+**** `5`: transfer stopped (hook removed during the transfer)
+**** `6`: transfer timeout
+**** `100`: thread creation error
+*** _error_code_pthread_: return code of function _pthread_create_
+    (integer, set only if _error_code_ is `100`)
 ** return value:
 *** _WEECHAT_RC_OK_
 *** _WEECHAT_RC_ERROR_
diff --git a/doc/sr/weechat_plugin_api.sr.adoc b/doc/sr/weechat_plugin_api.sr.adoc
index cb7bd2f71..908899977 100644
--- a/doc/sr/weechat_plugin_api.sr.adoc
+++ b/doc/sr/weechat_plugin_api.sr.adoc
@@ -10781,6 +10781,16 @@ struct t_hook *weechat_hook_url (const char *url,
 *** _headers_: HTTP заглавља у одзиву
 *** _output_: стандардни излаз (поставља се само ако у опцијама није постављено _file_out_)
 *** _error_: порука о грешки (поставља се само у случају грешке)
+*** _error_code_: error code (integer, set only in case of error):
+**** `1`: invalid URL
+**** `2`: transfer error (Curl error)
+**** `3`: not enough memory
+**** `4`: file error
+**** `5`: transfer stopped (hook removed during the transfer)
+**** `6`: transfer timeout
+**** `100`: thread creation error
+*** _error_code_pthread_: return code of function _pthread_create_
+    (integer, set only if _error_code_ is `100`)
 ** повратна вредност:
 *** _WEECHAT_RC_OK_
 *** _WEECHAT_RC_ERROR_