diff --git a/src/asciidoc/index.adoc b/src/asciidoc/index.adoc
index cbf252b655..1241783419 100644
--- a/src/asciidoc/index.adoc
+++ b/src/asciidoc/index.adoc
@@ -28578,13 +28578,12 @@ The following example shows a typical `persistence.xml` file:
[NOTE]
====
-The `exclude-unlisted-classes` element always indicates that __no__ scanning for
-annotated entity classes is supposed to occur, in order to support the
-`` shortcut. This is in line with the JPA specification,
-which suggests that shortcut, but unfortunately is in conflict with the JPA XSD, which
-implies `false` for that shortcut. Consequently, ` false
-` is not supported. Simply omit the
-`exclude-unlisted-classes` element if you want entity class scanning to occur.
+The `` shortcut indicates that __no__ scanning for
+annotated entity classes is supposed to occur. An explicit 'true' value specified -
+`true` - also means no scan.
+`false` does trigger a scan;
+however, it is recommended to simply omit the `exclude-unlisted-classes` element
+if you want entity class scanning to occur.
====
Using the `LocalContainerEntityManagerFactoryBean` is the most powerful JPA setup