Repository: camel
Updated Branches:
  refs/heads/master 1ae2a56e8 -> 5fcb818ac


CAMEL-7472: Polished Javadoc describing the required steps for the manual run 
of the test.

Project: http://git-wip-us.apache.org/repos/asf/camel/repo
Commit: http://git-wip-us.apache.org/repos/asf/camel/commit/5fcb818a
Tree: http://git-wip-us.apache.org/repos/asf/camel/tree/5fcb818a
Diff: http://git-wip-us.apache.org/repos/asf/camel/diff/5fcb818a

Branch: refs/heads/master
Commit: 5fcb818ac134c825252548fddad7a95200a27a8c
Parents: 1ae2a56
Author: Babak Vahdat <bvah...@apache.org>
Authored: Fri May 30 00:14:43 2014 +0200
Committer: Babak Vahdat <bvah...@apache.org>
Committed: Fri May 30 00:14:43 2014 +0200

----------------------------------------------------------------------
 .../netty/NettyUDPMulticastAsyncTest.java       | 32 +++++++++-----------
 1 file changed, 15 insertions(+), 17 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/camel/blob/5fcb818a/components/camel-netty/src/test/java/org/apache/camel/component/netty/NettyUDPMulticastAsyncTest.java
----------------------------------------------------------------------
diff --git 
a/components/camel-netty/src/test/java/org/apache/camel/component/netty/NettyUDPMulticastAsyncTest.java
 
b/components/camel-netty/src/test/java/org/apache/camel/component/netty/NettyUDPMulticastAsyncTest.java
index 78bc7ce..4d9e816 100644
--- 
a/components/camel-netty/src/test/java/org/apache/camel/component/netty/NettyUDPMulticastAsyncTest.java
+++ 
b/components/camel-netty/src/test/java/org/apache/camel/component/netty/NettyUDPMulticastAsyncTest.java
@@ -29,28 +29,26 @@ import org.junit.Test;
 
 /**
  * To run this test manually through Maven first remove the {@link Ignore}
- * annotation below, then make sure you've got a Network interface with the 
name
+ * annotation below, then make sure you've got a network interface with the 
name
  * <code>en0</code> as given by the route below. If this is not the case run
- * your OS specific command to find out which Network interfaces you've got
- * supporting IPv4. For example on OS-X you can use the following command for
- * this:
+ * your OS specific command to find out which network interfaces you've got
+ * supporting IPv4 (e.g. on OS-X that would be the {@code ifconfig -a} command.
+ * Next you need to enable UDP multicast on your OS for the given multicast
+ * address of this test ({@code 224.1.2.3}). For this purpose e.g. on OS-X
+ * follow the steps being described <a href=
+ * 
"http://blogs.agilefaqs.com/2009/11/08/enabling-multicast-on-your-macos-unix/";
+ * >here</a>. Now running the test manually should succeed (<b>but only</b> 
when
+ * using Java7+):
  * 
  * <pre>
- *   <code>$> ifconfig -a</code>
+ *   mvn test -Djava.net.preferIPv4Stack=true -Dtest=NettyUDPMulticastAsyncTest
  * </pre>
  * 
- * Then replace the <code>en0</code> Network interface name below with your own
- * one. Now running the test manually should succeed (<b>only</b> when using
- * Java7+):
- * 
- * <pre>
- *   <code>mvn test -Djava.net.preferIPv4Stack=true 
-Dtest=NettyUDPMulticastAsyncTest</code>
- * </pre>
- * 
- * Note that the usage of JUnit {@link BeforeClass} annotation to achieve the
- * same effect would not work in this case as at that stage it would be too 
late
- * to use {@link System#setProperty(String, String) the Java API} to reach the
- * same effect. Also setting such a system property through the surefire-plugin
+ * Please note that using the JUnit {@link BeforeClass} annotation together 
with
+ * the corresponding {@link System#setProperty(String, String) Java API} to set
+ * the {@code java.net.preferIPv4Stack} system property would not work here as
+ * at that moment it would be too <b>late</b> to set this system property. On
+ * the other hand setting such a system property through the surefire-plugin
  * would cause side effect by the other tests of this component.
  */
 @Ignore("See the Javadoc")

Reply via email to