[
https://issues.apache.org/jira/browse/LUCENE-10575?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17537544#comment-17537544
]
ASF subversion and git services commented on LUCENE-10575:
----------------------------------------------------------
Commit 520d771ebac1c2da822b74e2a44f3c096d5f96f6 in lucene's branch
refs/heads/branch_9x from Alan Woodward
[ https://gitbox.apache.org/repos/asf?p=lucene.git;h=520d771ebac ]
LUCENE-10575: Fix some visibility issues (#894)
> Broken links in some javadocs
> -----------------------------
>
> Key: LUCENE-10575
> URL: https://issues.apache.org/jira/browse/LUCENE-10575
> Project: Lucene - Core
> Issue Type: Bug
> Reporter: Alan Woodward
> Priority: Major
> Time Spent: 0.5h
> Remaining Estimate: 0h
>
> The release wizard for 9.2 has found some broken javadoc links:
> * ExternalRefSorter refers to package-private implementations when it should
> probably refer to the relevant interfaces instead
> * STMergingTermsEnum refers to package-private classes. I think we can
> solve this by making the whole class package-private, given that it's an
> implementation detail within a Codec?
> * MatchRegionRetriever links to an internal implementation, which should
> just be described rather than linked.
>
> These are all fairly simple to fix, and I will open a PR to do so. Slightly
> more worrying is that running `./gradlew
> lucene:documentation:checkBrokenLinks` does not seem to consistently find
> these problems. The release wizard runs against an entirely clean checkout
> and fails, but attempting to reproduce the failure on an existing checkout
> produces a green build. Some of these broken links have been around for a
> while - the STMergingTermsEnum ones since 2019 - so it may just be luck that
> I found them this time round.
--
This message was sent by Atlassian Jira
(v8.20.7#820007)
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscr...@lucene.apache.org
For additional commands, e-mail: issues-h...@lucene.apache.org
