From 6aec3211d170d687b2eb078c11d7b91c2d314b39 Mon Sep 17 00:00:00 2001
From: oltho <oltho@10.171.131.59>
Date: Fri, 20 Sep 2019 16:17:21 +0200
Subject: [PATCH] Documentation Class Instantiation

---
 .../Classes/ClassInstantiationStandard.xml    | 53 +++++++++++++++++++
 1 file changed, 53 insertions(+)
 create mode 100644 WordPress/Docs/Classes/ClassInstantiationStandard.xml

diff --git a/WordPress/Docs/Classes/ClassInstantiationStandard.xml b/WordPress/Docs/Classes/ClassInstantiationStandard.xml
new file mode 100644
index 0000000000..b25fd34ce7
--- /dev/null
+++ b/WordPress/Docs/Classes/ClassInstantiationStandard.xml
@@ -0,0 +1,53 @@
+<documentation title="Class Instantiation">
+    <standard>
+    <![CDATA[
+    Instantiation of an object should be done with parenthesis.  
+    ]]>
+    </standard>
+    <code_comparison>
+        <code title="Valid: with parenthesis.">
+        <![CDATA[
+$a = new Foobar<em>()</em>;
+        ]]>
+        </code>
+        <code title="Invalid: without parenthesis.">
+        <![CDATA[
+$a = new Foobar;
+        ]]>
+        </code>
+    </code_comparison>
+    <standard>
+    <![CDATA[
+    Don't use spaces between object name and open parenthesis when instantiating new object.  
+    ]]>
+    </standard>
+    <code_comparison>
+        <code title="Valid: no spaces between object name and parenthesis.">
+        <![CDATA[
+$a = new Foobar();
+        ]]>
+        </code>
+        <code title="Invalid: spaces between object name and parenthesis.">
+        <![CDATA[
+$a = new Foobar<em> </em>();
+        ]]>
+        </code>
+    </code_comparison>
+    <standard>
+    <![CDATA[
+    Object instantiation by reference is not supported by PHP anymore.  
+    ]]>
+    </standard>
+    <code_comparison>
+        <code title="Valid: object instantiation without reference.">
+        <![CDATA[
+$a = new Foobar();
+        ]]>
+        </code>
+        <code title="Invalid: object instantiation by reference.">
+        <![CDATA[
+$a = <em>&</em> new Foobar();
+        ]]>
+        </code>
+    </code_comparison>
+</documentation>