[ 
https://issues.apache.org/jira/browse/LUCENE-1896?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12752763#action_12752763
 ] 

Hoss Man commented on LUCENE-1896:
----------------------------------

as i mentioned in the linked thread, the biggest advantage i know of for 
queryNorm is that it is a reduction factor applied to the constituent parts of 
a complex score prior to multiplication -- so it helps prevent loss of 
information due to floating point accuracy that could arrise otherwise.

but then again: that'swhat the *default* queryNorm does ... an alternate 
queryNorm could do something (like be a no-op)

Since the target audience of the Similarity javadocs are mainly people who are 
interested in customizing the scoring, perhaps it should be something like...

{quote}
The queryNorm is a uniform normalization factor computed from the 
sumOfSquareWeights for the query which is then applied to each of the clauses 
of the query.  In some cases this can be useful for attempting to keep scores 
from simple queries semi-comparable.  The Default implementation is...
{quote} 

> Modify confusing javadoc for queryNorm
> --------------------------------------
>
>                 Key: LUCENE-1896
>                 URL: https://issues.apache.org/jira/browse/LUCENE-1896
>             Project: Lucene - Java
>          Issue Type: Improvement
>          Components: Javadocs
>            Reporter: Jiri Kuhn
>            Priority: Minor
>             Fix For: 2.9
>
>
> See http://markmail.org/message/arai6silfiktwcer
> The javadoc confuses me as well.

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.


---------------------------------------------------------------------
To unsubscribe, e-mail: java-dev-unsubscr...@lucene.apache.org
For additional commands, e-mail: java-dev-h...@lucene.apache.org

Reply via email to