Documentation updates for past changes

Add change log entries, expand Javadoc and expand specification text

api/src/main/java/jakarta/el/BeanELResolver.java

@@ -57,6 +57,12 @@
  * </p>
  *
  * <p>
+ * The JavaBeans specification predates the introduction of Modules. In addition to the JavaBeans specification
+ * requirements for looking up property getters, property setters and methods, this resolver also considers module
+ * visibility. 
+ * </p>
+ *
+ * <p>
  * This resolver can be constructed in read-only mode, which means that {@link #isReadOnly} will always return
  * <code>true</code> and {@link #setValue} will always throw <code>PropertyNotWritableException</code>.
  * </p>

spec/src/main/asciidoc/ELSpec.adoc

@@ -1300,6 +1300,8 @@ enforced.
 
 . Only the public static fields and methods can be referenced.
 
+. The fields and/or methods must be in an accessible module.
+
 . Static fields cannot be modified.
 
 . Except for classes with `java.lang.*` package
@@ -2978,6 +2980,12 @@ This appendix is non-normative.
 
 * Update to reflect new GitHub organisation and project names.
 
+* https://github.com/jakartaee/expression-language/issues/175[#175]
+  Add support for a new property, `length`, for arrays.
+
+* https://github.com/jakartaee/expression-language/issues/188[#188]
+  Allow for module visibility when accessing class methods.
+
 * https://github.com/jakartaee/expression-language/issues/192[#192]
   Removal all references to the Java SecurityManager and associated APIs.