From ba6c8f0a43327de6da4e091d8d56d0960d1249ad Mon Sep 17 00:00:00 2001
From: Christian Weiske <cweiske+github.com-2025@cweiske.de>
Date: Tue, 3 Mar 2026 15:38:25 +0100
Subject: [PATCH] Document special handling for "&" in SimpleXml::addChild()

See the comments section for that page: https://www.php.net/manual/en/simplexmlelement.addchild.php
---
 reference/simplexml/simplexmlelement/addChild.xml | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/reference/simplexml/simplexmlelement/addChild.xml b/reference/simplexml/simplexmlelement/addChild.xml
index 222c4ba0684a..3fd8f0c0a4f4 100644
--- a/reference/simplexml/simplexmlelement/addChild.xml
+++ b/reference/simplexml/simplexmlelement/addChild.xml
@@ -38,6 +38,10 @@
       <para>
        If specified, the value of the child element.
       </para>
+      <para>
+       Special characters <literal>&lt;</literal> and <literal>&gt;</literal> get escaped
+       automatically, <literal>&amp;</literal> must be escaped manually.
+      </para>
      </listitem>
     </varlistentry>
     <varlistentry>