From 9f1bc3cef4629ba897706c2eefbd3084ddece5ff Mon Sep 17 00:00:00 2001
From: Justin Martin <frozenfire@php.net>
Date: Tue, 26 Nov 2013 06:54:14 +0000
Subject: [PATCH] Clarify purpose of ReflectionParameter::getClass().

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@332198 c90b9560-bf6c-de11-be94-00142212c4b1
---
 .../reflectionparameter/getclass.xml          | 32 +++++++++++++++++--
 1 file changed, 30 insertions(+), 2 deletions(-)

diff --git a/reference/reflection/reflectionparameter/getclass.xml b/reference/reflection/reflectionparameter/getclass.xml
index 00a6f53e13..016f8ece54 100644
--- a/reference/reflection/reflectionparameter/getclass.xml
+++ b/reference/reflection/reflectionparameter/getclass.xml
@@ -4,7 +4,7 @@
 <refentry xml:id="reflectionparameter.getclass" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>ReflectionParameter::getClass</refname>
-  <refpurpose>Get class</refpurpose>
+  <refpurpose>Get the type hinted class</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
@@ -14,7 +14,7 @@
    <void />
   </methodsynopsis>
   <para>
-   Gets a class.
+   Gets the class type hinted for the parameter as a <classname>ReflectionClass</classname> object.
   </para>
 
   &warn.undocumented.func;
@@ -32,6 +32,34 @@
    A <classname>ReflectionClass</classname> object.
   </para>
  </refsect1>
+ 
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title>Using the <classname>ReflectionParameter</classname> class</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+function foo(Exception $a) { }
+
+$functionReflection = new ReflectionFunction('foo');
+$parameters = $functionReflection->getParameters();
+$aParameter = $parameters[0];
+
+echo $aParameter->getClass()->name;
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen>
+<![CDATA[
+Exception
+]]>
+    </screen>
+   </example>
+  </para>
+ </refsect1>
 
  <refsect1 role="seealso">
   &reftitle.seealso;