add missing @see annotations + use @linkplain

hibernate-core/src/main/java/org/hibernate/annotations/NamedNativeQuery.java

@@ -132,6 +132,8 @@
 	 *
 	 * @see org.hibernate.query.Query#setCacheMode(CacheMode)
 	 * @see org.hibernate.jpa.SpecHints#HINT_SPEC_CACHE_STORE_MODE
+	 *
+	 * @since 6.2
 	 */
 	CacheStoreMode cacheStoreMode() default CacheStoreMode.USE;
 
@@ -140,6 +142,8 @@
 	 *
 	 * @see org.hibernate.query.Query#setCacheMode(CacheMode)
 	 * @see org.hibernate.jpa.SpecHints#HINT_SPEC_CACHE_RETRIEVE_MODE
+	 *
+	 * @since 6.2
 	 */
 	CacheRetrieveMode cacheRetrieveMode() default CacheRetrieveMode.USE;
 

hibernate-core/src/main/java/org/hibernate/annotations/NamedQuery.java

@@ -54,6 +54,8 @@
 	 * {@link EntityManager#createNamedQuery(String, Class)}.
 	 *
 	 * @see jakarta.persistence.NamedQuery#resultClass()
+	 *
+	 * @since 7.0
 	 */
 	Class<?> resultClass() default void.class;
 
@@ -127,6 +129,8 @@
 	 *
 	 * @see org.hibernate.query.Query#setCacheStoreMode(CacheStoreMode)
 	 * @see org.hibernate.jpa.SpecHints#HINT_SPEC_CACHE_STORE_MODE
+	 *
+	 * @since 6.2
 	 */
 	CacheStoreMode cacheStoreMode() default CacheStoreMode.USE;
 
@@ -135,6 +139,8 @@
 	 *
 	 * @see org.hibernate.query.Query#setCacheRetrieveMode(CacheRetrieveMode)
 	 * @see org.hibernate.jpa.SpecHints#HINT_SPEC_CACHE_RETRIEVE_MODE
+	 *
+	 * @since 6.2
 	 */
 	CacheRetrieveMode cacheRetrieveMode() default CacheRetrieveMode.USE;
 

hibernate-core/src/main/java/org/hibernate/query/QueryFlushMode.java

@@ -30,7 +30,7 @@ public enum QueryFlushMode {
 	 */
 	NO_FLUSH,
 	/**
-	 * Let the owning {@link org.hibernate.Session session}
+	 * Let the owning {@linkplain org.hibernate.Session session}
 	 * decide whether to flush, depending on its current
 	 * {@link org.hibernate.FlushMode}.
 	 *