add small hint for programmatic remoting config, see #2604

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
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^