I have fixed the javadoc for "Modified Score" formular in CustomScoreQuery. - Patch attached: customScoreQuery_JavaDoc.patch
I'm quite curious why the method:
public float customScore(int doc, float subQueryScore, float valSrcScores)
calls public float customScore(int doc, float subQueryScore, float valSrcScore]) only in 2 of the 3 cases which makes the choice to override either one of the customScore methods dependent on the number of ValueSourceQuery passed to the constructor. I figure it would be more consistent if it would call the latter in all 3 cases.
I also attached a patch which proposes a fix for that issue. The patch does also include the JavaDoc issue mentioned above.