From 8574a2c1bd1dee8283a9d05fc0bd21c36efd237b Mon Sep 17 00:00:00 2001
From: Daniel Egeberg <degeberg@php.net>
Date: Thu, 22 Jul 2010 17:47:40 +0000
Subject: [PATCH] Documented constructor changes in PHP 5.3.3.

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@301474 c90b9560-bf6c-de11-be94-00142212c4b1
---
 language/oop5/changelog.xml | 10 ++++++++++
 language/oop5/decon.xml     | 21 +++++++++++++++++++++
 2 files changed, 31 insertions(+)

diff --git a/language/oop5/changelog.xml b/language/oop5/changelog.xml
index d653439a46..bf49a09bc5 100644
--- a/language/oop5/changelog.xml
+++ b/language/oop5/changelog.xml
@@ -16,6 +16,16 @@
      </row>
     </thead>
     <tbody>
+     <row>
+      <entry>5.3.3</entry>
+      <entry>
+       Changed: Methods with the same name as the last element of
+       a <link linkend="language.namespaces">namespaced</link>
+       class name will no longer be treated as <link
+       linkend="language.oop5.decon">constructor</link>. This change doesn't
+       affect non-namespaced classes.
+      </entry>
+     </row>
      <row>
       <entry>5.3.0</entry>
       <entry>
diff --git a/language/oop5/decon.xml b/language/oop5/decon.xml
index b7337e2929..52e730f27e 100644
--- a/language/oop5/decon.xml
+++ b/language/oop5/decon.xml
@@ -62,6 +62,27 @@ $obj = new SubClass();
     <function>__construct</function> is overridden with different parameters
     than the parent <function>__construct</function> method has.
    </para>
+   <para>
+    As of PHP 5.3.3, methods with the same name as the last element of a
+    namespaced class name will no longer be treated as constructor. This
+    change doesn't affect non-namespaced classes.
+   </para>
+   <example>
+    <title>Constructors in namespaced classes</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+namespace Foo;
+class Bar {
+    public function Bar() {
+        // treated as constructor in PHP 5.3.0-5.3.2
+        // treated as regular method as of PHP 5.3.3
+    }
+}
+?>
+]]>
+    </programlisting>
+   </example>
   </sect2>
 
   <sect2 xml:id="language.oop5.decon.destructor">