Added affinity parameter

Also a minor tweak to the definition of "execution agent"

Author: nelsc

cplexts.tex

@@ -44,7 +44,7 @@
 % These parameters, and the documentclass options,
 % are about document identification and overall formatting.
 \newcommand{\cplexts}{$CPLEXTS$}
-\renewcommand{\extrahead}{2014-08-13}
+\renewcommand{\extrahead}{2014-08-21}
 \standard{\cplexts}
 \yearofedition{2016}
 \languageofedition{(E)}

definitions.tex

@@ -33,7 +33,8 @@
 
 \definition{execution agent}{
 entity, such as an OS thread,
-that may perform work in parallel with other execution agents%
+that may execute a thread of execution
+in parallel with other execution agents%
 \footnote{EN:
 Adapted from the C++ standard.
 }

loopparameter.tex

@@ -39,6 +39,18 @@
 \pfxdefn{workload_unbalanced}
 \end{ttfamily}
 
+\pnum
+The
+\pfxdefn{affinity_t}
+type is an enumerated type
+with at least the following enumeration constants,
+each with nonzero value:
+
+\begin{ttfamily}
+\pfxdefn{affinity_close}\\
+\pfxdefn{affinity_spread}
+\end{ttfamily}
+
 \pnum
 When an object of type
 \pfx{loop_params_t}
@@ -191,3 +203,27 @@
 or
 \pfx{schedule_guided}.
 \end{note}
+
+\sclause{The \tcode{affinity} parameter}
+\ssclause*{Synopsis}
+\begin{ttfamily}
+\#include <cplex.h>\\
+void \pfxdefn{set_affinity}(\pfx{loop_params_t} *hints, \pfx{affinity_t} kind);\\
+\pfx{affinity_t} \pfx{get_affinity}(\pfx{loop_params_t} *hints);
+\end{ttfamily}
+
+\ssclause*{Description}
+\pnum
+The
+\pfx{set_affinity}
+macro sets to
+\tcode{kind}
+the recommended affinity
+for a parallel loop associated with the object pointed to by
+\tcode{hints}.
+
+\pnum
+The affinity of a loop indicates whether the loop benefits
+from being executed by co-located hardware threads,
+or whether performance is likely to improve if the software threads
+are spread over multiple cores.