The FastVectorHighlighterSample does most of what I need, but I see that it fails if a wildcard is used (eg "f?x" will not highlight "fox"). Is there a description anywhere of how I can find the tokens that were matched by the query? Assuming that I store the field and use WITH_POSITIONS_OFFSETS, how do I determine that a query found a document and that a search term was found at a certain position or offset?

Can you ask this on Lucene's user's list instead? (java-user@lucene.apache.org).

I will, thanks. But I was really asking if the book described the info I was looking for.

I don't think the book drills down in enough detail for this level of debugging. The closest is using Query.explain(...) to see details of whether the query matched a given doc. But this does not enumerate positional details that you need for highlighter debugging...