/**
 * Provides the classes necessary to create requests
 * and responses between nodes .
 * <p>
 * There are several ways of creating requests:
 * <ul>
 * <li> The default request does not imply an answer from the destination node.
 *      It is therefore asynchronous by default. (@see simizer.app.Application.sendOneWay)
 * </li>
 * 
 * <li> the second method demands a response from the destination node. 
 * the responding node must therefore create a Response object 
 * with the originating request as parent parameter, and call the sendResponse method
 * Upon reception a ResponseReceived event will be signaled to the VM and propagated to the Application,
 * which will the call the handle method of the corresponding Application.
 * 
 * @since 0.4
 * @see simizer.VM
 * @see  simizer.app
 */
package simizer.requests;

@@ -17,16 +17,8 @@
 the 
-classes 
 nece
@@ -27,58 +27,44 @@
 ary 
-to create requests%0A * and responses between nodes 
+classes to simulate sending requests
 .%0A *
@@ -85,32 +85,40 @@
 are 
-several
+two main
  ways 
+t
 o
-f
  creat
-ing
+e and send
  req
@@ -131,25 +131,20 @@
 %0A * %3Cul%3E
-%0A * 
 %3Cli%3E
- 
 The defa
@@ -168,13 +168,15 @@
 not 
-imply
+require
  an 
@@ -202,22 +202,16 @@
 tination
- node.
 %0A *     
@@ -215,67 +215,86 @@
     
-It is therefore asynchronous by default. (@see simizer.app.
+   node.  It can therefore be considered asynchronous.  See %7B@link%0A *         
 Appl
@@ -300,17 +300,17 @@
 lication
-.
+#
 sendOneW
@@ -315,32 +315,41 @@
 eWay
-)%0A * %3C/li%3E
+(Node,Request)%7D.%0A * 
 %0A * 
-%0A *
+   
  %3Cli%3E
- t
+T
 he s
@@ -358,21 +358,19 @@
 ond 
-method demand
+way require
 s a 
@@ -409,15 +409,23 @@
 de. 
-%0A * the
+ The%0A *        
  res
@@ -456,357 +456,131 @@
 ore 
-create a Response object %0A * with the originating request as parent parameter, and call the sendResponse method%0A * Upon reception a ResponseReceived event will be signaled to the VM and propagated to the Application,%0A * which will the call the handle method of the corresponding Application.%0A * %0A * @since 0.4%0A * @see simizer.VM%0A * @see  simizer.app
+send the request back to the caller.%0A *         (See %7B@link Application#sendResponse(Node,Request)%7D.%3C/ul%3E%0A * %0A * @since 0.4
 %0A */

Update the documentation for the requests package.