: It would also simplify some scorers if doc() wasn't undefined before
: next() or skipTo() was called, but instead -1.

+1 ... but if we are goingg to change the API requirements for doc(),
we should clarify the requirements or score() ... with doc(), negative
numbers can easily be used as a marker of "invalid", but the same rule
isn't as easy to apply with the score() method ... perhaps the
documentation for doc() and score() should be...

    doc():   Returns the current document number matching the query.
             Returns -1 if neither next() or skipTo() have been called at
             least once, behavior is undefined if the last call to next()
             or skipTo returned false.
    score(): Returns the score of the current document matching the query.
             The value is undefined if doc() reurns -1, or if the last
             call to next() or skipTo returned false.


...we probably want to make the same API changes to Spans, TermEnum,
and TermDocs as well to be consistent.

-Hoss


---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to