From 9ea98fa2983ad86d94f96d45782f2ea26fb7ba53 Mon Sep 17 00:00:00 2001
From: Christoph Michael Becker <cmb@php.net>
Date: Sun, 20 Sep 2020 15:35:17 +0000
Subject: [PATCH] Document behavior of xmlwriter_text() wrt. special XML
 characters

This integrates user notes 122901 and 122912.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@350604 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/xmlwriter/functions/xmlwriter-text.xml | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/reference/xmlwriter/functions/xmlwriter-text.xml b/reference/xmlwriter/functions/xmlwriter-text.xml
index 67f6dc58cb..ee860ac434 100644
--- a/reference/xmlwriter/functions/xmlwriter-text.xml
+++ b/reference/xmlwriter/functions/xmlwriter-text.xml
@@ -34,6 +34,13 @@
      <listitem>
       <para>
        The contents of the text.
+       The characters <literal>&lt;</literal>, <literal>&gt;</literal>,
+       <literal>&amp;</literal> and <literal>"</literal> are written as
+       entity references (i.e. <literal>&amp;lt;</literal>, <literal>&amp;gt;</literal>,
+       <literal>&amp;amp;</literal> and <literal>&amp;quot;</literal>, respectively).
+       All other characters including <literal>&apos;</literal> are written literally.
+       To write the special XML characters literally, or to write literal entity references,
+       <function>xmlwriter_write_raw</function> has to be used.
       </para>
      </listitem>
     </varlistentry>