Merge remote-tracking branch 'origin/master' into wip-1836-durMB-settings-∂π

... and fix up MailboxType docs with new constructor signature.

akka-docs/java/code/akka/docs/dispatcher/DispatcherDocTestBase.java

@@ -60,19 +60,17 @@ public class DispatcherDocTestBase {
   @Test
   public void defineDispatcher() {
     //#defining-dispatcher
-    ActorRef myActor1 = system.actorOf(new Props(MyUntypedActor.class).withDispatcher("my-dispatcher"),
-        "myactor1");
-    ActorRef myActor2 = system.actorOf(new Props(MyUntypedActor.class).withDispatcher("my-dispatcher"),
-        "myactor2");
+    ActorRef myActor =
+      system.actorOf(new Props(MyUntypedActor.class).withDispatcher("my-dispatcher"),
+        "myactor3");
     //#defining-dispatcher
   }
 
   @Test
   public void definePinnedDispatcher() {
     //#defining-pinned-dispatcher
-    String name = "myactor";
     ActorRef myActor = system.actorOf(new Props(MyUntypedActor.class)
-        .withDispatcher("myactor-dispatcher"), name);
+        .withDispatcher("my-pinned-dispatcher"));
     //#defining-pinned-dispatcher
   }
 
@@ -80,11 +78,13 @@ public class DispatcherDocTestBase {
   public void priorityDispatcher() throws Exception {
     //#prio-dispatcher
 
-    ActorRef myActor = system.actorOf( // We create a new Actor that just prints out what it processes
+      // We create a new Actor that just prints out what it processes
+    ActorRef myActor = system.actorOf(
         new Props().withCreator(new UntypedActorFactory() {
           public UntypedActor create() {
             return new UntypedActor() {
-              LoggingAdapter log = Logging.getLogger(getContext().system(), this);
+              LoggingAdapter log =
+                      Logging.getLogger(getContext().system(), this);
               {
                 getSelf().tell("lowpriority");
                 getSelf().tell("lowpriority");
@@ -101,7 +101,7 @@ public class DispatcherDocTestBase {
               }
             };
           }
-        }).withDispatcher("prio-dispatcher-java"));
+        }).withDispatcher("prio-dispatcher"));
 
     /*
     Logs:
@@ -123,19 +123,20 @@ public class DispatcherDocTestBase {
   }
 
   //#prio-mailbox
-  public static class PrioMailbox extends UnboundedPriorityMailbox {
-    public PrioMailbox(ActorSystem.Settings settings, Config config) { // needed for reflective instantiation
-      super(new PriorityGenerator() { // Create a new PriorityGenerator, lower prio means more important
+  public static class MyPrioMailbox extends UnboundedPriorityMailbox {
+    public MyPrioMailbox(ActorSystem.Settings settings, Config config) { // needed for reflective instantiation
+      // Create a new PriorityGenerator, lower prio means more important
+      super(new PriorityGenerator() {
         @Override
         public int gen(Object message) {
           if (message.equals("highpriority"))
             return 0; // 'highpriority messages should be treated first if possible
           else if (message.equals("lowpriority"))
-            return 100; // 'lowpriority messages should be treated last if possible
+            return 2; // 'lowpriority messages should be treated last if possible
           else if (message.equals(Actors.poisonPill()))
-            return 1000; // PoisonPill when no other left
+            return 3; // PoisonPill when no other left
           else
-            return 50; // We default to 50
+            return 1; // By default they go between high and low prio
         }
       });
     }