From b56795ba5f69be591bba482f007961468ac7938a Mon Sep 17 00:00:00 2001
From: Ceki Gulcu <ceki@qos.ch>
Date: Fri, 22 Dec 2023 16:24:08 +0100
Subject: [PATCH] add historical notes in the javadocs for LocationAwareLogger

Signed-off-by: Ceki Gulcu <ceki@qos.ch>
---
 .../main/java/org/slf4j/spi/LocationAwareLogger.java | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/slf4j-api/src/main/java/org/slf4j/spi/LocationAwareLogger.java b/slf4j-api/src/main/java/org/slf4j/spi/LocationAwareLogger.java
index d0d1a31b9..c37da8a6b 100644
--- a/slf4j-api/src/main/java/org/slf4j/spi/LocationAwareLogger.java
+++ b/slf4j-api/src/main/java/org/slf4j/spi/LocationAwareLogger.java
@@ -34,6 +34,18 @@
  * which need to provide hints so that the underlying logging system can extract
  * the correct location information (method name, line number).
  *
+ *  <p></p>
+ *
+ * <p>In response to <a href="https://jira.qos.ch/browse/SLF4J-118">SLF4J-118</a>,
+ * the {@link #log(Marker, String, int, String, Object[], Throwable) log()}  method was modified to accept
+ * an additional <code>Object[]</code> parameter.
+ * This Object[] represents arguments of the log request. Due to this modification, slf4j-api
+ * version 1.6.x no longer work with bindings shipping with SLF4J 1.5.x, instead
+ * bindings shipping with 1.6.x or later are required. See also
+ * <a href="https://github.com/qos-ch/slf4j/commit/6dd2bd58cff">commit 6dd2</a> dated
+ * April 9th, 2010.
+ * </p>
+ *
  * @author Ceki G&uuml;lc&uuml;
  * @since 1.3
  */