Document behavior of xmlwriter_text() wrt. special XML characters

git-svn-id: https://svn.php.net/repository/phpdoc/ja/trunk@350612 c90b9560-bf6c-de11-be94-00142212c4b1

Author: Yoshinari Takaoka

reference/xmlwriter/functions/xmlwriter-text.xml

@@ -1,7 +1,8 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 0d604bbc9d3b741d53e7fac26f5b24c306751e9a Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 9ea98fa2983ad86d94f96d45782f2ea26fb7ba53 Maintainer: takagi Status: ready -->
 <!-- Generated by xml_proto.php v2.4. Found in /scripts directory of phpdoc. -->
+<!-- Credits: mumumu -->
 <refentry xml:id="function.xmlwriter-text" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>XMLWriter::text</refname>
@@ -35,6 +36,13 @@
      <listitem>
       <para>
        テキストの内容。
+       <literal>&lt;</literal>, <literal>&gt;</literal>,
+       <literal>&amp;</literal>, <literal>"</literal> は、実体参照として書き込みます。
+       (つまり、 <literal>&amp;lt;</literal>, <literal>&amp;gt;</literal>,
+       <literal>&amp;amp;</literal>, <literal>&amp;quot;</literal>, をそれぞれ書き込みます)。
+       それ以外の文字は、<literal>&apos;</literal> を含めてそのまま書き込みます。
+       XML で特別な文字や、実体参照をそのまま書き込むには、
+       <function>xmlwriter_write_raw</function> を使わなければなりません。
       </para>
      </listitem>
     </varlistentry>