Changes between Version 17 and Version 18 of MessagePassing

Timestamp:

09/13/13 09:23:59 (13 years ago)

Author:

siegel

Comment:

--

MessagePassing

@@ -6 +6 @@
 
 * `$message`
- * an abstract datatype
+ * an abstract, immutable datatype representing a message
 * `$message $message_pack(int source, int dest, int tag, void *data, int size)`
  * creates a new message, copying data from the specified buffer
@@ -20 +20 @@
  * transfers message data to `buf`, throwing exception if message size exceeds specified size
 * `$comm`
- * an abstract datatype representing a communicator, or set of message channels between every pair of processes in a set of processes
+ * an abstract, immutable datatype representing a communicator value, which encapsulates a set of message channels between every pair of processes in a list of processes
 * `$comm $comm_create(int nprocs, $proc procs[])`
  * creates a new comm from the given sequence of processes, by allocating memory and copying the process sequence; the new comm has no messages
@@ -26 +26 @@
  * returns the number of processes associated to the comm
 * `$proc $comm_getProc($comm comm, int pid)`
- * returns a pointer to the procs array in comm
+ * returns the pid-th proc in the comm
 * `$comm $comm_enqueue($comm comm, $message message)`
- * adds the message to the comm
+ * adds the message to the comm (or, more precisely, returns a new comm value identical to the old except with the message added in the appropriate queue)
 * `boolean $comm_probe($comm comm, int source, int dest, int tag)`
  * returns true iff a matching message exists in comm