word smithing

diff --git a/doc/unlang/call.adoc b/doc/unlang/call.adoc
index 74e9bbfeaca10cf779dbf35674218fcf274f664e..df3c1760ddd4a55d25e979b44030817eb6d8604b 100644 (file)
--- a/doc/unlang/call.adoc
+++ b/doc/unlang/call.adoc
@@ -9,25 +9,29 @@ call <server> {
 ----
 
 The `call` statement will create a child request, as with the
-link:subrequest.adoc[subrequest] keyword.  The child request will be
-run through the virtual server given by _<server>_.  The called
-virtual server must have the same `namespace` value as the calling
-virtual server.  The child request will be an identical copy of the
-parent request, as with the link:parallel.adoc[parallel] keyword.
-
+link:subrequest.adoc[subrequest] keyword.  This child request will be
+an identical copy of the parent request, as with the
+link:parallel.adoc[parallel] keyword.
+
+<server>::  The virtual server which wil process the child request.
++
+The called virtual server must have the same `namespace` value as the
+calling virtual server.
++
 The called virtual server will execute the subrequest as if it had
 been received from the network.  For example, if the packet is a
 RADIUS `Access-Request`, then the called virtual server will process
 the `recv Access-Request` section, followed by the `authenticate
 <type>` section, followed by the `send Access-Accept` section.
 
-Once the called virtual server has finished, the _[ statements]_ from
-inside of the `call` section will be executed.  These statements will
-be executed in the context of the child.
+[ statements ]:: Once the called virtual server has finished, the _[
+statements]_ from inside of the `call` section will be executed.
+These statements will be executed in the context of the child.
 
-Once the child requests are finished, they are freed.  Any information
-stored in them is discarded.  Information needed after the `call`
-section is run should be saved in the parent request.
+The child requests are are freed once the _[ statements ]_ are
+finished.  Any information stored in the child request is discarded.
+Information that is needed after the `call` section is run should be
+saved in the parent request.
 
 NOTE: The statements inside of a `call` section are executed in the
 context of the _child_ request, and not in the context of the _parent_
@@ -40,7 +44,7 @@ attributes from the child to the parent.  For example, a reply
 The return code of the `call` statement is taken from the return code
 of the child request.
 
-*Examples:*
+.Example
 
 This example calls the `inner-tunnel` virtual server, and then copies
 the resulting `Packet-Type` back to the parent request.

diff --git a/doc/unlang/parallel.adoc b/doc/unlang/parallel.adoc
index f4feae103565ef66a06ef3e9b40dba8389421c9a..4d7a9b033832be9820a191abed42db5756eec611 100644 (file)
--- a/doc/unlang/parallel.adoc
+++ b/doc/unlang/parallel.adoc
@@ -69,8 +69,8 @@ This independence is required in order to fully implement the
 "parallel" nature of this keyword.
 
 Once the child requests are finished, they are freed.  Any information
-stored in them is discarded.  Information needed after the `parallel`
-section is run should be saved in the parent request.
+stored in them is discarded.  Information that is needed after the
+`parallel` section is run should be saved in the parent request.
 
 .Example