From 3379a5403818033142bcf389d6ef30a203458a22 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Gustavo=20Andr=C3=A9=20dos=20Santos=20Lopes?=
 <cataphract@php.net>
Date: Sat, 3 Mar 2012 15:08:21 +0000
Subject: [PATCH] - 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 | 16 ++++++++++------
 1 file changed, 10 insertions(+), 6 deletions(-)

diff --git a/reference/intl/transliterator/construct.xml b/reference/intl/transliterator/construct.xml
index 26088e32f8..1338b22dba 100644
--- a/reference/intl/transliterator/construct.xml
+++ b/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>