diff --git a/internals/zendapi/functions/get_zend_version.xml b/internals/zendapi/functions/get_zend_version.xml
index eb3aa794d9..e5478c6413 100644
--- a/internals/zendapi/functions/get_zend_version.xml
+++ b/internals/zendapi/functions/get_zend_version.xml
@@ -1,9 +1,9 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.1 $ -->
+<!-- $Revision: 1.2 $ -->
 <refentry id="zend-api.get-zend-version">
  <refnamediv>
   <refname>get_zend_version</refname>
-  <refpurpose>...</refpurpose>
+  <refpurpose>Get Zend Engine version string</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
@@ -14,31 +14,22 @@
     <methodparam><type></type><parameter>void</parameter></methodparam>
   </methodsynopsis>
   <para>
-   ...
-  </para>
- </refsect1>
-
- <refsect1 role="parameters">
-  &reftitle.parameters;
-  <para>
-   <variablelist>
-    <varlistentry>
-     <term><parameter>void</parameter></term>
-     <listitem>
-      <para>
-       ...
-      </para>
-     </listitem>
-    </varlistentry>
-   </variablelist>
+   <function>get_zend_version</function> returns a verbose version string
+   containing both version and copyright information for the Zend Engine
+   in use.
   </para>
  </refsect1>
 
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   ...
+   A Zend version string like:
   </para>
+  <blockqoute>
+   <simpara>
+   Zend Engine v2.0.5, Copyright (c) 1998-2006 Zend Technologies
+   </simpara>
+  </blockquote>
  </refsect1>
 
 </refentry>
diff --git a/internals/zendapi/functions/zend_error.xml b/internals/zendapi/functions/zend_error.xml
index 31119e4dd8..195d34dd18 100644
--- a/internals/zendapi/functions/zend_error.xml
+++ b/internals/zendapi/functions/zend_error.xml
@@ -1,14 +1,15 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
 <refentry id="zend-api.zend-error">
  <refnamediv>
   <refname>zend_error</refname>
-  <refpurpose>...</refpurpose>
+  <refpurpose>Generate error message and trigger error handling</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
   &reftitle.description;
   <literallayout>#include &lt;zend.h&gt;</literallayout>
+  <literallayout>#include &lt;zend_errors.h&gt;</literallayout>
   <methodsynopsis>
    <void/><methodname>zend_error</methodname>
     <methodparam><type>int</type><parameter>type</parameter></methodparam>
@@ -28,7 +29,13 @@
      <term><parameter>type</parameter></term>
      <listitem>
       <para>
-       ...
+       One of <constant>E_ERROR</constant>, <constant>E_WARNING</constant>,                
+       <constant>E_PARSE</constant>, <constant>E_NOTICE</constant>,                 
+       <constant>E_CORE_ERROR</constant>, <constant>E_CORE_WARNING</constant>,           
+       <constant>E_COMPILE_ERROR</constant>, <constant>E_COMPILE_WARNING</constant>,        
+       <constant>E_USER_ERROR</constant>, <constant>E_USER_WARNING</constant>,           
+       <constant>E_USER_NOTICE</constant>, <constant>E_STRICT</constant>, or                 
+       <constant>E_RECOVERABLE_ERROR</constant>.
       </para>
      </listitem>
     </varlistentry>
@@ -36,7 +43,7 @@
      <term><parameter>format</parameter></term>
      <listitem>
       <para>
-       ...
+       A <function role="libc">printf</function> format string.
       </para>
      </listitem>
     </varlistentry>
@@ -44,7 +51,7 @@
      <term><parameter>...</parameter></term>
      <listitem>
       <para>
-       ...
+       Output parameters for the <parameter>format</parameter> string.
       </para>
      </listitem>
     </varlistentry>
@@ -52,13 +59,6 @@
   </para>
  </refsect1>
 
- <refsect1 role="returnvalues">
-  &reftitle.returnvalues;
-  <para>
-   ...
-  </para>
- </refsect1>
-
 </refentry>
 
 <!-- Keep this comment at the end of the file