Author: ceki Date: Wed Jul 15 13:38:54 2009 New Revision: 2352 Modified: logback/trunk/logback-site/src/site/pages/manual/configuration.html Log: - documenting automatic reconfiguration Modified: logback/trunk/logback-site/src/site/pages/manual/configuration.html ============================================================================== --- logback/trunk/logback-site/src/site/pages/manual/configuration.html (original) +++ logback/trunk/logback-site/src/site/pages/manual/configuration.html Wed Jul 15 13:38:54 2009 @@ -353,6 +353,31 @@ <p class="source">java <b>-Dlogback.configurationFile=/path/to/config.xml</b> chapter3.MyApp1</p> + + <h3><a name="autoScan" href="#autoScan">Automatically reloading + configuration file upon modification</a></h3> + + <p>If instructed to do so, logback-classic will scan for changes in + its configuration file and automatically reconfigure itself when + the said configuration file changes. + </p> + + <p>Logback-classic can be instructed to scan for changes in its + configuration file and to automatically re-configure itself by + setting the <span class="attr">scan</span> atrribute of the + <code><configuration></code> element to true, as shown next. + + </p> + <em>Example 3.<span class="autoEx"/>: Scanning for changes in + configuration file and automatic re-configuraion + (logback-examples/src/main/java/chapter3/scan1.xml)</em> + +<pre class="prettyprint source"> +<configuration <b>scan="true"</b>> + ... +</configuration> +</pre> + <h3>Invoking <code>JoranConfigurator</code> directly</h3> <p>Logback relies on a configuration library called Joran which is