diff --git a/reference/yar/examples.xml b/reference/yar/examples.xml
index 775dce316d..fc2afc9bb6 100644
--- a/reference/yar/examples.xml
+++ b/reference/yar/examples.xml
@@ -99,9 +99,12 @@ function callback($ret, $callinfo) {
     echo $callinfo['method'] , " result: ", $ret , "\n";
 }
 
+/* register async call to remote services */
 Yar_Concurrent_Client::call("http://example.com/operator.php", "add", array(1, 2), "callback");
 Yar_Concurrent_Client::call("http://example.com/operator.php", "sub", array(2, 1), "callback");
 Yar_Concurrent_Client::call("http://example.com/operator.php", "mul", array(2, 2), "callback");
+
+/* sent all request and wait for response */
 Yar_Concurrent_Client::loop();
 ?>
 ]]>