This is an automated email from the ASF dual-hosted git repository.
github-bot pushed a commit to branch release/2.25.2-site-stg-out
in repository https://gitbox.apache.org/repos/asf/logging-log4j2.git
The following commit(s) were added to refs/heads/release/2.25.2-site-stg-out by
this push:
new 19f8630f4b Add website content generated from
`380b9f279dbfdafd4483f3b2f82847cfb09e95e8`
19f8630f4b is described below
commit 19f8630f4bc6eb2e74882a4df94fc5e88861a391
Author: ASF Logging Services RM <[email protected]>
AuthorDate: Thu Sep 18 18:14:14 2025 +0000
Add website content generated from
`380b9f279dbfdafd4483f3b2f82847cfb09e95e8`
---
_/css/site.css | 2 +-
javadoc/log4j-core/index-all.html | 12 ++-
javadoc/log4j-core/member-search-index.js | 2 +-
.../pattern/AbstractStyleNameConverter.Black.html | 4 +-
.../pattern/AbstractStyleNameConverter.Blue.html | 4 +-
.../pattern/AbstractStyleNameConverter.Cyan.html | 4 +-
.../pattern/AbstractStyleNameConverter.Green.html | 4 +-
.../AbstractStyleNameConverter.Magenta.html | 4 +-
.../pattern/AbstractStyleNameConverter.Red.html | 4 +-
.../pattern/AbstractStyleNameConverter.White.html | 4 +-
.../pattern/AbstractStyleNameConverter.Yellow.html | 4 +-
.../core/pattern/AbstractStyleNameConverter.html | 34 +++++-
.../core/pattern/EncodingPatternConverter.html | 13 ++-
.../pattern/EqualsBaseReplacementConverter.html | 28 ++++-
.../EqualsIgnoreCaseReplacementConverter.html | 4 +-
.../core/pattern/EqualsReplacementConverter.html | 4 +-
.../log4j/core/pattern/HighlightConverter.html | 13 ++-
.../core/pattern/LogEventPatternConverter.html | 13 ++-
.../log4j/core/pattern/MaxLengthConverter.html | 34 +++++-
.../core/pattern/RegexReplacementConverter.html | 34 +++++-
.../logging/log4j/core/pattern/StyleConverter.html | 13 ++-
.../VariablesNotEmptyReplacementConverter.html | 34 +++++-
manual/pattern-layout.html | 13 ++-
plugin-reference.html | 14 +--
release-notes.html | 9 ++
sitemap.xml | 118 ++++++++++-----------
26 files changed, 296 insertions(+), 130 deletions(-)
diff --git a/_/css/site.css b/_/css/site.css
index b502bd6a19..205df93199 100644
--- a/_/css/site.css
+++ b/_/css/site.css
@@ -1,3 +1,3 @@
-@font-face{font-family:Roboto;font-style:normal;font-weight:400;src:url(../font/roboto-latin-400-normal.woff2)
format("woff2"),url(../font/roboto-latin-400-normal.woff)
format("woff");unicode-range:U+00??,U+0131,U+0152-0153,U+02bb-02bc,U+02c6,U+02da,U+02dc,U+2000-206f,U+2074,U+20ac,U+2122,U+2191,U+2193,U+2212,U+2215,U+feff,U+fffd}@font-face{font-family:Roboto;font-style:normal;font-weight:400;src:url(../font/roboto-cyrillic-400-normal.woff2)
format("woff2");unicode-range:U+0301,U+0400-04 [...]
+@font-face{font-family:Roboto;font-style:normal;font-weight:400;src:url(../font/roboto-latin-400-normal.woff2)
format("woff2"),url(../font/roboto-latin-400-normal.woff)
format("woff");unicode-range:U+00??,U+0131,U+0152-0153,U+02bb-02bc,U+02c6,U+02da,U+02dc,U+2000-206f,U+2074,U+20ac,U+2122,U+2191,U+2193,U+2212,U+2215,U+feff,U+fffd}@font-face{font-family:Roboto;font-style:normal;font-weight:400;src:url(../font/roboto-cyrillic-400-normal.woff2)
format("woff2");unicode-range:U+0301,U+0400-04 [...]
/*! Adapted from the GitHub style by Vasily Polovnyov <[email protected]>
*/.hljs-comment,.hljs-quote{color:#998;font-style:italic}.hljs-keyword,.hljs-selector-tag,.hljs-subst{color:#333;font-weight:600}.hljs-literal,.hljs-number,.hljs-tag
.hljs-attr,.hljs-template-variable,.hljs-variable{color:teal}.hljs-doctag,.hljs-string{color:#d14}.hljs-section,.hljs-selector-id,.hljs-title{color:#900;font-weight:600}.hljs-subst{font-weight:400}.hljs-class
.hljs-title,.hljs-type{color:#458;font-wei [...]
\ No newline at end of file
diff --git a/javadoc/log4j-core/index-all.html
b/javadoc/log4j-core/index-all.html
index c32588aff8..4735c2de91 100644
--- a/javadoc/log4j-core/index-all.html
+++ b/javadoc/log4j-core/index-all.html
@@ -9493,24 +9493,34 @@ loadScripts(document, 'script');</script>
<dd> </dd>
<dt><a
href="org/apache/logging/log4j/core/async/AsyncLoggerDefaultExceptionHandler.html#handleOnStartException(java.lang.Throwable)"
class="member-name-link">handleOnStartException(Throwable)</a> - Method in
class org.apache.logging.log4j.core.async.<a
href="org/apache/logging/log4j/core/async/AsyncLoggerDefaultExceptionHandler.html"
title="class in
org.apache.logging.log4j.core.async">AsyncLoggerDefaultExceptionHandler</a></dt>
<dd> </dd>
+<dt><a
href="org/apache/logging/log4j/core/pattern/AbstractStyleNameConverter.html#handlesThrowable()"
class="member-name-link">handlesThrowable()</a> - Method in class
org.apache.logging.log4j.core.pattern.<a
href="org/apache/logging/log4j/core/pattern/AbstractStyleNameConverter.html"
title="class in
org.apache.logging.log4j.core.pattern">AbstractStyleNameConverter</a></dt>
+<dd> </dd>
<dt><a
href="org/apache/logging/log4j/core/pattern/EncodingPatternConverter.html#handlesThrowable()"
class="member-name-link">handlesThrowable()</a> - Method in class
org.apache.logging.log4j.core.pattern.<a
href="org/apache/logging/log4j/core/pattern/EncodingPatternConverter.html"
title="class in
org.apache.logging.log4j.core.pattern">EncodingPatternConverter</a></dt>
<dd> </dd>
+<dt><a
href="org/apache/logging/log4j/core/pattern/EqualsBaseReplacementConverter.html#handlesThrowable()"
class="member-name-link">handlesThrowable()</a> - Method in class
org.apache.logging.log4j.core.pattern.<a
href="org/apache/logging/log4j/core/pattern/EqualsBaseReplacementConverter.html"
title="class in
org.apache.logging.log4j.core.pattern">EqualsBaseReplacementConverter</a></dt>
+<dd> </dd>
<dt><a
href="org/apache/logging/log4j/core/pattern/HighlightConverter.html#handlesThrowable()"
class="member-name-link">handlesThrowable()</a> - Method in class
org.apache.logging.log4j.core.pattern.<a
href="org/apache/logging/log4j/core/pattern/HighlightConverter.html"
title="class in
org.apache.logging.log4j.core.pattern">HighlightConverter</a></dt>
<dd> </dd>
<dt><a
href="org/apache/logging/log4j/core/pattern/LogEventPatternConverter.html#handlesThrowable()"
class="member-name-link">handlesThrowable()</a> - Method in class
org.apache.logging.log4j.core.pattern.<a
href="org/apache/logging/log4j/core/pattern/LogEventPatternConverter.html"
title="class in
org.apache.logging.log4j.core.pattern">LogEventPatternConverter</a></dt>
<dd>
-<div class="block">Normally pattern converters are not meant to handle
Exceptions although few pattern converters might.</div>
+<div class="block">Tests whether this pattern converter is renders a <a
href="https://docs.oracle.com/javase/8/docs/api/java/lang/Throwable.html"
title="class or interface in java.lang"
class="external-link"><code>Throwable</code></a>.</div>
</dd>
+<dt><a
href="org/apache/logging/log4j/core/pattern/MaxLengthConverter.html#handlesThrowable()"
class="member-name-link">handlesThrowable()</a> - Method in class
org.apache.logging.log4j.core.pattern.<a
href="org/apache/logging/log4j/core/pattern/MaxLengthConverter.html"
title="class in
org.apache.logging.log4j.core.pattern">MaxLengthConverter</a></dt>
+<dd> </dd>
<dt><a
href="org/apache/logging/log4j/core/pattern/PatternFormatter.html#handlesThrowable()"
class="member-name-link">handlesThrowable()</a> - Method in class
org.apache.logging.log4j.core.pattern.<a
href="org/apache/logging/log4j/core/pattern/PatternFormatter.html" title="class
in org.apache.logging.log4j.core.pattern">PatternFormatter</a></dt>
<dd>
<div class="block">Normally pattern formatters are not meant to handle
Exceptions although few pattern formatters might.</div>
</dd>
+<dt><a
href="org/apache/logging/log4j/core/pattern/RegexReplacementConverter.html#handlesThrowable()"
class="member-name-link">handlesThrowable()</a> - Method in class
org.apache.logging.log4j.core.pattern.<a
href="org/apache/logging/log4j/core/pattern/RegexReplacementConverter.html"
title="class in
org.apache.logging.log4j.core.pattern">RegexReplacementConverter</a></dt>
+<dd> </dd>
<dt><a
href="org/apache/logging/log4j/core/pattern/StyleConverter.html#handlesThrowable()"
class="member-name-link">handlesThrowable()</a> - Method in class
org.apache.logging.log4j.core.pattern.<a
href="org/apache/logging/log4j/core/pattern/StyleConverter.html" title="class
in org.apache.logging.log4j.core.pattern">StyleConverter</a></dt>
<dd> </dd>
<dt><a
href="org/apache/logging/log4j/core/pattern/ThrowablePatternConverter.html#handlesThrowable()"
class="member-name-link">handlesThrowable()</a> - Method in class
org.apache.logging.log4j.core.pattern.<a
href="org/apache/logging/log4j/core/pattern/ThrowablePatternConverter.html"
title="class in
org.apache.logging.log4j.core.pattern">ThrowablePatternConverter</a></dt>
<dd>
<div class="block">Indicates this converter handles <a
href="https://docs.oracle.com/javase/8/docs/api/java/lang/Throwable.html"
title="class or interface in java.lang"
class="external-link"><code>Throwable</code></a>s.</div>
</dd>
+<dt><a
href="org/apache/logging/log4j/core/pattern/VariablesNotEmptyReplacementConverter.html#handlesThrowable()"
class="member-name-link">handlesThrowable()</a> - Method in class
org.apache.logging.log4j.core.pattern.<a
href="org/apache/logging/log4j/core/pattern/VariablesNotEmptyReplacementConverter.html"
title="class in
org.apache.logging.log4j.core.pattern">VariablesNotEmptyReplacementConverter</a></dt>
+<dd> </dd>
<dt><a
href="org/apache/logging/log4j/core/config/LoggerConfig.html#hasAppenders()"
class="member-name-link">hasAppenders()</a> - Method in class
org.apache.logging.log4j.core.config.<a
href="org/apache/logging/log4j/core/config/LoggerConfig.html" title="class in
org.apache.logging.log4j.core.config">LoggerConfig</a></dt>
<dd> </dd>
<dt><a href="org/apache/logging/log4j/core/config/Node.html#hasChildren()"
class="member-name-link">hasChildren()</a> - Method in class
org.apache.logging.log4j.core.config.<a
href="org/apache/logging/log4j/core/config/Node.html" title="class in
org.apache.logging.log4j.core.config">Node</a></dt>
diff --git a/javadoc/log4j-core/member-search-index.js
b/javadoc/log4j-core/member-search-index.js
index 9281429d37..13bacb07d2 100644
--- a/javadoc/log4j-core/member-search-index.js
+++ b/javadoc/log4j-core/member-search-index.js
@@ -1 +1 @@
-memberSearchIndex =
[{"p":"org.apache.logging.log4j.core.pattern","c":"NameAbbreviator","l":"abbreviate(String,
StringBuilder)","u":"abbreviate(java.lang.String,java.lang.StringBuilder)"},{"p":"org.apache.logging.log4j.core.pattern","c":"NamePatternConverter","l":"abbreviate(String,
StringBuilder)","u":"abbreviate(java.lang.String,java.lang.StringBuilder)"},{"p":"org.apache.logging.log4j.core.util.datetime","c":"FixedDateFormat.FixedFormat","l":"ABSOLUTE"},{"p":"org.apache.logging.log4j.
[...]
\ No newline at end of file
+memberSearchIndex =
[{"p":"org.apache.logging.log4j.core.pattern","c":"NameAbbreviator","l":"abbreviate(String,
StringBuilder)","u":"abbreviate(java.lang.String,java.lang.StringBuilder)"},{"p":"org.apache.logging.log4j.core.pattern","c":"NamePatternConverter","l":"abbreviate(String,
StringBuilder)","u":"abbreviate(java.lang.String,java.lang.StringBuilder)"},{"p":"org.apache.logging.log4j.core.util.datetime","c":"FixedDateFormat.FixedFormat","l":"ABSOLUTE"},{"p":"org.apache.logging.log4j.
[...]
\ No newline at end of file
diff --git
a/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/AbstractStyleNameConverter.Black.html
b/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/AbstractStyleNameConverter.Black.html
index a17a690eb7..de6e2fb88d 100644
---
a/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/AbstractStyleNameConverter.Black.html
+++
b/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/AbstractStyleNameConverter.Black.html
@@ -169,10 +169,10 @@ loadScripts(document, 'script');</script>
</div>
<div class="inherited-list">
<h3
id="methods-inherited-from-class-org.apache.logging.log4j.core.pattern.AbstractStyleNameConverter">Methods
inherited from class org.apache.logging.log4j.core.pattern.<a
href="AbstractStyleNameConverter.html" title="class in
org.apache.logging.log4j.core.pattern">AbstractStyleNameConverter</a></h3>
-<code><a
href="AbstractStyleNameConverter.html#format(org.apache.logging.log4j.core.LogEvent,java.lang.StringBuilder)">format</a>,
<a
href="AbstractStyleNameConverter.html#newInstance(java.lang.Class,java.lang.String,org.apache.logging.log4j.core.config.Configuration,java.lang.String%5B%5D)">newInstance</a></code></div>
+<code><a
href="AbstractStyleNameConverter.html#format(org.apache.logging.log4j.core.LogEvent,java.lang.StringBuilder)">format</a>,
<a
href="AbstractStyleNameConverter.html#handlesThrowable()">handlesThrowable</a>,
<a
href="AbstractStyleNameConverter.html#newInstance(java.lang.Class,java.lang.String,org.apache.logging.log4j.core.config.Configuration,java.lang.String%5B%5D)">newInstance</a></code></div>
<div class="inherited-list">
<h3
id="methods-inherited-from-class-org.apache.logging.log4j.core.pattern.LogEventPatternConverter">Methods
inherited from class org.apache.logging.log4j.core.pattern.<a
href="LogEventPatternConverter.html" title="class in
org.apache.logging.log4j.core.pattern">LogEventPatternConverter</a></h3>
-<code><a
href="LogEventPatternConverter.html#emptyVariableOutput()">emptyVariableOutput</a>,
<a
href="LogEventPatternConverter.html#format(java.lang.Object,java.lang.StringBuilder)">format</a>,
<a
href="LogEventPatternConverter.html#handlesThrowable()">handlesThrowable</a>,
<a href="LogEventPatternConverter.html#isVariable()">isVariable</a></code></div>
+<code><a
href="LogEventPatternConverter.html#emptyVariableOutput()">emptyVariableOutput</a>,
<a
href="LogEventPatternConverter.html#format(java.lang.Object,java.lang.StringBuilder)">format</a>,
<a
href="LogEventPatternConverter.html#isVariable()">isVariable</a></code></div>
<div class="inherited-list">
<h3
id="methods-inherited-from-class-org.apache.logging.log4j.core.pattern.AbstractPatternConverter">Methods
inherited from class org.apache.logging.log4j.core.pattern.<a
href="AbstractPatternConverter.html" title="class in
org.apache.logging.log4j.core.pattern">AbstractPatternConverter</a></h3>
<code><a href="AbstractPatternConverter.html#getName()">getName</a>, <a
href="AbstractPatternConverter.html#getStyleClass(java.lang.Object)">getStyleClass</a></code></div>
diff --git
a/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/AbstractStyleNameConverter.Blue.html
b/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/AbstractStyleNameConverter.Blue.html
index 12c909c31a..bdb7b4be9c 100644
---
a/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/AbstractStyleNameConverter.Blue.html
+++
b/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/AbstractStyleNameConverter.Blue.html
@@ -169,10 +169,10 @@ loadScripts(document, 'script');</script>
</div>
<div class="inherited-list">
<h3
id="methods-inherited-from-class-org.apache.logging.log4j.core.pattern.AbstractStyleNameConverter">Methods
inherited from class org.apache.logging.log4j.core.pattern.<a
href="AbstractStyleNameConverter.html" title="class in
org.apache.logging.log4j.core.pattern">AbstractStyleNameConverter</a></h3>
-<code><a
href="AbstractStyleNameConverter.html#format(org.apache.logging.log4j.core.LogEvent,java.lang.StringBuilder)">format</a>,
<a
href="AbstractStyleNameConverter.html#newInstance(java.lang.Class,java.lang.String,org.apache.logging.log4j.core.config.Configuration,java.lang.String%5B%5D)">newInstance</a></code></div>
+<code><a
href="AbstractStyleNameConverter.html#format(org.apache.logging.log4j.core.LogEvent,java.lang.StringBuilder)">format</a>,
<a
href="AbstractStyleNameConverter.html#handlesThrowable()">handlesThrowable</a>,
<a
href="AbstractStyleNameConverter.html#newInstance(java.lang.Class,java.lang.String,org.apache.logging.log4j.core.config.Configuration,java.lang.String%5B%5D)">newInstance</a></code></div>
<div class="inherited-list">
<h3
id="methods-inherited-from-class-org.apache.logging.log4j.core.pattern.LogEventPatternConverter">Methods
inherited from class org.apache.logging.log4j.core.pattern.<a
href="LogEventPatternConverter.html" title="class in
org.apache.logging.log4j.core.pattern">LogEventPatternConverter</a></h3>
-<code><a
href="LogEventPatternConverter.html#emptyVariableOutput()">emptyVariableOutput</a>,
<a
href="LogEventPatternConverter.html#format(java.lang.Object,java.lang.StringBuilder)">format</a>,
<a
href="LogEventPatternConverter.html#handlesThrowable()">handlesThrowable</a>,
<a href="LogEventPatternConverter.html#isVariable()">isVariable</a></code></div>
+<code><a
href="LogEventPatternConverter.html#emptyVariableOutput()">emptyVariableOutput</a>,
<a
href="LogEventPatternConverter.html#format(java.lang.Object,java.lang.StringBuilder)">format</a>,
<a
href="LogEventPatternConverter.html#isVariable()">isVariable</a></code></div>
<div class="inherited-list">
<h3
id="methods-inherited-from-class-org.apache.logging.log4j.core.pattern.AbstractPatternConverter">Methods
inherited from class org.apache.logging.log4j.core.pattern.<a
href="AbstractPatternConverter.html" title="class in
org.apache.logging.log4j.core.pattern">AbstractPatternConverter</a></h3>
<code><a href="AbstractPatternConverter.html#getName()">getName</a>, <a
href="AbstractPatternConverter.html#getStyleClass(java.lang.Object)">getStyleClass</a></code></div>
diff --git
a/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/AbstractStyleNameConverter.Cyan.html
b/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/AbstractStyleNameConverter.Cyan.html
index 7fb12dce04..947addf3fc 100644
---
a/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/AbstractStyleNameConverter.Cyan.html
+++
b/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/AbstractStyleNameConverter.Cyan.html
@@ -169,10 +169,10 @@ loadScripts(document, 'script');</script>
</div>
<div class="inherited-list">
<h3
id="methods-inherited-from-class-org.apache.logging.log4j.core.pattern.AbstractStyleNameConverter">Methods
inherited from class org.apache.logging.log4j.core.pattern.<a
href="AbstractStyleNameConverter.html" title="class in
org.apache.logging.log4j.core.pattern">AbstractStyleNameConverter</a></h3>
-<code><a
href="AbstractStyleNameConverter.html#format(org.apache.logging.log4j.core.LogEvent,java.lang.StringBuilder)">format</a>,
<a
href="AbstractStyleNameConverter.html#newInstance(java.lang.Class,java.lang.String,org.apache.logging.log4j.core.config.Configuration,java.lang.String%5B%5D)">newInstance</a></code></div>
+<code><a
href="AbstractStyleNameConverter.html#format(org.apache.logging.log4j.core.LogEvent,java.lang.StringBuilder)">format</a>,
<a
href="AbstractStyleNameConverter.html#handlesThrowable()">handlesThrowable</a>,
<a
href="AbstractStyleNameConverter.html#newInstance(java.lang.Class,java.lang.String,org.apache.logging.log4j.core.config.Configuration,java.lang.String%5B%5D)">newInstance</a></code></div>
<div class="inherited-list">
<h3
id="methods-inherited-from-class-org.apache.logging.log4j.core.pattern.LogEventPatternConverter">Methods
inherited from class org.apache.logging.log4j.core.pattern.<a
href="LogEventPatternConverter.html" title="class in
org.apache.logging.log4j.core.pattern">LogEventPatternConverter</a></h3>
-<code><a
href="LogEventPatternConverter.html#emptyVariableOutput()">emptyVariableOutput</a>,
<a
href="LogEventPatternConverter.html#format(java.lang.Object,java.lang.StringBuilder)">format</a>,
<a
href="LogEventPatternConverter.html#handlesThrowable()">handlesThrowable</a>,
<a href="LogEventPatternConverter.html#isVariable()">isVariable</a></code></div>
+<code><a
href="LogEventPatternConverter.html#emptyVariableOutput()">emptyVariableOutput</a>,
<a
href="LogEventPatternConverter.html#format(java.lang.Object,java.lang.StringBuilder)">format</a>,
<a
href="LogEventPatternConverter.html#isVariable()">isVariable</a></code></div>
<div class="inherited-list">
<h3
id="methods-inherited-from-class-org.apache.logging.log4j.core.pattern.AbstractPatternConverter">Methods
inherited from class org.apache.logging.log4j.core.pattern.<a
href="AbstractPatternConverter.html" title="class in
org.apache.logging.log4j.core.pattern">AbstractPatternConverter</a></h3>
<code><a href="AbstractPatternConverter.html#getName()">getName</a>, <a
href="AbstractPatternConverter.html#getStyleClass(java.lang.Object)">getStyleClass</a></code></div>
diff --git
a/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/AbstractStyleNameConverter.Green.html
b/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/AbstractStyleNameConverter.Green.html
index bafaa3aa6f..d1c8a5141e 100644
---
a/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/AbstractStyleNameConverter.Green.html
+++
b/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/AbstractStyleNameConverter.Green.html
@@ -169,10 +169,10 @@ loadScripts(document, 'script');</script>
</div>
<div class="inherited-list">
<h3
id="methods-inherited-from-class-org.apache.logging.log4j.core.pattern.AbstractStyleNameConverter">Methods
inherited from class org.apache.logging.log4j.core.pattern.<a
href="AbstractStyleNameConverter.html" title="class in
org.apache.logging.log4j.core.pattern">AbstractStyleNameConverter</a></h3>
-<code><a
href="AbstractStyleNameConverter.html#format(org.apache.logging.log4j.core.LogEvent,java.lang.StringBuilder)">format</a>,
<a
href="AbstractStyleNameConverter.html#newInstance(java.lang.Class,java.lang.String,org.apache.logging.log4j.core.config.Configuration,java.lang.String%5B%5D)">newInstance</a></code></div>
+<code><a
href="AbstractStyleNameConverter.html#format(org.apache.logging.log4j.core.LogEvent,java.lang.StringBuilder)">format</a>,
<a
href="AbstractStyleNameConverter.html#handlesThrowable()">handlesThrowable</a>,
<a
href="AbstractStyleNameConverter.html#newInstance(java.lang.Class,java.lang.String,org.apache.logging.log4j.core.config.Configuration,java.lang.String%5B%5D)">newInstance</a></code></div>
<div class="inherited-list">
<h3
id="methods-inherited-from-class-org.apache.logging.log4j.core.pattern.LogEventPatternConverter">Methods
inherited from class org.apache.logging.log4j.core.pattern.<a
href="LogEventPatternConverter.html" title="class in
org.apache.logging.log4j.core.pattern">LogEventPatternConverter</a></h3>
-<code><a
href="LogEventPatternConverter.html#emptyVariableOutput()">emptyVariableOutput</a>,
<a
href="LogEventPatternConverter.html#format(java.lang.Object,java.lang.StringBuilder)">format</a>,
<a
href="LogEventPatternConverter.html#handlesThrowable()">handlesThrowable</a>,
<a href="LogEventPatternConverter.html#isVariable()">isVariable</a></code></div>
+<code><a
href="LogEventPatternConverter.html#emptyVariableOutput()">emptyVariableOutput</a>,
<a
href="LogEventPatternConverter.html#format(java.lang.Object,java.lang.StringBuilder)">format</a>,
<a
href="LogEventPatternConverter.html#isVariable()">isVariable</a></code></div>
<div class="inherited-list">
<h3
id="methods-inherited-from-class-org.apache.logging.log4j.core.pattern.AbstractPatternConverter">Methods
inherited from class org.apache.logging.log4j.core.pattern.<a
href="AbstractPatternConverter.html" title="class in
org.apache.logging.log4j.core.pattern">AbstractPatternConverter</a></h3>
<code><a href="AbstractPatternConverter.html#getName()">getName</a>, <a
href="AbstractPatternConverter.html#getStyleClass(java.lang.Object)">getStyleClass</a></code></div>
diff --git
a/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/AbstractStyleNameConverter.Magenta.html
b/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/AbstractStyleNameConverter.Magenta.html
index 065b4ed486..5d3fe76732 100644
---
a/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/AbstractStyleNameConverter.Magenta.html
+++
b/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/AbstractStyleNameConverter.Magenta.html
@@ -169,10 +169,10 @@ loadScripts(document, 'script');</script>
</div>
<div class="inherited-list">
<h3
id="methods-inherited-from-class-org.apache.logging.log4j.core.pattern.AbstractStyleNameConverter">Methods
inherited from class org.apache.logging.log4j.core.pattern.<a
href="AbstractStyleNameConverter.html" title="class in
org.apache.logging.log4j.core.pattern">AbstractStyleNameConverter</a></h3>
-<code><a
href="AbstractStyleNameConverter.html#format(org.apache.logging.log4j.core.LogEvent,java.lang.StringBuilder)">format</a>,
<a
href="AbstractStyleNameConverter.html#newInstance(java.lang.Class,java.lang.String,org.apache.logging.log4j.core.config.Configuration,java.lang.String%5B%5D)">newInstance</a></code></div>
+<code><a
href="AbstractStyleNameConverter.html#format(org.apache.logging.log4j.core.LogEvent,java.lang.StringBuilder)">format</a>,
<a
href="AbstractStyleNameConverter.html#handlesThrowable()">handlesThrowable</a>,
<a
href="AbstractStyleNameConverter.html#newInstance(java.lang.Class,java.lang.String,org.apache.logging.log4j.core.config.Configuration,java.lang.String%5B%5D)">newInstance</a></code></div>
<div class="inherited-list">
<h3
id="methods-inherited-from-class-org.apache.logging.log4j.core.pattern.LogEventPatternConverter">Methods
inherited from class org.apache.logging.log4j.core.pattern.<a
href="LogEventPatternConverter.html" title="class in
org.apache.logging.log4j.core.pattern">LogEventPatternConverter</a></h3>
-<code><a
href="LogEventPatternConverter.html#emptyVariableOutput()">emptyVariableOutput</a>,
<a
href="LogEventPatternConverter.html#format(java.lang.Object,java.lang.StringBuilder)">format</a>,
<a
href="LogEventPatternConverter.html#handlesThrowable()">handlesThrowable</a>,
<a href="LogEventPatternConverter.html#isVariable()">isVariable</a></code></div>
+<code><a
href="LogEventPatternConverter.html#emptyVariableOutput()">emptyVariableOutput</a>,
<a
href="LogEventPatternConverter.html#format(java.lang.Object,java.lang.StringBuilder)">format</a>,
<a
href="LogEventPatternConverter.html#isVariable()">isVariable</a></code></div>
<div class="inherited-list">
<h3
id="methods-inherited-from-class-org.apache.logging.log4j.core.pattern.AbstractPatternConverter">Methods
inherited from class org.apache.logging.log4j.core.pattern.<a
href="AbstractPatternConverter.html" title="class in
org.apache.logging.log4j.core.pattern">AbstractPatternConverter</a></h3>
<code><a href="AbstractPatternConverter.html#getName()">getName</a>, <a
href="AbstractPatternConverter.html#getStyleClass(java.lang.Object)">getStyleClass</a></code></div>
diff --git
a/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/AbstractStyleNameConverter.Red.html
b/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/AbstractStyleNameConverter.Red.html
index 615c424c8f..6aad9489a6 100644
---
a/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/AbstractStyleNameConverter.Red.html
+++
b/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/AbstractStyleNameConverter.Red.html
@@ -169,10 +169,10 @@ loadScripts(document, 'script');</script>
</div>
<div class="inherited-list">
<h3
id="methods-inherited-from-class-org.apache.logging.log4j.core.pattern.AbstractStyleNameConverter">Methods
inherited from class org.apache.logging.log4j.core.pattern.<a
href="AbstractStyleNameConverter.html" title="class in
org.apache.logging.log4j.core.pattern">AbstractStyleNameConverter</a></h3>
-<code><a
href="AbstractStyleNameConverter.html#format(org.apache.logging.log4j.core.LogEvent,java.lang.StringBuilder)">format</a>,
<a
href="AbstractStyleNameConverter.html#newInstance(java.lang.Class,java.lang.String,org.apache.logging.log4j.core.config.Configuration,java.lang.String%5B%5D)">newInstance</a></code></div>
+<code><a
href="AbstractStyleNameConverter.html#format(org.apache.logging.log4j.core.LogEvent,java.lang.StringBuilder)">format</a>,
<a
href="AbstractStyleNameConverter.html#handlesThrowable()">handlesThrowable</a>,
<a
href="AbstractStyleNameConverter.html#newInstance(java.lang.Class,java.lang.String,org.apache.logging.log4j.core.config.Configuration,java.lang.String%5B%5D)">newInstance</a></code></div>
<div class="inherited-list">
<h3
id="methods-inherited-from-class-org.apache.logging.log4j.core.pattern.LogEventPatternConverter">Methods
inherited from class org.apache.logging.log4j.core.pattern.<a
href="LogEventPatternConverter.html" title="class in
org.apache.logging.log4j.core.pattern">LogEventPatternConverter</a></h3>
-<code><a
href="LogEventPatternConverter.html#emptyVariableOutput()">emptyVariableOutput</a>,
<a
href="LogEventPatternConverter.html#format(java.lang.Object,java.lang.StringBuilder)">format</a>,
<a
href="LogEventPatternConverter.html#handlesThrowable()">handlesThrowable</a>,
<a href="LogEventPatternConverter.html#isVariable()">isVariable</a></code></div>
+<code><a
href="LogEventPatternConverter.html#emptyVariableOutput()">emptyVariableOutput</a>,
<a
href="LogEventPatternConverter.html#format(java.lang.Object,java.lang.StringBuilder)">format</a>,
<a
href="LogEventPatternConverter.html#isVariable()">isVariable</a></code></div>
<div class="inherited-list">
<h3
id="methods-inherited-from-class-org.apache.logging.log4j.core.pattern.AbstractPatternConverter">Methods
inherited from class org.apache.logging.log4j.core.pattern.<a
href="AbstractPatternConverter.html" title="class in
org.apache.logging.log4j.core.pattern">AbstractPatternConverter</a></h3>
<code><a href="AbstractPatternConverter.html#getName()">getName</a>, <a
href="AbstractPatternConverter.html#getStyleClass(java.lang.Object)">getStyleClass</a></code></div>
diff --git
a/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/AbstractStyleNameConverter.White.html
b/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/AbstractStyleNameConverter.White.html
index 27c7ec4c8a..ea18d26fc8 100644
---
a/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/AbstractStyleNameConverter.White.html
+++
b/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/AbstractStyleNameConverter.White.html
@@ -169,10 +169,10 @@ loadScripts(document, 'script');</script>
</div>
<div class="inherited-list">
<h3
id="methods-inherited-from-class-org.apache.logging.log4j.core.pattern.AbstractStyleNameConverter">Methods
inherited from class org.apache.logging.log4j.core.pattern.<a
href="AbstractStyleNameConverter.html" title="class in
org.apache.logging.log4j.core.pattern">AbstractStyleNameConverter</a></h3>
-<code><a
href="AbstractStyleNameConverter.html#format(org.apache.logging.log4j.core.LogEvent,java.lang.StringBuilder)">format</a>,
<a
href="AbstractStyleNameConverter.html#newInstance(java.lang.Class,java.lang.String,org.apache.logging.log4j.core.config.Configuration,java.lang.String%5B%5D)">newInstance</a></code></div>
+<code><a
href="AbstractStyleNameConverter.html#format(org.apache.logging.log4j.core.LogEvent,java.lang.StringBuilder)">format</a>,
<a
href="AbstractStyleNameConverter.html#handlesThrowable()">handlesThrowable</a>,
<a
href="AbstractStyleNameConverter.html#newInstance(java.lang.Class,java.lang.String,org.apache.logging.log4j.core.config.Configuration,java.lang.String%5B%5D)">newInstance</a></code></div>
<div class="inherited-list">
<h3
id="methods-inherited-from-class-org.apache.logging.log4j.core.pattern.LogEventPatternConverter">Methods
inherited from class org.apache.logging.log4j.core.pattern.<a
href="LogEventPatternConverter.html" title="class in
org.apache.logging.log4j.core.pattern">LogEventPatternConverter</a></h3>
-<code><a
href="LogEventPatternConverter.html#emptyVariableOutput()">emptyVariableOutput</a>,
<a
href="LogEventPatternConverter.html#format(java.lang.Object,java.lang.StringBuilder)">format</a>,
<a
href="LogEventPatternConverter.html#handlesThrowable()">handlesThrowable</a>,
<a href="LogEventPatternConverter.html#isVariable()">isVariable</a></code></div>
+<code><a
href="LogEventPatternConverter.html#emptyVariableOutput()">emptyVariableOutput</a>,
<a
href="LogEventPatternConverter.html#format(java.lang.Object,java.lang.StringBuilder)">format</a>,
<a
href="LogEventPatternConverter.html#isVariable()">isVariable</a></code></div>
<div class="inherited-list">
<h3
id="methods-inherited-from-class-org.apache.logging.log4j.core.pattern.AbstractPatternConverter">Methods
inherited from class org.apache.logging.log4j.core.pattern.<a
href="AbstractPatternConverter.html" title="class in
org.apache.logging.log4j.core.pattern">AbstractPatternConverter</a></h3>
<code><a href="AbstractPatternConverter.html#getName()">getName</a>, <a
href="AbstractPatternConverter.html#getStyleClass(java.lang.Object)">getStyleClass</a></code></div>
diff --git
a/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/AbstractStyleNameConverter.Yellow.html
b/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/AbstractStyleNameConverter.Yellow.html
index 0afec86ea2..01e271e6c2 100644
---
a/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/AbstractStyleNameConverter.Yellow.html
+++
b/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/AbstractStyleNameConverter.Yellow.html
@@ -169,10 +169,10 @@ loadScripts(document, 'script');</script>
</div>
<div class="inherited-list">
<h3
id="methods-inherited-from-class-org.apache.logging.log4j.core.pattern.AbstractStyleNameConverter">Methods
inherited from class org.apache.logging.log4j.core.pattern.<a
href="AbstractStyleNameConverter.html" title="class in
org.apache.logging.log4j.core.pattern">AbstractStyleNameConverter</a></h3>
-<code><a
href="AbstractStyleNameConverter.html#format(org.apache.logging.log4j.core.LogEvent,java.lang.StringBuilder)">format</a>,
<a
href="AbstractStyleNameConverter.html#newInstance(java.lang.Class,java.lang.String,org.apache.logging.log4j.core.config.Configuration,java.lang.String%5B%5D)">newInstance</a></code></div>
+<code><a
href="AbstractStyleNameConverter.html#format(org.apache.logging.log4j.core.LogEvent,java.lang.StringBuilder)">format</a>,
<a
href="AbstractStyleNameConverter.html#handlesThrowable()">handlesThrowable</a>,
<a
href="AbstractStyleNameConverter.html#newInstance(java.lang.Class,java.lang.String,org.apache.logging.log4j.core.config.Configuration,java.lang.String%5B%5D)">newInstance</a></code></div>
<div class="inherited-list">
<h3
id="methods-inherited-from-class-org.apache.logging.log4j.core.pattern.LogEventPatternConverter">Methods
inherited from class org.apache.logging.log4j.core.pattern.<a
href="LogEventPatternConverter.html" title="class in
org.apache.logging.log4j.core.pattern">LogEventPatternConverter</a></h3>
-<code><a
href="LogEventPatternConverter.html#emptyVariableOutput()">emptyVariableOutput</a>,
<a
href="LogEventPatternConverter.html#format(java.lang.Object,java.lang.StringBuilder)">format</a>,
<a
href="LogEventPatternConverter.html#handlesThrowable()">handlesThrowable</a>,
<a href="LogEventPatternConverter.html#isVariable()">isVariable</a></code></div>
+<code><a
href="LogEventPatternConverter.html#emptyVariableOutput()">emptyVariableOutput</a>,
<a
href="LogEventPatternConverter.html#format(java.lang.Object,java.lang.StringBuilder)">format</a>,
<a
href="LogEventPatternConverter.html#isVariable()">isVariable</a></code></div>
<div class="inherited-list">
<h3
id="methods-inherited-from-class-org.apache.logging.log4j.core.pattern.AbstractPatternConverter">Methods
inherited from class org.apache.logging.log4j.core.pattern.<a
href="AbstractPatternConverter.html" title="class in
org.apache.logging.log4j.core.pattern">AbstractPatternConverter</a></h3>
<code><a href="AbstractPatternConverter.html#getName()">getName</a>, <a
href="AbstractPatternConverter.html#getStyleClass(java.lang.Object)">getStyleClass</a></code></div>
diff --git
a/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/AbstractStyleNameConverter.html
b/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/AbstractStyleNameConverter.html
index a9c1139e48..ee533c490c 100644
---
a/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/AbstractStyleNameConverter.html
+++
b/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/AbstractStyleNameConverter.html
@@ -195,12 +195,17 @@ loadScripts(document, 'script');</script>
<div class="col-last even-row-color method-summary-table
method-summary-table-tab2 method-summary-table-tab4">
<div class="block">Formats an event into a string buffer.</div>
</div>
-<div class="col-first odd-row-color method-summary-table
method-summary-table-tab1 method-summary-table-tab4"><code>protected static
<T extends <a href="AbstractStyleNameConverter.html" title="class in
org.apache.logging.log4j.core.pattern">AbstractStyleNameConverter</a>><br>T</code></div>
-<div class="col-second odd-row-color method-summary-table
method-summary-table-tab1 method-summary-table-tab4"><code><a
href="#newInstance(java.lang.Class,java.lang.String,org.apache.logging.log4j.core.config.Configuration,java.lang.String%5B%5D)"
class="member-name-link">newInstance</a><wbr>(<a
href="https://docs.oracle.com/javase/8/docs/api/java/lang/Class.html"
title="class or interface in java.lang"
class="external-link">Class</a><T> asnConverterClass,
+<div class="col-first odd-row-color method-summary-table
method-summary-table-tab2 method-summary-table-tab4"><code>boolean</code></div>
+<div class="col-second odd-row-color method-summary-table
method-summary-table-tab2 method-summary-table-tab4"><code><a
href="#handlesThrowable()"
class="member-name-link">handlesThrowable</a>()</code></div>
+<div class="col-last odd-row-color method-summary-table
method-summary-table-tab2 method-summary-table-tab4">
+<div class="block">Tests whether this pattern converter is renders a <a
href="https://docs.oracle.com/javase/8/docs/api/java/lang/Throwable.html"
title="class or interface in java.lang"
class="external-link"><code>Throwable</code></a>.</div>
+</div>
+<div class="col-first even-row-color method-summary-table
method-summary-table-tab1 method-summary-table-tab4"><code>protected static
<T extends <a href="AbstractStyleNameConverter.html" title="class in
org.apache.logging.log4j.core.pattern">AbstractStyleNameConverter</a>><br>T</code></div>
+<div class="col-second even-row-color method-summary-table
method-summary-table-tab1 method-summary-table-tab4"><code><a
href="#newInstance(java.lang.Class,java.lang.String,org.apache.logging.log4j.core.config.Configuration,java.lang.String%5B%5D)"
class="member-name-link">newInstance</a><wbr>(<a
href="https://docs.oracle.com/javase/8/docs/api/java/lang/Class.html"
title="class or interface in java.lang"
class="external-link">Class</a><T> asnConverterClass,
<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html"
title="class or interface in java.lang"
class="external-link">String</a> name,
<a href="../config/Configuration.html" title="interface in
org.apache.logging.log4j.core.config">Configuration</a> config,
<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html"
title="class or interface in java.lang"
class="external-link">String</a>[] options)</code></div>
-<div class="col-last odd-row-color method-summary-table
method-summary-table-tab1 method-summary-table-tab4">
+<div class="col-last even-row-color method-summary-table
method-summary-table-tab1 method-summary-table-tab4">
<div class="block">Gets an instance of the class (called via reflection).</div>
</div>
</div>
@@ -208,7 +213,7 @@ loadScripts(document, 'script');</script>
</div>
<div class="inherited-list">
<h3
id="methods-inherited-from-class-org.apache.logging.log4j.core.pattern.LogEventPatternConverter">Methods
inherited from class org.apache.logging.log4j.core.pattern.<a
href="LogEventPatternConverter.html" title="class in
org.apache.logging.log4j.core.pattern">LogEventPatternConverter</a></h3>
-<code><a
href="LogEventPatternConverter.html#emptyVariableOutput()">emptyVariableOutput</a>,
<a
href="LogEventPatternConverter.html#format(java.lang.Object,java.lang.StringBuilder)">format</a>,
<a
href="LogEventPatternConverter.html#handlesThrowable()">handlesThrowable</a>,
<a href="LogEventPatternConverter.html#isVariable()">isVariable</a></code></div>
+<code><a
href="LogEventPatternConverter.html#emptyVariableOutput()">emptyVariableOutput</a>,
<a
href="LogEventPatternConverter.html#format(java.lang.Object,java.lang.StringBuilder)">format</a>,
<a
href="LogEventPatternConverter.html#isVariable()">isVariable</a></code></div>
<div class="inherited-list">
<h3
id="methods-inherited-from-class-org.apache.logging.log4j.core.pattern.AbstractPatternConverter">Methods
inherited from class org.apache.logging.log4j.core.pattern.<a
href="AbstractPatternConverter.html" title="class in
org.apache.logging.log4j.core.pattern">AbstractPatternConverter</a></h3>
<code><a href="AbstractPatternConverter.html#getName()">getName</a>, <a
href="AbstractPatternConverter.html#getStyleClass(java.lang.Object)">getStyleClass</a></code></div>
@@ -282,6 +287,27 @@ loadScripts(document, 'script');</script>
</dl>
</section>
</li>
+<li>
+<section class="detail" id="handlesThrowable()">
+<h3>handlesThrowable</h3>
+<div class="member-signature"><span class="modifiers">public</span> <span
class="return-type">boolean</span> <span
class="element-name">handlesThrowable</span>()</div>
+<div class="block"><span class="descfrm-type-label">Description copied from
class: <code><a
href="LogEventPatternConverter.html#handlesThrowable()">LogEventPatternConverter</a></code></span></div>
+<div class="block">Tests whether this pattern converter is renders a <a
href="https://docs.oracle.com/javase/8/docs/api/java/lang/Throwable.html"
title="class or interface in java.lang"
class="external-link"><code>Throwable</code></a>.
+
+ <p>
+ The <a href="PatternParser.html" title="class in
org.apache.logging.log4j.core.pattern"><code>PatternParser</code></a> checks
this flag when processing the
+ <code>alwaysWriteExceptions</code> option: if no converter in the pattern
handles
+ throwables, the parser automatically appends a converter to ensure exceptions
are still written.
+ </p></div>
+<dl class="notes">
+<dt>Overrides:</dt>
+<dd><code><a
href="LogEventPatternConverter.html#handlesThrowable()">handlesThrowable</a></code> in
class <code><a href="LogEventPatternConverter.html" title="class in
org.apache.logging.log4j.core.pattern">LogEventPatternConverter</a></code></dd>
+<dt>Returns:</dt>
+<dd><code>true</code> if this converter consumes and renders a <a
href="https://docs.oracle.com/javase/8/docs/api/java/lang/Throwable.html"
title="class or interface in java.lang"
class="external-link"><code>Throwable</code></a>,
+ <code>false</code> otherwise</dd>
+</dl>
+</section>
+</li>
</ul>
</section>
</li>
diff --git
a/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/EncodingPatternConverter.html
b/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/EncodingPatternConverter.html
index 538f4bb7af..3003754aa6 100644
---
a/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/EncodingPatternConverter.html
+++
b/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/EncodingPatternConverter.html
@@ -126,7 +126,7 @@ loadScripts(document, 'script');</script>
<div class="col-first odd-row-color method-summary-table
method-summary-table-tab2 method-summary-table-tab4"><code>boolean</code></div>
<div class="col-second odd-row-color method-summary-table
method-summary-table-tab2 method-summary-table-tab4"><code><a
href="#handlesThrowable()"
class="member-name-link">handlesThrowable</a>()</code></div>
<div class="col-last odd-row-color method-summary-table
method-summary-table-tab2 method-summary-table-tab4">
-<div class="block">Normally pattern converters are not meant to handle
Exceptions although few pattern converters might.</div>
+<div class="block">Tests whether this pattern converter is renders a <a
href="https://docs.oracle.com/javase/8/docs/api/java/lang/Throwable.html"
title="class or interface in java.lang"
class="external-link"><code>Throwable</code></a>.</div>
</div>
<div class="col-first even-row-color method-summary-table
method-summary-table-tab1 method-summary-table-tab4"><code>static <a
href="EncodingPatternConverter.html" title="class in
org.apache.logging.log4j.core.pattern">EncodingPatternConverter</a></code></div>
<div class="col-second even-row-color method-summary-table
method-summary-table-tab1 method-summary-table-tab4"><code><a
href="#newInstance(org.apache.logging.log4j.core.config.Configuration,java.lang.String%5B%5D)"
class="member-name-link">newInstance</a><wbr>(<a
href="../config/Configuration.html" title="interface in
org.apache.logging.log4j.core.config">Configuration</a> config,
@@ -162,16 +162,19 @@ loadScripts(document, 'script');</script>
<h3>handlesThrowable</h3>
<div class="member-signature"><span class="modifiers">public</span> <span
class="return-type">boolean</span> <span
class="element-name">handlesThrowable</span>()</div>
<div class="block"><span class="descfrm-type-label">Description copied from
class: <code><a
href="LogEventPatternConverter.html#handlesThrowable()">LogEventPatternConverter</a></code></span></div>
-<div class="block">Normally pattern converters are not meant to handle
Exceptions although few pattern converters might.
+<div class="block">Tests whether this pattern converter is renders a <a
href="https://docs.oracle.com/javase/8/docs/api/java/lang/Throwable.html"
title="class or interface in java.lang"
class="external-link"><code>Throwable</code></a>.
+
<p>
- By examining the return values for this method, the containing layout will
determine whether it handles
- throwables or not.
+ The <a href="PatternParser.html" title="class in
org.apache.logging.log4j.core.pattern"><code>PatternParser</code></a> checks
this flag when processing the
+ <code>alwaysWriteExceptions</code> option: if no converter in the pattern
handles
+ throwables, the parser automatically appends a converter to ensure exceptions
are still written.
</p></div>
<dl class="notes">
<dt>Overrides:</dt>
<dd><code><a
href="LogEventPatternConverter.html#handlesThrowable()">handlesThrowable</a></code> in
class <code><a href="LogEventPatternConverter.html" title="class in
org.apache.logging.log4j.core.pattern">LogEventPatternConverter</a></code></dd>
<dt>Returns:</dt>
-<dd>true if this PatternConverter handles throwables</dd>
+<dd><code>true</code> if this converter consumes and renders a <a
href="https://docs.oracle.com/javase/8/docs/api/java/lang/Throwable.html"
title="class or interface in java.lang"
class="external-link"><code>Throwable</code></a>,
+ <code>false</code> otherwise</dd>
</dl>
</section>
</li>
diff --git
a/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/EqualsBaseReplacementConverter.html
b/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/EqualsBaseReplacementConverter.html
index ddd4145664..385ff24041 100644
---
a/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/EqualsBaseReplacementConverter.html
+++
b/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/EqualsBaseReplacementConverter.html
@@ -154,12 +154,17 @@ loadScripts(document, 'script');</script>
<div class="col-last odd-row-color method-summary-table
method-summary-table-tab2 method-summary-table-tab4">
<div class="block">Formats an event into a string buffer.</div>
</div>
+<div class="col-first even-row-color method-summary-table
method-summary-table-tab2 method-summary-table-tab4"><code>boolean</code></div>
+<div class="col-second even-row-color method-summary-table
method-summary-table-tab2 method-summary-table-tab4"><code><a
href="#handlesThrowable()"
class="member-name-link">handlesThrowable</a>()</code></div>
+<div class="col-last even-row-color method-summary-table
method-summary-table-tab2 method-summary-table-tab4">
+<div class="block">Tests whether this pattern converter is renders a <a
href="https://docs.oracle.com/javase/8/docs/api/java/lang/Throwable.html"
title="class or interface in java.lang"
class="external-link"><code>Throwable</code></a>.</div>
+</div>
</div>
</div>
</div>
<div class="inherited-list">
<h3
id="methods-inherited-from-class-org.apache.logging.log4j.core.pattern.LogEventPatternConverter">Methods
inherited from class org.apache.logging.log4j.core.pattern.<a
href="LogEventPatternConverter.html" title="class in
org.apache.logging.log4j.core.pattern">LogEventPatternConverter</a></h3>
-<code><a
href="LogEventPatternConverter.html#emptyVariableOutput()">emptyVariableOutput</a>,
<a
href="LogEventPatternConverter.html#format(java.lang.Object,java.lang.StringBuilder)">format</a>,
<a
href="LogEventPatternConverter.html#handlesThrowable()">handlesThrowable</a>,
<a href="LogEventPatternConverter.html#isVariable()">isVariable</a></code></div>
+<code><a
href="LogEventPatternConverter.html#emptyVariableOutput()">emptyVariableOutput</a>,
<a
href="LogEventPatternConverter.html#format(java.lang.Object,java.lang.StringBuilder)">format</a>,
<a
href="LogEventPatternConverter.html#isVariable()">isVariable</a></code></div>
<div class="inherited-list">
<h3
id="methods-inherited-from-class-org.apache.logging.log4j.core.pattern.AbstractPatternConverter">Methods
inherited from class org.apache.logging.log4j.core.pattern.<a
href="AbstractPatternConverter.html" title="class in
org.apache.logging.log4j.core.pattern">AbstractPatternConverter</a></h3>
<code><a href="AbstractPatternConverter.html#getName()">getName</a>, <a
href="AbstractPatternConverter.html#getStyleClass(java.lang.Object)">getStyleClass</a></code></div>
@@ -240,6 +245,27 @@ loadScripts(document, 'script');</script>
</dl>
</section>
</li>
+<li>
+<section class="detail" id="handlesThrowable()">
+<h3>handlesThrowable</h3>
+<div class="member-signature"><span class="modifiers">public</span> <span
class="return-type">boolean</span> <span
class="element-name">handlesThrowable</span>()</div>
+<div class="block"><span class="descfrm-type-label">Description copied from
class: <code><a
href="LogEventPatternConverter.html#handlesThrowable()">LogEventPatternConverter</a></code></span></div>
+<div class="block">Tests whether this pattern converter is renders a <a
href="https://docs.oracle.com/javase/8/docs/api/java/lang/Throwable.html"
title="class or interface in java.lang"
class="external-link"><code>Throwable</code></a>.
+
+ <p>
+ The <a href="PatternParser.html" title="class in
org.apache.logging.log4j.core.pattern"><code>PatternParser</code></a> checks
this flag when processing the
+ <code>alwaysWriteExceptions</code> option: if no converter in the pattern
handles
+ throwables, the parser automatically appends a converter to ensure exceptions
are still written.
+ </p></div>
+<dl class="notes">
+<dt>Overrides:</dt>
+<dd><code><a
href="LogEventPatternConverter.html#handlesThrowable()">handlesThrowable</a></code> in
class <code><a href="LogEventPatternConverter.html" title="class in
org.apache.logging.log4j.core.pattern">LogEventPatternConverter</a></code></dd>
+<dt>Returns:</dt>
+<dd><code>true</code> if this converter consumes and renders a <a
href="https://docs.oracle.com/javase/8/docs/api/java/lang/Throwable.html"
title="class or interface in java.lang"
class="external-link"><code>Throwable</code></a>,
+ <code>false</code> otherwise</dd>
+</dl>
+</section>
+</li>
</ul>
</section>
</li>
diff --git
a/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/EqualsIgnoreCaseReplacementConverter.html
b/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/EqualsIgnoreCaseReplacementConverter.html
index f787120b31..963de6420f 100644
---
a/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/EqualsIgnoreCaseReplacementConverter.html
+++
b/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/EqualsIgnoreCaseReplacementConverter.html
@@ -137,10 +137,10 @@ loadScripts(document, 'script');</script>
</div>
<div class="inherited-list">
<h3
id="methods-inherited-from-class-org.apache.logging.log4j.core.pattern.EqualsBaseReplacementConverter">Methods
inherited from class org.apache.logging.log4j.core.pattern.<a
href="EqualsBaseReplacementConverter.html" title="class in
org.apache.logging.log4j.core.pattern">EqualsBaseReplacementConverter</a></h3>
-<code><a
href="EqualsBaseReplacementConverter.html#format(org.apache.logging.log4j.core.LogEvent,java.lang.StringBuilder)">format</a></code></div>
+<code><a
href="EqualsBaseReplacementConverter.html#format(org.apache.logging.log4j.core.LogEvent,java.lang.StringBuilder)">format</a>,
<a
href="EqualsBaseReplacementConverter.html#handlesThrowable()">handlesThrowable</a></code></div>
<div class="inherited-list">
<h3
id="methods-inherited-from-class-org.apache.logging.log4j.core.pattern.LogEventPatternConverter">Methods
inherited from class org.apache.logging.log4j.core.pattern.<a
href="LogEventPatternConverter.html" title="class in
org.apache.logging.log4j.core.pattern">LogEventPatternConverter</a></h3>
-<code><a
href="LogEventPatternConverter.html#emptyVariableOutput()">emptyVariableOutput</a>,
<a
href="LogEventPatternConverter.html#format(java.lang.Object,java.lang.StringBuilder)">format</a>,
<a
href="LogEventPatternConverter.html#handlesThrowable()">handlesThrowable</a>,
<a href="LogEventPatternConverter.html#isVariable()">isVariable</a></code></div>
+<code><a
href="LogEventPatternConverter.html#emptyVariableOutput()">emptyVariableOutput</a>,
<a
href="LogEventPatternConverter.html#format(java.lang.Object,java.lang.StringBuilder)">format</a>,
<a
href="LogEventPatternConverter.html#isVariable()">isVariable</a></code></div>
<div class="inherited-list">
<h3
id="methods-inherited-from-class-org.apache.logging.log4j.core.pattern.AbstractPatternConverter">Methods
inherited from class org.apache.logging.log4j.core.pattern.<a
href="AbstractPatternConverter.html" title="class in
org.apache.logging.log4j.core.pattern">AbstractPatternConverter</a></h3>
<code><a href="AbstractPatternConverter.html#getName()">getName</a>, <a
href="AbstractPatternConverter.html#getStyleClass(java.lang.Object)">getStyleClass</a></code></div>
diff --git
a/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/EqualsReplacementConverter.html
b/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/EqualsReplacementConverter.html
index 2abe389513..cfa4bf52ec 100644
---
a/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/EqualsReplacementConverter.html
+++
b/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/EqualsReplacementConverter.html
@@ -137,10 +137,10 @@ loadScripts(document, 'script');</script>
</div>
<div class="inherited-list">
<h3
id="methods-inherited-from-class-org.apache.logging.log4j.core.pattern.EqualsBaseReplacementConverter">Methods
inherited from class org.apache.logging.log4j.core.pattern.<a
href="EqualsBaseReplacementConverter.html" title="class in
org.apache.logging.log4j.core.pattern">EqualsBaseReplacementConverter</a></h3>
-<code><a
href="EqualsBaseReplacementConverter.html#format(org.apache.logging.log4j.core.LogEvent,java.lang.StringBuilder)">format</a></code></div>
+<code><a
href="EqualsBaseReplacementConverter.html#format(org.apache.logging.log4j.core.LogEvent,java.lang.StringBuilder)">format</a>,
<a
href="EqualsBaseReplacementConverter.html#handlesThrowable()">handlesThrowable</a></code></div>
<div class="inherited-list">
<h3
id="methods-inherited-from-class-org.apache.logging.log4j.core.pattern.LogEventPatternConverter">Methods
inherited from class org.apache.logging.log4j.core.pattern.<a
href="LogEventPatternConverter.html" title="class in
org.apache.logging.log4j.core.pattern">LogEventPatternConverter</a></h3>
-<code><a
href="LogEventPatternConverter.html#emptyVariableOutput()">emptyVariableOutput</a>,
<a
href="LogEventPatternConverter.html#format(java.lang.Object,java.lang.StringBuilder)">format</a>,
<a
href="LogEventPatternConverter.html#handlesThrowable()">handlesThrowable</a>,
<a href="LogEventPatternConverter.html#isVariable()">isVariable</a></code></div>
+<code><a
href="LogEventPatternConverter.html#emptyVariableOutput()">emptyVariableOutput</a>,
<a
href="LogEventPatternConverter.html#format(java.lang.Object,java.lang.StringBuilder)">format</a>,
<a
href="LogEventPatternConverter.html#isVariable()">isVariable</a></code></div>
<div class="inherited-list">
<h3
id="methods-inherited-from-class-org.apache.logging.log4j.core.pattern.AbstractPatternConverter">Methods
inherited from class org.apache.logging.log4j.core.pattern.<a
href="AbstractPatternConverter.html" title="class in
org.apache.logging.log4j.core.pattern">AbstractPatternConverter</a></h3>
<code><a href="AbstractPatternConverter.html#getName()">getName</a>, <a
href="AbstractPatternConverter.html#getStyleClass(java.lang.Object)">getStyleClass</a></code></div>
diff --git
a/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/HighlightConverter.html
b/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/HighlightConverter.html
index 09562aab62..b70049ee9b 100644
---
a/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/HighlightConverter.html
+++
b/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/HighlightConverter.html
@@ -167,7 +167,7 @@ loadScripts(document, 'script');</script>
<div class="col-first odd-row-color method-summary-table
method-summary-table-tab2 method-summary-table-tab4"><code>boolean</code></div>
<div class="col-second odd-row-color method-summary-table
method-summary-table-tab2 method-summary-table-tab4"><code><a
href="#handlesThrowable()"
class="member-name-link">handlesThrowable</a>()</code></div>
<div class="col-last odd-row-color method-summary-table
method-summary-table-tab2 method-summary-table-tab4">
-<div class="block">Normally pattern converters are not meant to handle
Exceptions although few pattern converters might.</div>
+<div class="block">Tests whether this pattern converter is renders a <a
href="https://docs.oracle.com/javase/8/docs/api/java/lang/Throwable.html"
title="class or interface in java.lang"
class="external-link"><code>Throwable</code></a>.</div>
</div>
<div class="col-first even-row-color method-summary-table
method-summary-table-tab1 method-summary-table-tab4"><code>static <a
href="HighlightConverter.html" title="class in
org.apache.logging.log4j.core.pattern">HighlightConverter</a></code></div>
<div class="col-second even-row-color method-summary-table
method-summary-table-tab1 method-summary-table-tab4"><code><a
href="#newInstance(org.apache.logging.log4j.core.config.Configuration,java.lang.String%5B%5D)"
class="member-name-link">newInstance</a><wbr>(<a
href="../config/Configuration.html" title="interface in
org.apache.logging.log4j.core.config">Configuration</a> config,
@@ -234,16 +234,19 @@ loadScripts(document, 'script');</script>
<h3>handlesThrowable</h3>
<div class="member-signature"><span class="modifiers">public</span> <span
class="return-type">boolean</span> <span
class="element-name">handlesThrowable</span>()</div>
<div class="block"><span class="descfrm-type-label">Description copied from
class: <code><a
href="LogEventPatternConverter.html#handlesThrowable()">LogEventPatternConverter</a></code></span></div>
-<div class="block">Normally pattern converters are not meant to handle
Exceptions although few pattern converters might.
+<div class="block">Tests whether this pattern converter is renders a <a
href="https://docs.oracle.com/javase/8/docs/api/java/lang/Throwable.html"
title="class or interface in java.lang"
class="external-link"><code>Throwable</code></a>.
+
<p>
- By examining the return values for this method, the containing layout will
determine whether it handles
- throwables or not.
+ The <a href="PatternParser.html" title="class in
org.apache.logging.log4j.core.pattern"><code>PatternParser</code></a> checks
this flag when processing the
+ <code>alwaysWriteExceptions</code> option: if no converter in the pattern
handles
+ throwables, the parser automatically appends a converter to ensure exceptions
are still written.
</p></div>
<dl class="notes">
<dt>Overrides:</dt>
<dd><code><a
href="LogEventPatternConverter.html#handlesThrowable()">handlesThrowable</a></code> in
class <code><a href="LogEventPatternConverter.html" title="class in
org.apache.logging.log4j.core.pattern">LogEventPatternConverter</a></code></dd>
<dt>Returns:</dt>
-<dd>true if this PatternConverter handles throwables</dd>
+<dd><code>true</code> if this converter consumes and renders a <a
href="https://docs.oracle.com/javase/8/docs/api/java/lang/Throwable.html"
title="class or interface in java.lang"
class="external-link"><code>Throwable</code></a>,
+ <code>false</code> otherwise</dd>
</dl>
</section>
</li>
diff --git
a/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/LogEventPatternConverter.html
b/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/LogEventPatternConverter.html
index 59e8190168..e2e6d8ab26 100644
---
a/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/LogEventPatternConverter.html
+++
b/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/LogEventPatternConverter.html
@@ -153,7 +153,7 @@ loadScripts(document, 'script');</script>
<div class="col-first odd-row-color method-summary-table
method-summary-table-tab2 method-summary-table-tab4"><code>boolean</code></div>
<div class="col-second odd-row-color method-summary-table
method-summary-table-tab2 method-summary-table-tab4"><code><a
href="#handlesThrowable()"
class="member-name-link">handlesThrowable</a>()</code></div>
<div class="col-last odd-row-color method-summary-table
method-summary-table-tab2 method-summary-table-tab4">
-<div class="block">Normally pattern converters are not meant to handle
Exceptions although few pattern converters might.</div>
+<div class="block">Tests whether this pattern converter is renders a <a
href="https://docs.oracle.com/javase/8/docs/api/java/lang/Throwable.html"
title="class or interface in java.lang"
class="external-link"><code>Throwable</code></a>.</div>
</div>
<div class="col-first even-row-color method-summary-table
method-summary-table-tab2 method-summary-table-tab4"><code>boolean</code></div>
<div class="col-second even-row-color method-summary-table
method-summary-table-tab2 method-summary-table-tab4"><code><a
href="#isVariable()" class="member-name-link">isVariable</a>()</code></div>
@@ -229,14 +229,17 @@ loadScripts(document, 'script');</script>
<section class="detail" id="handlesThrowable()">
<h3>handlesThrowable</h3>
<div class="member-signature"><span class="modifiers">public</span> <span
class="return-type">boolean</span> <span
class="element-name">handlesThrowable</span>()</div>
-<div class="block">Normally pattern converters are not meant to handle
Exceptions although few pattern converters might.
+<div class="block">Tests whether this pattern converter is renders a <a
href="https://docs.oracle.com/javase/8/docs/api/java/lang/Throwable.html"
title="class or interface in java.lang"
class="external-link"><code>Throwable</code></a>.
+
<p>
- By examining the return values for this method, the containing layout will
determine whether it handles
- throwables or not.
+ The <a href="PatternParser.html" title="class in
org.apache.logging.log4j.core.pattern"><code>PatternParser</code></a> checks
this flag when processing the
+ <code>alwaysWriteExceptions</code> option: if no converter in the pattern
handles
+ throwables, the parser automatically appends a converter to ensure exceptions
are still written.
</p></div>
<dl class="notes">
<dt>Returns:</dt>
-<dd>true if this PatternConverter handles throwables</dd>
+<dd><code>true</code> if this converter consumes and renders a <a
href="https://docs.oracle.com/javase/8/docs/api/java/lang/Throwable.html"
title="class or interface in java.lang"
class="external-link"><code>Throwable</code></a>,
+ <code>false</code> otherwise</dd>
</dl>
</section>
</li>
diff --git
a/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/MaxLengthConverter.html
b/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/MaxLengthConverter.html
index 23d80b65ec..24ef25df3b 100644
---
a/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/MaxLengthConverter.html
+++
b/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/MaxLengthConverter.html
@@ -132,10 +132,15 @@ loadScripts(document, 'script');</script>
<div class="col-last even-row-color method-summary-table
method-summary-table-tab2 method-summary-table-tab4">
<div class="block">Formats an event into a string buffer.</div>
</div>
-<div class="col-first odd-row-color method-summary-table
method-summary-table-tab1 method-summary-table-tab4"><code>static <a
href="MaxLengthConverter.html" title="class in
org.apache.logging.log4j.core.pattern">MaxLengthConverter</a></code></div>
-<div class="col-second odd-row-color method-summary-table
method-summary-table-tab1 method-summary-table-tab4"><code><a
href="#newInstance(org.apache.logging.log4j.core.config.Configuration,java.lang.String%5B%5D)"
class="member-name-link">newInstance</a><wbr>(<a
href="../config/Configuration.html" title="interface in
org.apache.logging.log4j.core.config">Configuration</a> config,
+<div class="col-first odd-row-color method-summary-table
method-summary-table-tab2 method-summary-table-tab4"><code>boolean</code></div>
+<div class="col-second odd-row-color method-summary-table
method-summary-table-tab2 method-summary-table-tab4"><code><a
href="#handlesThrowable()"
class="member-name-link">handlesThrowable</a>()</code></div>
+<div class="col-last odd-row-color method-summary-table
method-summary-table-tab2 method-summary-table-tab4">
+<div class="block">Tests whether this pattern converter is renders a <a
href="https://docs.oracle.com/javase/8/docs/api/java/lang/Throwable.html"
title="class or interface in java.lang"
class="external-link"><code>Throwable</code></a>.</div>
+</div>
+<div class="col-first even-row-color method-summary-table
method-summary-table-tab1 method-summary-table-tab4"><code>static <a
href="MaxLengthConverter.html" title="class in
org.apache.logging.log4j.core.pattern">MaxLengthConverter</a></code></div>
+<div class="col-second even-row-color method-summary-table
method-summary-table-tab1 method-summary-table-tab4"><code><a
href="#newInstance(org.apache.logging.log4j.core.config.Configuration,java.lang.String%5B%5D)"
class="member-name-link">newInstance</a><wbr>(<a
href="../config/Configuration.html" title="interface in
org.apache.logging.log4j.core.config">Configuration</a> config,
<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html"
title="class or interface in java.lang"
class="external-link">String</a>[] options)</code></div>
-<div class="col-last odd-row-color method-summary-table
method-summary-table-tab1 method-summary-table-tab4">
+<div class="col-last even-row-color method-summary-table
method-summary-table-tab1 method-summary-table-tab4">
<div class="block">Gets an instance of the class.</div>
</div>
</div>
@@ -143,7 +148,7 @@ loadScripts(document, 'script');</script>
</div>
<div class="inherited-list">
<h3
id="methods-inherited-from-class-org.apache.logging.log4j.core.pattern.LogEventPatternConverter">Methods
inherited from class org.apache.logging.log4j.core.pattern.<a
href="LogEventPatternConverter.html" title="class in
org.apache.logging.log4j.core.pattern">LogEventPatternConverter</a></h3>
-<code><a
href="LogEventPatternConverter.html#emptyVariableOutput()">emptyVariableOutput</a>,
<a
href="LogEventPatternConverter.html#format(java.lang.Object,java.lang.StringBuilder)">format</a>,
<a
href="LogEventPatternConverter.html#handlesThrowable()">handlesThrowable</a>,
<a href="LogEventPatternConverter.html#isVariable()">isVariable</a></code></div>
+<code><a
href="LogEventPatternConverter.html#emptyVariableOutput()">emptyVariableOutput</a>,
<a
href="LogEventPatternConverter.html#format(java.lang.Object,java.lang.StringBuilder)">format</a>,
<a
href="LogEventPatternConverter.html#isVariable()">isVariable</a></code></div>
<div class="inherited-list">
<h3
id="methods-inherited-from-class-org.apache.logging.log4j.core.pattern.AbstractPatternConverter">Methods
inherited from class org.apache.logging.log4j.core.pattern.<a
href="AbstractPatternConverter.html" title="class in
org.apache.logging.log4j.core.pattern">AbstractPatternConverter</a></h3>
<code><a href="AbstractPatternConverter.html#getName()">getName</a>, <a
href="AbstractPatternConverter.html#getStyleClass(java.lang.Object)">getStyleClass</a></code></div>
@@ -192,6 +197,27 @@ loadScripts(document, 'script');</script>
</dl>
</section>
</li>
+<li>
+<section class="detail" id="handlesThrowable()">
+<h3>handlesThrowable</h3>
+<div class="member-signature"><span class="modifiers">public</span> <span
class="return-type">boolean</span> <span
class="element-name">handlesThrowable</span>()</div>
+<div class="block"><span class="descfrm-type-label">Description copied from
class: <code><a
href="LogEventPatternConverter.html#handlesThrowable()">LogEventPatternConverter</a></code></span></div>
+<div class="block">Tests whether this pattern converter is renders a <a
href="https://docs.oracle.com/javase/8/docs/api/java/lang/Throwable.html"
title="class or interface in java.lang"
class="external-link"><code>Throwable</code></a>.
+
+ <p>
+ The <a href="PatternParser.html" title="class in
org.apache.logging.log4j.core.pattern"><code>PatternParser</code></a> checks
this flag when processing the
+ <code>alwaysWriteExceptions</code> option: if no converter in the pattern
handles
+ throwables, the parser automatically appends a converter to ensure exceptions
are still written.
+ </p></div>
+<dl class="notes">
+<dt>Overrides:</dt>
+<dd><code><a
href="LogEventPatternConverter.html#handlesThrowable()">handlesThrowable</a></code> in
class <code><a href="LogEventPatternConverter.html" title="class in
org.apache.logging.log4j.core.pattern">LogEventPatternConverter</a></code></dd>
+<dt>Returns:</dt>
+<dd><code>true</code> if this converter consumes and renders a <a
href="https://docs.oracle.com/javase/8/docs/api/java/lang/Throwable.html"
title="class or interface in java.lang"
class="external-link"><code>Throwable</code></a>,
+ <code>false</code> otherwise</dd>
+</dl>
+</section>
+</li>
</ul>
</section>
</li>
diff --git
a/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/RegexReplacementConverter.html
b/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/RegexReplacementConverter.html
index 2fd840725a..bca78ae1ea 100644
---
a/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/RegexReplacementConverter.html
+++
b/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/RegexReplacementConverter.html
@@ -122,10 +122,15 @@ loadScripts(document, 'script');</script>
<div class="col-last even-row-color method-summary-table
method-summary-table-tab2 method-summary-table-tab4">
<div class="block">Formats an event into a string buffer.</div>
</div>
-<div class="col-first odd-row-color method-summary-table
method-summary-table-tab1 method-summary-table-tab4"><code>static <a
href="RegexReplacementConverter.html" title="class in
org.apache.logging.log4j.core.pattern">RegexReplacementConverter</a></code></div>
-<div class="col-second odd-row-color method-summary-table
method-summary-table-tab1 method-summary-table-tab4"><code><a
href="#newInstance(org.apache.logging.log4j.core.config.Configuration,java.lang.String%5B%5D)"
class="member-name-link">newInstance</a><wbr>(<a
href="../config/Configuration.html" title="interface in
org.apache.logging.log4j.core.config">Configuration</a> config,
+<div class="col-first odd-row-color method-summary-table
method-summary-table-tab2 method-summary-table-tab4"><code>boolean</code></div>
+<div class="col-second odd-row-color method-summary-table
method-summary-table-tab2 method-summary-table-tab4"><code><a
href="#handlesThrowable()"
class="member-name-link">handlesThrowable</a>()</code></div>
+<div class="col-last odd-row-color method-summary-table
method-summary-table-tab2 method-summary-table-tab4">
+<div class="block">Tests whether this pattern converter is renders a <a
href="https://docs.oracle.com/javase/8/docs/api/java/lang/Throwable.html"
title="class or interface in java.lang"
class="external-link"><code>Throwable</code></a>.</div>
+</div>
+<div class="col-first even-row-color method-summary-table
method-summary-table-tab1 method-summary-table-tab4"><code>static <a
href="RegexReplacementConverter.html" title="class in
org.apache.logging.log4j.core.pattern">RegexReplacementConverter</a></code></div>
+<div class="col-second even-row-color method-summary-table
method-summary-table-tab1 method-summary-table-tab4"><code><a
href="#newInstance(org.apache.logging.log4j.core.config.Configuration,java.lang.String%5B%5D)"
class="member-name-link">newInstance</a><wbr>(<a
href="../config/Configuration.html" title="interface in
org.apache.logging.log4j.core.config">Configuration</a> config,
<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html"
title="class or interface in java.lang"
class="external-link">String</a>[] options)</code></div>
-<div class="col-last odd-row-color method-summary-table
method-summary-table-tab1 method-summary-table-tab4">
+<div class="col-last even-row-color method-summary-table
method-summary-table-tab1 method-summary-table-tab4">
<div class="block">Gets an instance of the class.</div>
</div>
</div>
@@ -133,7 +138,7 @@ loadScripts(document, 'script');</script>
</div>
<div class="inherited-list">
<h3
id="methods-inherited-from-class-org.apache.logging.log4j.core.pattern.LogEventPatternConverter">Methods
inherited from class org.apache.logging.log4j.core.pattern.<a
href="LogEventPatternConverter.html" title="class in
org.apache.logging.log4j.core.pattern">LogEventPatternConverter</a></h3>
-<code><a
href="LogEventPatternConverter.html#emptyVariableOutput()">emptyVariableOutput</a>,
<a
href="LogEventPatternConverter.html#format(java.lang.Object,java.lang.StringBuilder)">format</a>,
<a
href="LogEventPatternConverter.html#handlesThrowable()">handlesThrowable</a>,
<a href="LogEventPatternConverter.html#isVariable()">isVariable</a></code></div>
+<code><a
href="LogEventPatternConverter.html#emptyVariableOutput()">emptyVariableOutput</a>,
<a
href="LogEventPatternConverter.html#format(java.lang.Object,java.lang.StringBuilder)">format</a>,
<a
href="LogEventPatternConverter.html#isVariable()">isVariable</a></code></div>
<div class="inherited-list">
<h3
id="methods-inherited-from-class-org.apache.logging.log4j.core.pattern.AbstractPatternConverter">Methods
inherited from class org.apache.logging.log4j.core.pattern.<a
href="AbstractPatternConverter.html" title="class in
org.apache.logging.log4j.core.pattern">AbstractPatternConverter</a></h3>
<code><a href="AbstractPatternConverter.html#getName()">getName</a>, <a
href="AbstractPatternConverter.html#getStyleClass(java.lang.Object)">getStyleClass</a></code></div>
@@ -182,6 +187,27 @@ loadScripts(document, 'script');</script>
</dl>
</section>
</li>
+<li>
+<section class="detail" id="handlesThrowable()">
+<h3>handlesThrowable</h3>
+<div class="member-signature"><span class="modifiers">public</span> <span
class="return-type">boolean</span> <span
class="element-name">handlesThrowable</span>()</div>
+<div class="block"><span class="descfrm-type-label">Description copied from
class: <code><a
href="LogEventPatternConverter.html#handlesThrowable()">LogEventPatternConverter</a></code></span></div>
+<div class="block">Tests whether this pattern converter is renders a <a
href="https://docs.oracle.com/javase/8/docs/api/java/lang/Throwable.html"
title="class or interface in java.lang"
class="external-link"><code>Throwable</code></a>.
+
+ <p>
+ The <a href="PatternParser.html" title="class in
org.apache.logging.log4j.core.pattern"><code>PatternParser</code></a> checks
this flag when processing the
+ <code>alwaysWriteExceptions</code> option: if no converter in the pattern
handles
+ throwables, the parser automatically appends a converter to ensure exceptions
are still written.
+ </p></div>
+<dl class="notes">
+<dt>Overrides:</dt>
+<dd><code><a
href="LogEventPatternConverter.html#handlesThrowable()">handlesThrowable</a></code> in
class <code><a href="LogEventPatternConverter.html" title="class in
org.apache.logging.log4j.core.pattern">LogEventPatternConverter</a></code></dd>
+<dt>Returns:</dt>
+<dd><code>true</code> if this converter consumes and renders a <a
href="https://docs.oracle.com/javase/8/docs/api/java/lang/Throwable.html"
title="class or interface in java.lang"
class="external-link"><code>Throwable</code></a>,
+ <code>false</code> otherwise</dd>
+</dl>
+</section>
+</li>
</ul>
</section>
</li>
diff --git
a/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/StyleConverter.html
b/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/StyleConverter.html
index a13c1abeb6..0e8b3f11a9 100644
---
a/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/StyleConverter.html
+++
b/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/StyleConverter.html
@@ -130,7 +130,7 @@ loadScripts(document, 'script');</script>
<div class="col-first odd-row-color method-summary-table
method-summary-table-tab2 method-summary-table-tab4"><code>boolean</code></div>
<div class="col-second odd-row-color method-summary-table
method-summary-table-tab2 method-summary-table-tab4"><code><a
href="#handlesThrowable()"
class="member-name-link">handlesThrowable</a>()</code></div>
<div class="col-last odd-row-color method-summary-table
method-summary-table-tab2 method-summary-table-tab4">
-<div class="block">Normally pattern converters are not meant to handle
Exceptions although few pattern converters might.</div>
+<div class="block">Tests whether this pattern converter is renders a <a
href="https://docs.oracle.com/javase/8/docs/api/java/lang/Throwable.html"
title="class or interface in java.lang"
class="external-link"><code>Throwable</code></a>.</div>
</div>
<div class="col-first even-row-color method-summary-table
method-summary-table-tab1 method-summary-table-tab4"><code>static <a
href="StyleConverter.html" title="class in
org.apache.logging.log4j.core.pattern">StyleConverter</a></code></div>
<div class="col-second even-row-color method-summary-table
method-summary-table-tab1 method-summary-table-tab4"><code><a
href="#newInstance(org.apache.logging.log4j.core.config.Configuration,java.lang.String%5B%5D)"
class="member-name-link">newInstance</a><wbr>(<a
href="../config/Configuration.html" title="interface in
org.apache.logging.log4j.core.config">Configuration</a> config,
@@ -202,16 +202,19 @@ loadScripts(document, 'script');</script>
<h3>handlesThrowable</h3>
<div class="member-signature"><span class="modifiers">public</span> <span
class="return-type">boolean</span> <span
class="element-name">handlesThrowable</span>()</div>
<div class="block"><span class="descfrm-type-label">Description copied from
class: <code><a
href="LogEventPatternConverter.html#handlesThrowable()">LogEventPatternConverter</a></code></span></div>
-<div class="block">Normally pattern converters are not meant to handle
Exceptions although few pattern converters might.
+<div class="block">Tests whether this pattern converter is renders a <a
href="https://docs.oracle.com/javase/8/docs/api/java/lang/Throwable.html"
title="class or interface in java.lang"
class="external-link"><code>Throwable</code></a>.
+
<p>
- By examining the return values for this method, the containing layout will
determine whether it handles
- throwables or not.
+ The <a href="PatternParser.html" title="class in
org.apache.logging.log4j.core.pattern"><code>PatternParser</code></a> checks
this flag when processing the
+ <code>alwaysWriteExceptions</code> option: if no converter in the pattern
handles
+ throwables, the parser automatically appends a converter to ensure exceptions
are still written.
</p></div>
<dl class="notes">
<dt>Overrides:</dt>
<dd><code><a
href="LogEventPatternConverter.html#handlesThrowable()">handlesThrowable</a></code> in
class <code><a href="LogEventPatternConverter.html" title="class in
org.apache.logging.log4j.core.pattern">LogEventPatternConverter</a></code></dd>
<dt>Returns:</dt>
-<dd>true if this PatternConverter handles throwables</dd>
+<dd><code>true</code> if this converter consumes and renders a <a
href="https://docs.oracle.com/javase/8/docs/api/java/lang/Throwable.html"
title="class or interface in java.lang"
class="external-link"><code>Throwable</code></a>,
+ <code>false</code> otherwise</dd>
</dl>
</section>
</li>
diff --git
a/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/VariablesNotEmptyReplacementConverter.html
b/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/VariablesNotEmptyReplacementConverter.html
index c6eb5fd671..780be3c0f0 100644
---
a/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/VariablesNotEmptyReplacementConverter.html
+++
b/javadoc/log4j-core/org/apache/logging/log4j/core/pattern/VariablesNotEmptyReplacementConverter.html
@@ -122,10 +122,15 @@ loadScripts(document, 'script');</script>
<div class="col-last even-row-color method-summary-table
method-summary-table-tab2 method-summary-table-tab4">
<div class="block">Formats an event into a string buffer.</div>
</div>
-<div class="col-first odd-row-color method-summary-table
method-summary-table-tab1 method-summary-table-tab4"><code>static <a
href="VariablesNotEmptyReplacementConverter.html" title="class in
org.apache.logging.log4j.core.pattern">VariablesNotEmptyReplacementConverter</a></code></div>
-<div class="col-second odd-row-color method-summary-table
method-summary-table-tab1 method-summary-table-tab4"><code><a
href="#newInstance(org.apache.logging.log4j.core.config.Configuration,java.lang.String%5B%5D)"
class="member-name-link">newInstance</a><wbr>(<a
href="../config/Configuration.html" title="interface in
org.apache.logging.log4j.core.config">Configuration</a> config,
+<div class="col-first odd-row-color method-summary-table
method-summary-table-tab2 method-summary-table-tab4"><code>boolean</code></div>
+<div class="col-second odd-row-color method-summary-table
method-summary-table-tab2 method-summary-table-tab4"><code><a
href="#handlesThrowable()"
class="member-name-link">handlesThrowable</a>()</code></div>
+<div class="col-last odd-row-color method-summary-table
method-summary-table-tab2 method-summary-table-tab4">
+<div class="block">Tests whether this pattern converter is renders a <a
href="https://docs.oracle.com/javase/8/docs/api/java/lang/Throwable.html"
title="class or interface in java.lang"
class="external-link"><code>Throwable</code></a>.</div>
+</div>
+<div class="col-first even-row-color method-summary-table
method-summary-table-tab1 method-summary-table-tab4"><code>static <a
href="VariablesNotEmptyReplacementConverter.html" title="class in
org.apache.logging.log4j.core.pattern">VariablesNotEmptyReplacementConverter</a></code></div>
+<div class="col-second even-row-color method-summary-table
method-summary-table-tab1 method-summary-table-tab4"><code><a
href="#newInstance(org.apache.logging.log4j.core.config.Configuration,java.lang.String%5B%5D)"
class="member-name-link">newInstance</a><wbr>(<a
href="../config/Configuration.html" title="interface in
org.apache.logging.log4j.core.config">Configuration</a> config,
<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html"
title="class or interface in java.lang"
class="external-link">String</a>[] options)</code></div>
-<div class="col-last odd-row-color method-summary-table
method-summary-table-tab1 method-summary-table-tab4">
+<div class="col-last even-row-color method-summary-table
method-summary-table-tab1 method-summary-table-tab4">
<div class="block">Gets an instance of the class.</div>
</div>
</div>
@@ -133,7 +138,7 @@ loadScripts(document, 'script');</script>
</div>
<div class="inherited-list">
<h3
id="methods-inherited-from-class-org.apache.logging.log4j.core.pattern.LogEventPatternConverter">Methods
inherited from class org.apache.logging.log4j.core.pattern.<a
href="LogEventPatternConverter.html" title="class in
org.apache.logging.log4j.core.pattern">LogEventPatternConverter</a></h3>
-<code><a
href="LogEventPatternConverter.html#emptyVariableOutput()">emptyVariableOutput</a>,
<a
href="LogEventPatternConverter.html#format(java.lang.Object,java.lang.StringBuilder)">format</a>,
<a
href="LogEventPatternConverter.html#handlesThrowable()">handlesThrowable</a>,
<a href="LogEventPatternConverter.html#isVariable()">isVariable</a></code></div>
+<code><a
href="LogEventPatternConverter.html#emptyVariableOutput()">emptyVariableOutput</a>,
<a
href="LogEventPatternConverter.html#format(java.lang.Object,java.lang.StringBuilder)">format</a>,
<a
href="LogEventPatternConverter.html#isVariable()">isVariable</a></code></div>
<div class="inherited-list">
<h3
id="methods-inherited-from-class-org.apache.logging.log4j.core.pattern.AbstractPatternConverter">Methods
inherited from class org.apache.logging.log4j.core.pattern.<a
href="AbstractPatternConverter.html" title="class in
org.apache.logging.log4j.core.pattern">AbstractPatternConverter</a></h3>
<code><a href="AbstractPatternConverter.html#getName()">getName</a>, <a
href="AbstractPatternConverter.html#getStyleClass(java.lang.Object)">getStyleClass</a></code></div>
@@ -181,6 +186,27 @@ loadScripts(document, 'script');</script>
</dl>
</section>
</li>
+<li>
+<section class="detail" id="handlesThrowable()">
+<h3>handlesThrowable</h3>
+<div class="member-signature"><span class="modifiers">public</span> <span
class="return-type">boolean</span> <span
class="element-name">handlesThrowable</span>()</div>
+<div class="block"><span class="descfrm-type-label">Description copied from
class: <code><a
href="LogEventPatternConverter.html#handlesThrowable()">LogEventPatternConverter</a></code></span></div>
+<div class="block">Tests whether this pattern converter is renders a <a
href="https://docs.oracle.com/javase/8/docs/api/java/lang/Throwable.html"
title="class or interface in java.lang"
class="external-link"><code>Throwable</code></a>.
+
+ <p>
+ The <a href="PatternParser.html" title="class in
org.apache.logging.log4j.core.pattern"><code>PatternParser</code></a> checks
this flag when processing the
+ <code>alwaysWriteExceptions</code> option: if no converter in the pattern
handles
+ throwables, the parser automatically appends a converter to ensure exceptions
are still written.
+ </p></div>
+<dl class="notes">
+<dt>Overrides:</dt>
+<dd><code><a
href="LogEventPatternConverter.html#handlesThrowable()">handlesThrowable</a></code> in
class <code><a href="LogEventPatternConverter.html" title="class in
org.apache.logging.log4j.core.pattern">LogEventPatternConverter</a></code></dd>
+<dt>Returns:</dt>
+<dd><code>true</code> if this converter consumes and renders a <a
href="https://docs.oracle.com/javase/8/docs/api/java/lang/Throwable.html"
title="class or interface in java.lang"
class="external-link"><code>Throwable</code></a>,
+ <code>false</code> otherwise</dd>
+</dl>
+</section>
+</li>
</ul>
</section>
</li>
diff --git a/manual/pattern-layout.html b/manual/pattern-layout.html
index 2b54a450b4..9282cd54e9 100644
--- a/manual/pattern-layout.html
+++ b/manual/pattern-layout.html
@@ -476,8 +476,7 @@ The pattern parser knows when it has reached the end of a
conversion specifier w
In the example above the conversion specifier <code>%-5p</code> means the
priority of the log event should be left justified to a width of five
characters.</p>
</div>
<div class="paragraph">
-<p>If the pattern string does not contain a specifier to handle a
<code>Throwable</code> being logged, parsing of the pattern will act as if the
<code>%xEx</code> specifier had been added to the end of the string.
-To suppress the formatting of the <code>Throwable</code> completely simply add
<code>%ex{0}</code> as a specifier in the pattern string.</p>
+<p>If the pattern string does not contain a specifier to handle a
<code>Throwable</code> being logged, parsing of the pattern will act as if the
<code>%n%ex</code> specifier had been added to the end of the string.</p>
</div>
</div>
</div>
@@ -617,7 +616,7 @@ If configured, the <code>replace</code> element must
specify the regular express
</tbody>
</table>
<div class="paragraph">
-<p>If <code>true</code> and the user-provided pattern does not contain an
exception converter, an implicit <a
href="#converter-exception-extended"><code>%xEx</code></a> pattern is appended.
+<p>If <code>true</code> and the user-provided pattern does not contain an
exception converter, an implicit <a
href="#converter-exception-extended"><code>%n%ex</code></a> pattern is appended.
This means that if you do not include a way to output exceptions in your
pattern, the default exception formatter will be added to the end of the
pattern.
Setting this to <code>false</code> disables this behavior and allows you to
exclude exceptions from your pattern output.</p>
</div>
@@ -1383,7 +1382,13 @@ It features two modes:</p>
</td>
<td class="content">
<div class="paragraph">
-<p>All rendered exception stack traces are ensured to be prefixed with a new
line obtained using <code>System.lineSeparator()</code>.</p>
+<p>Earlier versions of Log4j Core always inserted a space between the
<strong>output</strong> of the previous conversion specifier and the stack
trace.
+Starting with version <code>2.25.0</code>, this was changed to a line
separator instead of a space.
+Since version <code>2.25.2</code>, automatic separation occurs
<strong>only</strong> for converters implicitly added via the <a
href="#plugin-attr-alwaysWriteExceptions"><code>alwaysWriteExceptions</code></a>
option.</p>
+</div>
+<div class="paragraph">
+<p>When you add a throwable converter explicitly in your pattern, Log4j Core
no longer inserts any separator on its own: you have full control over whether
and how to separate the stack trace from the preceding message.
+Thus, if you explicitly provide an exception stack trace converter (e.g.,
<code>%ex</code>), and want to prefix it with a newline, you need it add the
newline prefix yourself too (e.g., <code>%n%ex</code>).</p>
</div>
</td>
</tr>
diff --git a/plugin-reference.html b/plugin-reference.html
index 1e9e90b87b..67804c387f 100644
--- a/plugin-reference.html
+++ b/plugin-reference.html
@@ -1477,7 +1477,7 @@ Originally developed by Ceki Glc and Anders
Kristensen.</p>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p
class="tableblock"><code>header</code></p></td>
-<td class="tableblock halign-left valign-top"><p
class="tableblock"><code>String?</code></p></td>
+<td class="tableblock halign-left valign-top"><p
class="tableblock"><code>boolean?</code></p></td>
<td class="tableblock halign-left valign-top"></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
@@ -16265,10 +16265,10 @@ Supports Lookup expressions.</p>
<td class="tableblock halign-left valign-top"><p
class="tableblock"><code>boolean?</code></p></td>
<td class="tableblock halign-left valign-top"></td>
<td class="tableblock halign-left valign-top"><div class="content"><div
class="paragraph">
-<p>If "true", includes the stacktrace of any Throwable in the generated data,
defaults to "true".</p>
+<p>If "true", includes the stacktrace of any Throwable in the generated JSON,
defaults to "true".</p>
</div>
<div class="paragraph">
-<p>If "true", includes the stacktrace of any Throwable in the generated JSON,
defaults to "true".</p>
+<p>If "true", includes the stacktrace of any Throwable in the generated data,
defaults to "true".</p>
</div></div></td>
</tr>
<tr>
@@ -17562,10 +17562,10 @@ Supports Lookup expressions.</p>
<td class="tableblock halign-left valign-top"><p
class="tableblock"><code>boolean?</code></p></td>
<td class="tableblock halign-left valign-top"></td>
<td class="tableblock halign-left valign-top"><div class="content"><div
class="paragraph">
-<p>If "true", includes the stacktrace of any Throwable in the generated data,
defaults to "true".</p>
+<p>If "true", includes the stacktrace of any Throwable in the generated JSON,
defaults to "true".</p>
</div>
<div class="paragraph">
-<p>If "true", includes the stacktrace of any Throwable in the generated JSON,
defaults to "true".</p>
+<p>If "true", includes the stacktrace of any Throwable in the generated data,
defaults to "true".</p>
</div></div></td>
</tr>
<tr>
@@ -17761,10 +17761,10 @@ Supports Lookup expressions.</p>
<td class="tableblock halign-left valign-top"><p
class="tableblock"><code>boolean?</code></p></td>
<td class="tableblock halign-left valign-top"></td>
<td class="tableblock halign-left valign-top"><div class="content"><div
class="paragraph">
-<p>If "true", includes the stacktrace of any Throwable in the generated data,
defaults to "true".</p>
+<p>If "true", includes the stacktrace of any Throwable in the generated JSON,
defaults to "true".</p>
</div>
<div class="paragraph">
-<p>If "true", includes the stacktrace of any Throwable in the generated JSON,
defaults to "true".</p>
+<p>If "true", includes the stacktrace of any Throwable in the generated data,
defaults to "true".</p>
</div></div></td>
</tr>
<tr>
diff --git a/release-notes.html b/release-notes.html
index 3f273abc75..36f4e6c3e3 100644
--- a/release-notes.html
+++ b/release-notes.html
@@ -385,8 +385,17 @@
<p>Discard the sub-second part while obtaining the initial time (i.e.,
creation time) of a file in <code>RollingFileManager</code> (<a
href="https://github.com/apache/logging-log4j2/issues/3068">3068</a>, <a
href="https://github.com/apache/logging-log4j2/pull/3872">3872</a>)</p>
</li>
<li>
+<p>Fix Pattern Layout exception stack trace converters to no longer prepend
newlines based on context (<a
href="https://github.com/apache/logging-log4j2/issues/3873">3873</a>, <a
href="https://github.com/apache/logging-log4j2/pull/3919">3919</a>)</p>
+</li>
+<li>
<p>Fix the <code>com.google.errorprone:error_prone_annotations</code>
dependency whose version property gets erased due to flattening (<a
href="https://github.com/apache/logging-log4j2/issues/3779">3779</a>, <a
href="https://github.com/apache/logging-log4j2/pull/3785">3785</a>, <a
href="https://github.com/apache/logging-log4j2/issues/3822">3822</a>, <a
href="https://github.com/apache/logging-log4j2/pull/3905">3905</a>)</p>
</li>
+<li>
+<p>Fix detection of <code>Throwable</code> converters inside nested Pattern
Layout patterns when applying <code>alwaysWriteExceptions</code> (<a
href="https://github.com/apache/logging-log4j2/pull/3920">3920</a>)</p>
+</li>
+<li>
+<p>Fix parsing and merging of literals in
<code>InstantPatternDynamicFormatter</code> (<a
href="https://github.com/apache/logging-log4j2/issues/3930">3930</a>, <a
href="https://github.com/apache/logging-log4j2/pull/3932">3932</a>)</p>
+</li>
</ul>
</div>
</div>
diff --git a/sitemap.xml b/sitemap.xml
index 90ccda9986..e71731161a 100644
--- a/sitemap.xml
+++ b/sitemap.xml
@@ -2,238 +2,238 @@
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
<url>
<loc>https://logging.apache.org/log4j/2.x/components.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/development.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/download.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/faq.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/graalvm.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/hibernate.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/index.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/jakarta.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/javadoc.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/log4j-iostreams.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/log4j-jul.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/log4j-spring-boot.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/log4j-spring-cloud-config-client.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/log4j-to-jul.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/api.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/appenders.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/appenders/database.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/appenders/delegating.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/appenders/file.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/appenders/message-queue.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/appenders/network.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/appenders/rolling-file.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/architecture.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/async.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/compatibility.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/config-intro.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/configuration.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/customconfig.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/customloglevels.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/eventlogging.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/extending.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/filters.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/flowtracing.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/garbagefree.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/getting-started.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/implementation.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/index.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/installation.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/jmx.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/json-template-layout.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/layouts.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/logbuilder.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/lookups.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/markers.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/messages.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/pattern-layout.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/performance.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/plugins.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/scripts.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/simple-logger.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/status-logger.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/systemproperties.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/thread-context.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/migrate-from-log4j1.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/migrate-from-logback.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/migrate-from-slf4j.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/plugin-reference.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/release-notes.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/soa.html</loc>
-<lastmod>2025-09-09T19:03:48.714Z</lastmod>
+<lastmod>2025-09-18T18:13:41.948Z</lastmod>
</url>
</urlset>