Skip to content

Accept partially qualified member types in javadoc links #517#5191

Open
kamilkrzywanski wants to merge 1 commit into
eclipse-jdt:masterfrom
kamilkrzywanski:issue_517
Open

Accept partially qualified member types in javadoc links #517#5191
kamilkrzywanski wants to merge 1 commit into
eclipse-jdt:masterfrom
kamilkrzywanski:issue_517

Conversation

@kamilkrzywanski

Copy link
Copy Markdown
Contributor

Summary

  • Package omission in member type Javadoc references (e.g. {@link Map.Entry} with import java.util.Map) was only allowed within the same package.
  • Allow package omission across packages as well, matching the Documentation Comment Specification and the standard doclet.
  • Wrong outer types (e.g. Test.Inner when the type is Foo.Inner) are still rejected.
  • Update related expectations (testBug222188a, testBug221539b) and add regression tests for issue 517.

Fixes #517

Test plan

  • JavadocBugsTest (3682 tests) — all pass with the fix
  • Existing cases that expected "Invalid member type qualification" for valid Type.Member via import updated to conform
  • New tests: Map.Entry with import, fully qualified, and wrong outer type still invalid



Package omission in member type references (e.g. {@link Map.Entry}
with import java.util.Map) was only allowed within the same package.
Allow it across packages as well, matching the Documentation Comment
Specification and the standard doclet. Wrong outer types (e.g.
Test.Inner when the type is Foo.Inner) are still rejected.

Update related testBug222188a/testBug221539b expectations and add
regression tests for issue 517.

Fixes eclipse-jdt#517

Signed-off-by: Kamil Krzywannski <kamilkrzywanski01@gmail.com>
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.

Javadoc: Invalid member type qualification

1 participant