doc: Add a note about actor-alive? being likely to be deprecated.
authorChristopher Allan Webber <cwebber@dustycloud.org>
Fri, 6 Jan 2017 22:23:50 +0000 (16:23 -0600)
committerChristopher Allan Webber <cwebber@dustycloud.org>
Fri, 6 Jan 2017 22:23:50 +0000 (16:23 -0600)
* doc/8sync-new-manual.org: Add footnote about future deprecation of
actor-alive?.

doc/8sync-new-manual.org

index 269dafbb116d1c0527a071a10dedee3984c023c1..844653fa0b6a3da7eedd30ad376775d65fcc5759 100644 (file)
@@ -409,7 +409,7 @@ and will always yield to the scheduler.
 Our while loop also checks "actor-alive?" to see whether or not
 it is still registered.
 In general, if you keep a loop in your actor that regularly yields
-to the scheduler, you should check this.
+to the scheduler, you should check this.[fn:actor-alive-deprecated-soon]
 (An alternate way to handle it would be to not use a while loop at all
 but simply send a message to ourselves with "<-" to call the
 sleeper-loop handler again.
@@ -646,6 +646,12 @@ manager> Oh!  I guess you can go home then.
 worker> Whew!  Free at last.
 #+END_SRC
 
+[fn:actor-alive-deprecated-soon]
+  Or rather, for now you should call =actor-alive?= if your code
+  is looping like this.
+  In the future, after an actor dies, its coroutines will
+  automatically be "canceled".
+
 ** Writing our own network-enabled actor
 
 So, you want to write a networked actor!