[idxp-java-discuss] IDXP-03 RC5

[<Ben...@gu...>]

Hey ya'll,

Here is IDXP-03 Release Candidate 5, encorporating the comments I received
this afternoon from Darren New and John White.  My reply to John's comments
are below.

Cheers,
Ben

-----Original Message-----
From: John C. C. White [mailto:jc...@mi...]
Sent: Tuesday, September 04, 2001 3:43 PM
To: Ben...@gu...
Cc: idx...@li...; jer...@gu...
Subject: Re: [idxp-java-discuss] IDXP-03 RC4


> A few comments:
>
> Section 3.3   I think the first sentence should be "MUST" instead of
> "may", unless there are other MIME content-types possible.

Agreed.

> Section 3.4.1  The last sentence of the first paragraph should start
> with "One" instead of "Zero." Otherwise it's just a tautology (i.e.,
> there are no other conceivable possibilities, so it's not meaningful).
> Same for the only paragraph of section 3.4.2, and the third paragraph of
> section 4.

Agreed.

> Section 4   The third paragraph says that the "mustUnderstand" attribute
> MUST be present, but it isn't present in the first two examples after
> that, and some of the later text essentially forbids it. Perhaps it
> should be optional, with an assumed value of FALSE, if it is not present?

I agree, "mustUnderstand" is now optional and defaults to "false".

> Section 8.2 and 8.3  There are two lines that exceed the allowable line
> width; they need to be rearranged or have a continuation character
inserted.

Fixed.  Also, at Darren New's suggestion, I've eliminated the URLs in my
ENTITY declarations.

> Appendix B.1   Should include "Modified Sections 2, 3 and 4 to use the
> requirements language specified by [2]."

Agreed.

> And finally, a true nit-pick: I believe that when a sentence ends with a
> quoted element, the final period belongs INSIDE the closing quotation
> mark. This is not necessarily logical, but there are several cases in
> the document which violate this usage. My dictionary is a little vague
> on this, and I won't be offended at all if this comment is simply ignored.

I agree that grammatically, the period always belongs inside the closing
quotation mark.  However, since my use of quotation marks are really to
indicate special string values, and not quotations per se, I feel that this
deviation from proper English grammer is warranted.  Otherwise, a resonable
person might misconstrue that the period is really a part of the special
string value.  Does this seem reasonable to others?