[doc-en] master: ext/curl: Fix inaccurate notes in `curl_errno()` and `curl_error()` (#5884)
| From: | KentarouTakeda via GitHub | Date: | Sat, 26 Sep 2026 05:34:14 +0000 |
| Subject: | [doc-en] master: ext/curl: Fix inaccurate notes in `curl_errno()` and `curl_error()` (#5884) | ||
| Groups: | php.doc.cvs | ||
| Request: | Send a blank email to doc-cvs+get-23780@lists.php.net to get a copy of this message | ||
Author: KentarouTakeda (KentarouTakeda)
Committer: GitHub (web-flow)
Pusher: lacatoire
Date: 2026-09-26T07:34:11+02:00
Commit: https://github.com/php/doc-en/commit/fa9bae0f65aec476264cf4f828ac9fe253f9839b
Raw diff: https://github.com/php/doc-en/commit/fa9bae0f65aec476264cf4f828ac9fe253f9839b.diff
ext/curl: Fix inaccurate notes in
curl_errno() and curl_error() (#5884)
Changed paths:
M reference/curl/functions/curl-errno.xml
M reference/curl/functions/curl-error.xml
Diff:
diff --git a/reference/curl/functions/curl-errno.xml b/reference/curl/functions/curl-errno.xml
index 7b9f97b97c49..5010ccfe115f 100644
--- a/reference/curl/functions/curl-errno.xml
+++ b/reference/curl/functions/curl-errno.xml
@@ -35,10 +35,11 @@
<note>
<simpara>
When a <type>CurlHandle</type> is executed via
- <function>curl_multi_exec</function>, this function always returns
- <literal>0</literal>. The error code for each individual handle is
- available as the <literal>result</literal> key returned by
- <function>curl_multi_info_read</function>.
+ <function>curl_multi_exec</function>, this function returns
+ <literal>0</literal> until <function>curl_multi_info_read</function>
+ has returned the message for that handle. The error code for each
+ individual handle is available as the <literal>result</literal> key
+ returned by <function>curl_multi_info_read</function>.
</simpara>
</note>
</refsect1>
diff --git a/reference/curl/functions/curl-error.xml b/reference/curl/functions/curl-error.xml
index 166b9cc499f7..02e890c5d60e 100644
--- a/reference/curl/functions/curl-error.xml
+++ b/reference/curl/functions/curl-error.xml
@@ -35,9 +35,11 @@
<note>
<simpara>
When a <type>CurlHandle</type> is executed via
- <function>curl_multi_exec</function>, this function always returns
- <literal>''</literal> (the empty string). To retrieve the error string
for
- each individual handle, pass the <literal>result</literal> key returned by
+ <function>curl_multi_exec</function>, this function returns
+ <literal>''</literal> (the empty string) until
+ <function>curl_multi_info_read</function> has returned the message for
+ that handle. To retrieve the error string for each individual handle,
+ pass the <literal>result</literal> key returned by
<function>curl_multi_info_read</function> to
<function>curl_strerror</function>.
</simpara>