mfischer Mon Jun 10 06:51:59 2002 EDT
Modified files:
/phpdoc/en/language oop.xml references.xml
Log:
- Document that we have @new but not @&new or &@new, closes #14094.
Index: phpdoc/en/language/oop.xml
diff -u phpdoc/en/language/oop.xml:1.35 phpdoc/en/language/oop.xml:1.36
--- phpdoc/en/language/oop.xml:1.35 Mon Jun 10 04:43:11 2002
+++ phpdoc/en/language/oop.xml Mon Jun 10 06:51:57 2002
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.35 $ -->
+<!-- $Revision: 1.36 $ -->
<chapter id="language.oop">
<title>Classes and Objects</title>
@@ -343,6 +343,12 @@
]]>
</programlisting>
</informalexample>
+
+ <para>
+ You also can use the <literal>@</literal> operator to
+ <emphasis>mute</emphasis> errors occuring in the constructor, e.g.
+ <literal>@new</literal>.
+ </para>
<caution>
<simpara>
Index: phpdoc/en/language/references.xml
diff -u phpdoc/en/language/references.xml:1.22 phpdoc/en/language/references.xml:1.23
--- phpdoc/en/language/references.xml:1.22 Wed Dec 12 16:29:56 2001
+++ phpdoc/en/language/references.xml Mon Jun 10 06:51:58 2002
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.22 $ -->
+<!-- $Revision: 1.23 $ -->
<chapter id="language.references">
<title>References Explained</title>
@@ -62,6 +62,13 @@
<literal>$this</literal> will operate on the copy, which is not always
what is desired. Usually you want to have a single instance to work with,
due to performance and memory consumption issues.
+ </para>
+ <para>
+ While you can use the <literal>@</literal> operator to
+ <emphasis>mute</emphasis> any errors in the constructor when using it as
+ <literal>@new</literal>, this does not work when using the
+ <literal>&new</literal> statement. This is a limitation of the Zend
+ Engine and will therefore result in a parser error.
</para>
</note>
<para>
