Improve precision of BeanContainer.isMatchingEvent() javadoc, to be s…

…quashed before merging

api/src/main/java/jakarta/enterprise/inject/spi/BeanContainer.java

@@ -300,11 +300,12 @@ boolean isMatchingBean(Set<Type> beanTypes, Set<Annotation> beanQualifiers, Type
      * match an observer method with given observed event type and observed event qualifiers,
      * {@code false} otherwise.
      * <p>
-     * In line with the specification for events and observer resolution, the event type used is
-     * the {@code specifiedType} and the set of event qualifiers used is a set that contains all
-     * {@code specifiedQualifiers} and {@code @Any}. Also, this method returns {@code true} when
-     * {@code observedEventQualifiers} contains {@code @Default} and the set of {@code specifiedQualifiers}
-     * is empty.
+     * For the purpose of observer resolution, the {@code specifiedType} is used as the event type
+     * directly (because there is no event object in this API) and {@code specifiedQualifiers} are
+     * used as event qualifiers. In line with the specification for events and observer resolution,
+     * the set of event qualifiers is considered to always include {@code @Any}. Also, this method
+     * returns {@code true} when the types match, the set of {@code observedEventQualifiers}
+     * contains {@code @Default} and the set of {@code specifiedQualifiers} is empty.
      * <p>
      * Throws {@link IllegalArgumentException} if any of the arguments is {@code null},
      * if the {@code specifiedType} contains a type variable, or if any of the {@code specifiedQualifiers}