RFR: 8355223: Improve documentation on @IntrinsicCandidate [v5]

[Chen Liang]

On Wed, 23 Apr 2025 14:12:29 GMT, Chen Liang <liach at openjdk.org> wrote:

>> In offline discussion, we noted that the documentation on this annotation does not recommend minimizing the intrinsified section and moving whatever can be done in Java to Java; thus I prepared this documentation update, to shrink a "TLDR" essay to something concise for readers, such as pointing to that list at `vmIntrinsics.hpp` instead of "a list".
>
> Chen Liang has updated the pull request incrementally with one additional commit since the last revision:
> 
>   Update src/java.base/share/classes/jdk/internal/vm/annotation/IntrinsicCandidate.java
>   
>   Co-authored-by: Raffaello Giulietti <raffaello.giulietti at oracle.com>

Thanks for the suggestion. In this aspect, intrinsification is just a topic under this annotation - "intrinsic" is mainly a special identifier for hardcoded logic, but the exact purpose is unspecified, with intrinsification being the most common one.

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

PR Comment: https://git.openjdk.org/jdk/pull/24777#issuecomment-2843500730