@@ -305,14 +305,21 @@ terminateAllSlaves backend = do
305305-- Master nodes
306306--------------------------------------------------------------------------------
307307
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
311−-- nodes.
308+-- | 'startMaster' finds all slaves /currently/ available on the local network,
309+-- redirects all log messages to itself, and then calls the specified process,
310+-- passing the list of slaves nodes.
312311--
313312-- Terminates when the specified process terminates. If you want to terminate
314313-- the slaves when the master terminates, you should manually call
315314-- 'terminateAllSlaves'.
315+--
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.
319+--
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.
316323startMaster :: Backend -> ([NodeId] -> Process ()) -> IO ()
317324startMaster backend proc = do
318325 node <- newLocalNode backend