diff --git a/reference/image/reference.xml b/reference/image/reference.xml
index 3225b5a6ae..4921fcf87b 100644
--- a/reference/image/reference.xml
+++ b/reference/image/reference.xml
@@ -1,12 +1,21 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.9 $ -->
+<!-- $Revision: 1.10 $ -->
 <reference id="ref.image">
  <title>Image functions</title>
  <titleabbrev>Image</titleabbrev>
 
  <partintro>
    <section id="image.intro">
-   &reftitle.intro;
+    &reftitle.intro;
+    <para>
+     PHP is not limited to creating just HTML output.  It can also be
+     used to create and manipulate image files in a variety of different
+     image formats, including gif, png, jpg, wbmp, and xpm. Even more
+     convenient, PHP can output image streams directly to a browser. You
+     will need to compile PHP with the GD library of image functions for
+     this to work. GD and PHP may also require other libraries, depending
+     on which image formats you want to work with.
+    </para>
     <para>
      You can use the image functions in PHP to get the size of
      <acronym>JPEG</acronym>, <acronym>GIF</acronym>,
@@ -87,6 +96,36 @@
 
    &reference.image.constants;
 
+   <section id="image.examples">
+    &reftitle.examples;
+    <para>
+     <example>
+      <title>PNG creation with PHP</title>
+      <programlisting role="php">
+<![CDATA[
+<?php
+    header("Content-type: image/png");
+    $string = implode($argv, " ");
+    $im     = imagecreatefrompng("images/button1.png");
+    $orange = imagecolorallocate($im, 220, 210, 60);
+    $px     = (imagesx($im) - 7.5 * strlen($string)) / 2;
+    imagestring($im, 3, $px, 9, $string, $orange);
+    imagepng($im);
+    imagedestroy($im);
+?>
+]]>
+      </programlisting>
+     </example>
+     This example would be called from a page with a tag like: &lt;img
+     src=&quot;button.php?text&quot;&gt;. The above button.php script
+     then takes this &quot;text&quot; string and overlays it on top of a
+     base image which in this case is &quot;images/button1.png&quot;
+     and outputs the resulting image. This is a very convenient way to
+     avoid having to draw new button images every time you want to
+     change the text of a button. With this method they are
+     dynamically generated.
+    </para>
+   </section>
  </partintro>
 
 &reference.image.functions;