From 72605fc9de80bd30f50b112e447326dfe6c2a523 Mon Sep 17 00:00:00 2001
From: "Christoph M. Becker" <cmbecker69@gmx.de>
Date: Sat, 5 Oct 2024 19:19:56 +0200
Subject: [PATCH] Move the parse_url() caution up to description section
 (GH-3834)

This information is apparently not widely known, so we put it in a
more prominent place.
---
 reference/url/functions/parse-url.xml | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/reference/url/functions/parse-url.xml b/reference/url/functions/parse-url.xml
index 8a81f60e5474..78d07261f3e8 100644
--- a/reference/url/functions/parse-url.xml
+++ b/reference/url/functions/parse-url.xml
@@ -24,6 +24,15 @@
    URLs are also accepted, <function>parse_url</function> tries its best to
    parse them correctly.
   </para>
+  <caution>
+   <para>
+    This function may not give correct results for relative or invalid URLs,
+    and the results may not even match common behavior of HTTP clients.
+    If URLs from untrusted input need to be parsed, extra validation is
+    required, e.g. by using <function>filter_var</function> with the
+    <constant>FILTER_VALIDATE_URL</constant> filter.
+   </para>
+  </caution>
  </refsect1>
 
  <refsect1 role="parameters">
@@ -252,15 +261,6 @@ array(3) {
 
  <refsect1 role="notes">
   &reftitle.notes;
-  <caution>
-   <para>
-    This function may not give correct results for relative or invalid URLs,
-    and the results may not even match common behavior of HTTP clients.
-    If URLs from untrusted input need to be parsed, extra validation is
-    required, e.g. by using <function>filter_var</function> with the
-    <constant>FILTER_VALIDATE_URL</constant> filter.
-   </para>
-  </caution>
   <note>
    <para>
     This function is intended specifically for the purpose of parsing URLs