diff --git a/functions/image.xml b/functions/image.xml
index 1f92dd60ed..424adae8af 100644
--- a/functions/image.xml
+++ b/functions/image.xml
@@ -1,5 +1,5 @@
 <?xml encoding="iso-8859-1"?>
-<!-- $Revision: 1.51 $ -->
+<!-- $Revision: 1.52 $ -->
 <reference id="ref.image">
  <title>Image functions</title>
  <titleabbrev>Image</titleabbrev>
@@ -224,7 +224,7 @@
     and <parameter>h</parameter> specifies the ellipse's width and
     height respectively while the start and end points are specified
     in degrees indicated by the <parameter>s</parameter> and
-    <parameter>e</parameter>.  arguments.
+    <parameter>e</parameter> arguments.
     <parameter>style</parameter> is a bitwise OR of the following possibilities:
     <orderedlist>
      <listitem><simpara><literal>IMG_ARC_PIE</literal></simpara></listitem>
@@ -330,8 +330,8 @@
     <parameter>c</parameter> in the image identified by
     <parameter>id</parameter> with its upper-left at
     <parameter>x</parameter>,<parameter>y</parameter> (top left is 0,
-    0) with the color <parameter>col</parameter>. If font is 1, 2, 3,
-    4 or 5, a built-in font is used (with higher numbers
+    0) with the color <parameter>col</parameter>. If <parameter>font</parameter>
+    is 1, 2, 3, 4 or 5, a built-in font is used (with higher numbers
     corresponding to larger fonts).
    </para>
    <para>
@@ -363,8 +363,9 @@
     <parameter>c</parameter> vertically in the image identified by
     <parameter>im</parameter> at coordinates
     <parameter>x</parameter>, <parameter>y</parameter> (top left is
-    0, 0) with the color <parameter>col</parameter>.  If font is 1,
-    2, 3, 4 or 5, a built-in font is used.
+    0, 0) with the color <parameter>col</parameter>.
+    If <parameter>font</parameter> is 1, 2, 3, 4 or 5, a built-in font is
+    used.
    </para>
    <para>
     See also <function>imageloadfont</function>.
@@ -2144,7 +2145,7 @@ ImagePng($im);
      In the case everything went right, a valid font index will be
      returned and can be used for further purposes. Otherwise the
      function returns &false; and prints a message describing what went
-     wrong.
+     wrong, which you cannot read directly, while the output type is image.
     </para>
     <para>
      <programlisting role="php">