9541 2010-04-16 15:59:27 +0000 TokenInfo term confusing 2011-01-05 22:12:35 +0000 1 1 1 Unclassified XPath / XQuery / XSLT Full Text 1.0 Proposed Recommendation All All RESOLVED LATER P2 normal --- 1 paul jim.melton liam pcase public-qt-comments oldest_to_newest 35105 0 paul 2010-04-16 15:59:27 +0000 From section 4.1.2: Definition: A TokenInfo represents a contiguous collection of tokens from an XML document. In comparison for QueryTokenInfo: Definition: A QueryTokenInfo is the identity of a [single] token inside a query string. Assuming that my insertion of the word "single" into the definition of QueryTokenInfo for clarity is correct, then a QueryTokenInfo is info for a single token whereas TokenInfo is info for "a contiguous collection of tokens." The name "TokenInfo" sounds like it has info only for a single token, but it actually is either a "range" or "span" of info for "a contiguous collection of tokens." I therefore suggest that "TokenInfo" be renamed to something like "TokenSpan" or "TokenRange". 35560 1 liam 2010-05-11 16:33:36 +0000 The joint Working Groups considered this, and agreed it would be an improvement, but we don't have resources to justify this sort of change rght now. You could always consider joining the Working Group... 35565 2 paul 2010-05-11 17:23:29 +0000 In private communication with Liam Quin, he suggested that if I "feel strongly that [the name change] needs to be done now, please reopen the bug and we'll reconsider." OK, so I'm reopening it. While the mere name of something might seem trivial, it's important to choose good names and the earlier the better. Names affect how people talk about things, how implementers will name their data structures, how others will write their own documentation, papers, books, etc. Naturally, people will use the names used in the specification. If a name is confusing, it will only cause the confusion to proliferate. If the name is changed in a future release, then there will already be legacy documentation, books, code, etc., that uses the old name. Speaking as an XQuery Full Text implementor, XQuery, although being a rich and expressive language, is quite a complicated language, both for users and implementors. Having clear names for things is a necessary foundation. Thank you for your reconsideration. 35749 3 pcase 2010-05-18 15:59:03 +0000 Paul, The XQuery and XSL Working Groups did not have concensus to change the name of TokenInfo at this time. We may consider the change in a future verion. Pat Case, Library of Congress, Member XQuery Working Group 43833 4 paul 2011-01-05 22:12:35 +0000 OK, well if you're not going to change it, I see no reason to close the bug.