@@ -305,14 +305,21 @@ terminateAllSlaves backend = do
305-- Master nodes
305-- Master nodes
306--------------------------------------------------------------------------------
306--------------------------------------------------------------------------------
308−-- | 'startMaster' finds all slaves currently available on the local network
308+-- | 'startMaster' finds all slaves /currently/ available on the local network,
309−-- (which should therefore be started first), redirects all log messages to
310−-- itself, and then calls the specified process, passing the list of slaves
309+-- redirects all log messages to itself, and then calls the specified process,
311−-- nodes.
310+-- passing the list of slaves nodes.
313-- Terminates when the specified process terminates. If you want to terminate
312-- Terminates when the specified process terminates. If you want to terminate
314-- the slaves when the master terminates, you should manually call
313-- the slaves when the master terminates, you should manually call
315-- 'terminateAllSlaves'.
314-- 'terminateAllSlaves'.
316+-- If you start more slave nodes after having started the master node, you can
317+-- discover them with later calls to 'findSlaves', but be aware that you will
318+-- need to call 'redirectLogHere' to redirect their logs to the master node.
320+-- Note that you can use functionality of "SimpleLocalnet" directly (through
321+-- 'Backend'), instead of using 'startMaster'/'startSlave', if the master/slave
322+-- distinction does not suit your application.
316startMaster :: Backend -> ([NodeId] -> Process ()) -> IO ()
323startMaster :: Backend -> ([NodeId] -> Process ()) -> IO ()
317startMaster backend proc = do
324startMaster backend proc = do
318 node <- newLocalNode backend
325 node <- newLocalNode backend