Author: ron.sigal(a)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.or...;. + 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>