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

[Jonathan Gibbons]

On Fri, 19 Apr 2024 19:16:54 GMT, Joe Darcy <darcy at openjdk.org> wrote:

>> 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.

Yes, it needs to be an element name before the `##`

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

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