From 8cbc3b5570cf3857b348e7fdb46658f077fc132a Mon Sep 17 00:00:00 2001 From: Konrad `ktoso` Malawski Date: Wed, 9 Aug 2017 23:13:43 +0900 Subject: [PATCH] +doc more details on akka.actor.Status support in ask (#23463) --- akka-docs/src/main/paradox/scala/actors.md | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/akka-docs/src/main/paradox/scala/actors.md b/akka-docs/src/main/paradox/scala/actors.md index e905ee540e..ed3be4de57 100644 --- a/akka-docs/src/main/paradox/scala/actors.md +++ b/akka-docs/src/main/paradox/scala/actors.md @@ -745,8 +745,12 @@ is available in the `akka.pattern.PatternsCS` object. @@@ warning -To complete the future with an exception you need send a Failure message to the sender. -This is *not done automatically* when an actor throws an exception while processing a message. +To complete the future with an exception you need to send an `akka.actor.Status.Failure` message to the sender. +This is *not done automatically* when an actor throws an exception while processing a message. + +Please note that Scala's `Try` sub types `scala.util.Failure` and `scala.util.Success` are not treated +specially, and would complete the ask Future with the given value - only the `akka.actor.Status` messages +are treated specially by the ask pattern. @@@