ISSUE-45 (jndiContextParameter has unflagged RFC 2119): jndiContextParameter has unflagged RFC 2119 keywords, at least one is spurious [SOAP-JMS Binding specification]

ISSUE-45 (jndiContextParameter has unflagged RFC 2119): jndiContextParameter has unflagged RFC 2119 keywords, at least one is spurious [SOAP-JMS Binding specification]

http://www.w3.org/2002/ws/soapjms/tracker/issues/45

Raised by: Eric Johnson
On product: SOAP-JMS Binding specification

>From email:
http://lists.w3.org/Archives/Public/public-soap-jms/2010Jul/0013.html

For the definition of the jndiContext parameter in section 2.2.1:

The second bullet starts with:
"An optional property that MAY be specified more than once."  This RFC 2119 keyword is not flagged as an assertion.  Also, the statement is likely not normative, but merely informative.

The fourth bullet starts with:
"The JNDI property's name MUST be included in the name  attribute, its value MUST be included in the value attribute".  This normative statement doesn't mean anything in the context of the URI representation, and in the context of the WSDL representation, XML Schema conformance is likely the broader concern.

Proposal:

For the jndiContextParameter definition, change the second bullet to start:
"An optional property that can be specified more than once."

Change the fourth bullet to start:
"In XML form the JNDI property's name is defined by the name attribute of the jndiContextParameter element, and the JNDI property value is defined by the value attribute.  When indicated in a URI, the name of the JNDI property is derived from dropping the 'jndi-' prefix from any parameter name starting that way, and the value comes from the parameter value."

Received on Monday, 12 July 2010 23:28:32 UTC