deprecate closure-taking Props factories, see #3081

- base Props on Deploy, Class and Seq[Any] (i.e. constructor args)
- remove deprecated Props usage from akka-docs sample code
- rewrite UntypedActorDocTestBase
- rewrite Java/Scala doc section on actor creation
- add migration guide entry

akka-remote/src/main/scala/akka/remote/serialization/DaemonMsgCreateSerializer.scala

@@ -12,7 +12,6 @@ import akka.actor.{ Actor, ActorRef, Deploy, ExtendedActorSystem, NoScopeGiven,
 import akka.remote.DaemonMsgCreate
 import akka.remote.RemoteProtocol.{ DaemonMsgCreateProtocol, DeployProtocol, PropsProtocol }
 import akka.routing.{ NoRouter, RouterConfig }
-import akka.actor.FromClassCreator
 import scala.reflect.ClassTag
 import util.{ Failure, Success }
 
@@ -51,15 +50,11 @@ private[akka] class DaemonMsgCreateSerializer(val system: ExtendedActorSystem) e
       }
 
       def propsProto = {
-        val builder = PropsProtocol.newBuilder.
-          setDispatcher(props.dispatcher).
-          setDeploy(deployProto(props.deploy))
-        props.creator match {
-          case FromClassCreator(clazz) ⇒ builder.setFromClassCreator(clazz.getName)
-          case creator                 ⇒ builder.setCreator(serialize(creator))
-        }
-        if (props.routerConfig != NoRouter)
-          builder.setRouterConfig(serialize(props.routerConfig))
+        val builder = PropsProtocol.newBuilder
+          .setClazz(props.clazz.getName)
+          .setDeploy(deployProto(props.deploy))
+        props.args map serialize foreach builder.addArgs
+        props.args map (_.getClass.getName) foreach builder.addClasses
         builder.build
       }
 
@@ -95,21 +90,11 @@ private[akka] class DaemonMsgCreateSerializer(val system: ExtendedActorSystem) e
     }
 
     def props = {
-      val creator =
-        if (proto.getProps.hasFromClassCreator)
-          FromClassCreator(system.dynamicAccess.getClassFor[Actor](proto.getProps.getFromClassCreator).get)
-        else
-          deserialize(proto.getProps.getCreator, classOf[() ⇒ Actor])
-
-      val routerConfig =
-        if (proto.getProps.hasRouterConfig) deserialize(proto.getProps.getRouterConfig, classOf[RouterConfig])
-        else NoRouter
-
-      Props(
-        creator = creator,
-        dispatcher = proto.getProps.getDispatcher,
-        routerConfig = routerConfig,
-        deploy = deploy(proto.getProps.getDeploy))
+      import scala.collection.JavaConverters._
+      val clazz = system.dynamicAccess.getClassFor[AnyRef](proto.getProps.getClazz).get
+      val args: Vector[AnyRef] = (proto.getProps.getArgsList.asScala zip proto.getProps.getClassesList.asScala)
+        .map(p ⇒ deserialize(p._1, system.dynamicAccess.getClassFor[AnyRef](p._2).get))(collection.breakOut)
+      Props(deploy(proto.getProps.getDeploy), clazz, args)
     }
 
     DaemonMsgCreate(
@@ -119,7 +104,7 @@ private[akka] class DaemonMsgCreateSerializer(val system: ExtendedActorSystem) e
       supervisor = deserializeActorRef(system, proto.getSupervisor))
   }
 
-  protected def serialize(any: AnyRef): ByteString = ByteString.copyFrom(serialization.serialize(any).get)
+  protected def serialize(any: Any): ByteString = ByteString.copyFrom(serialization.serialize(any.asInstanceOf[AnyRef]).get)
 
   protected def deserialize[T: ClassTag](data: ByteString, clazz: Class[T]): T = {
     val bytes = data.toByteArray