Re: [Gen-art] Gen-ART review of draf-merrick-jms-uri-10

["Vijay K. Gurbani" <[e-mail]>]

On 12/06/2010 11:54 AM, Eric Johnson wrote:
> Hi Vijay,
>
> Thanks for your review! I was just wondering if I should be "ping"ing
> anyone about it.

Eric: For that I have no idea.  You may want to check with your
co-authors regarding the edits and with Alexey on next steps since
this is an AD-sponsored draft.

> I'm more than happy to post a new draft with some edits, but I have
> questions below:

Please see inline.

> OK. What if I change this:
> The required particles in the JMS URI are the scheme name ("jms"), the
> variant identifier, and the <jms-dest> portions. The three recognized
> variants (<jms-variant> above) are "jndi", "queue", and "topic". The
> <jms-dest> portion identifies the JMS destination object in a way that
> is determined by the particular variant. Both the variant, and the
> jms-dest portions of the URI are case-sensitive.
>
> To this:
>
> "The required portions of the syntax include the terminal of "jms" for
> the URI scheme name, the <jms-variant> element to indicate the variant
> of the scheme, and the <jms-dest> element, which identifies the
> destination based on the chosen variant. For the <jms-variant> element,
> this document defines three values: "jndi", "queue", and "topic". Both
> the <jms-variant>, and the <jms-dest> elements of the URI are
> case-sensitive.

I think it is fine with one caveat: the last sentence can simply
state that "All the terminals resulting from <jms-variant> and
<jms-dest> production rule are case-sensitive."

>> * S4.4 -- I am not sure why the second paragraph starts with
>> an underline character: _Warning_. This will probably render using a
>> different font, etc. on a browser, but in the printed page it will
>> loose its meaning. Maybe best to s/_Warning_/Warning/
>
> This is how XML 2 RFC appears to render something with emphasis. Looks
> fine in the HTML rendering. Can you suggest an alternate construct I
> could put in the XML form, rather than the current form?
>
> <spanx style="emph">Warning</spanx>

Ah, OK.  I was not aware of the <spanx> element in xml2rfc.  If
that's what it does then that's what it does.

Thanks,

- vijay
-- 
Vijay K. Gurbani, Bell Laboratories, Alcatel-Lucent
1960 Lucent Lane, Rm. 9C-533, Naperville, Illinois 60566 (USA)
Email: vkg@{alcatel-lucent.com,bell-labs.com,acm.org}
Web:   http://ect.bell-labs.com/who/vkg/