jvz commented on code in PR #1752:
URL: https://github.com/apache/logging-log4j2/pull/1752#discussion_r1331917355
##########
log4j-plugins/src/main/java/org/apache/logging/log4j/plugins/Configurable.java:
##########
@@ -22,34 +22,40 @@
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
+import org.apache.logging.log4j.plugins.convert.TypeConverter;
import org.apache.logging.log4j.util.Strings;
/**
- * Annotates a plugin as being a configurable plugin. Configurable plugins are
instantiated from a tree of
- * {@link Node} objects.
+ * Annotates a plugin as being a configurable plugin. A configurable plugin
corresponds to a {@code Node} element
+ * of a configuration tree. Each configuration element may have zero or more
{@linkplain PluginAttribute attributes}
+ * where attribute values are converted from strings into other types via
{@link TypeConverter}, an optional
+ * {@linkplain PluginValue value} (another type of plugin attribute which may
have dedicated syntax in some configuration
+ * formats such as XML), and zero or more child elements.
Review Comment:
A pattern converter has its own syntax, parser, etc., compared to a
configuration file. That's a good point, though, that different things can be
referenced in config files.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
