diff --git a/reference/yar/examples.xml b/reference/yar/examples.xml
index 0423ecc24c..10b547d868 100644
--- a/reference/yar/examples.xml
+++ b/reference/yar/examples.xml
@@ -45,6 +45,9 @@ class Operator {
 		return $a + $b;
 	}
 }
+
+$server = new Yar_Server(new Operator());
+$server->handle();
 ?>
 ]]>
   </programlisting>
@@ -66,7 +69,7 @@ class Operator {
   <programlisting role="php">
 <![CDATA[
 <?php
-$client = yar_client("http://example.com/operator.php");
+$client = new yar_client("http://example.com/operator.php");
 
 /* call directly */
 var_dump($client->add(1, 2));
diff --git a/reference/yar/yar_client/call.xml b/reference/yar/yar_client/call.xml
index 5ac4695554..6139b800a9 100644
--- a/reference/yar/yar_client/call.xml
+++ b/reference/yar/yar_client/call.xml
@@ -75,7 +75,7 @@ $result = $client->some_method("parameter");
  <refsect1 role="seealso">
   &reftitle.seealso;
   <simplelist>
-   <member></member>
+   <member><methodname>Yar_Client::setOpt</methodname></member>
   </simplelist>
  </refsect1>
 
diff --git a/reference/yar/yar_client/construct.xml b/reference/yar/yar_client/construct.xml
index 956334d161..dbbb2e64f7 100644
--- a/reference/yar/yar_client/construct.xml
+++ b/reference/yar/yar_client/construct.xml
@@ -63,7 +63,8 @@ $client = new Yar_Client("http://host/api/");
  <refsect1 role="seealso">
   &reftitle.seealso;
   <simplelist>
-   <member></member>
+   <member><methodname>Yar_Client::Call</methodname></member>
+   <member><methodname>Yar_Client::setOpt</methodname></member>
   </simplelist>
  </refsect1>
 
diff --git a/reference/yar/yar_client/setopt.xml b/reference/yar/yar_client/setopt.xml
index bd0b4f6678..4c0e1069cc 100644
--- a/reference/yar/yar_client/setopt.xml
+++ b/reference/yar/yar_client/setopt.xml
@@ -85,7 +85,7 @@ $result = $client->some_method("parameter");
  <refsect1 role="seealso">
   &reftitle.seealso;
   <simplelist>
-   <member></member>
+   <member><methodname>Yar_Client::Call</methodname></member>
   </simplelist>
  </refsect1>
 
diff --git a/reference/yar/yar_concurrent_client/call.xml b/reference/yar/yar_concurrent_client/call.xml
index 4a7d1143dd..3bf47291bc 100644
--- a/reference/yar/yar_concurrent_client/call.xml
+++ b/reference/yar/yar_concurrent_client/call.xml
@@ -104,7 +104,7 @@ Yar_Concurrent_Client::call("http://host/api/", "some_method", array("parameters
  <refsect1 role="seealso">
   &reftitle.seealso;
   <simplelist>
-   <member></member>
+   <member><methodname>Yar_Concurrent_Client::loop</methodname></member>
   </simplelist>
  </refsect1>
 
diff --git a/reference/yar/yar_concurrent_client/loop.xml b/reference/yar/yar_concurrent_client/loop.xml
index de2e19d3cf..96aca6106d 100644
--- a/reference/yar/yar_concurrent_client/loop.xml
+++ b/reference/yar/yar_concurrent_client/loop.xml
@@ -61,11 +61,6 @@
    <title><function>Yar_Concurrent_Client::loop</function> example</title>
    <programlisting role="php">
 <![CDATA[
-]]>
-   </programlisting>
-   &example.outputs.similar;
-   <screen>
-<![CDATA[
 <?php
 function callback($retval, $callinfo) {
      if ($callinfo == NULL) {
@@ -91,6 +86,11 @@ Yar_Concurrent_Client::call("http://host/api/", "some_method", array("parameters
 Yar_Concurrent_Client::loop("callback", "error_callback"); //send the requests, 
                                                            //the error_callback is optional
 ?>
+]]>
+   </programlisting>
+   &example.outputs.similar;
+   <screen>
+<![CDATA[
 ]]>
    </screen>
   </example>
@@ -100,7 +100,7 @@ Yar_Concurrent_Client::loop("callback", "error_callback"); //send the requests,
  <refsect1 role="seealso">
   &reftitle.seealso;
   <simplelist>
-   <member></member>
+   <member><methodname>Yar_Concurrent_Client::call</methodname></member>
   </simplelist>
  </refsect1>
 
diff --git a/reference/yar/yar_server/construct.xml b/reference/yar/yar_server/construct.xml
index bfd659b50b..40fee10ff6 100644
--- a/reference/yar/yar_server/construct.xml
+++ b/reference/yar/yar_server/construct.xml
@@ -78,7 +78,7 @@ $service->handle();
  <refsect1 role="seealso">
   &reftitle.seealso;
   <simplelist>
-   <member></member>
+   <member><methodname>Yar_Server::handle</methodname></member>
   </simplelist>
  </refsect1>
 
diff --git a/reference/yar/yar_server/handle.xml b/reference/yar/yar_server/handle.xml
index 6612216e84..79c304073e 100644
--- a/reference/yar/yar_server/handle.xml
+++ b/reference/yar/yar_server/handle.xml
@@ -74,7 +74,7 @@ $service->handle();
  <refsect1 role="seealso">
   &reftitle.seealso;
   <simplelist>
-   <member></member>
+   <member><methodname>Yar_Server::__construct</methodname></member>
   </simplelist>
  </refsect1>