svn commit: r1858689 - /velocity/site/production/engine/devel/configuration.html

[cbrisson]

Author: cbrisson
Date: Sun May  5 14:01:11 2019
New Revision: 1858689

URL: http://svn.apache.org/viewvc?rev=1858689&view=rev
Log:
[site/engine] Document runtime.log.track_location (prod)

Modified:
    velocity/site/production/engine/devel/configuration.html

Modified: velocity/site/production/engine/devel/configuration.html
URL: 
http://svn.apache.org/viewvc/velocity/site/production/engine/devel/configuration.html?rev=1858689&r1=1858688&r2=1858689&view=diff
==============================================================================
--- velocity/site/production/engine/devel/configuration.html (original)
+++ velocity/site/production/engine/devel/configuration.html Sun May  5 
14:01:11 2019
@@ -311,6 +311,7 @@ h2:hover > .headerlink, h3:hover > .head
 <span class="na">         |        +-- log_invalid_method_calls</span> <span 
class="o">=</span> <span class="s">true</span>
 <span class="na">         |        +-- log_invalid_references</span> <span 
class="o">=</span> <span class="s">true</span>
 <span class="na">         |        +-- name</span> <span class="o">=</span> 
<span class="s">org.apache.velocity</span>
+<span class="na">         |        +-- track_location</span> <span 
class="o">=</span> <span class="s">false</span>
 <span class="na">         +-- strict_math</span> <span class="o">=</span> 
<span class="s">false</span>
 <span class="na">         +-- strict_mode. +-- enable</span> <span 
class="o">=</span> <span class="s">false</span>
 <span class="na">         |                +-- escape</span> <span 
class="o">=</span> <span class="s">false</span>
@@ -344,6 +345,10 @@ h2:hover > .headerlink, h3:hover > .head
 <blockquote>
 <p>Property to turn off the log output when a method call isn't valid or has 
thrown. Good thing to turn off in production, but very valuable for 
debugging.</p>
 </blockquote>
+<p><strong><code>runtime.log.track_location = false</code></strong></p>
+<blockquote>
+<p>(Since 2.2). When set to true, Velocity will populate <a 
href="https://logback.qos.ch/manual/mdc.html";>slf4j MDC</a> with the 
<code>file</code>, <code>line</code> and <code>context</code> tags during the 
template rendering process. When using an MDC-aware slf4j backend, you can 
display template locations in logs. Be aware that it can have a small 
performance impact.</p>
+</blockquote>
 <h2 id="vtl-directives">VTL Directives<a class="headerlink" 
href="#vtl-directives" title="Permanent link">&para;</a></h2>
 <h3 id="define-directive">#define() Directive<a class="headerlink" 
href="#define-directive" title="Permanent link">&para;</a></h3>
 <p><strong><code>directive.define.max_depth = 2</code></strong></p>