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-docs/rst/java/code/docs/pattern/SchedulerPatternTest.java

@@ -121,13 +121,7 @@ public class SchedulerPatternTest {
   public void scheduleInConstructor() {
     new TestSchedule(system) {{
       final JavaTestKit probe = new JavaTestKit(system);
-
-      final Props props = new Props(new UntypedActorFactory() {
-        public UntypedActor create() {
-          return new ScheduleInConstructor(probe.getRef());
-        }
-      });
-
+      final Props props = Props.create(ScheduleInConstructor.class, probe.getRef());
       testSchedule(probe, props, duration("3000 millis"), duration("2000 millis"));
     }};
   }
@@ -135,16 +129,9 @@ public class SchedulerPatternTest {
   @Test
   @Ignore // no way to tag this as timing sensitive
   public void scheduleInReceive() {
-
     new TestSchedule(system) {{
       final JavaTestKit probe = new JavaTestKit(system);
-
-      final Props props = new Props(new UntypedActorFactory() {
-        public UntypedActor create() {
-          return new ScheduleInReceive(probe.getRef());
-        }
-      });
-
+      final Props props = Props.create(ScheduleInReceive.class, probe.getRef());
       testSchedule(probe, props, duration("3000 millis"), duration("2500 millis"));
     }};
   }

akka-docs/rst/java/code/docs/pattern/SupervisedAsk.java

@@ -45,7 +45,7 @@ public class SupervisedAsk {
     public void onReceive(Object message) throws Exception {
       if (message instanceof AskParam) {
         ActorRef supervisor = getContext().actorOf(
-            Props.apply(AskSupervisor.class));
+            Props.create(AskSupervisor.class));
         supervisor.forward(message, getContext());
       } else {
         unhandled(message);
@@ -104,6 +104,6 @@ public class SupervisedAsk {
 
   synchronized public static ActorRef createSupervisorCreator(
       ActorRefFactory factory) {
-    return factory.actorOf(Props.apply(AskSupervisorCreator.class));
+    return factory.actorOf(Props.create(AskSupervisorCreator.class));
   }
 }

akka-docs/rst/java/code/docs/pattern/SupervisedAskSpec.java

@@ -18,7 +18,7 @@ public class SupervisedAskSpec {
       ActorRef supervisorCreator = SupervisedAsk
           .createSupervisorCreator(actorSystem);
       Future<Object> finished = SupervisedAsk.askOf(supervisorCreator,
-          Props.apply(someActor), message, timeout);
+          Props.create(someActor), message, timeout);
       return Await.result(finished, timeout.duration());
     } catch (Exception e) {
       // exception propagated by supervision