doc/: Miscellaneous clarifications and rewordings.

[sod] / doc / runtime.tex

diff --git a/doc/runtime.tex b/doc/runtime.tex
index f6f0846685ccd9f1daeaf1c6da2e15a800b78f61..4178c435b7c648338727660ceee97929632063b1 100644 (file)
--- a/doc/runtime.tex
+++ b/doc/runtime.tex
@@ -183,7 +183,7 @@ The following keyword-argument macros can be used within the @|KWARGS|
 A \emph{keyword set} defines the collection of keyword arguments accepted by
 a particular function.  The same keyword set may be used by several
 functions.  (If your function currently accepts no keyword arguments, but you
-plan to add some later, do not define a keyword set, and use the
+plan to add some later, do not define a keyword set; instead, use the
 @|KWPARSE_EMPTY| macro described below.)
 
 Each keyword set has a name, which is a C identifier.  It's good to choose
@@ -196,15 +196,12 @@ the same name as the function.
 
 The keyword arguments for a keyword set named @<set> are described by a `list
 macro' named @|@<set>{}_KWSET|.  This macro takes a single argument,
-conventionally named @`_'.
-
-It should expand to a sequence of one or more list items of the form
+conventionally named @`_'.  It should expand to a sequence of one or more
+list items of the form
 \begin{prog}
   _(@<type>, @<name>, @<default>)
 \end{prog}
-with no separation between them.
-
-For example:
+with no separation between them.  For example:
 \begin{prog}
   \#define example_KWSET(_) @\\ \\ \ind
     _(int, x, 0) @\\ \\
@@ -276,10 +273,10 @@ keyword arguments.
     {@<declaration-specifiers> KWDECL(@<set>, @<kw>);}
   The macro declares and initializes a keyword argument structure variable
   named @<kw> for the named keyword @<set>.  The optional
-  @<declaration-specifiers> may provide additional storage-class, qualifiers,
-  or other declaration specifiers.  The @`_suppliedp' flags are initialized
-  to zero; the other members are initialized with the corresponding defaults
-  from the keyword-set definition.
+  @<declaration-specifiers> may provide additional storage-class specifiers,
+  qualifiers, or other declaration specifiers.  The @`_suppliedp' flags are
+  initialized to zero; the other members are initialized with the
+  corresponding defaults from the keyword-set definition.
 \end{describe}
 
 \begin{describe}[KWSET_PARSEFN]{mac}