add small hint for programmatic remoting config, see #2604

akka-docs/rst/java/code/docs/remoting/RemoteDeploymentDocTestBase.java

@@ -7,6 +7,8 @@ import org.junit.AfterClass;
 import org.junit.BeforeClass;
 import org.junit.Test;
 
+import com.typesafe.config.ConfigFactory;
+
 //#import
 import akka.actor.ActorRef;
 import akka.actor.Address;
@@ -61,5 +63,13 @@ public class RemoteDeploymentDocTestBase {
     //#sample-actor
   }
   
+  @Test
+  public void demonstrateProgrammaticConfig() {
+    //#programmatic
+    ConfigFactory.parseString("akka.remote.netty.hostname=\"1.2.3.4\"")
+        .withFallback(ConfigFactory.load());
+    //#programmatic
+  }
+
   
 }

akka-docs/rst/java/remoting.rst

@@ -60,6 +60,13 @@ reference file for more information:
 .. literalinclude:: ../../../akka-remote/src/main/resources/reference.conf
    :language: none
 
+.. note::
+
+   Setting properties like the listening IP and port number programmatically is
+   best done by using something like the following:
+
+   .. includecode:: code/docs/remoting/RemoteDeploymentDocTestBase.java#programmatic
+
 Looking up Remote Actors
 ^^^^^^^^^^^^^^^^^^^^^^^^
 

akka-docs/rst/scala/remoting.rst

@@ -57,6 +57,13 @@ reference file for more information:
 .. literalinclude:: ../../../akka-remote/src/main/resources/reference.conf
    :language: none
 
+.. note::
+
+   Setting properties like the listening IP and port number programmatically is
+   best done by using something like the following:
+
+   .. includecode:: ../java/code/docs/remoting/RemoteDeploymentDocTestBase.java#programmatic
+
 Types of Remote Interaction
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^