From 2bf03aa27737c929c93356e585b800f414142acc Mon Sep 17 00:00:00 2001
From: lacatoire <la.catoire@gmail.com>
Date: Tue, 25 Aug 2026 10:14:28 +0200
Subject: [PATCH] [Sync-En] curl_errno/curl_error: document CurlHandle
 parameter type

Closes: php/doc-fr#3337
---
 reference/curl/functions/curl-errno.xml | 13 +++++++++++--
 reference/curl/functions/curl-error.xml | 15 +++++++++++++--
 2 files changed, 24 insertions(+), 4 deletions(-)

diff --git a/reference/curl/functions/curl-errno.xml b/reference/curl/functions/curl-errno.xml
index e2748aa1ff..c563fdf31e 100644
--- a/reference/curl/functions/curl-errno.xml
+++ b/reference/curl/functions/curl-errno.xml
@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: fc9a0a8b29a7a099998bdd71fe5350a10b18fe62 Maintainer: Fan2Shrek Status: ready -->
-<!-- Reviewed: no -->
+<!-- EN-Revision: ff7a0054b19ab80290b365d1417550807f82755a Maintainer: Fan2Shrek Status: ready -->
 <refentry xml:id="function.curl-errno" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>curl_errno</refname>
@@ -32,6 +31,15 @@
   <para>
    Retourne le numéro de l'erreur ou <literal>0</literal> si aucune erreur n'est survenue.
   </para>
+  <note>
+   <simpara>
+    Lorsqu'un <type>CurlHandle</type> est exécuté via
+    <function>curl_multi_exec</function>, cette fonction retourne toujours
+    <literal>0</literal>. Le code d'erreur pour chaque handle individuel est
+    disponible via la clé <literal>result</literal> retournée par
+    <function>curl_multi_info_read</function>.
+   </simpara>
+  </note>
  </refsect1>
 
  <refsect1 role="changelog">
@@ -83,6 +91,7 @@ if(curl_errno($ch))
   <para>
    <simplelist>
     <member><function>curl_error</function></member>
+    <member><function>curl_multi_info_read</function></member>
     <member><link xlink:href="&url.curl.error;">les codes erreurs cURL</link></member>
    </simplelist>
   </para>
diff --git a/reference/curl/functions/curl-error.xml b/reference/curl/functions/curl-error.xml
index d316364972..51112b4618 100644
--- a/reference/curl/functions/curl-error.xml
+++ b/reference/curl/functions/curl-error.xml
@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: fc9a0a8b29a7a099998bdd71fe5350a10b18fe62 Maintainer: Fan2Shrek Status: ready -->
-<!-- Reviewed: no -->
+<!-- EN-Revision: ff7a0054b19ab80290b365d1417550807f82755a Maintainer: Fan2Shrek Status: ready -->
 <refentry xml:id="function.curl-error" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>curl_error</refname>
@@ -33,6 +32,16 @@
    Retourne le message d'erreur ou <literal>''</literal> (chaîne vide) si aucune
    erreur n'est survenue.
   </para>
+  <note>
+   <simpara>
+    Lorsqu'un <type>CurlHandle</type> est exécuté via
+    <function>curl_multi_exec</function>, cette fonction retourne toujours
+    <literal>''</literal> (chaîne vide). Pour récupérer le message d'erreur pour
+    chaque handle individuel, passer la clé <literal>result</literal> retournée par
+    <function>curl_multi_info_read</function> à
+    <function>curl_strerror</function>.
+   </simpara>
+  </note>
  </refsect1>
 
  <refsect1 role="changelog">
@@ -84,6 +93,8 @@ else
   <para>
    <simplelist>
     <member><function>curl_errno</function></member>
+    <member><function>curl_strerror</function></member>
+    <member><function>curl_multi_info_read</function></member>
     <member><link xlink:href="&url.curl.error;">Curl error codes</link></member>
    </simplelist>
   </para>