[logging-log4j2] branch master updated: Promote the Log4j API

[rg...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

rgoers pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/logging-log4j2.git


The following commit(s) were added to refs/heads/master by this push:
     new 3ebaf1d  Promote the Log4j API
3ebaf1d is described below

commit 3ebaf1de70529de8fb8767a0d5b45cc4a91fc83e
Author: Ralph Goers <rg...@apache.org>
AuthorDate: Sat Jan 5 15:16:32 2019 -0700

    Promote the Log4j API
---
 src/site/asciidoc/index.adoc | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/src/site/asciidoc/index.adoc b/src/site/asciidoc/index.adoc
index c31e45cf..931c4df 100644
--- a/src/site/asciidoc/index.adoc
+++ b/src/site/asciidoc/index.adoc
@@ -27,6 +27,19 @@ The API for Log4j is separate from the implementation making it clear for applic
 methods they can use while ensuring forward compatibility. This allows the Log4j team to improve the implementation
 safely and in a compatible manner.
 
+
+The Log4j API is a logging facade that may, of course, be used with the Log4j implementation, but may also be used
+in front of other logging implementations such as Logback. The Log4j API has several advantages over SLF4J:
+
+. The Log4j API supports logging [Messages](manual/messages.html) instead of just Strings.
+. The Log4j API supports lambda expressions.
+. The Log4j API provides many more logging methods than SLF4J.
+. In addition to the "parameterized logging" format supported by SLF4J, the Log4j API also supports events using
+the java.text.MessageFormat syntax as well printf-sytle messages.
+. The Log4j API provides a LogManager.shutdown() method. The underlying logging implementation must implement the
+Terminable interface for the method to have effect.
+. Other constructs such as Markers, log Levels, and ThreadContext (aka MDC) are fully supported.
+
 === Improved Performance
 
 Log4j 2 contains next-generation Asynchronous Loggers based on the LMAX Disruptor library. In multi-threaded scenarios