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
This commit is contained in:
Christoph Michael Becker 2020-09-20 15:35:17 +00:00
parent 5b39b84a3b
commit 9ea98fa298

View file

@ -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>