Merge pull request #275 from jjhursey/c-tool-pause

Clarify a cospawn pause section

Chap_API_Tools.tex

@@ -749,10 +749,10 @@ \subsection{Co-Location of Debugger Daemons}
 given node are responsible for self-determining their specific target
 process(es) - e.g., by referencing their own \refattr{PMIX_LOCAL_RANK} in the
 daemon debugger job versus the corresponding \refattr{PMIX_LOCAL_RANK} of the
-target processes on the node. Note that this method for starting the debugger
-precludes the use of \ac{PMIx} attributes to \emph{pause} the application prior
-to attaching the debugger. Users are referred to the \refapi{PMIx_Job_control}
-\ac{API} for possible alternative methods.
+target processes on the node. Note that the debugger will be attaching to the application processes
+at some arbitrary point in the application's execution unless some method for pausing the application
+(e.g., by providing a \ac{PMIx} directive at time of launch, or via a tool using the
+\refapi{PMIx_Job_control} \ac{API} to direct that the process be paused) has been employed.
 
 \adviceuserstart
 Note that the tool calling \refapi{PMIx_Spawn} to request the launch of the debugger daemons is \emph{not} included in the resulting job - i.e., the debugger daemons do not inherit the namespace of the tool. Thus, collective operations and notifications that target the debugger daemon job will not include the tool unless the namespace/rank of the tool is explicitly included.
@@ -777,13 +777,14 @@ \subsection{Co-Spawn of Debugger Daemons}
 \refapi{PMIx_Spawn} command until all included applications and the debugger
 daemons have been started.
 
-Attributes that apply to both the debugger and the application processes can
+Attributes that apply to both the debugger daemons and the application processes can
 be specified in the \refarg{job_info} array passed into the
 \refapi{PMIx_Spawn} \ac{API}. Attributes that either (a) apply solely to the
 debugger daemons or to one of the applications included in the spawn request,
 or (b) have values that differ from those provided in the \refarg{job_info}
 array, should be specified in the \refarg{info} array in the corresponding
 \refstruct{pmix_app_t}.
+Note that \ac{PMIx} job \emph{pause} attributes (e.g., \refattr{PMIX_DEBUG_STOP_IN_INIT}) do not apply to applications (defined in \refstruct{pmix_app_t}) where the \refattr{PMIX_DEBUGGER_DAEMONS} attribute is set to \code{true}.
 
 Debugger daemons spawned in this manner shall be provided with the typical
 \ac{PMIx} information for their own job plus the target they are to debug via