ISSUE-45: jndiContextParameter has unflagged RFC 2119 keywords, at least one is spurious

jndiContextParameter has unflagged RFC 2119

jndiContextParameter has unflagged RFC 2119 keywords, at least one is spurious

State:
CLOSED
Product:
SOAP-JMS Binding specification
Raised by:
Eric Johnson
Opened on:
2010-07-12
Description:
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."
Related Actions Items:
No related actions
Related emails:
  1. RE: Agenda for the 2010-08-17 conference call (from Derek.Rokicki@softwareag.com on 2010-08-17)
  2. Agenda for the 2010-08-17 conference call (from eric@tibco.com on 2010-08-16)
  3. Agenda for the 2010-08-03 conference call (from eric@tibco.com on 2010-08-02)
  4. Agenda for the 2010-07-27 conference call (from eric@tibco.com on 2010-07-26)
  5. Re: Agenda for the 2010-07-20 conference call (from eric@tibco.com on 2010-07-20)
  6. RE: Agenda for the 2010-07-20 conference call (from Derek.Rokicki@softwareag.com on 2010-07-20)
  7. Re: Agenda for the 2010-07-20 conference call (from phil_adams@us.ibm.com on 2010-07-20)
  8. Agenda for the 2010-07-20 conference call (from eric@tibco.com on 2010-07-19)
  9. ACTION-194 - apply resolutions to issues 41-46 (from eric@tibco.com on 2010-07-19)
  10. Agenda for the 2010-07-13 conference call (from eric@tibco.com on 2010-07-12)
  11. Re: ACTION 186 - top to bottom review of current copy of spec (from eric@tibco.com on 2010-07-12)
  12. ISSUE-45 (jndiContextParameter has unflagged RFC 2119): jndiContextParameter has unflagged RFC 2119 keywords, at least one is spurious [SOAP-JMS Binding specification] (from sysbot+tracker@w3.org on 2010-07-12)

Related notes:

Opened and resolved as per:
http://www.w3.org/2010/07/13-soap-jms-minutes.html

Eric Johnson, 15 Jul 2010, 20:55:53

Application of resolution of this issue accepted as per:
http://www.w3.org/2010/08/17-soap-jms-minutes.html

Eric Johnson, 23 Aug 2010, 17:56:37

Display change log ATOM feed


Chair, Staff Contact
Tracker: documentation, (configuration for this group), originally developed by Dean Jackson, is developed and maintained by the Systems Team <w3t-sys@w3.org>.
$Id: 45.html,v 1.1 2013-09-16 14:06:36 carine Exp $