From 38965efae6b0a417ba178e2a6527461cae1f82c0 Mon Sep 17 00:00:00 2001
From: Mark Skilbeck <markskilbeck@php.net>
Date: Mon, 15 Mar 2010 15:34:55 +0000
Subject: [PATCH] Added function description, return value description,
 OO-style example and See-Also's.

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@296246 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/cairo/cairocontext/setfontface.xml | 31 ++++++++++++--------
 1 file changed, 19 insertions(+), 12 deletions(-)

diff --git a/reference/cairo/cairocontext/setfontface.xml b/reference/cairo/cairocontext/setfontface.xml
index ff614d4823..f427301252 100644
--- a/reference/cairo/cairocontext/setfontface.xml
+++ b/reference/cairo/cairocontext/setfontface.xml
@@ -22,10 +22,8 @@
    <methodparam><type>CairoFontFace</type><parameter>fontface</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Description here.
+  Sets the font-face for a given context.
   </para>
-  
-  &warn.undocumented.func;
  
  </refsect1>
 
@@ -56,7 +54,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Description...
+   No value is returned
   </para>
  </refsect1>
 
@@ -68,16 +66,24 @@
     <programlisting role="php">
 <![CDATA[
 <?php
-/* ... */
+// New surface with white background
+$s = new CairoImageSurface(CairoFormat::ARGB32, 300, 100);
+$c = new CairoContext($s);
+$c->setSourceRgb(1, 1, 1);
+$c->paint();
+
+// Draw some text
+$c->setSourceRgb(0, 0, 0);
+$c->moveTo(10, 60);
+// Create a new font face
+$f = new CairoToyFontFace("sans-serif", CairoFontSlant::NORMAL, CairoFontWeight::NORMAL);
+$c->setFontFace($f);
+$c->setFontSize(30);
+$c->showText('Hello, World!');
+$s->writeToPng(dirname(__FILE__) . '/setFontFace.png');
 ?>
 ]]>
      </programlisting>
-     &example.outputs.similar;
-     <screen>
-<![CDATA[
-...
-]]>
-    </screen>
    </example>
   </para>
   <para>
@@ -104,7 +110,8 @@
   &reftitle.seealso;
   <para>
    <simplelist>
-    <member><methodname>Classname::Method</methodname></member>
+    <member><methodname>CairoContext::setFontSize</methodname></member>
+    <member><methodname>CairoContext::showText</methodname></member>
    </simplelist>
   </para>
  </refsect1>