Fixed TypeConverters#LevelConverter javadoc (#3359)

Author: jethomas-tsi

log4j-core/src/main/java/org/apache/logging/log4j/core/config/plugins/convert/TypeConverters.java

@@ -285,10 +285,17 @@ public Integer convert(final String s) {
     }
 
     /**
-     * Converts a {@link String} into a Log4j {@link Level}. Returns {@code null} for invalid level names.
+     * Converts a {@link String} into a Log4j {@link Level}.
      */
     @Plugin(name = "Level", category = CATEGORY)
     public static class LevelConverter implements TypeConverter<Level> {
+        /**
+         * {@inheritDoc}
+         * @param s the string to convert
+         * @return the resolved level
+         * @throws NullPointerException if the given value is {@code null}.
+         * @throws IllegalArgumentException if the given argument is not resolvable to a level
+         */
         @Override
         public Level convert(final String s) {
             return Level.valueOf(s);

src/changelog/2.25.0/3359_fix-javadoc.xml

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<entry xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+       xmlns="https://logging.apache.org/xml/ns"
+       xsi:schemaLocation="https://logging.apache.org/xml/ns https://logging.apache.org/xml/ns/log4j-changelog-0.xsd"
+       type="fixed">
+  <issue id="3359" link="https://github.com/apache/logging-log4j2/issues/3359"/>
+  <description format="asciidoc">
+    TypeConverters convert for "Level" incorrectly documented behaviour for invalid value - updated javadoc.
+  </description>
+</entry>