[jboss-remoting-commits] JBoss Remoting SVN: r5722 - remoting2/branches/2.x/docs/guide/en.

[jboss-remoting-commits at lists.jboss.org]

Author: ron.sigal at jboss.com
Date: 2010-02-17 17:41:28 -0500 (Wed, 17 Feb 2010)
New Revision: 5722

Modified:
   remoting2/branches/2.x/docs/guide/en/chap3.xml
   remoting2/branches/2.x/docs/guide/en/chap5.xml
Log:
JBREM-1180: Added note about InvokerLocator system property suppressHostWarning.

Modified: remoting2/branches/2.x/docs/guide/en/chap3.xml
===================================================================
--- remoting2/branches/2.x/docs/guide/en/chap3.xml	2010-02-17 21:47:01 UTC (rev 5721)
+++ remoting2/branches/2.x/docs/guide/en/chap3.xml	2010-02-17 22:41:28 UTC (rev 5722)
@@ -63,6 +63,16 @@
   <methodname>org.jboss.remoting.InvokerLocator.setUseLegacyParsing()</methodname>.
   </para>
   
+  <para><emphasis role="bold">N.B.</emphasis>The syntax of URIs is defined in 
+  <ulink url="http://www.ietf.org/rfc/rfc2396.txt">http://www.ietf.org/rfc/rfc2396.txt</ulink>.
+  A not unknown error is to give a hostname with the illegal underscore character "_", which
+  confuses the <classname>java.net.URI</classname> parsing algorithm, leading to the hostname
+  being set to null.  As of release 2.5.2.SP3, <classname>org.jboss.remoting.InvokerLocator</classname>
+  will log a warning if the hostname is set to null. This warning can be disabled by setting
+  the system property <code>InvokerLocator.SUPPRESS_HOST_WARNING</code> (actual value
+  "suppressHostWarning") to "true".
+  </para>
+  
   <para><emphasis
   role="bold">org.jboss.remoting.transport.Connector</emphasis> - is an MBean
   that loads a particular ServerInvoker implementation for a given transport

Modified: remoting2/branches/2.x/docs/guide/en/chap5.xml
===================================================================
--- remoting2/branches/2.x/docs/guide/en/chap5.xml	2010-02-17 21:47:01 UTC (rev 5721)
+++ remoting2/branches/2.x/docs/guide/en/chap5.xml	2010-02-17 22:41:28 UTC (rev 5722)
@@ -5985,6 +5985,11 @@
     renewal and must be greater than zero in order to be recognized. If this
     property is not set (and CLIENT_LEASE is), will use the lease period as
     specified by the server.</para>
+    
+    <para><emphasis role="bold">SUPPRESS_HOST_WARNING</emphasis> (actual value is
+    'suppressHostWarning') - the boolean valued system property that determines if 
+    <classname>InvokerLocator</classname> should log a warning that the hostname is
+    null.  The default value is "false", i.e., the warning is logged by default.</para>
 
     </section>