Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

LUCENE-4198: add format description for term impacts to javadocs #115

Merged
merged 1 commit into from
May 4, 2021

Conversation

mocobeta
Copy link
Contributor

@mocobeta mocobeta commented Apr 29, 2021

https://issues.apache.org/jira/browse/LUCENE-4198 introduced term impacts to PostingsFormat; this is a follow-up to fix the format documentation ("SkipDatum" part) to reflect the changes.

latest javadocs (for .doc file)
postingsformat_latest_javadoc

modified javadocs with this patch (for .doc file)
postingsformat_updated_javadoc

* <li>ImpactLength is the total length of CompetitiveFreqDelta and CompetitiveNormDelta
* pairs. CompetitiveFreqDelta and CompetitiveNormDelta are used to safely skip score
* calculation for uncompetitive documents; See {@link
* org.apache.lucene.codecs.CompetitiveImpactAccumulator} for more details.
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Also added brief description about the impacts.

@@ -299,7 +306,7 @@
* positions. Some payloads and offsets will be separated out into .pos file, for performance
* reasons.
* <ul>
* <li>PayFile(.pay): --&gt; Header, &lt;TermPayloads, TermOffsets?&gt;
* <li>PayFile(.pay): --&gt; Header, &lt;TermPayloads?, TermOffsets?&gt;
Copy link
Contributor Author

@mocobeta mocobeta Apr 29, 2021

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It is not related to LUCENE-4198 at all... but TermPayloads seems to be optional as well as TermOffsets.

if (writePayloads) {
pforUtil.encode(payloadLengthBuffer, payOut);
payOut.writeVInt(payloadByteUpto);
payOut.writeBytes(payloadBytes, 0, payloadByteUpto);
payloadByteUpto = 0;
}

@mocobeta
Copy link
Contributor Author

@jpountz Could you take a look at this.

Copy link
Contributor

@jpountz jpountz left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you!

@mocobeta mocobeta merged commit c33d211 into apache:main May 4, 2021
@mocobeta mocobeta deleted the jira/LUCENE-4198-update-javadoc branch May 4, 2021 01:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants