cmRtNet.h/c : Sync. messages are now transmitted to the client

in _cmRtNetRecv().
Added comments.

cmRtNet.c

   return rc;
 }
 
+// This is called in the context of cmRtNetReceive().
 void _cmRtNetRecv( void* cbArg, const char* data, unsigned dataByteCnt, const struct sockaddr_in* fromAddr )
 {
   cmRtNet_t* p = (cmRtNet_t*)cbArg;
   
   if( _cmRtNetIsSyncModeMsg(data,dataByteCnt))
     _cmRtNetSyncModeRecv(p,data,dataByteCnt,fromAddr);
-  else
+  // else
     p->cbFunc(p->cbArg,data,dataByteCnt,fromAddr);
   
 }
   cmRtNetRC_t rc = kOkNetRC;
   cmRtNet_t*  p  = _cmRtNetHandleToPtr(h);
 
+  // Calling this function results in callbacks to _cmRtNetRecv() (above)
   if( cmUdpGetAvailData(p->udpH, NULL, NULL, NULL ) != kOkUdpRC )
   {
     cmErrMsg(&p->err,kUdpPortFailNetRC,"UDP port query failed.");

cmRtNet.h

   cmRtNetRC_t cmRtNetDoSync( cmRtNetH_t h );
 
   // This function must be polled to receive incoming network messages
-  // via the callback funcion 'cbFunc' as passed to cmRtNetAlloc()
+  // via the callback funcion 'cbFunc' as passed to cmRtNetAlloc().
+  // Note that all messages received via 'cbFunc' will be prefixed with
+  // an cmRtNetMsg_t header (See cmRtSysMsg.h).
   cmRtNetRC_t cmRtNetReceive( cmRtNetH_t h );
 
   // Get an end point handle for use with cmRtNetSend.