doc/charm++: sync entry method revisions
authorPritish Jetley <pjetley2@illinois.edu>
Wed, 8 Aug 2012 18:05:12 +0000 (14:05 -0400)
committerPritish Jetley <pjetley2@illinois.edu>
Wed, 8 Aug 2012 18:05:12 +0000 (14:05 -0400)
doc/charm++/sync.tex

index 90e65ae73de9536af0db75b599c8b7b9e9747ede..5969bc8f4e730313aafb007d718685190d5c0898 100644 (file)
@@ -2,16 +2,17 @@
 \section{Sync Entry Methods}
 \label{sync}
 
-Generally entry methods are invoked asynchronously and return void. Therefore,
-while an entry method may send data back to its invoker, it does so by invoking
-another asynchronous entry method on the invoking chare object.
+Generally, entry methods are invoked asynchronously and return {\tt void}. Therefore,
+while an entry method may send data back to its invoker, it can only do so by invoking
+another asynchronous entry method on the chare object that invoked it.
 
 However, it is possible to use \kw{sync} entry methods, which have blocking
-semantics and can return data back to their invoker that is available when it
-returns from blocking. This returned data must be in the form of a \charmpp
-message. Because the caller of a sync entry method will block, it must execute
-in a thread separate from the scheduler; that is, it must be a \kw{threaded}
-entry method. If a sync entry method returns a value, it is provided as the
+semantics. The data returned by the invocation of such an entry method is
+available at the call site when it returns from blocking. This returned data
+must be in the form of a \charmpp message. Because the caller of a sync entry
+method will block, it must execute in a thread separate from the scheduler;
+that is, it must be a \kw{threaded} entry method ({\em cf.} \S~\ref{threaded},
+above).  If a \kw{sync} entry method returns a value, it is provided as the
 return value from the invocation on the proxy object:
 
 \begin{alltt}