HHH-19216 - NamedEntityGraph annotation supporting Hibernate parseable format

HHH-19237 - Expand graph language to optionally specify entity
HHH-19217 - Expose GraphParser#parse on SessionFactory

Author: sebersole

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

@@ -50,7 +50,12 @@
 	String name() default "";
 
 	/**
-	 * The textual representation of the graph - e.g., {@code "title, isbn, author(name, books)"}.
+	 * The textual representation of the graph.
+	 * <p/>
+	 * When applied to a package, the syntax requires the entity name - e.g., {@code "Book: title, isbn, author(name, books)"}.
+	 * <p/>
+	 * When applied to an entity, the entity name should be omitted - e.g., {@code "title, isbn, author(name, books)"}.
+	 * <p/>
 	 * See {@linkplain org.hibernate.graph.GraphParser} for details about the syntax.
 	 */
 	String graph();

hibernate-core/src/main/java/org/hibernate/graph/GraphParser.java

@@ -23,12 +23,7 @@
  *     attributeNode:: attributePath subGraph?
  *     subGraph:: LPAREN (subTypeEntityName COLON)? attributeList RPAREN
  * </pre>
- *
- * JPA {@link jakarta.persistence.EntityGraph}
- * ({@link RootGraph}) and {@link jakarta.persistence.Subgraph} ({@link SubGraph}),
- * using a simple syntax defined by the {@code graph.g} ANTLR grammar. For example:
- * <pre>employees(username, password, accessLevel, department(employees(username)))</pre>
- * <p>
+ * <p/>
  * The {@link #parse} methods all create a root {@link jakarta.persistence.EntityGraph}
  * based on the passed entity class and parse the graph string into that root graph.
  * <p>