diff --git a/reference/soap/functions/soap-soapserver-fault.xml b/reference/soap/functions/soap-soapserver-fault.xml
index e1e6b5e943..b36297d104 100644
--- a/reference/soap/functions/soap-soapserver-fault.xml
+++ b/reference/soap/functions/soap-soapserver-fault.xml
@@ -1,9 +1,9 @@
 <?xml version='1.0' encoding='iso-8859-1'?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
 <refentry id="function.soap-soapserver-fault">
  <refnamediv>
   <refname>SoapServer->fault()</refname>
-  <refpurpose></refpurpose>
+  <refpurpose>Issue SoapServer fault indicating an error</refpurpose>
  </refnamediv>
  <refsect1 role="description">
   &reftitle.description;
diff --git a/reference/soap/functions/soap-soapserver-handle.xml b/reference/soap/functions/soap-soapserver-handle.xml
index ff59be8ac5..fb0a064c15 100644
--- a/reference/soap/functions/soap-soapserver-handle.xml
+++ b/reference/soap/functions/soap-soapserver-handle.xml
@@ -1,5 +1,5 @@
 <?xml version='1.0' encoding='iso-8859-1'?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
 <refentry id="function.soap-soapserver-handle">
  <refnamediv>
   <refname>SoapServer->handle()</refname>
@@ -56,8 +56,15 @@ function test($x)
     return $x;
 }
 
+// function can return SoapHeader object
+function echoMeStringResponse($string)
+{
+    return new SoapHeader('http://soapinterop.org/echoheader/', 'echoMeStringResponse', $string);
+}
+
 $server = new SoapServer(null, array('uri' => "http://test-uri/"));
 $server->addFunction("test");
+$server->echoMeStringResponse("test");
 $server->handle();
 ?>
 ]]>
diff --git a/reference/soap/functions/use-soap-error-handler.xml b/reference/soap/functions/use-soap-error-handler.xml
index 0ee5f6dddb..0ce8813f96 100644
--- a/reference/soap/functions/use-soap-error-handler.xml
+++ b/reference/soap/functions/use-soap-error-handler.xml
@@ -1,14 +1,14 @@
 <?xml version='1.0' encoding='iso-8859-1'?>
-<!-- $Revision: 1.4 $ -->
+<!-- $Revision: 1.5 $ -->
 <refentry id="function.use-soap-error-handler">
  <refnamediv>
   <refname>use_soap_error_handler</refname>
-  <refpurpose></refpurpose>
+  <refpurpose>Set whether to use the SOAP error handler and return the former value</refpurpose>
  </refnamediv>
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>void</type><methodname>use_soap_error_handler</methodname>
+   <type>bool</type><methodname>use_soap_error_handler</methodname>
    <methodparam choice="opt"><type>bool</type><parameter>handler</parameter></methodparam>
   </methodsynopsis>
   &warn.undocumented.func;