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/camel/sample/http/HttpSample.java

@@ -9,19 +9,15 @@ public class HttpSample {
     // run the example in the MicroKernel. Just add the three lines below
     // to your boot class.
     ActorSystem system = ActorSystem.create("some-system");
-    final ActorRef httpTransformer = system.actorOf(new Props(HttpTransformer.class));
+    
+    final ActorRef httpTransformer = system.actorOf(
+        Props.create(HttpTransformer.class));
 
-    final ActorRef httpProducer = system.actorOf(new Props(new UntypedActorFactory(){
-      public Actor create() {
-        return new HttpProducer(httpTransformer);
-      }
-    }));
-
-    ActorRef httpConsumer = system.actorOf(new Props(new UntypedActorFactory(){
-      public Actor create() {
-        return new HttpConsumer(httpProducer);
-      }
-    }));
+    final ActorRef httpProducer = system.actorOf(
+        Props.create(HttpProducer.class, httpTransformer));
+    
+    final ActorRef httpConsumer = system.actorOf(
+        Props.create(HttpConsumer.class, httpProducer));
     //#HttpExample
   }
 }

akka-docs/rst/java/code/docs/camel/sample/quartz/QuartzSample.java

@@ -6,7 +6,7 @@ import akka.actor.Props;
 public class QuartzSample {
   public static void main(String[] args) {
     ActorSystem system = ActorSystem.create("my-quartz-system");
-    system.actorOf(new Props(MyQuartzActor.class));
+    system.actorOf(Props.create(MyQuartzActor.class));
   }
 }
 //#QuartzExample

akka-docs/rst/java/code/docs/camel/sample/route/CustomRouteSample.java

@@ -4,25 +4,16 @@ import akka.actor.*;
 import akka.camel.CamelExtension;
 
 public class CustomRouteSample {
+  @SuppressWarnings("unused")
   public static void main(String[] args) {
     try {
       //#CustomRouteExample
       // the below lines can be added to a Boot class, so that you can run the
       // example from a MicroKernel
       ActorSystem system = ActorSystem.create("some-system");
-      final ActorRef producer = system.actorOf(new Props(Producer1.class));
-      final ActorRef mediator = system.actorOf(new Props(new UntypedActorFactory() {
-        public Actor create() {
-          return new Transformer(producer);
-
-        }
-      }));
-      ActorRef consumer = system.actorOf(new Props(new UntypedActorFactory() {
-        public Actor create() {
-          return new Consumer3(mediator);
-
-        }
-      }));
+      final ActorRef producer = system.actorOf(Props.create(Producer1.class));
+      final ActorRef mediator = system.actorOf(Props.create(Transformer.class, producer));
+      final ActorRef consumer = system.actorOf(Props.create(Consumer3.class, mediator));
       CamelExtension.get(system).context().addRoutes(new CustomRouteBuilder());
       //#CustomRouteExample
     } catch (Exception e) {