diff --git a/logback-classic/src/main/java/ch/qos/logback/classic/Level.java b/logback-classic/src/main/java/ch/qos/logback/classic/Level.java
index e5a889cc8a..a9a91413ca 100644
--- a/logback-classic/src/main/java/ch/qos/logback/classic/Level.java
+++ b/logback-classic/src/main/java/ch/qos/logback/classic/Level.java
@@ -45,7 +45,11 @@ public final class Level implements java.io.Serializable {
public static final Integer ALL_INTEGER = ALL_INT;
/**
- * The OFF
is used to turn off logging.
+ * The OFF
is used to turn off logging. It is intended to be used
+ * for logging system configuration.
+ *
+ * Warning: it should never be passed as an argument to logger methods
+ * in a regular log statement.
*/
public static final Level OFF = new Level(OFF_INT, "OFF");
@@ -79,7 +83,18 @@ public final class Level implements java.io.Serializable {
public static final Level TRACE = new Level(TRACE_INT, "TRACE");
/**
- * The ALL
is used to turn on all logging.
+ *
The ALL
is used to turn on all logging. The ALL
level is vestigial from
+ * log4j 1.x.
+ *
In logback, where the Level class is final, logging can be turned on for all levels by setting
+ * a logger's level to TRACE
.
+ *
Thus, the ALL
level is marked as deprecated.
+ *