[Bug 9541] New: TokenInfo term confusing

http://www.w3.org/Bugs/Public/show_bug.cgi?id=9541

           Summary: TokenInfo term confusing
           Product: XPath / XQuery / XSLT
           Version: Proposed Recommendation
          Platform: All
        OS/Version: All
            Status: NEW
          Severity: normal
          Priority: P2
         Component: Full Text 1.0
        AssignedTo: jim.melton@acm.org
        ReportedBy: paul@lucasmail.org
         QAContact: public-qt-comments@w3.org


>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".

-- 
Configure bugmail: http://www.w3.org/Bugs/Public/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the QA contact for the bug.

Received on Friday, 16 April 2010 15:59:29 UTC