Merge branch 'refs/heads/t/doc'

Some minor documentation improvements. Cooking for four months.

* refs/heads/t/doc:
  Fix bad grammar "allows <infinitive>".
  doc: Move filter examples to man page.
  doc: Move sender examples to manual page.

diff --combined NEWS.md
index 4fd9dcb495e7f42cf89468ae18d485338820ec9b,d0bd6585a3a2f04be5ec262d580bfb8800733498..9ced85e9019eea7c93c0a4c37f8c632464e2dd58
--- 1/NEWS.md
--- 2/NEWS.md
+++ b/NEWS.md
@@@ -1,13 -1,6 +1,15 @@@
  NEWS
  ====
  
 +-------------------------------------------
 +0.6.2 (to be accounced) "elastic diversity"
 +-------------------------------------------
 +
 +- para_gui no longer waits up to one second to update the screen when
 +the geometry of the terminal changes.
 +
++- Minor documentation improvements.
++
  ----------------------------------------
  0.6.1 (2017-09-23) "segmented iteration"
  ----------------------------------------

diff --combined mp.c
index c5702c625bf2125afd10f3dab8ce1627053ddb07,3f6cfbe6cd297ad2bc34490a77784679f434754f..bade05bcf866103b5bd794af4ae1ae6ce8cb5b72
--- 1/mp.c
--- 2/mp.c
+++ b/mp.c
@@@ -6,10 -6,10 +6,10 @@@
   * This file contains the public and the private API of the flex/bison based
   * mood parser.
   *
-  * The public API (at the bottom of the file) allows to parse the same mood
+  * The public API (at the bottom of the file) allows parsing the same mood
   * definition many times in an efficient manner.
   *
 - * The first function to all is \ref mp_init(), which analyzes the given mood
 + * The first function to call is \ref mp_init(), which analyzes the given mood
   * definition syntactically. It returns the abstract syntax tree of the mood
   * definition and pre-compiles all regular expression patterns to make later
   * pattern matching efficient.
@@@ -61,8 -61,8 +61,8 @@@ struct mp_context 
   *
   * This function turns a generalized C99 string literal like "xyz\n" into a C
   * string (containing the three characters 'x', 'y' and 'z', followed by a
-  * newline character and the terminating zero byte). The function allows to
-  * specify different quote characters so that, for example, regular expression
+  * newline character and the terminating zero byte). The function receives
+  * quote characters as an argument so that, for example, regular expression
   * patterns enclosed in '/' can be parsed as well. To parse a proper string
   * literal, one has to pass two double quotes as the second argument.
   *

diff --combined vss.c
index 13a8e25fd0febc7aeeb56e8e37099f7ec4747a0f,e6705b6f74cb7a9d4c9c2d5c93abab05020753a8..8b850fe1e56c27d3cebda6db2d0eb6984575c20e
--- 1/vss.c
--- 2/vss.c
+++ b/vss.c
@@@ -25,8 -25,8 +25,8 @@@
  #include "string.h"
  #include "afh.h"
  #include "afs.h"
 -#include "server.h"
  #include "net.h"
 +#include "server.h"
  #include "list.h"
  #include "send.h"
  #include "sched.h"
@@@ -298,7 -298,7 +298,7 @@@ static int initialize_fec_client(struc
        if (fcp->init_fec) {
                /*
                 * Set the maximum slice size to the Maximum Packet Size if the
-                * transport protocol allows to determine this value. The user
+                * transport protocol allows determination of this value. The user
                 * can specify a slice size up to this value.
                 */
                ret = fcp->init_fec(fc->sc);
@@@ -997,7 -997,7 +997,7 @@@ static void recv_afs_result(struct vss_
                goto err;
        }
        ret = para_mmap(statbuf.st_size, PROT_READ, MAP_PRIVATE | MAP_POPULATE,
 -              passed_fd, 0, &vsst->map);
 +              passed_fd, &vsst->map);
        if (ret < 0)
                goto err;
        vsst->mapsize = statbuf.st_size;