RFR: 8329644: Discuss expected visitor evolution patterns in javax.lang.model.util [v8]

[Joe Darcy]

On Fri, 19 Apr 2024 19:00:18 GMT, Jonathan Gibbons <jjg at openjdk.org> wrote:

>> Joe Darcy has updated the pull request incrementally with one additional commit since the last revision:
>> 
>>   Implement review feedback; add link in remainder of preview visitor classes.
>
> src/java.compiler/share/classes/javax/lang/model/util/AbstractAnnotationValueVisitorPreview.java line 43:
> 
>> 41:  * @param <P> the type of the additional parameter to this visitor's methods.
>> 42:  *
>> 43: * @see <a href="package-summary.html#expectedEvolution">
> 
> FWIW, I would expect that you could write this as
> 
> 
> @see package-name##id   description

I tried something like

`@see package-info##foo Description of Foo`

but that didn't work, hence the use of HTML. I'll try out the variation you suggested here and if it works file a quick follow-up bug.

-------------

PR Review Comment: https://git.openjdk.org/jdk/pull/18804#discussion_r1572822214