Fix #73750: Additions to documentation on iconv() //TRANSLIT option

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

reference/iconv/functions/iconv.xml

@@ -49,6 +49,15 @@
        discarded. Otherwise, <constant>E_NOTICE</constant> is generated and the function
        will return &false;.
       </para>
+      <caution>
+       <para>
+        If and how <literal>//TRANSLIT</literal> works exactly depends on the
+        system's iconv() implementation (cf. <constant>ICONV_IMPL</constant>).
+        Some implementations are known to ignore <literal>//TRANSLIT</literal>,
+        so the conversion is likely to fail for characters which are illegal for
+        the <parameter>out_charset</parameter>.
+       </para>
+      </caution>
      </listitem>
     </varlistentry>
     <varlistentry>