Revise the Yar extension documentation

reference/yar/book.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ --> 
+<!-- $Revision$ -->
 
 <book xml:id="book.yar" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <?phpdoc extension-membership="pecl" ?>
@@ -8,11 +8,24 @@
 
  <preface xml:id="intro.yar">
   &reftitle.intro;
-  <para>
-    Yar is a RPC framework which aims to provide a simple and easy way to do
-    communication between PHP applications
-    It has the ability to concurrently call multiple remote services.
-  </para>
+  <simpara>
+   Yar (Yet another RPC framework) is a light, concurrent RPC framework
+   which aims to provide a simple and easy way to do communication
+   between PHP applications. It can also issue multiple calls to remote
+   services concurrently.
+  </simpara>
+  <simpara>
+   Yar is a native PHP extension rather than a userland library. It uses
+   a compact binary protocol over HTTP, HTTPS or TCP and ships with three
+   built-in packagers (<literal>php</literal>, <literal>json</literal>
+   and, when built with <option role="configure">--enable-msgpack</option>,
+   <literal>msgpack</literal>), so no extra packages or proxy processes
+   are required.
+  </simpara>
+  <simpara>
+   The protocol is language agnostic: compatible implementations exist
+   for C, Java and Lua.
+  </simpara>
  </preface>
 
  &reference.yar.setup;

reference/yar/configure.xml

@@ -1,14 +1,14 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ --> 
+<!-- $Revision$ -->
 
 <section xml:id="yar.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  &reftitle.install;
 
- <para>
+ <simpara>
   &pecl.info;
   <link xlink:href="&url.pecl.package;yar">&url.pecl.package;yar</link>
- </para>
- 
+ </simpara>
+
 </section>