actor: minor supervision example improvements 2

Author: pitr-ch

doc/actor/supervision_tree.out.rb

@@ -1,7 +1,7 @@
 
 class Master < Concurrent::Actor::RestartingContext
   def initialize
-    # for listener to be child of master
+    # create listener a supervised child of master
     @listener = Listener.spawn(name: 'listener1', supervise: true)
   end
 
@@ -17,7 +17,7 @@ def on_message(msg)
     end
   end
 
-  # TODO turn this into Behaviour and make it default part of RestartingContext
+  # TODO this should be a part of a behaviour, it ensures that children are restarted/paused etc. when theirs parents are
   def on_event(event)
     event_name, _ = event
     case event_name
@@ -48,25 +48,25 @@ def on_message(msg)
 end 
 
 master   = Master.spawn(name: 'master', supervise: true)
-    # => #<Concurrent::Actor::Reference:0x7fd443366568 /master (Master)>
+    # => #<Concurrent::Actor::Reference:0x7fa595899fa8 /master (Master)>
 listener = master.ask!(:listener)
-    # => #<Concurrent::Actor::Reference:0x7fd44335cf68 /master/listener1 (Listener)>
-listener.ask!(:number)                             # => 20
-
+    # => #<Concurrent::Actor::Reference:0x7fa5958909d0 /master/listener1 (Listener)>
+listener.ask!(:number)                             # => 12
+# crash the listener which is supervised by master, it's restarted automatically reporting a different number
 listener.tell(:crash)
-    # => #<Concurrent::Actor::Reference:0x7fd44335cf68 /master/listener1 (Listener)>
-listener.ask!(:number)                             # => 41
+    # => #<Concurrent::Actor::Reference:0x7fa5958909d0 /master/listener1 (Listener)>
+listener.ask!(:number)                             # => 65
 
 master << :crash
-    # => #<Concurrent::Actor::Reference:0x7fd443366568 /master (Master)>
+    # => #<Concurrent::Actor::Reference:0x7fa595899fa8 /master (Master)>
 
 sleep 0.1                                          # => 0
 
-# ask for listener again, old one is terminated
+# ask for listener again, old one is terminated with master and replaced with new one
 listener.ask!(:terminated?)                        # => true
 listener = master.ask!(:listener)
-    # => #<Concurrent::Actor::Reference:0x7fd4433357b0 /master/listener1 (Listener)>
-listener.ask!(:number)                             # => 12
+    # => #<Concurrent::Actor::Reference:0x7fa5970d5608 /master/listener1 (Listener)>
+listener.ask!(:number)                             # => 77
 
 master.ask!(:terminate!)                           # => [[true], true]