elharo commented on code in PR #12929:
URL: https://github.com/apache/maven/pull/12929#discussion_r3889130556
##########
api/maven-api-core/src/main/java/org/apache/maven/api/plugin/Log.java:
##########
@@ -36,13 +36,85 @@
@Experimental
@Provider
public interface Log {
+ /**
+ * {@return true if the <b>trace</b> error level is enabled}
+ * <p>
+ * The default implementation returns {@code false} for backward
+ * compatibility with existing {@code Log} implementations.
+ */
+ default boolean isTraceEnabled() {
+ return false;
+ }
+
+ /**
+ * Sends a message to the user in the <b>trace</b> error level.
+ * <p>
+ * Trace is the most verbose level, intended for Maven core internals
+ * such as resolver negotiation, model interpolation, and lifecycle
+ * ordering details. Use {@link #debug(CharSequence)} instead for
+ * messages that help <em>users</em> investigate their build
+ * (e.g. why a module was recompiled).
Review Comment:
e.g. --> For instance,
##########
api/maven-api-core/src/main/java/org/apache/maven/api/plugin/Log.java:
##########
@@ -36,13 +36,85 @@
@Experimental
@Provider
public interface Log {
+ /**
+ * {@return true if the <b>trace</b> error level is enabled}
+ * <p>
+ * The default implementation returns {@code false} for backward
+ * compatibility with existing {@code Log} implementations.
+ */
+ default boolean isTraceEnabled() {
+ return false;
+ }
+
+ /**
+ * Sends a message to the user in the <b>trace</b> error level.
Review Comment:
usually written as "at the trace error level" rather than "in the trace
error level"
--
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]
