From f9202b651d126b52612e9740af3beb84ea0977fc Mon Sep 17 00:00:00 2001
From: Justin Martin <frozenfire@php.net>
Date: Sun, 27 May 2012 23:08:29 +0000
Subject: [PATCH] Documented many undocumented ReflectionClass methods. Removed
 undocumented warnings from a couple of documented methods. Removed $default
 parameter from ReflectionClass::getStaticPropertyValue method documentation,
 as its behaviour is undefined and seems to exist only as an artefact.

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@325878 c90b9560-bf6c-de11-be94-00142212c4b1
---
 .../reflection/reflectionclass/export.xml     |  54 ++++++++-
 .../reflectionclass/getconstructor.xml        |  39 ++++++-
 .../reflectionclass/getextension.xml          |  36 +++++-
 .../reflectionclass/getextensionname.xml      |  32 +++++-
 .../reflection/reflectionclass/getmethod.xml  |  35 +++++-
 .../reflection/reflectionclass/getmethods.xml | 107 +++++++++++++++++-
 .../reflectionclass/getproperty.xml           |  35 +++++-
 .../getstaticpropertyvalue.xml                |  44 ++++---
 .../reflectionclass/iscloneable.xml           |  41 ++++++-
 .../reflectionclass/isinstantiable.xml        |   6 +-
 .../reflectionclass/isinterface.xml           |  32 +++++-
 .../reflection/reflectionclass/isinternal.xml |  35 +++++-
 .../reflectionclass/newinstanceargs.xml       |  29 ++++-
 13 files changed, 462 insertions(+), 63 deletions(-)

diff --git a/reference/reflection/reflectionclass/export.xml b/reference/reflection/reflectionclass/export.xml
index 4577592afc..4a3597745b 100644
--- a/reference/reflection/reflectionclass/export.xml
+++ b/reference/reflection/reflectionclass/export.xml
@@ -18,8 +18,6 @@
    Exports a reflected class.
   </para>
 
-  &warn.undocumented.func;
-
  </refsect1>
 
  <refsect1 role="parameters">
@@ -52,6 +50,58 @@
    &reflection.export.return;
   </para>
  </refsect1>
+ 
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title>Basic usage of <methodname>ReflectionClass::export</methodname></title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+class Apple {
+    public $var1;
+    public $var2 = 'Orange';
+
+    public function type() {
+        return 'Apple';
+    }
+}
+ReflectionClass::export('Apple');
+?>
+]]>
+    </programlisting>
+    &example.outputs.similar;
+    <screen>
+<![CDATA[
+Class [ <user> class Apple ] {
+  @@ php shell code 1-8
+
+  - Constants [0] {
+  }
+
+  - Static properties [0] {
+  }
+
+  - Static methods [0] {
+  }
+
+  - Properties [2] {
+    Property [ <default> public $var1 ]
+    Property [ <default> public $var2 ]
+  }
+
+  - Methods [1] {
+    Method [ <user> public method type ] {
+      @@ php shell code 5 - 7
+    }
+  }
+}
+]]>
+    </screen>
+   </example>
+  </para>
+ </refsect1>
 
  <refsect1 role="seealso">
   &reftitle.seealso;
diff --git a/reference/reflection/reflectionclass/getconstructor.xml b/reference/reflection/reflectionclass/getconstructor.xml
index ca72e37706..28a0e9b612 100644
--- a/reference/reflection/reflectionclass/getconstructor.xml
+++ b/reference/reflection/reflectionclass/getconstructor.xml
@@ -4,21 +4,19 @@
 <refentry xml:id="reflectionclass.getconstructor" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>ReflectionClass::getConstructor</refname>
-  <refpurpose>Gets constructor</refpurpose>
+  <refpurpose>Gets the constructor of the class</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <modifier>public</modifier> <type>object</type> <methodname>ReflectionClass::getConstructor</methodname>
+   <modifier>public</modifier> <type>ReflectionMethod</type> <methodname>ReflectionClass::getConstructor</methodname>
    <void />
   </methodsynopsis>
   <para>
-   Gets the constructor from a class.
+   Gets the constructor of the reflected class.
   </para>
 
-  &warn.undocumented.func;
-
  </refsect1>
 
  <refsect1 role="parameters">
@@ -29,7 +27,36 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   A <classname>ReflectionMethod</classname> object.
+   A <classname>ReflectionMethod</classname> object reflecting the class' constructor.
+  </para>
+ </refsect1>
+ 
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title>Basic usage of <methodname>ReflectionClass::getConstructor</methodname></title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$class = new ReflectionClass('ReflectionClass');
+$constructor = $class->getConstructor();
+var_dump($constructor);
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen>
+<![CDATA[
+object(ReflectionMethod)#2 (2) {
+  ["name"]=>
+  string(11) "__construct"
+  ["class"]=>
+  string(15) "ReflectionClass"
+}
+]]>
+    </screen>
+   </example>
   </para>
  </refsect1>
 
diff --git a/reference/reflection/reflectionclass/getextension.xml b/reference/reflection/reflectionclass/getextension.xml
index 5e9e84b4ac..828c895e99 100644
--- a/reference/reflection/reflectionclass/getextension.xml
+++ b/reference/reflection/reflectionclass/getextension.xml
@@ -4,7 +4,7 @@
 <refentry xml:id="reflectionclass.getextension" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>ReflectionClass::getExtension</refname>
-  <refpurpose>Gets extension info</refpurpose>
+  <refpurpose>Gets a <classname>ReflectionExtension</classname> object for the extension which defined the class</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
@@ -14,11 +14,9 @@
    <void />
   </methodsynopsis>
   <para>
-   Gets an extensions <classname>ReflectionExtension</classname> object.
+   Gets a <classname>ReflectionExtension</classname> object for the extension which defined the class.
   </para>
 
-  &warn.undocumented.func;
-
  </refsect1>
 
  <refsect1 role="parameters">
@@ -29,7 +27,35 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   A <classname>ReflectionExtension</classname> object.
+   A <classname>ReflectionExtension</classname> object representing the extension which defined the class,
+   or &null; for user-defined classes.
+  </para>
+ </refsect1>
+ 
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title>Basic usage of <methodname>ReflectionClass::getExtension</methodname></title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$class = new ReflectionClass('ReflectionClass');
+$extension = $class->getExtension();
+var_dump($extension);
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen>
+<![CDATA[
+object(ReflectionExtension)#2 (1) {
+  ["name"]=>
+  string(10) "Reflection"
+}
+]]>
+    </screen>
+   </example>
   </para>
  </refsect1>
 
diff --git a/reference/reflection/reflectionclass/getextensionname.xml b/reference/reflection/reflectionclass/getextensionname.xml
index c354812d46..8bf07ec03f 100644
--- a/reference/reflection/reflectionclass/getextensionname.xml
+++ b/reference/reflection/reflectionclass/getextensionname.xml
@@ -4,7 +4,7 @@
 <refentry xml:id="reflectionclass.getextensionname" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>ReflectionClass::getExtensionName</refname>
-  <refpurpose>Gets an extensions name</refpurpose>
+  <refpurpose>Gets the name of the extension which defined the class</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
@@ -14,11 +14,9 @@
    <void />
   </methodsynopsis>
   <para>
-   Gets an extensions name.
+   Gets the name of the extension which defined the class.
   </para>
 
-  &warn.undocumented.func;
-
  </refsect1>
 
  <refsect1 role="parameters">
@@ -29,7 +27,31 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   The extensions name.
+   The name of the extension which defined the class, or &false; for user-defined classes.
+  </para>
+ </refsect1>
+ 
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title>Basic usage of <methodname>ReflectionClass::getExtensionName</methodname></title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$class = new ReflectionClass('ReflectionClass');
+$extension = $class->getExtensionName();
+var_dump($extension);
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen>
+<![CDATA[
+string(10) "Reflection"
+]]>
+    </screen>
+   </example>
   </para>
  </refsect1>
 
diff --git a/reference/reflection/reflectionclass/getmethod.xml b/reference/reflection/reflectionclass/getmethod.xml
index 18971ebcdb..14a73f17ce 100644
--- a/reference/reflection/reflectionclass/getmethod.xml
+++ b/reference/reflection/reflectionclass/getmethod.xml
@@ -4,7 +4,7 @@
 <refentry xml:id="reflectionclass.getmethod" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>ReflectionClass::getMethod</refname>
-  <refpurpose>Gets a ReflectionMethod</refpurpose>
+  <refpurpose>Gets a <classname>ReflectionMethod</classname> for a class method.</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
@@ -14,11 +14,9 @@
    <methodparam><type>string</type><parameter>name</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Gets a <classname>ReflectionMethod</classname> about a method.
+   Gets a <classname>ReflectionMethod</classname> for a class method.
   </para>
 
-  &warn.undocumented.func;
-
  </refsect1>
 
  <refsect1 role="parameters">
@@ -43,6 +41,35 @@
    A <classname>ReflectionMethod</classname>.
   </para>
  </refsect1>
+ 
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title>Basic usage of <methodname>ReflectionClass::getMethod</methodname></title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$class = new ReflectionClass('ReflectionClass');
+$method = $class->getMethod('getMethod');
+var_dump($method);
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen>
+<![CDATA[
+object(ReflectionMethod)#2 (2) {
+  ["name"]=>
+  string(9) "getMethod"
+  ["class"]=>
+  string(15) "ReflectionClass"
+}
+]]>
+    </screen>
+   </example>
+  </para>
+ </refsect1>
 
  <refsect1 role="seealso">
   &reftitle.seealso;
diff --git a/reference/reflection/reflectionclass/getmethods.xml b/reference/reflection/reflectionclass/getmethods.xml
index 7dbd6ed780..7cc7cef64b 100644
--- a/reference/reflection/reflectionclass/getmethods.xml
+++ b/reference/reflection/reflectionclass/getmethods.xml
@@ -4,7 +4,7 @@
 <refentry xml:id="reflectionclass.getmethods" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>ReflectionClass::getMethods</refname>
-  <refpurpose>Gets a list of methods</refpurpose>
+  <refpurpose>Gets an array of methods</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
@@ -14,11 +14,8 @@
    <methodparam choice="opt"><type>string</type><parameter>filter</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Gets a list of methods.
+   Gets an array of methods for the class.
   </para>
-
-  &warn.undocumented.func;
-
  </refsect1>
 
  <refsect1 role="parameters">
@@ -28,6 +25,10 @@
     <varlistentry>
      <term><parameter>filter</parameter></term>
      <listitem>
+      <para>
+       Filter the results to include only methods with certain attributes. Defaults
+       to no filtering.
+      </para>
       <para>
        Any combination of <constant>ReflectionMethod::IS_STATIC</constant>,
        <constant>ReflectionMethod::IS_PUBLIC</constant>,
@@ -45,7 +46,101 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   An <type>array</type> of methods.
+   An <type>array</type> of <classname>ReflectionMethod</classname> objects
+   reflecting each method.
+  </para>
+ </refsect1>
+ 
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title>Basic usage of <methodname>ReflectionClass::getMethods</methodname></title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+class Apple {
+    public function firstMethod() { }
+    final protected function secondMethod() { }
+    private static function thirdMethod() { }
+}
+
+$class = new ReflectionClass('Apple');
+$methods = $class->getMethods();
+var_dump($methods);
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen>
+<![CDATA[
+array(3) {
+  [0]=>
+  &object(ReflectionMethod)#2 (2) {
+    ["name"]=>
+    string(11) "firstMethod"
+    ["class"]=>
+    string(5) "Apple"
+  }
+  [1]=>
+  &object(ReflectionMethod)#3 (2) {
+    ["name"]=>
+    string(12) "secondMethod"
+    ["class"]=>
+    string(5) "Apple"
+  }
+  [2]=>
+  &object(ReflectionMethod)#4 (2) {
+    ["name"]=>
+    string(11) "thirdMethod"
+    ["class"]=>
+    string(5) "Apple"
+  }
+}
+]]>
+    </screen>
+   </example>
+  </para>
+  <para>
+   <example>
+    <title>Filtering results from <methodname>ReflectionClass::getMethods</methodname></title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+class Apple {
+    public function firstMethod() { }
+    final protected function secondMethod() { }
+    private static function thirdMethod() { }
+}
+
+$class = new ReflectionClass('Apple');
+$methods = $class->getMethods(ReflectionMethod::IS_STATIC | ReflectionMethod::IS_FINAL);
+var_dump($methods);
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen>
+<![CDATA[
+array(2) {
+  [0]=>
+  &object(ReflectionMethod)#2 (2) {
+    ["name"]=>
+    string(12) "secondMethod"
+    ["class"]=>
+    string(5) "Apple"
+  }
+  [1]=>
+  &object(ReflectionMethod)#3 (2) {
+    ["name"]=>
+    string(11) "thirdMethod"
+    ["class"]=>
+    string(5) "Apple"
+  }
+}
+]]>
+    </screen>
+   </example>
   </para>
  </refsect1>
 
diff --git a/reference/reflection/reflectionclass/getproperty.xml b/reference/reflection/reflectionclass/getproperty.xml
index 13387e2d70..206592158f 100644
--- a/reference/reflection/reflectionclass/getproperty.xml
+++ b/reference/reflection/reflectionclass/getproperty.xml
@@ -4,7 +4,7 @@
 <refentry xml:id="reflectionclass.getproperty" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>ReflectionClass::getProperty</refname>
-  <refpurpose>Gets property</refpurpose>
+  <refpurpose>Gets a <classname>ReflectionProperty</classname> for a class's property</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
@@ -14,11 +14,9 @@
    <methodparam><type>string</type><parameter>name</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Gets a property.
+   Gets a <classname>ReflectionProperty</classname> for a class's property.
   </para>
 
-  &warn.undocumented.func;
-
  </refsect1>
 
  <refsect1 role="parameters">
@@ -43,6 +41,35 @@
    A <classname>ReflectionProperty</classname>.
   </para>
  </refsect1>
+ 
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title>Basic usage of <methodname>ReflectionClass::getProperty</methodname></title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$class = new ReflectionClass('ReflectionClass');
+$property = $class->getProperty('name');
+var_dump($property);
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen>
+<![CDATA[
+object(ReflectionProperty)#2 (2) {
+  ["name"]=>
+  string(4) "name"
+  ["class"]=>
+  string(15) "ReflectionClass"
+}
+]]>
+    </screen>
+   </example>
+  </para>
+ </refsect1>
 
  <refsect1 role="seealso">
   &reftitle.seealso;
diff --git a/reference/reflection/reflectionclass/getstaticpropertyvalue.xml b/reference/reflection/reflectionclass/getstaticpropertyvalue.xml
index c5cf9c5984..dd859d514b 100644
--- a/reference/reflection/reflectionclass/getstaticpropertyvalue.xml
+++ b/reference/reflection/reflectionclass/getstaticpropertyvalue.xml
@@ -12,14 +12,11 @@
   <methodsynopsis>
    <modifier>public</modifier> <type>mixed</type><methodname>ReflectionClass::getStaticPropertyValue</methodname>
    <methodparam><type>string</type><parameter>name</parameter></methodparam>
-   <methodparam choice="opt"><type>string</type><parameter>default</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Gets the static property values.
+   Gets the value of a static property on this class.
   </para>
 
-  &warn.undocumented.func;
-
  </refsect1>
 
  <refsect1 role="parameters">
@@ -30,15 +27,7 @@
      <term><parameter>name</parameter></term>
      <listitem>
       <para>
-       
-      </para>
-     </listitem>
-    </varlistentry>
-    <varlistentry>
-     <term><parameter>default</parameter></term>
-     <listitem>
-      <para>
-       
+       The name of the static property for which to return a value.
       </para>
      </listitem>
     </varlistentry>
@@ -49,7 +38,34 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   
+   The value of the static property.
+  </para>
+ </refsect1>
+ 
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title>Basic usage of <methodname>ReflectionClass::getStaticPropertyValue</methodname></title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+class Apple {
+    public static $color = 'Red';
+}
+
+$class = new ReflectionClass('Apple');
+var_dump($class->getStaticPropertyValue('color'));
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen>
+<![CDATA[
+string(3) "Red"
+]]>
+    </screen>
+   </example>
   </para>
  </refsect1>
 
diff --git a/reference/reflection/reflectionclass/iscloneable.xml b/reference/reflection/reflectionclass/iscloneable.xml
index 43299d94bc..d3df8aa2e4 100644
--- a/reference/reflection/reflectionclass/iscloneable.xml
+++ b/reference/reflection/reflectionclass/iscloneable.xml
@@ -14,11 +14,9 @@
    <void />
   </methodsynopsis>
   <para>
-
+   Returns whether this class is cloneable.
   </para>
 
-  &warn.undocumented.func;
-
  </refsect1>
 
  <refsect1 role="parameters">
@@ -32,7 +30,44 @@
    Returns &true; if the class is cloneable, &false; otherwise.
   </para>
  </refsect1>
+ 
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title>Basic usage of <methodname>ReflectionClass::isCloneable</methodname></title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+class NotCloneable {
+    public $var1;
+    
+    private function __clone() {
+    }
+}
 
+class Cloneable {
+    public $var1;
+}
+
+$notCloneable = new ReflectionClass('NotCloneable');
+$cloneable = new ReflectionClass('Cloneable');
+
+var_dump($notCloneable->isCloneable());
+var_dump($cloneable->isCloneable());
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen>
+<![CDATA[
+bool(false)
+bool(true)
+]]>
+    </screen>
+   </example>
+  </para>
+ </refsect1>
 
 </refentry>
 
diff --git a/reference/reflection/reflectionclass/isinstantiable.xml b/reference/reflection/reflectionclass/isinstantiable.xml
index 95359a23cc..0e769c6e79 100644
--- a/reference/reflection/reflectionclass/isinstantiable.xml
+++ b/reference/reflection/reflectionclass/isinstantiable.xml
@@ -4,7 +4,7 @@
 <refentry xml:id="reflectionclass.isinstantiable" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>ReflectionClass::isInstantiable</refname>
-  <refpurpose>Checks if instantiable</refpurpose>
+  <refpurpose>Checks if the class is instantiable</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
@@ -14,11 +14,9 @@
    <void />
   </methodsynopsis>
   <para>
-   Checks if the class is instanciable.
+   Checks if the class is instantiable.
   </para>
 
-  &warn.undocumented.func;
-
  </refsect1>
 
  <refsect1 role="parameters">
diff --git a/reference/reflection/reflectionclass/isinterface.xml b/reference/reflection/reflectionclass/isinterface.xml
index 03cab5c3b2..de793ea1c4 100644
--- a/reference/reflection/reflectionclass/isinterface.xml
+++ b/reference/reflection/reflectionclass/isinterface.xml
@@ -4,7 +4,7 @@
 <refentry xml:id="reflectionclass.isinterface" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>ReflectionClass::isInterface</refname>
-  <refpurpose>Checks if interface</refpurpose>
+  <refpurpose>Checks if the class is an interface</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
@@ -16,9 +16,6 @@
   <para>
    Checks whether the class is an interface.
   </para>
-
-  &warn.undocumented.func;
-
  </refsect1>
 
  <refsect1 role="parameters">
@@ -32,6 +29,33 @@
    &return.success;
   </para>
  </refsect1>
+ 
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title>Basic usage of <methodname>ReflectionClass::isInterface</methodname></title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+interface SomeInterface {
+    public function interfaceMethod();
+}
+
+$class = new ReflectionClass('SomeInterface');
+var_dump($class->isInterface());
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen>
+<![CDATA[
+bool(true)
+]]>
+    </screen>
+   </example>
+  </para>
+ </refsect1>
 
  <refsect1 role="seealso">
   &reftitle.seealso;
diff --git a/reference/reflection/reflectionclass/isinternal.xml b/reference/reflection/reflectionclass/isinternal.xml
index 305f55cb30..129eaadb93 100644
--- a/reference/reflection/reflectionclass/isinternal.xml
+++ b/reference/reflection/reflectionclass/isinternal.xml
@@ -4,7 +4,7 @@
 <refentry xml:id="reflectionclass.isinternal" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>ReflectionClass::isInternal</refname>
-  <refpurpose>Checks if internal</refpurpose>
+  <refpurpose>Checks if class is defined internally by an extension, or the core</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
@@ -14,11 +14,9 @@
    <void />
   </methodsynopsis>
   <para>
-   Checks whether the class is internal, as opposed to user-defined.
+   Checks if the class is defined internally by an extension, or the core, as opposed to user-defined.
   </para>
 
-  &warn.undocumented.func;
-
  </refsect1>
 
  <refsect1 role="parameters">
@@ -32,6 +30,35 @@
    &return.success;
   </para>
  </refsect1>
+ 
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title>Basic usage of <methodname>ReflectionClass::isInternal</methodname></title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$internalclass = new ReflectionClass('ReflectionClass');
+
+class Apple {}
+$userclass = new ReflectionClass('Apple');
+
+var_dump($internalclass->isInternal());
+var_dump($userclass->isInternal());
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen>
+<![CDATA[
+bool(true)
+bool(false)
+]]>
+    </screen>
+   </example>
+  </para>
+ </refsect1>
 
  <refsect1 role="seealso">
   &reftitle.seealso;
diff --git a/reference/reflection/reflectionclass/newinstanceargs.xml b/reference/reflection/reflectionclass/newinstanceargs.xml
index c38bfae10c..605a57bc6e 100644
--- a/reference/reflection/reflectionclass/newinstanceargs.xml
+++ b/reference/reflection/reflectionclass/newinstanceargs.xml
@@ -18,8 +18,6 @@
    class constructor.
   </para>
 
-  &warn.undocumented.func;
-
  </refsect1>
 
  <refsect1 role="parameters">
@@ -44,6 +42,33 @@
    Returns a new instance of the class.
   </para>
  </refsect1>
+ 
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title>Basic usage of <methodname>ReflectionClass::newInstanceArgs</methodname></title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$class = new ReflectionClass('ReflectionFunction');
+$instance = $class->newInstanceArgs(array('substr'));
+var_dump($instance);
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen>
+<![CDATA[
+object(ReflectionFunction)#2 (1) {
+  ["name"]=>
+  string(6) "substr"
+}
+]]>
+    </screen>
+   </example>
+  </para>
+ </refsect1>
 
  <refsect1 role="errors">
   &reftitle.errors;