- Documented Transliterator::__construct. See bug #61244.

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

reference/intl/transliterator/construct.xml

@@ -4,7 +4,7 @@
 <refentry xml:id="transliterator.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Transliterator::__construct</refname>
-  <refpurpose>Construct a Transliterator object</refpurpose>
+  <refpurpose>Private constructor to deny instantiation</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
@@ -14,10 +14,13 @@
    <void />
   </constructorsynopsis>
   <para>
-   Constructs a transliterator object.
+   This method should not be called. Its only purpose is to deny instantiation
+   with the <link linkend="language.oop5.basic.new">new</link> operator.
+  </para>
+  <para>
+   Use the factory methods <methodname>Transliterator::create</methodname> or
+   <methodname>Transliterator::createFromRules</methodname> instead.
   </para>
-
-  &warn.undocumented.func;
 
  </refsect1>
 
@@ -29,7 +32,8 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   A transliterator object.
+   This method should not be executed. If it is (e.g. through reflection), then
+   its return value is unspecified.
   </para>
  </refsect1>
 
@@ -37,8 +41,8 @@
   &reftitle.seealso;
   <para>
    <simplelist>
-    <member><methodname>Transliterator::getErrorMessage</methodname></member>
     <member><methodname>Transliterator::create</methodname></member>
+    <member><methodname>Transliterator::createFromRules</methodname></member>
    </simplelist>
   </para>
  </refsect1>